[!WARNING]
Some dependencies could not be looked up. Check the Dependency Dashboard for more information.
Release Notes
chronotope/chrono (chrono)
### [`v0.4.35`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.35)
[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.34...v0.4.35)
Most of our efforts have shifted to improving the API for a 0.5 release, for which cleanups and refactorings are landing on the 0.4.x branch.
The most significant changes in this release are two sets of deprecations.
- We deprecated all timestamp-related methods on `NaiveDateTime`. The reason is that a timestamp is defined to be in UTC. The `NaiveDateTime` type doesn't know the offset from UTC, so it was technically wrong to have these methods. The alternative is to use the similar methods on the `DateTime` type, or from the `TimeZone` trait.
Converting from `NaiveDateTime` to `DateTime` is simple with `.and_utc()`, and in the other direction with `.naive_utc()`.
- The panicking constructors of `TimeDelta` (the new name of the `Duration` type) are deprecated. This was the last part of chrono that defaulted to panicking on error, dating from before rust 1.0.
- A nice change is that `NaiveDate` now includes a niche. So now `Option`, `Option` and `Option>` are the same size as their base types.
- `format::Numeric` and `format::Fixed` are marked as `non_exhaustive`. This will allow us to improve our formatting and parsing support, and we have reason to believe this breaking change will have little to no impact on users.
### Additions
- Add `DateTime::{from_timestamp_micros, from_timestamp_nanos}` ([#1234](https://togithub.com/chronotope/chrono/issues/1234))
- Add getters to `Parsed` ([#1465](https://togithub.com/chronotope/chrono/issues/1465))
### Deprecations
- Deprecate timestamp methods on `NaiveDateTime` ([#1473](https://togithub.com/chronotope/chrono/issues/1473))
- Deprecate panicking constructors of `TimeDelta` ([#1450](https://togithub.com/chronotope/chrono/issues/1450))
### Changes/fixes
- Use `NonZeroI32` inside `NaiveDate` ([#1207](https://togithub.com/chronotope/chrono/issues/1207))
- Mark `format::Numeric` and `format::Fixed` as `non_exhaustive` ([#1430](https://togithub.com/chronotope/chrono/issues/1430))
- `Parsed` fixes to error values ([#1439](https://togithub.com/chronotope/chrono/issues/1439))
- Use `overflowing_naive_local` in `DateTime::checked_add*` ([#1333](https://togithub.com/chronotope/chrono/issues/1333))
- Do complete range checks in `Parsed::set_*` ([#1465](https://togithub.com/chronotope/chrono/issues/1465))
### Documentation
- Rustfmt doctests ([#1452](https://togithub.com/chronotope/chrono/issues/1452))
- Improve docs for crate features ([#1455](https://togithub.com/chronotope/chrono/issues/1455), thanks [@edmorley](https://togithub.com/edmorley))
- Add more documentation and examples to `Parsed` ([#1439](https://togithub.com/chronotope/chrono/issues/1439))
### Internal
- Refactor `internals` module ([#1428](https://togithub.com/chronotope/chrono/issues/1428), [#1429](https://togithub.com/chronotope/chrono/issues/1429), [#1431](https://togithub.com/chronotope/chrono/issues/1431), [#1432](https://togithub.com/chronotope/chrono/issues/1432), [#1433](https://togithub.com/chronotope/chrono/issues/1433), [#1438](https://togithub.com/chronotope/chrono/issues/1438))
- CI: test cross-compiling to `x86_64-unknown-illumos` instead of Solaris ([#1437](https://togithub.com/chronotope/chrono/issues/1437))
- CI: lint Windows target, fix clippy warning ([#1441](https://togithub.com/chronotope/chrono/issues/1441))
- CI: only run `cargo hack check` on Linux ([#1442](https://togithub.com/chronotope/chrono/issues/1442))
- Update windows-bindgen to 0.54 ([#1462](https://togithub.com/chronotope/chrono/issues/1462), [#1483](https://togithub.com/chronotope/chrono/issues/1483))
- Simplify error value of `parse_internal` ([#1459](https://togithub.com/chronotope/chrono/issues/1459))
- Simplify `SerdeError` ([#1458](https://togithub.com/chronotope/chrono/issues/1458))
- Simplify `NaiveDate::from_isoywd` a bit ([#1464](https://togithub.com/chronotope/chrono/issues/1464))
Thanks to all contributors on behalf of the chrono team, [@djc](https://togithub.com/djc) and [@pitdicker](https://togithub.com/pitdicker)!
### [`v0.4.34`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.34): 0.4.34
[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.33...v0.4.34)
### Notable changes
- In chrono 0.4.34 we finished the work to make all methods const where doing so is supported by rust 1.61.
- We renamed the `Duration` type to `TimeDelta`. This removes the confusion between chrono's type and the later `Duration` type in the standard library. It will remain available under the old name as a type alias for compatibility.
- The Windows implementation of `Local` is rewritten. The new version avoids panics when the date is outside of the range supported by windows (the years 1601 to 30828), and gives more accurate results during DST transitions.
- The `Display` format of `TimeDelta` is modified to conform better to ISO 8601. Previously it converted all values greater than 24 hours to a value with days. This is not correct, as doing so changes the duration from an 'accurate' to a 'nominal' representation to use ISO 8601 terms.
### Fixes
- Add missing range check in `TimeDelta::milliseconds` ([#1385](https://togithub.com/chronotope/chrono/issues/1385), thanks [@danwilliams](https://togithub.com/danwilliams))
- Remove check for `DurationExceedsTimestamp` in `DurationRound` ([#1403](https://togithub.com/chronotope/chrono/issues/1403), thanks [@joroKr21](https://togithub.com/joroKr21))
- Fix localized formatting with `%X` ([https://github.com/chronotope/pure-rust-locales/pull/12](https://togithub.com/chronotope/pure-rust-locales/pull/12), [#1420](https://togithub.com/chronotope/chrono/issues/1420))
- Windows: base implementation on `GetTimeZoneInformationForYear` ([#1017](https://togithub.com/chronotope/chrono/issues/1017))
### Additions
- Add `TimeDelta::try_milliseconds` ([#1385](https://togithub.com/chronotope/chrono/issues/1385), thanks [@danwilliams](https://togithub.com/danwilliams))
- Add `TimeDelta::new` ([#1337](https://togithub.com/chronotope/chrono/issues/1337))
- Add `StrftimeItems::{parse, parse_to_owned}` and more documentation ([#1184](https://togithub.com/chronotope/chrono/issues/1184))
- More standard traits and documentation for `format::Locale` (via [https://github.com/chronotope/pure-rust-locales/pull/8](https://togithub.com/chronotope/pure-rust-locales/pull/8))
### Changes
- Rename `Duration` to `TimeDelta`, add type alias ([#1406](https://togithub.com/chronotope/chrono/issues/1406))
- Make `TimeDelta` methods const ([#1337](https://togithub.com/chronotope/chrono/issues/1337))
- Make remaining methods of `NaiveDate`, `NaiveWeek`, `NaiveTime` and `NaiveDateTime` const where possible ([#1337](https://togithub.com/chronotope/chrono/issues/1337))
- Make methods on `DateTime` const where possible ([#1400](https://togithub.com/chronotope/chrono/issues/1400))
- Make `Display` format of `TimeDelta` conform better to ISO 8601 ([#1328](https://togithub.com/chronotope/chrono/issues/1328))
### Documentation
- Fix the formatting of `timestamp_micros`'s Example doc ([#1338](https://togithub.com/chronotope/chrono/issues/1338) via [#1386](https://togithub.com/chronotope/chrono/issues/1386), thanks [@emikitas](https://togithub.com/emikitas))
- Specify branch for GitHub Actions badge and fix link ([#1388](https://togithub.com/chronotope/chrono/issues/1388))
- Don't mention some deprecated methods in docs ([#1395](https://togithub.com/chronotope/chrono/issues/1395))
- Remove stray documentation from main ([#1397](https://togithub.com/chronotope/chrono/issues/1397))
- Improved documentation of `TimeDelta` constructors ([#1385](https://togithub.com/chronotope/chrono/issues/1385), thanks [@danwilliams](https://togithub.com/danwilliams))
### Internal
- Switch branch names: 0.4.x releases are the `main` branch, work on 0.5 happens in the `0.5.x` branch ([#1390](https://togithub.com/chronotope/chrono/issues/1390), [#1402](https://togithub.com/chronotope/chrono/issues/1402)).
- Don't use deprecated method in `impl Arbitrary for DateTime` and set up CI test ([#1336](https://togithub.com/chronotope/chrono/issues/1336))
- Remove workaround for Rust < 1.61 ([#1393](https://togithub.com/chronotope/chrono/issues/1393))
- Bump `codecov/codecov-action` from 3 to 4 ([#1404](https://togithub.com/chronotope/chrono/issues/1404))
- Remove partial support for handling `-0000` offset ([#1411](https://togithub.com/chronotope/chrono/issues/1411))
- Move `TOO_LONG` error out of `parse_internal` ([#1419](https://togithub.com/chronotope/chrono/issues/1419))
Thanks to all contributors on behalf of the chrono team, [@djc](https://togithub.com/djc) and [@pitdicker](https://togithub.com/pitdicker)!
### [`v0.4.33`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.33): 0.4.33
[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.32...v0.4.33)
This release fixes the broken docrs.rs build of [chrono 0.4.32](https://togithub.com/chronotope/chrono/releases/tag/v0.4.32).
#### What's Changed
- Make `rkyv` feature imply `size_32` ([#1383](https://togithub.com/chronotope/chrono/issues/1383))
- Fixed typo in `Duration::hours()` exception ([#1384](https://togithub.com/chronotope/chrono/issues/1384), thanks [@danwilliams](https://togithub.com/danwilliams))
### [`v0.4.32`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.32)
[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.31...v0.4.32)
In this release we shipped part of the effort to reduce the number of methods that could unexpectedly panic, notably for the `DateTime` and `Duration` types.
Chrono internally stores the value of a `DateTime` in UTC, and transparently converts it to the local value as required. For example adding a second to a `DateTime` needs to be done in UTC to get the correct result, but adding a day needs to be done in local time to be correct. What happens when the value is near the edge of the representable range, and the implicit conversions pushes it beyond the representable range? *Many* methods could panic on such inputs, including formatting the value for `Debug` output.
In chrono 0.4.32 the range of `NaiveDate`, `NaiveDateTime` and `DateTime` is made slightly smaller. This allows us to always do the implicit conversion, and in many cases return the expected result. Specifically the range is now from January 1, -262144 until December 31, 262143, one year less on both sides than before. We expect this may trip up tests if you hardcoded the `MIN` and `MAX` dates.
`Duration` had a similar issue. The range of this type was pretty arbitrary picked to match the range of an `i64` in milliseconds. Negating an `i64::MIN` pushes a value out of range, and in the same way negating `Duration::MIN` could push it out of our defined range and cause a panic. This turns out to be somewhat common and hidden behind many layers of abstraction. We adjusted the type to have a minimum value of `-Duration::MAX` instead and prevent the panic case.
Other highlights:
- `Duration` gained new fallible initialization methods.
- Better support for `rkyv`.
- Most methods on `NaiveDateTime` are now const.
- We had to bump our MSRV to 1.61 to keep building with our dependencies. This will also allow us to make more methods on `DateTime` const in a future release.
Complete list of changes:
#### Fixes
- Fix panic in `TimeZone::from_local_datetime` ([#1071](https://togithub.com/chronotope/chrono/issues/1071))
- Fix out of range panics in `DateTime` getters and setters ([#1317](https://togithub.com/chronotope/chrono/issues/1317), [#1329](https://togithub.com/chronotope/chrono/issues/1329))
#### Additions
- Add `NaiveDateTime::checked_(add|sub)_offset` ([#1313](https://togithub.com/chronotope/chrono/issues/1313))
- Add `DateTime::to_utc` ([#1325](https://togithub.com/chronotope/chrono/issues/1325))
- Derive `Default` for `Duration` ([#1327](https://togithub.com/chronotope/chrono/issues/1327))
- Add `Duration::subsec_nanos` ([#1327](https://togithub.com/chronotope/chrono/issues/1327))
- Add `try_*` builders to `Duration` ([#1327](https://togithub.com/chronotope/chrono/issues/1327))
- Implement `AddAssign` and `SubAssign` for `Duration` ([#1327](https://togithub.com/chronotope/chrono/issues/1327))
- Make methods on `NaiveDateTime` const where possible ([#1286](https://togithub.com/chronotope/chrono/issues/1286))
- Split `clock` feature into `clock` and `now` ([#1343](https://togithub.com/chronotope/chrono/issues/1343), thanks [@mmastrac](https://togithub.com/mmastrac))
- Add `From` for `NaiveDateTime` ([#1355](https://togithub.com/chronotope/chrono/issues/1355), thanks [@dcechano](https://togithub.com/dcechano))
- Add `NaiveDateTime::from_timestamp_nanos` ([#1357](https://togithub.com/chronotope/chrono/issues/1357), thanks [@Ali-Mirghasemi](https://togithub.com/Ali-Mirghasemi))
- Add `Months::num_months()` and `num_years()` ([#1373](https://togithub.com/chronotope/chrono/issues/1373), thanks [@danwilliams](https://togithub.com/danwilliams))
- Add `DateTime::from_timestamp_millis` ([#1374](https://togithub.com/chronotope/chrono/issues/1374), thanks [@xmakro](https://togithub.com/xmakro))
#### Changes
- Fix panic in `Duration::MIN.abs()` (adjust `Duration::MIN` by 1 millisecond) ([#1334](https://togithub.com/chronotope/chrono/issues/1334))
- Bump MSRV to 1.61 ([#1347](https://togithub.com/chronotope/chrono/issues/1347))
- Update windows-targets requirement from 0.48 to 0.52 ([#1360](https://togithub.com/chronotope/chrono/issues/1360))
- Update windows-bindgen to 0.52 ([#1379](https://togithub.com/chronotope/chrono/issues/1379))
#### Deprecations
- Deprecate standalone `format` functions ([#1306](https://togithub.com/chronotope/chrono/issues/1306))
#### Documentation
- Improve doc comment and tests for timestamp_nanos_opt ([#1299](https://togithub.com/chronotope/chrono/issues/1299), thanks [@mlegner](https://togithub.com/mlegner))
- Switch to `doc_auto_cfg` ([#1305](https://togithub.com/chronotope/chrono/issues/1305), [#1326](https://togithub.com/chronotope/chrono/issues/1326))
- Document panics in `Add`/`Sub` impls and use `expect` ([#1316](https://togithub.com/chronotope/chrono/issues/1316))
- Improve types listed in top-level documentation ([#1274](https://togithub.com/chronotope/chrono/issues/1274))
- Improve deprecation note of `TimeZone::datetime_from_str` ([#1342](https://togithub.com/chronotope/chrono/issues/1342), thanks [@tmccombs](https://togithub.com/tmccombs))
- Fix typos in `Datelike` impl for `DateTime` ([#1376](https://togithub.com/chronotope/chrono/issues/1376), thanks [@ElectrifyPro](https://togithub.com/ElectrifyPro))
#### Rkyv support
- Export `Archived*` types in `rkyv` module ([#1304](https://togithub.com/chronotope/chrono/issues/1304))
- Duplicate derives on `Archived*` types ([#1271](https://togithub.com/chronotope/chrono/issues/1271), thanks [@Awpteamoose](https://togithub.com/Awpteamoose))
- Archive derive of PartialEq for rkyv ([#959](https://togithub.com/chronotope/chrono/issues/959), thanks [@mkatychev](https://togithub.com/mkatychev))
- Expose rkyv features as features for chrono users ([#1368](https://togithub.com/chronotope/chrono/issues/1368), thanks [@gz](https://togithub.com/gz))
#### Changes to unstable features
- Don't let `unstable-locales` imply the `alloc` feature ([#1307](https://togithub.com/chronotope/chrono/issues/1307))
- Remove `format::{format_localized, format_item_localized}` ([#1311](https://togithub.com/chronotope/chrono/issues/1311))
- Inline `write_rfc2822_inner`, don't localize ([#1322](https://togithub.com/chronotope/chrono/issues/1322))
#### Internal
- Add benchmark for `DateTime::with_*` ([#1309](https://togithub.com/chronotope/chrono/issues/1309))
- Fix `*_DAYS_FROM_YEAR_0` calculation ([#1312](https://togithub.com/chronotope/chrono/issues/1312))
- Add `NaiveTime::overflowing_(add|sub)_offset` ([#1310](https://togithub.com/chronotope/chrono/issues/1310))
- Rewrite `DateTime::overflowing_(add|sub)_offset` ([#1069](https://togithub.com/chronotope/chrono/issues/1069))
- Tests calling date command `set env LC_ALL` ([#1315](https://togithub.com/chronotope/chrono/issues/1315), thanks [@jtmoon79](https://togithub.com/jtmoon79))
- Update `deny.toml` ([#1320](https://togithub.com/chronotope/chrono/issues/1320))
- Bump actions/setup-node from 3 to 4 ([#1346](https://togithub.com/chronotope/chrono/issues/1346))
- test.yml remove errant `with: node-version` ([#1352](https://togithub.com/chronotope/chrono/issues/1352), thanks [@jtmoon79](https://togithub.com/jtmoon79))
- CI Linting: Fix missing sources checkout in `toml` job ([#1371](https://togithub.com/chronotope/chrono/issues/1371), thanks [@gibbz00](https://togithub.com/gibbz00))
- Silence clippy lint for test code with Rust 1.74.0 ([#1362](https://togithub.com/chronotope/chrono/issues/1362))
Thanks to all contributors on behalf of the chrono team, [@djc](https://togithub.com/djc) and [@pitdicker](https://togithub.com/pitdicker)!
Configuration
📅 Schedule: Branch creation - "before 4am on the first day of the month" (UTC), 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 Mend Renovate. View repository job log here.
This PR contains the following updates:
0.4.31->0.4.35Release Notes
chronotope/chrono (chrono)
### [`v0.4.35`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.35) [Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.34...v0.4.35) Most of our efforts have shifted to improving the API for a 0.5 release, for which cleanups and refactorings are landing on the 0.4.x branch. The most significant changes in this release are two sets of deprecations. - We deprecated all timestamp-related methods on `NaiveDateTime`. The reason is that a timestamp is defined to be in UTC. The `NaiveDateTime` type doesn't know the offset from UTC, so it was technically wrong to have these methods. The alternative is to use the similar methods on the `DateTimeConfiguration
📅 Schedule: Branch creation - "before 4am on the first day of the month" (UTC), 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.
This PR has been generated by Mend Renovate. View repository job log here.