Instant is deprecated. It is recommended to use std::time::Instant directly, importing
time::ext::InstantExt for interoperability with time::Duration.
FormatItem has been renamed to BorrowedFormatItem, avoiding confusion with OwnedFormatItem.
An alias has been added for backwards compatibility.

Fixed

The weekday is optional when parsing RFC2822.
The range of sub-second values in Duration is documented correctly. The previous documentation
contained an off-by-one error.
Leap seconds are now correctly handled when parsing ISO 8601.

`v0.3.34`

Compare Source

Fixed

Computing the local offset on Windows works again. It was broken in some cases in v0.3.32 and
v0.3.33.

`v0.3.33`

Compare Source

Fixed

Builds targeting wasm32-unknown-unknown now work again.

`v0.3.32`

Compare Source

Added

Methods to replace the day of the year.
- Date::replace_ordinal
- PrimitiveDateTime::replace_ordinal
- OffsetDateTime::replace_ordinal
Modules to treat an OffsetDateTime as a Unix timestamp with subsecond precision for serde.
- time::serde::timestamp::milliseconds
- time::serde::timestamp::microseconds
- time::serde::timestamp::nanoseconds

Changed

Duration::time_fn is deprecated.

`v0.3.31`

Compare Source

Added

OffsetDateTime::new_in_offset
OffsetDateTime::new_utc

Changed

The valid range of UtcOffset has been expanded from ±23:59:59 to ±25:59:59. This is to support
the full POSIX range while permitting infallible negation.

`v0.3.30`

Compare Source

Added

powerfmt::smart_display::SmartDisplay has been added for the main types in the library. These
implementations ensure that values follow the requested fill, width, and alignment when using
format! or similar macros. Display is implemented in terms of SmartDisplay.

Fixed

Large values no longer wrap around in release mode when using NumericalDuration or
NumericalStdDuration.

`v0.3.29`

Compare Source

Added

Niche value optimization for Date has been added. Both Date and Option<Date> are four bytes.
Unit conversions have been added. It is now possible to write Second::per(Day), which returns
the number of seconds in one day. See the types in the [time::convert module][time::convert module] for more
information.

Changed

The diagnostic for --cfg unsound_local_offset has been removed.
#![feature(no_coverage)] was previously used internally for code coverage. It is no longer used,
so it has been removed.
The default value for modifier::OffsetHour has been changed. This was unintentionally changed in
v0.3.17 and went unnoticed until now. The sign is now only present if needed by default, as was
the case previously. This does not affect any situation where format_description! or
format_description::parse is used.

Fixed

Adding or subtracting a std::time::Duration to/from an OffsetDateTime will not result in
integer overflow internally. It will still panic if the result is out of range.

`v0.3.28`

Compare Source

Added

More additional constants for the well-known Iso8601 format description have been added. This
avoids the need to manually configure the format.
An [end] component has been added. This is ignored during formatting, but is used to indicate
the end of input when parsing. If any input remains after this component, an error is returned.
This is useful when using the [first] component, as it avoids the need to reorder variants.

Changed

The exemption for MacOS introduced in 0.3.20 has been removed. This is because some supported
versions of MacOS do not meet the requirements for the exemption.
The UnexpectedTrailingCharacters error variant has been moved to ParseFromDescription. All
previously-existing locations of this variant have been deprecated and will no longer be returned.

`v0.3.27`

Compare Source

This sets the serde dependency requirement to >= 1.0.184 where the binaries have been removed.

This release contains only a single change. serde is required to be a version prior to 1.0.171.
This is due to the decision by the maintainer of serde to include pre-built binaries that are
executed without the end user's knowledge. As of the time of publishing, the included binary has not
even been reproduced. This is a security risk, and the time project strongly opposes this
decision. While this may break some users' builds due to conflicting versions, it is a necessary
step to ensure the security.

`v0.3.25`

Compare Source

Fixed

Methods such as Time::replace_milliseconds would panic on some out-of-range values. This has
been fixed.

`v0.3.24`

Compare Source

Added

The subsecond component is taken into account when parsing the unix_timestamp component. If
data is conflicting, the subsecond value takes precedence.
Parsing a Time with only the hour component is now supported. The minute and second, and
subsecond components are assumed to be zero.

Changed

The minimum supported Rust version is now 1.67.0.
The debug output for Parsed has been improved.
When parsing, invalid values are now rejected sooner. Previously, the entire input would be parsed
before being rejected in the final step. Now, invalid values are rejected as soon as they are
encountered. This affects the error variant returned, which may cause minor breakage for any code
(incorrectly) relying on the exact error variant.
When parsing a Time, an error is returned if components are present but not consecutive. For
example, if hours and seconds are present, minutes will not be assumed to be zero.

Fixed

The implementation of Duration::checked_div could return a slightly incorrect result in some
cases. This has been fixed.

`v0.3.23`

Compare Source

Added

Date::next_occurrence
Date::prev_occurrence
Date::nth_next_occurrence
Date::nth_prev_occurrence
Weekday::nth_prev
Month::nth_next
Month::nth_prev

Changed

The minimum supported Rust version policy has been updated. See the README for
details.

Fixed

Duration::abs correctly returns Duration::MAX when near the minimum value. The nanoseconds
value was previously incorrect.
Compliance with ISO 8601 has been improved. Previously, a UTC offset would be incorrectly rejected
in some cases.

`v0.3.22`

Compare Source

Added

OffsetDateTime::checked_to_offset

`v0.3.21`

Compare Source

Added

Any formattable/parsable type can now be used with the time::serde::format_description! macro.
Weekday::nth_next

Changed

The minimum supported Rust version is now 1.65.0.

`v0.3.20`

Compare Source

Changed

The minimum supported Rust version is now 1.63.0.
On Unix-based operating systems with known thread-safe environments, functions obtaining the local
offset no longer require a check that the program is single-threaded. This currently includes
MacOS, illumos, and NetBSD.

Added

[ignore] component in format descriptions. A count modifier is required, indicating the number
of bytes to ignore when parsing.
[unix_timestamp] component in format descriptions. This is currently only usable with
OffsetDateTime. Users can choose between seconds, milliseconds, microseconds, and nanoseconds,
and whether the sign is mandatory or optional.

Fixed

The API for declaring soundness now uses stricter atomic orderings internally.

`v0.3.19`

Compare Source

Fixed

This includes the update to the format_description! macro, which was supposed to be included in
0.3.18.

`v0.3.18`

Compare Source

Changed

The minimum supported Rust version is now 1.62.0.

Added

[first] and [optional] items can now be included in format descriptions. To parse this at
runtime, you must use the format_description::parse_owned method.
format_description::parse_borrowed
An API has been added to opt out of soundness checks for obtaining the local offset. This replaces
the previous, officially unsupported RUSTFLAGS="--cfg unsound_local_offset". End users may call
time::util::local_offset::set_soundness(time::util::local_offset::Soundness::Unsound). This
method is unsafe because it enables undefined behavior if its safety requirements are not
upheld. Note that libraries must not set this to Unsound, as it is impossible for a library
to guarantee end users uphold the required invariants.

Fixed

Correctly parse offset sign when hour is zero. The parse was previously unconditionally positive,
even if the sign indicated otherwise.
Compilation is fixed for WebAssembly.

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

If you want to rebase/retry this PR, check this box

This PR has been generated by Renovate Bot.

This PR contains the following updates: | Package | Type | Update | Change | |---|---|---|---| | [time](https://time-rs.github.io) ([source](https://github.com/time-rs/time)) | dependencies | patch | `0.3.17` -> `0.3.36` | --- ### Release Notes <details> <summary>time-rs/time (time)</summary> ### [`v0.3.36`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0336-2024-04-10) [Compare Source](https://github.com/time-rs/time/compare/v0.3.35...v0.3.36) ##### # Fixed - `FormatItem` can be used as part of an import path. See [#675] for details. [#675]: https://github.com/time-rs/time/issues/675 ### [`v0.3.35`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0335-2024-04-10) [Compare Source](https://github.com/time-rs/time/compare/v0.3.34...v0.3.35) ##### Added - `Duration::checked_neg` - `ext::InstantExt`, which provides methods for using `time::Duration` with `std::time::Instant` ##### Changed - `Instant` is deprecated. It is recommended to use `std::time::Instant` directly, importing `time::ext::InstantExt` for interoperability with `time::Duration`. - `FormatItem` has been renamed to `BorrowedFormatItem`, avoiding confusion with `OwnedFormatItem`. An alias has been added for backwards compatibility. ##### Fixed - The weekday is optional when parsing RFC2822. - The range of sub-second values in `Duration` is documented correctly. The previous documentation contained an off-by-one error. - Leap seconds are now correctly handled when parsing ISO 8601. ### [`v0.3.34`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0334-2024-02-03) [Compare Source](https://github.com/time-rs/time/compare/v0.3.33...v0.3.34) ##### Fixed Computing the local offset on Windows works again. It was broken in some cases in v0.3.32 and v0.3.33. ### [`v0.3.33`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0333-2024-02-03) [Compare Source](https://github.com/time-rs/time/compare/v0.3.32...v0.3.33) ##### Fixed Builds targeting `wasm32-unknown-unknown` now work again. ### [`v0.3.32`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0332-2024-02-01) [Compare Source](https://github.com/time-rs/time/compare/v0.3.31...v0.3.32) ##### Added - Methods to replace the day of the year. - `Date::replace_ordinal` - `PrimitiveDateTime::replace_ordinal` - `OffsetDateTime::replace_ordinal` - Modules to treat an `OffsetDateTime` as a Unix timestamp with subsecond precision for serde. - `time::serde::timestamp::milliseconds` - `time::serde::timestamp::microseconds` - `time::serde::timestamp::nanoseconds` ##### Changed - `Duration::time_fn` is deprecated. ### [`v0.3.31`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0331-2023-12-19) [Compare Source](https://github.com/time-rs/time/compare/v0.3.30...v0.3.31) ##### Added - `OffsetDateTime::new_in_offset` - `OffsetDateTime::new_utc` ##### Changed - The valid range of `UtcOffset` has been expanded from ±23:59:59 to ±25:59:59. This is to support the full POSIX range while permitting infallible negation. ### [`v0.3.30`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0330-2023-10-13) [Compare Source](https://github.com/time-rs/time/compare/v0.3.29...v0.3.30) ##### Added - `powerfmt::smart_display::SmartDisplay` has been added for the main types in the library. These implementations ensure that values follow the requested fill, width, and alignment when using `format!` or similar macros. `Display` is implemented in terms of `SmartDisplay`. ##### Fixed - Large values no longer wrap around in release mode when using `NumericalDuration` or `NumericalStdDuration`. ### [`v0.3.29`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0329-2023-09-24) [Compare Source](https://github.com/time-rs/time/compare/v0.3.28...v0.3.29) ##### Added - Niche value optimization for `Date` has been added. Both `Date` and `Option<Date>` are four bytes. - Unit conversions have been added. It is now possible to write `Second::per(Day)`, which returns the number of seconds in one day. See the types in the [`time::convert` module][time::convert module] for more information. [`time::convert` module]: https://time-rs.github.io/api/time/convert/index.html ##### Changed - The diagnostic for `--cfg unsound_local_offset` has been removed. - `#![feature(no_coverage)]` was previously used internally for code coverage. It is no longer used, so it has been removed. - The default value for `modifier::OffsetHour` has been changed. This was unintentionally changed in v0.3.17 and went unnoticed until now. The sign is now only present if needed by default, as was the case previously. This does not affect any situation where `format_description!` or `format_description::parse` is used. ##### Fixed - Adding or subtracting a `std::time::Duration` to/from an `OffsetDateTime` will not result in integer overflow internally. It will still panic if the result is out of range. ### [`v0.3.28`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0328-2023-08-27) [Compare Source](https://github.com/time-rs/time/compare/v0.3.27...v0.3.28) ##### Added - More additional constants for the well-known `Iso8601` format description have been added. This avoids the need to manually configure the format. - An `[end]` component has been added. This is ignored during formatting, but is used to indicate the end of input when parsing. If any input remains after this component, an error is returned. This is useful when using the `[first]` component, as it avoids the need to reorder variants. ##### Changed - The exemption for MacOS introduced in 0.3.20 has been removed. This is because some supported versions of MacOS do not meet the requirements for the exemption. - The `UnexpectedTrailingCharacters` error variant has been moved to `ParseFromDescription`. All previously-existing locations of this variant have been deprecated and will no longer be returned. ### [`v0.3.27`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0327-2023-08-22) [Compare Source](https://github.com/time-rs/time/compare/v0.3.26...v0.3.27) This sets the `serde` dependency requirement to `>= 1.0.184` where the binaries have been removed. ### [`v0.3.26`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0326-2023-08-18) [Compare Source](https://github.com/time-rs/time/compare/v0.3.25...v0.3.26) This release contains only a single change. `serde` is required to be a version prior to 1.0.171. This is due to the decision by the maintainer of `serde` to include pre-built binaries that are executed without the end user's knowledge. As of the time of publishing, the included binary has not even been reproduced. This is a security risk, and the `time` project strongly opposes this decision. While this may break some users' builds due to conflicting versions, it is a necessary step to ensure the security. ### [`v0.3.25`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0325-2023-08-02) [Compare Source](https://github.com/time-rs/time/compare/v0.3.24...v0.3.25) ##### Fixed - Methods such as `Time::replace_milliseconds` would panic on some out-of-range values. This has been fixed. ### [`v0.3.24`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0324-2023-07-30) [Compare Source](https://github.com/time-rs/time/compare/v0.3.23...v0.3.24) ##### Added - The `subsecond` component is taken into account when parsing the `unix_timestamp` component. If data is conflicting, the `subsecond` value takes precedence. - Parsing a `Time` with only the `hour` component is now supported. The `minute` and `second`, and `subsecond` components are assumed to be zero. ##### Changed - The minimum supported Rust version is now 1.67.0. - The debug output for `Parsed` has been improved. - When parsing, invalid values are now rejected sooner. Previously, the entire input would be parsed before being rejected in the final step. Now, invalid values are rejected as soon as they are encountered. This affects the error variant returned, which may cause minor breakage for any code (incorrectly) relying on the exact error variant. - When parsing a `Time`, an error is returned if components are present but not consecutive. For example, if `hours` and `seconds` are present, `minutes` will not be assumed to be zero. ##### Fixed - The implementation of `Duration::checked_div` could return a slightly incorrect result in some cases. This has been fixed. ### [`v0.3.23`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0323-2023-07-08) [Compare Source](https://github.com/time-rs/time/compare/v0.3.22...v0.3.23) ##### Added - `Date::next_occurrence` - `Date::prev_occurrence` - `Date::nth_next_occurrence` - `Date::nth_prev_occurrence` - `Weekday::nth_prev` - `Month::nth_next` - `Month::nth_prev` ##### Changed **The minimum supported Rust version policy has been updated.** See [the README][msrv-policy] for details. [msrv-policy]: https://github.com/time-rs/time#minimum-rust-version-policy ##### Fixed - `Duration::abs` correctly returns `Duration::MAX` when near the minimum value. The nanoseconds value was previously incorrect. - Compliance with ISO 8601 has been improved. Previously, a UTC offset would be incorrectly rejected in some cases. ### [`v0.3.22`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0322-2023-06-07) [Compare Source](https://github.com/time-rs/time/compare/v0.3.21...v0.3.22) ##### Added - `OffsetDateTime::checked_to_offset` ### [`v0.3.21`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0321-2023-05-05) [Compare Source](https://github.com/time-rs/time/compare/v0.3.20...v0.3.21) ##### Added - Any formattable/parsable type can now be used with the `time::serde::format_description!` macro. - `Weekday::nth_next` ##### Changed - The minimum supported Rust version is now 1.65.0. ### [`v0.3.20`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0320-2023-02-24) [Compare Source](https://github.com/time-rs/time/compare/v0.3.19...v0.3.20) ##### Changed - The minimum supported Rust version is now 1.63.0. - On Unix-based operating systems with known thread-safe environments, functions obtaining the local offset no longer require a check that the program is single-threaded. This currently includes MacOS, illumos, and NetBSD. ##### Added - `[ignore]` component in format descriptions. A `count` modifier is required, indicating the number of bytes to ignore when parsing. - `[unix_timestamp]` component in format descriptions. This is currently only usable with `OffsetDateTime`. Users can choose between seconds, milliseconds, microseconds, and nanoseconds, and whether the sign is mandatory or optional. ##### Fixed - The API for declaring soundness now uses stricter atomic orderings internally. ### [`v0.3.19`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0319-2023-02-16) [Compare Source](https://github.com/time-rs/time/compare/v0.3.18...v0.3.19) ##### Fixed This includes the update to the `format_description!` macro, which was supposed to be included in 0.3.18. ### [`v0.3.18`](https://github.com/time-rs/time/blob/HEAD/CHANGELOG.md#0318-2023-02-16) [Compare Source](https://github.com/time-rs/time/compare/v0.3.17...v0.3.18) ##### Changed - The minimum supported Rust version is now 1.62.0. ##### Added - `[first]` and `[optional]` items can now be included in format descriptions. To parse this at runtime, you must use the `format_description::parse_owned` method. - `format_description::parse_borrowed` - An API has been added to opt out of soundness checks for obtaining the local offset. This replaces the previous, officially unsupported `RUSTFLAGS="--cfg unsound_local_offset"`. End users may call `time::util::local_offset::set_soundness(time::util::local_offset::Soundness::Unsound)`. This method is `unsafe` because it enables undefined behavior if its safety requirements are not upheld. Note that libraries **must not** set this to `Unsound`, as it is impossible for a library to guarantee end users uphold the required invariants. ##### Fixed - Correctly parse offset sign when hour is zero. The parse was previously unconditionally positive, even if the sign indicated otherwise. - Compilation is fixed for WebAssembly. </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this PR, check this box --- This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).