v0.3.42 release

Author: jhpratt

CHANGELOG.md

@@ -6,6 +6,48 @@ The format is based on [Keep a Changelog]. This project adheres to [Semantic Ver
 
 ---
 
+## 0.3.42 [2025-08-31]
+
+### Added
+
+- `Time::duration_until`
+- `Time::duration_since`
+- `per_t` method for all types in `time::convert`. This is similar to the existing `per` method, but
+  can return any of the primitive numeric types that can represent the result. This will cut down on
+  `as` casts while ensuring correctness. Type inference isn't perfect, so you may need to provide a
+  type annotation in some situations.
+- `impl PartialOrd for Month` and `impl Ord for Month`; this assumes the months are in the same year
+- `SystemTimeExt` trait, adding methods for checked arithmetic with `time::Duration` and obtaining
+  the difference between two `SystemTime`s as a `time::Duration`
+- Permit using `UtcDateTime` with `rand` (this was inadvertently omitted previously)
+- `impl core::error::Error` for all error types (now available when the `std` feature is disabled)
+- MacOS can now obtain the local UTC offset in multi-threaded programs as the system APIs are
+  thread-safe.
+- `#[track_caller]` has been added to all relevant methods.
+
+### Changed
+
+- The dependency on `itoa` has been removed, as the standard library now has similar functionality
+  by default.
+- Formatting a component that involves a floating point number is now guaranteed to be
+  deterministic, avoiding any subtle differences between platforms or compiler versions.
+
+### Fixed
+
+- Serializing timestamps with nanosecond precision _should_ always emit the correct value.
+  Previously, it could be off by one nanosecond due to floating point imprecision.
+- A previously unknown bug in `OffsetDateTime::to_offset` and `UtcDateTime::to_offset` has been
+  fixed. The bug could result in a value that was invalid. It was unlikely to ever occur in
+  real-world code, as it involved passing a UTC offset that has never been used in any location.
+
+### Miscellaneous
+
+- The amount of code generated by macros has been massively reduced, on the order of 65-70% for
+  typical use cases of `format_description!`.
+- Significant performance gains for comparisons of `Time`, `PrimitiveDateTime`, `UtcDateTime`, and
+  `OffsetDateTime`. The first three have gains of approximately 85% (i.e. 6× faster).
+- Nearly all methods are `#[inline]`.
+
 ## 0.3.41 [2025-03-23]
 
 ### Fixed

Cargo.lock

@@ -4,8 +4,8 @@ members = ["time", "time-core", "time-macros"]
 resolver = "2"
 
 [workspace.dependencies]
-time-core = { path = "time-core", version = "=0.1.4" }
-time-macros = { path = "time-macros", version = "=0.2.22" }
+time-core = { path = "time-core", version = "=0.1.5" }
+time-macros = { path = "time-macros", version = "=0.2.23" }
 
 criterion = { version = "0.5.1", default-features = false }
 deranged = { version = "0.5.2", features = ["powerfmt"] }

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "time-core"
-version = "0.1.4"
+version = "0.1.5"
 authors = ["Jacob Pratt <[email protected]>", "Time contributors"]
 edition = "2021"
 rust-version = "1.81.0"

time-core/Cargo.toml

@@ -76,7 +76,7 @@ macro_rules! impl_per {
 
             #[doc = concat!("Obtain the number of times `", stringify!($t), "` can fit into `T`.")]
             #[doc = concat!("If `T` is smaller than `", stringify!($t), "`, the code will fail to")]
-            /// compile. The return type is any primitive integer type that can represent the value.
+            /// compile. The return type is any primitive numeric type that can represent the value.
             ///
             /// Valid calls:
             ///

time-core/src/convert.rs

@@ -1,6 +1,6 @@
 [package]
 name = "time-macros"
-version = "0.2.22"
+version = "0.2.23"
 authors = ["Jacob Pratt <[email protected]>", "Time contributors"]
 edition = "2021"
 rust-version = "1.81.0"

time-macros/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "time"
-version = "0.3.41"
+version = "0.3.42"
 authors = ["Jacob Pratt <[email protected]>", "Time contributors"]
 edition = "2021"
 rust-version = "1.81.0"

time/Cargo.toml

@@ -7,6 +7,7 @@ use crate::error::{self, ParseFromDescription, TryFromParsed};
 
 /// An error that occurred at some stage of parsing.
 #[non_exhaustive]
+#[allow(variant_size_differences, reason = "only triggers on some platforms")]
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 pub enum Parse {
     #[expect(missing_docs)]

time/src/error/parse.rs

@@ -6,6 +6,7 @@ use crate::error;
 
 /// An error that occurred when converting a [`Parsed`](crate::parsing::Parsed) to another type.
 #[non_exhaustive]
+#[allow(variant_size_differences, reason = "only triggers on some platforms")]
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 pub enum TryFromParsed {
     /// The [`Parsed`](crate::parsing::Parsed) did not include enough information to construct the

time/src/error/try_from_parsed.rs

@@ -1,5 +1,3 @@
-use num_conv::prelude::*;
-
 use crate::convert::*;
 use crate::OffsetDateTime;