Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Switch to windows-bindgen #1202

Merged
merged 2 commits into from Aug 29, 2023
Merged

Conversation

pitdicker
Copy link
Collaborator

@pitdicker pitdicker commented Jul 25, 2023

As discussed in #1190.
I have to admit windows-bindgen was surprisingly easy to set up.

Edit: The CI is not happy 😆. That is when you declare something as easy.

@pitdicker
Copy link
Collaborator Author

No clue why the CI fails:

     Running tests\win_bindings.rs (target\debug\deps\win_bindings-961cd5ef61c9bddd.exe)

running 1 test
test gen_bindings ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 1.56s

   Doc-tests chrono
error: unexpected closing delimiter: `}`
  --> D:\a\chrono\chrono\src\win_bindings.rs:56:1
   |
53 |  clone(&self) -> Self {
   |                       - this delimiter might not be properly closed...
54 |         *self
55 |     }
   |     - ...as it matches this but it has different indentation
56 | }
   | ^ unexpected closing delimiter

error: aborting due to previous error

error: doctest failed, to rerun pass `--doc`

Maybe cargo starts compiling the doctests while the file is not entirely written yet?


let bindings = windows_bindgen::standalone(&apis);
let mut file = OpenOptions::new().write(true).create(true).open("src/win_bindings.rs")?;
file.write("#![allow(unreachable_pub)]\n".as_bytes())?;
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Currently rustc throws a lot of "warning: unreachable pub item" warnings. I'll open an issue in windows-bindgen.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess I'd go for fs::write("src/win_bindings.rs", format!("#![allow(unreachable_pub)]\n{bindings}"))?; instead, what do you think?

I'd like this test to fail if the existing contents of src/win_bindings.rs are different from the newly generated code.

Also, let's put this in src/offset/local/win_bindings.rs?

@@ -0,0 +1,51 @@
#![allow(unreachable_pub)]
// Bindings generated by `windows-bindgen` 0.49.0
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Windows-bindgen inserts an empty line below the comment, that rustfmt removes. Maybe also something to open an issue for?

@pitdicker
Copy link
Collaborator Author

No clue why the CI fails:

This was an interesting problem. I should have set OpenOptions::truncate. But why did the code look somewhat valid? And why couldn't I replicate the problem?

The CI checks out the repo with CR LF line endings, while I check it out with LF.
The test overwrites the file, but always writes LF line endings. So the new file is shorter, and not truncated because of the missing open option.

It just so happened that the ca. 50 line endings that the new file is shorter left a valid-looking fragment of code of 50 characters at the end.

Copy link
Contributor

@djc djc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is looking great! Would make sense to file bugs for the blank line and unreachable_pub stuff. I'm guessing the latter might be tricky for them...


let bindings = windows_bindgen::standalone(&apis);
let mut file = OpenOptions::new().write(true).create(true).open("src/win_bindings.rs")?;
file.write("#![allow(unreachable_pub)]\n".as_bytes())?;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess I'd go for fs::write("src/win_bindings.rs", format!("#![allow(unreachable_pub)]\n{bindings}"))?; instead, what do you think?

I'd like this test to fail if the existing contents of src/win_bindings.rs are different from the newly generated code.

Also, let's put this in src/offset/local/win_bindings.rs?

@@ -0,0 +1,20 @@
#![cfg(all(windows, feature = "clock", feature = "std"))]

use std::fs::OpenOptions;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I prefer not to import io::Result, instead importing io::self and using io::Result<()>.

use winapi::um::timezoneapi::{
SystemTimeToFileTime, SystemTimeToTzSpecificLocalTime, TzSpecificLocalTimeToSystemTime,
};
use crate::win_bindings::*;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd still prefer not to use * imports.

@djc
Copy link
Contributor

djc commented Jul 27, 2023

(Also, would be cool if you can do the same thing for iana-time-zone, otherwise we effectively still have a dependency on windows-sys.)

@pitdicker pitdicker force-pushed the windows-bindgen branch 2 times, most recently from cbc2854 to 69d953e Compare July 27, 2023 13:44
let existing = fs::read_to_string(path)?;
// Skip the first two lines when comparing:
// - We add `#![allow(unreachable_pub)]` as a first line.
// - Rustfmt removes the empty line after the comment.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should make sure the code is formatted before it's written, so we can compare directly (and don't need to format as a separate stuff when we need to commit a new version).

Can you run rustfmt against the generated file? Or use the prettyplease crate, if it yields the same formatting for this code?

@pitdicker
Copy link
Collaborator Author

We may want to hold off on this. I could not find the repro for windows-bindgen. It seems to get replaced by riddle microsoft/windows-rs#2544, https://crates.io/crates/riddle.

@djc
Copy link
Contributor

djc commented Jul 27, 2023

riddle looks to be for the windows crate, whereas windows-bindgen is for windows-sys.

What do you mean by "could not find the repro"?

@pitdicker
Copy link
Collaborator Author

The crate use to live in https://github.com/microsoft/windows-rs/tree/0.50.0/crates/libs/bindgen, but is gone on master.

@djc
Copy link
Contributor

djc commented Jul 27, 2023

Ah, you meant repo instead of repro. It does look like riddle is the hot new thing...

@pitdicker pitdicker marked this pull request as draft July 27, 2023 15:08
@MarijnS95
Copy link

Riddle is indeed the new thing, and works a treat for generating these bindings. You could have a simple script or (documented) minimal cmd-line to call riddle with one argument, it no longer needs to be hardcoded in a #[test] or build.rs.

@MarijnS95
Copy link

This is how I employed it in one of the crates I maintain: Traverse-Research/amd-ext-d3d-rs@d5ba122

@pitdicker
Copy link
Collaborator Author

This is how I employed it in one of the crates I maintain: Traverse-Research/amd-ext-d3d-rs@d5ba122

Thank you, this is very helpful!

@pitdicker
Copy link
Collaborator Author

windows-bindgen is back as a library version of riddle microsoft/windows-rs#2609.
It's API seems to still be unstable, and now requires an input file 🤷.

@pitdicker pitdicker marked this pull request as ready for review August 28, 2023 13:49
@codecov
Copy link

codecov bot commented Aug 28, 2023

Codecov Report

Merging #1202 (80734fc) into 0.4.x (7eb6db1) will decrease coverage by 0.07%.
Report is 4 commits behind head on 0.4.x.
The diff coverage is n/a.

@@            Coverage Diff             @@
##            0.4.x    #1202      +/-   ##
==========================================
- Coverage   86.14%   86.08%   -0.07%     
==========================================
  Files          37       37              
  Lines       13394    13501     +107     
==========================================
+ Hits        11538    11622      +84     
- Misses       1856     1879      +23     
Files Changed Coverage Δ
src/offset/local/mod.rs 89.01% <ø> (ø)

... and 6 files with indirect coverage changes

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

@pitdicker pitdicker force-pushed the windows-bindgen branch 3 times, most recently from ee2351d to 59b7550 Compare August 28, 2023 14:43
Cargo.toml Show resolved Hide resolved
src/offset/local/win_bindings.txt Show resolved Hide resolved
Copy link
Contributor

@djc djc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is looking really nice!

eprintln!("{}", log);

let new = fs::read_to_string(output).unwrap();
if !new.lines().eq(existing.lines()) {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why are we comparing this on a line-by-line basis? To get around the \r\n vs \n differences? If so, please add a comment to that effect.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pretty sure it's that, all files should be checked in to the repo with \n but because the test runs on Windows (windows-bindgen runs just fine on Linux, fwiw!) the output will be \r\n.

Personally I'd just run this test in the CI with a helpful "how to regenerate" message and a git status --porcelain check for files that may not be checked in, as linked above:

Traverse-Research/amd-ext-d3d-rs@d5ba122#diff-b803fcb7f17ed9235f1e5cb1fcd2f5d3b2838429d4368ae4c57ce4436577f03fR62

(Note that this line changed a bit on main because we're back to cargo r -p api_gen.)

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(windows-bindgen runs just fine on Linux, fwiw!)

I just rebooted from Linux to Windows to work on this 🤣

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@MarijnS95 I have to admit I am pretty bad at all this 😄. Is it easy for you to change this PR to something better?
And thanks for helping out already!

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

At least you can execute the generated code that way, unless cross-compiling with --target x86_64-pc-windows-gnu and running it in wine :)

Is it easy for you to change this PR

Not at all, I'm a Linux user keeping windows-rs "in check" around our dependencies to support a primarily (exclusively?) Windows-based dev team, so I just happen to look at random PRs but otherwise have no reviewer/maintainer rights here whatsoever.

@djc
Copy link
Contributor

djc commented Aug 29, 2023

@MarijnS95 thanks for the reviews!

(already covered by the `clock` feature)
@djc
Copy link
Contributor

djc commented Aug 29, 2023

I think it would be great to just merge this in its current state, we can get it into 0.4.27.

@pitdicker pitdicker merged commit 00d389e into chronotope:0.4.x Aug 29, 2023
36 checks passed
@pitdicker pitdicker deleted the windows-bindgen branch August 29, 2023 13:25
renovate bot added a commit to ziyadedher/evm-bench that referenced this pull request Aug 29, 2023
[![Mend
Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [chrono](https://togithub.com/chronotope/chrono) | dependencies |
patch | `0.4.26` -> `0.4.27` |

---

### Release Notes

<details>
<summary>chronotope/chrono (chrono)</summary>

###
[`v0.4.27`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.27):
0.4.27

This release bumps the MSRV from 1.56 to 1.57. This allows us to take
advantage of the panicking in const feature. In this release most
methods on `NaiveDate` and `NaiveTime` are made const, `NaiveDateTime`
and others will follow in a later release.

##### Deprecations

- Deprecate `DateTime::{from_local, from_utc}`
([chronotope/chrono#1175)

##### Additions

- Let `DateTime::signed_duration_since` take argument with `Borrow`
([chronotope/chrono#1119)
- Implement `PartialOrd` for `Month`
([chronotope/chrono#999,
thanks [@&#8203;Munksgaard](https://togithub.com/Munksgaard))
- Add `Ord` and `Eq` for types which already derive `PartialOrd` and
`PartialEq`
([chronotope/chrono#1128,
thanks [@&#8203;totikom](https://togithub.com/totikom))
- implement `FusedIterator` for `NaiveDateDaysIterator` and
`NaiveDateWeeksIterator`
([chronotope/chrono#1134)
- Make `NaiveDateDaysIterator` and `NaiveDateWeeksIterator` public
([chronotope/chrono#1134)
- Add `FromStr` for `FixedOffset`
([chronotope/chrono#1157,
thanks [@&#8203;mcronce](https://togithub.com/mcronce))
- Remove `Tz::Offset: Display` requirement from `DateTime::to_rfc*`
([chronotope/chrono#1160)
- More flexible offset formatting (not exposed yet)
([chronotope/chrono#1160)
- Make `StrftimeItems` with `unstable-locales` work without allocating
([chronotope/chrono#1152)
- Make `NaiveDate::from_ymd_opt` const
([chronotope/chrono#1172,
thanks [@&#8203;kamadorueda](https://togithub.com/kamadorueda))
- Implement `Error` trait for `ParseWeekdayError` and `ParseMonthError`
([chronotope/chrono#539,
thanks [@&#8203;mike-kfed](https://togithub.com/mike-kfed))
- Make methods on `NaiveTime` const, update MSRV to 1.57
([chronotope/chrono#1080)
- Make methods on `NaiveDate` const
([chronotope/chrono#1205)
- Implement operations for `core::time::Duration` on `DateTime` types
([chronotope/chrono#1229)

##### Fixes

- Ensure `timestamp_nanos` panics on overflow in release builds
([chronotope/chrono#1123)
- Fix `offset_from_local_datetime` for `wasm_bindgen`
([chronotope/chrono#1131)
- Parsing: Consider `%s` to be a timestamp in UTC
([chronotope/chrono#1136)
- Don't panic when formatting with `%#z`
([chronotope/chrono#1140,
thanks [@&#8203;domodwyer](https://togithub.com/domodwyer))
- Parsing: allow MINUS SIGN (U+2212) in offset
([chronotope/chrono#1087,
thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
- Fix locale formatting for `%c` and `%r`
([chronotope/chrono#1165)
- Localize decimal point with `unstable-locales` feature
([chronotope/chrono#1168)
- Fix panic on macOS 10.12 caused by using version 1 of the TZif file
format
([chronotope/chrono#1201,
thanks to help from [@&#8203;jfro](https://togithub.com/jfro))
- Fix deserialization of negative timestamps
([chronotope/chrono#1194)
- Do not use `Offset`'s `Debug` impl when serializing `DateTime`
([chronotope/chrono#1035)
- Allow missing seconds in `NaiveTime::from_str`
([chronotope/chrono#1181)
- Do not depend on `android-tzdata` if the `clock` feature is not
enabled
([chronotope/chrono#1220,
thanks [@&#8203;AlexTMjugador](https://togithub.com/AlexTMjugador))
- Small fixes to the RFC 3339 parsers
([chronotope/chrono#1145)

##### Documentation

- Add "Errors" and "Panics" sections to API docs
([chronotope/chrono#1120)
- Specify licenses in SPDX format
([chronotope/chrono#1132,
backport of
[chronotope/chrono#856,
thanks [@&#8203;keymandll](https://togithub.com/keymandll))
- Fix `NaiveTime` doc typo
([chronotope/chrono#1146,
thanks [@&#8203;zachs18](https://togithub.com/zachs18))
- Clarify nanosecond formatting specifier doc
([chronotope/chrono#1173)
- Add warning against combining multiple `Datelike::with_*`
([chronotope/chrono#1199)
- Fix typo "accepted"
([chronotope/chrono#1209)
- Add some examples to `Utc::now` and `Local::now`
([chronotope/chrono#1192)
- Add example to `Weekday::num_days_from_monday`
([chronotope/chrono#1193)
- Fix some comments and panic messages
([chronotope/chrono#1221,
thanks [@&#8203;umanwizard](https://togithub.com/umanwizard))

##### Internal improvements

- `DateTime::to_rfc_*` optimizations
([chronotope/chrono#1200)
- Move all tests into modules, fix clippy warnings
([chronotope/chrono#1138)
- Offset parsing cleanup
([chronotope/chrono#1158)
- Factor out formatting to `format/formatting.rs`
([chronotope/chrono#1156)
- Format refactorings
([chronotope/chrono#1198)
- Format toml files with taplo
([chronotope/chrono#1117,
thanks [@&#8203;tottoto](https://togithub.com/tottoto))
- Stop vendoring `saturating_abs`
([chronotope/chrono#1124)
- CI: shell set -eux, use bash
([chronotope/chrono#1103,
thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
- Fix dead code error when running dateutils test on Windows
([chronotope/chrono#1125)
- Remove `Makefile`
([chronotope/chrono#1133)
- CI: Test `wasm-bindgen` feature
([chronotope/chrono#1131)
- Stop using deprecated methods in parse module
([chronotope/chrono#1142)
- Add formatting benchmarks
([chronotope/chrono#1155)
- Feature gate tests instead of methods
([chronotope/chrono#1159,
[chronotope/chrono#1162)
- Parallelize `try_verify_against_date_command`
([chronotope/chrono#1161)
- CI: also run integration tests with `no_std`
([chronotope/chrono#1166)
- Split ` test_parse `
([chronotope/chrono#1170)
- Remove `#![deny(dead_code)]`
([chronotope/chrono#1187)
- Clippy fixes for Rust 1.71
([chronotope/chrono#1186)
- Various small improvements
([chronotope/chrono#1191)
- Add unit test for uncovered regions
([chronotope/chrono#1149,
thanks [@&#8203;CXWorks](https://togithub.com/CXWorks))
- Don't test the same thing twice in `test_date_extreme_offset`
([chronotope/chrono#1195)
- CI: Add workflow code coverage report and upload
([chronotope/chrono#1178,
[chronotope/chrono#1215,
thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
- CI: fail on warnings in `features-check`
([chronotope/chrono#1216)
- Switch to windows-bindgen
([chronotope/chrono#1202,
thanks to help from [@&#8203;MarijnS95](https://togithub.com/MarijnS95))

Thanks to all contributors on behalf of the chrono team,
[@&#8203;djc](https://togithub.com/djc) and
[@&#8203;pitdicker](https://togithub.com/pitdicker)!

</details>

---

### Configuration

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

🚦 **Automerge**: Enabled.

♻ **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.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR has been generated by [Mend
Renovate](https://www.mend.io/free-developer-tools/renovate/). View
repository job log
[here](https://developer.mend.io/github/ziyadedher/evm-bench).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNi42OC4xIiwidXBkYXRlZEluVmVyIjoiMzYuNjguMSIsInRhcmdldEJyYW5jaCI6Im1haW4ifQ==-->

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
fbjork added a commit to grafbase/grafbase that referenced this pull request Sep 4, 2023
[![Mend
Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [chrono](https://togithub.com/chronotope/chrono) | dependencies |
patch | `0.4.26` -> `0.4.28` |

---

### Release Notes

<details>
<summary>chronotope/chrono (chrono)</summary>

###
[`v0.4.28`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.28):
0.4.28

[Compare
Source](https://togithub.com/chronotope/chrono/compare/v0.4.27...v0.4.28)

This release fixes a test failure on 32-bit targets introduced with
0.4.27, see
[chronotope/chrono#1234.

###
[`v0.4.27`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.27):
0.4.27

[Compare
Source](https://togithub.com/chronotope/chrono/compare/v0.4.26...v0.4.27)

This release bumps the MSRV from 1.56 to 1.57. This allows us to take
advantage of the panicking in const feature. In this release most
methods on `NaiveDate` and `NaiveTime` are made const, `NaiveDateTime`
and others will follow in a later release.

The parser for the `%+` formatting specifier and the `RFC3339`
formatting item is switched from a strict to a relaxed parser (see
[chronotope/chrono#1145).
This matches the existing documentation, and the parser used by
`DateTime::from_str`. If you need to validate the input, consider using
`DateTime::from_rfc3339`.

##### Deprecations

- Deprecate `DateTime::{from_local, from_utc}`
([chronotope/chrono#1175)

##### Additions

- Let `DateTime::signed_duration_since` take argument with `Borrow`
([chronotope/chrono#1119)
- Implement `PartialOrd` for `Month`
([chronotope/chrono#999,
thanks [@&#8203;Munksgaard](https://togithub.com/Munksgaard))
- Add `Ord` and `Eq` for types which already derive `PartialOrd` and
`PartialEq`
([chronotope/chrono#1128,
thanks [@&#8203;totikom](https://togithub.com/totikom))
- implement `FusedIterator` for `NaiveDateDaysIterator` and
`NaiveDateWeeksIterator`
([chronotope/chrono#1134)
- Make `NaiveDateDaysIterator` and `NaiveDateWeeksIterator` public
([chronotope/chrono#1134)
- Add `FromStr` for `FixedOffset`
([chronotope/chrono#1157,
thanks [@&#8203;mcronce](https://togithub.com/mcronce))
- Remove `Tz::Offset: Display` requirement from `DateTime::to_rfc*`
([chronotope/chrono#1160)
- More flexible offset formatting (not exposed yet)
([chronotope/chrono#1160)
- Make `StrftimeItems` with `unstable-locales` work without allocating
([chronotope/chrono#1152)
- Make `NaiveDate::from_ymd_opt` const
([chronotope/chrono#1172,
thanks [@&#8203;kamadorueda](https://togithub.com/kamadorueda))
- Implement `Error` trait for `ParseWeekdayError` and `ParseMonthError`
([chronotope/chrono#539,
thanks [@&#8203;mike-kfed](https://togithub.com/mike-kfed))
- Make methods on `NaiveTime` const, update MSRV to 1.57
([chronotope/chrono#1080)
- Make methods on `NaiveDate` const
([chronotope/chrono#1205)
- Implement operations for `core::time::Duration` on `DateTime` types
([chronotope/chrono#1229)

##### Fixes

- Ensure `timestamp_nanos` panics on overflow in release builds
([chronotope/chrono#1123)
- Fix `offset_from_local_datetime` for `wasm_bindgen`
([chronotope/chrono#1131)
- Parsing: Consider `%s` to be a timestamp in UTC
([chronotope/chrono#1136)
- Don't panic when formatting with `%#z`
([chronotope/chrono#1140,
thanks [@&#8203;domodwyer](https://togithub.com/domodwyer))
- Parsing: allow MINUS SIGN (U+2212) in offset
([chronotope/chrono#1087,
thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
- Fix locale formatting for `%c` and `%r`
([chronotope/chrono#1165)
- Localize decimal point with `unstable-locales` feature
([chronotope/chrono#1168)
- Fix panic on macOS 10.12 caused by using version 1 of the TZif file
format
([chronotope/chrono#1201,
thanks to help from [@&#8203;jfro](https://togithub.com/jfro))
- Fix deserialization of negative timestamps
([chronotope/chrono#1194)
- Do not use `Offset`'s `Debug` impl when serializing `DateTime`
([chronotope/chrono#1035)
- Allow missing seconds in `NaiveTime::from_str`
([chronotope/chrono#1181)
- Do not depend on `android-tzdata` if the `clock` feature is not
enabled
([chronotope/chrono#1220,
thanks [@&#8203;AlexTMjugador](https://togithub.com/AlexTMjugador))
- Small fixes to the RFC 3339 parsers
([chronotope/chrono#1145)

##### Documentation

- Add "Errors" and "Panics" sections to API docs
([chronotope/chrono#1120)
- Specify licenses in SPDX format
([chronotope/chrono#1132,
backport of
[chronotope/chrono#910,
thanks [@&#8203;LingMan](https://togithub.com/LingMan))
- Fix `NaiveTime` doc typo
([chronotope/chrono#1146,
thanks [@&#8203;zachs18](https://togithub.com/zachs18))
- Clarify nanosecond formatting specifier doc
([chronotope/chrono#1173)
- Add warning against combining multiple `Datelike::with_*`
([chronotope/chrono#1199)
- Fix typo "accepted"
([chronotope/chrono#1209,
thanks [@&#8203;simon04](https://togithub.com/simon04))
- Add some examples to `Utc::now` and `Local::now`
([chronotope/chrono#1192)
- Add example to `Weekday::num_days_from_monday`
([chronotope/chrono#1193)
- Fix some comments and panic messages
([chronotope/chrono#1221,
thanks [@&#8203;umanwizard](https://togithub.com/umanwizard))

##### Internal improvements

- `DateTime::to_rfc_*` optimizations
([chronotope/chrono#1200)
- Move all tests into modules, fix clippy warnings
([chronotope/chrono#1138)
- Offset parsing cleanup
([chronotope/chrono#1158)
- Factor out formatting to `format/formatting.rs`
([chronotope/chrono#1156)
- Format refactorings
([chronotope/chrono#1198)
- Format toml files with taplo
([chronotope/chrono#1117,
thanks [@&#8203;tottoto](https://togithub.com/tottoto))
- Stop vendoring `saturating_abs`
([chronotope/chrono#1124)
- CI: shell set -eux, use bash
([chronotope/chrono#1103,
thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
- Fix dead code error when running dateutils test on Windows
([chronotope/chrono#1125)
- Remove `Makefile`
([chronotope/chrono#1133)
- CI: Test `wasm-bindgen` feature
([chronotope/chrono#1131)
- Stop using deprecated methods in parse module
([chronotope/chrono#1142)
- Add formatting benchmarks
([chronotope/chrono#1155)
- Feature gate tests instead of methods
([chronotope/chrono#1159,
[chronotope/chrono#1162)
- Parallelize `try_verify_against_date_command`
([chronotope/chrono#1161)
- CI: also run integration tests with `no_std`
([chronotope/chrono#1166)
- Split ` test_parse `
([chronotope/chrono#1170)
- Remove `#![deny(dead_code)]`
([chronotope/chrono#1187)
- Clippy fixes for Rust 1.71
([chronotope/chrono#1186)
- Various small improvements
([chronotope/chrono#1191)
- Add unit test for uncovered regions
([chronotope/chrono#1149,
thanks [@&#8203;CXWorks](https://togithub.com/CXWorks))
- Don't test the same thing twice in `test_date_extreme_offset`
([chronotope/chrono#1195)
- CI: Add workflow code coverage report and upload
([chronotope/chrono#1178,
[chronotope/chrono#1215,
thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
- CI: fail on warnings in `features-check`
([chronotope/chrono#1216)
- Switch to windows-bindgen
([chronotope/chrono#1202,
thanks to help from [@&#8203;MarijnS95](https://togithub.com/MarijnS95))

Thanks to all contributors on behalf of the chrono team,
[@&#8203;djc](https://togithub.com/djc) and
[@&#8203;pitdicker](https://togithub.com/pitdicker)!

</details>

---

### Configuration

📅 **Schedule**: Branch creation - "before 4am on Monday" (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.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR has been generated by [Mend
Renovate](https://www.mend.io/free-developer-tools/renovate/). View
repository job log
[here](https://developer.mend.io/github/grafbase/grafbase).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNi43OC44IiwidXBkYXRlZEluVmVyIjoiMzYuNzguOCIsInRhcmdldEJyYW5jaCI6Im1haW4ifQ==-->
kodiakhq bot pushed a commit to X-oss-byte/Nextjs that referenced this pull request Sep 21, 2023
[![Mend Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [chrono](https://togithub.com/chronotope/chrono) | workspace.dependencies | patch | `0.4.23` -> `0.4.31` |

---

### Release Notes

<details>
<summary>chronotope/chrono (chrono)</summary>

### [`v0.4.31`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.31): 0.4.31

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.30...v0.4.31)

Another maintenance release.
It was not a planned effort to improve our support for UNIX timestamps, yet most PRs seem related to this.

##### Deprecations

-   Deprecate `timestamp_nanos` in favor of the non-panicking `timestamp_nanos_opt` ([#&#8203;1275](https://togithub.com/chronotope/chrono/issues/1275))

##### Additions

-   Add `DateTime::<Utc>::from_timestamp` ([#&#8203;1279](https://togithub.com/chronotope/chrono/issues/1279), thanks [@&#8203;demurgos](https://togithub.com/demurgos))
-   Add `TimeZone::timestamp_micros` ([#&#8203;1285](https://togithub.com/chronotope/chrono/issues/1285), thanks [@&#8203;emikitas](https://togithub.com/emikitas))
-   Add `DateTime<Tz>::timestamp_nanos_opt` and `NaiveDateTime::timestamp_nanos_opt` ([#&#8203;1275](https://togithub.com/chronotope/chrono/issues/1275))
-   Add `UNIX_EPOCH` constants ([#&#8203;1291](https://togithub.com/chronotope/chrono/issues/1291))

##### Fixes

-   Format day of month in RFC 2822 without padding ([#&#8203;1272](https://togithub.com/chronotope/chrono/issues/1272))
-   Don't allow strange leap seconds which are not on a minute boundary initialization methods ([#&#8203;1283](https://togithub.com/chronotope/chrono/issues/1283))
    This makes many methods a little more strict:
    -   `NaiveTime::from_hms_milli`
    -   `NaiveTime::from_hms_milli_opt`
    -   `NaiveTime::from_hms_micro`
    -   `NaiveTime::from_hms_micro_opt`
    -   `NaiveTime::from_hms_nano`
    -   `NaiveTime::from_hms_nano_opt`
    -   `NaiveTime::from_num_seconds_from_midnight`
    -   `NaiveTime::from_num_seconds_from_midnight_opt`
    -   `NaiveDate::and_hms_milli`
    -   `NaiveDate::and_hms_milli_opt`
    -   `NaiveDate::and_hms_micro`
    -   `NaiveDate::and_hms_micro_opt`
    -   `NaiveDate::and_hms_nano`
    -   `NaiveDate::and_hms_nano_opt`
    -   `NaiveDateTime::from_timestamp`
    -   `NaiveDateTime::from_timestamp_opt`
    -   `TimeZone::timestamp`
    -   `TimeZone::timestamp_opt`
-   Fix underflow in `NaiveDateTime::timestamp_nanos_opt` ([#&#8203;1294](https://togithub.com/chronotope/chrono/issues/1294), thanks [@&#8203;crepererum](https://togithub.com/crepererum))

##### Documentation

-   Add more documentation about the RFC 2822 obsolete date format ([#&#8203;1267](https://togithub.com/chronotope/chrono/issues/1267))

##### Internal

-   Remove internal `__doctest` feature and `doc_comment` dependency ([#&#8203;1276](https://togithub.com/chronotope/chrono/issues/1276))
-   CI: Bump `actions/checkout` from 3 to 4 ([#&#8203;1280](https://togithub.com/chronotope/chrono/issues/1280))
-   Optimize `NaiveDate::add_days` for small values ([#&#8203;1214](https://togithub.com/chronotope/chrono/issues/1214))
-   Upgrade `pure-rust-locales` to 0.7.0 ([#&#8203;1288](https://togithub.com/chronotope/chrono/issues/1288), thanks [@&#8203;jeremija](https://togithub.com/jeremija) wo did good improvements on `pure-rust-locales`)

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.30`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.30): 0.4.30

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.29...v0.4.30)

In this release, we have decided to swap out the `chrono::Duration` type (which has been a re-export of time 0.1 `Duration` type) with our own definition, which exposes a strict superset of the `time::Duration` API. This helps avoid warnings about the [CVE-2020-26235] and [RUSTSEC-2020-0071] advisories for downstream users and allows us to improve the `Duration` API going forward.

While this is technically a SemVer-breaking change, we expect the risk of downstream users experiencing actual incompatibility to be exceedingly limited (see [our analysis](https://togithub.com/chronotope/chrono/pull/1095#issuecomment-1571716955) of public code using a crater-like experiment), and not enough justification for the large ecosystem churn of a 0.5 release. If you have any feedback on these changes, please let us know in [#&#8203;1268](https://togithub.com/chronotope/chrono/issues/1268).

##### Additions

-   Add `NaiveDate::leap_year` ([#&#8203;1261](https://togithub.com/chronotope/chrono/issues/1261))

##### Documentation

-   Update main documentation from README ([#&#8203;1260](https://togithub.com/chronotope/chrono/issues/1260), thanks [@&#8203;Stygmates](https://togithub.com/Stygmates))
-   Add history of relation between chrono and time 0.1 to documentation ([chronotope/chrono#1264, [chronotope/chrono#1266)
-   Clarify `Timelike::num_seconds_from_midnight` is a simple mapping ([#&#8203;1255](https://togithub.com/chronotope/chrono/issues/1255))

#### Relation between chrono and time 0.1

Rust first had a `time` module added to `std` in its 0.7 release. It later moved to `libextra`, and then to a `libtime` library shipped alongside the standard library. In 2014 work on chrono started in order to provide a full-featured date and time library in Rust. Some improvements from chrono made it into the standard library; notably, `chrono::Duration` was included as `std::time::Duration` ([rust#15934]) in 2014.

In preparation of Rust 1.0 at the end of 2014 `libtime` was moved out of the Rust distro and into the `time` crate to eventually be redesigned ([rust#18832], [rust#18858]), like the `num` and `rand` crates. Of course chrono kept its dependency on this `time` crate. `time` started re-exporting `std::time::Duration` during this period. Later, the standard library was changed to have a more limited unsigned `Duration` type ([rust#24920], [RFC 1040]), while the `time` crate kept the full functionality with `time::Duration`. `time::Duration` had been a part of chrono's public API.

By 2016 `time` 0.1 lived under the `rust-lang-deprecated` organisation and was not actively maintained ([time#136]). chrono absorbed the platform functionality and `Duration` type of the `time` crate in [chrono#478] (the work started in [chrono#286]). In order to preserve compatibility with downstream crates depending on `time` and `chrono` sharing a `Duration` type, chrono kept depending on time 0.1. chrono offered the option to opt out of the `time` dependency by disabling the `oldtime` feature (swapping it out for an effectively similar chrono type). In 2019, [@&#8203;jhpratt](https://togithub.com/jhpratt) took over maintenance on the `time` crate and released what amounts to a new crate as `time` 0.2.

[rust#15934]: https://togithub.com/rust-lang/rust/pull/15934

[rust#18832]: https://togithub.com/rust-lang/rust/pull/18832#issuecomment-62448221

[rust#18858]: https://togithub.com/rust-lang/rust/pull/18858

[rust#24920]: https://togithub.com/rust-lang/rust/pull/24920

[RFC 1040]: https://rust-lang.github.io/rfcs/1040-duration-reform.html

[time#136]: https://togithub.com/time-rs/time/issues/136

[chrono#286]: https://togithub.com/chronotope/chrono/pull/286

[chrono#478]: https://togithub.com/chronotope/chrono/pull/478

##### Security advisories

In November of 2020 [CVE-2020-26235] and [RUSTSEC-2020-0071] were opened against the `time` crate. [@&#8203;quininer](https://togithub.com/quininer) had found that calls to `localtime_r` may be unsound ([chrono#499]). Eventually, almost a year later, this was also made into a security advisory against chrono as [RUSTSEC-2020-0159], which had platform code similar to `time`.

On Unix-like systems a process is given a timezone id or description via the `TZ` environment variable. We need this timezone data to calculate the current local time from a value that is in UTC, such as the time from the system clock. `time` 0.1 and chrono used the POSIX function `localtime_r` to do the conversion to local time, which reads the `TZ` variable.

Rust assumes the environment to be writable and uses locks to access it from multiple threads. Some other programming languages and libraries use similar locking strategies, but these are typically not shared across languages. More importantly, POSIX declares modifying the environment in a multi-threaded process as unsafe, and `getenv` in libc can't be changed to take a lock because it returns a pointer to the data (see [rust#27970] for more discussion).

Since version 4.20 chrono no longer uses `localtime_r`, instead using Rust code to query the timezone (from the `TZ` variable or via `iana-time-zone` as a fallback) and work with data from the system timezone database directly. The code for this was forked from the [tz-rs crate] by [@&#8203;x-hgg-x](https://togithub.com/x-hgg-x). As such, chrono now respects the Rust lock when reading the `TZ` environment variable. In general, code should avoid modifying the environment.

[CVE-2020-26235]: https://nvd.nist.gov/vuln/detail/CVE-2020-26235

[RUSTSEC-2020-0071]: https://rustsec.org/advisories/RUSTSEC-2020-0071

[chrono#499]: https://togithub.com/chronotope/chrono/pull/499

[RUSTSEC-2020-0159]: https://rustsec.org/advisories/RUSTSEC-2020-0159.html

[rust#27970]: https://togithub.com/rust-lang/rust/issues/27970

[chrono#677]: https://togithub.com/chronotope/chrono/pull/677

[tz-rs crate]: https://crates.io/crates/tz-rs

##### Removing time 0.1

Because time 0.1 has been unmaintained for years, however, the security advisory mentioned above has not been addressed. While chrono maintainers were careful not to break backwards compatibility with the `time::Duration` type, there has been a long stream of issues from users inquiring about the time 0.1 dependency with the vulnerability. We investigated the potential breakage of removing the time 0.1 dependency in [chrono#1095] using a crater-like experiment and determined that the potential for breaking (public) dependencies is very low. We reached out to those few crates that did still depend on compatibility with time 0.1.

As such, for chrono 0.4.30 we have decided to swap out the time 0.1 `Duration` implementation for a local one that will offer a strict superset of the existing API going forward. This will prevent most downstream users from being affected by the security vulnerability in time 0.1 while minimizing the ecosystem impact of semver-incompatible version churn.

[chrono#1095]: https://togithub.com/chronotope/chrono/pull/1095

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.29`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.29): 0.4.29

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.28...v0.4.29)

This release fixes a panic introduced in chrono 0.4.27 in `FromStr<DateTime<Utc>>` ([#&#8203;1253](https://togithub.com/chronotope/chrono/issues/1253)).

Chrono now has a [Discord channel](https://discord.gg/sXpav4PS7M).

#### Fixes

-   Fix arbitrary string slicing in `parse_rfc3339_relaxed` ([#&#8203;1254](https://togithub.com/chronotope/chrono/issues/1254))

#### Deprecations

-   Deprecate `TimeZone::datetime_from_str` ([#&#8203;1251](https://togithub.com/chronotope/chrono/issues/1251))

#### Documentation

-   Correct documentation for `FromStr` for `Weekday` and `Month` ([#&#8203;1226](https://togithub.com/chronotope/chrono/issues/1226), thanks [@&#8203;wfraser](https://togithub.com/wfraser))

#### Internal improvements

-   Revert "add test_issue\_866" ([#&#8203;1238](https://togithub.com/chronotope/chrono/issues/1238))
-   CI: run tests on `i686` and `wasm32-wasi` ([#&#8203;1237](https://togithub.com/chronotope/chrono/issues/1237))
-   CI: Include doctests for code coverage ([#&#8203;1248](https://togithub.com/chronotope/chrono/issues/1248))
-   Move benchmarks to a separate crate ([#&#8203;1243](https://togithub.com/chronotope/chrono/issues/1243))
    This allows us to upgrade the criterion dependency to 5.1 without changing our MSRV.
-   Add Discord link to README ([#&#8203;1240](https://togithub.com/chronotope/chrono/issues/1240), backported in [#&#8203;1256](https://togithub.com/chronotope/chrono/issues/1256))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.28`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.28): 0.4.28

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.27...v0.4.28)

This release fixes a test failure on 32-bit targets introduced with 0.4.27, see [chronotope/chrono#1234.

### [`v0.4.27`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.27): 0.4.27

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.26...v0.4.27)

This release bumps the MSRV from 1.56 to 1.57. This allows us to take advantage of the panicking in const feature. In this release most methods on `NaiveDate` and `NaiveTime` are made const, `NaiveDateTime` and others will follow in a later release.

The parser for the `%+` formatting specifier and the `RFC3339` formatting item is switched from a strict to a relaxed parser (see [chronotope/chrono#1145). This matches the existing documentation, and the parser used by `DateTime::from_str`. If you need to validate the input, consider using `DateTime::from_rfc3339`.

#### Deprecations

-   Deprecate `DateTime::{from_local, from_utc}` ([chronotope/chrono#1175)

#### Additions

-   Let `DateTime::signed_duration_since` take argument with `Borrow` ([chronotope/chrono#1119)
-   Implement `PartialOrd` for `Month` ([chronotope/chrono#999, thanks [@&#8203;Munksgaard](https://togithub.com/Munksgaard))
-   Add `Ord` and `Eq` for types which already derive `PartialOrd` and `PartialEq` ([chronotope/chrono#1128, thanks [@&#8203;totikom](https://togithub.com/totikom))
-   implement `FusedIterator` for `NaiveDateDaysIterator` and `NaiveDateWeeksIterator` ([chronotope/chrono#1134)
-   Make `NaiveDateDaysIterator` and `NaiveDateWeeksIterator` public ([chronotope/chrono#1134)
-   Add `FromStr` for `FixedOffset` ([chronotope/chrono#1157, thanks [@&#8203;mcronce](https://togithub.com/mcronce))
-   Remove `Tz::Offset: Display` requirement from `DateTime::to_rfc*` ([chronotope/chrono#1160)
-   More flexible offset formatting (not exposed yet) ([chronotope/chrono#1160)
-   Make `StrftimeItems` with `unstable-locales` work without allocating ([chronotope/chrono#1152)
-   Make `NaiveDate::from_ymd_opt` const ([chronotope/chrono#1172, thanks [@&#8203;kamadorueda](https://togithub.com/kamadorueda))
-   Implement `Error` trait for `ParseWeekdayError` and `ParseMonthError` ([chronotope/chrono#539, thanks [@&#8203;mike-kfed](https://togithub.com/mike-kfed))
-   Make methods on `NaiveTime` const, update MSRV to 1.57 ([chronotope/chrono#1080)
-   Make methods on `NaiveDate` const ([chronotope/chrono#1205)
-   Implement operations for `core::time::Duration` on `DateTime` types ([chronotope/chrono#1229)

#### Fixes

-   Ensure `timestamp_nanos` panics on overflow in release builds ([chronotope/chrono#1123)
-   Fix `offset_from_local_datetime` for `wasm_bindgen` ([chronotope/chrono#1131)
-   Parsing: Consider `%s` to be a timestamp in UTC ([chronotope/chrono#1136)
-   Don't panic when formatting with `%#z` ([chronotope/chrono#1140, thanks [@&#8203;domodwyer](https://togithub.com/domodwyer))
-   Parsing: allow MINUS SIGN (U+2212) in offset ([chronotope/chrono#1087, thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Fix locale formatting for `%c` and `%r` ([chronotope/chrono#1165)
-   Localize decimal point with `unstable-locales` feature ([chronotope/chrono#1168)
-   Fix panic on macOS 10.12 caused by using version 1 of the TZif file format ([chronotope/chrono#1201, thanks to help from [@&#8203;jfro](https://togithub.com/jfro))
-   Fix deserialization of negative timestamps ([chronotope/chrono#1194)
-   Do not use `Offset`'s `Debug` impl when serializing `DateTime` ([chronotope/chrono#1035)
-   Allow missing seconds in `NaiveTime::from_str` ([chronotope/chrono#1181)
-   Do not depend on `android-tzdata` if the `clock` feature is not enabled ([chronotope/chrono#1220, thanks [@&#8203;AlexTMjugador](https://togithub.com/AlexTMjugador))
-   Small fixes to the RFC 3339 parsers ([chronotope/chrono#1145)

#### Documentation

-   Add "Errors" and "Panics" sections to API docs ([chronotope/chrono#1120)
-   Specify licenses in SPDX format ([chronotope/chrono#1132, backport of [chronotope/chrono#910, thanks [@&#8203;LingMan](https://togithub.com/LingMan))
-   Fix `NaiveTime` doc typo ([chronotope/chrono#1146, thanks [@&#8203;zachs18](https://togithub.com/zachs18))
-   Clarify nanosecond formatting specifier doc ([chronotope/chrono#1173)
-   Add warning against combining multiple `Datelike::with_*` ([chronotope/chrono#1199)
-   Fix typo "accepted" ([chronotope/chrono#1209, thanks [@&#8203;simon04](https://togithub.com/simon04))
-   Add some examples to `Utc::now` and `Local::now` ([chronotope/chrono#1192)
-   Add example to `Weekday::num_days_from_monday` ([chronotope/chrono#1193)
-   Fix some comments and panic messages ([chronotope/chrono#1221, thanks [@&#8203;umanwizard](https://togithub.com/umanwizard))

#### Internal improvements

-   `DateTime::to_rfc_*` optimizations ([chronotope/chrono#1200)
-   Move all tests into modules, fix clippy warnings ([chronotope/chrono#1138)
-   Offset parsing cleanup ([chronotope/chrono#1158)
-   Factor out formatting to `format/formatting.rs` ([chronotope/chrono#1156)
-   Format refactorings ([chronotope/chrono#1198)
-   Format toml files with taplo ([chronotope/chrono#1117, thanks [@&#8203;tottoto](https://togithub.com/tottoto))
-   Stop vendoring `saturating_abs` ([chronotope/chrono#1124)
-   CI: shell set -eux, use bash ([chronotope/chrono#1103, thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Fix dead code error when running dateutils test on Windows ([chronotope/chrono#1125)
-   Remove `Makefile` ([chronotope/chrono#1133)
-   CI: Test `wasm-bindgen` feature ([chronotope/chrono#1131)
-   Stop using deprecated methods in parse module ([chronotope/chrono#1142)
-   Add formatting benchmarks ([chronotope/chrono#1155)
-   Feature gate tests instead of methods ([chronotope/chrono#1159, [chronotope/chrono#1162)
-   Parallelize `try_verify_against_date_command` ([chronotope/chrono#1161)
-   CI: also run integration tests with `no_std` ([chronotope/chrono#1166)
-   Split ` test_parse  ` ([chronotope/chrono#1170)
-   Remove `#![deny(dead_code)]` ([chronotope/chrono#1187)
-   Clippy fixes for Rust 1.71 ([chronotope/chrono#1186)
-   Various small improvements ([chronotope/chrono#1191)
-   Add unit test for uncovered regions ([chronotope/chrono#1149, thanks [@&#8203;CXWorks](https://togithub.com/CXWorks))
-   Don't test the same thing twice in `test_date_extreme_offset` ([chronotope/chrono#1195)
-   CI: Add workflow code coverage report and upload ([chronotope/chrono#1178, [chronotope/chrono#1215, thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   CI: fail on warnings in `features-check` ([chronotope/chrono#1216)
-   Switch to windows-bindgen ([chronotope/chrono#1202, thanks to help from [@&#8203;MarijnS95](https://togithub.com/MarijnS95))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.26`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.26): 0.4.26

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.25...v0.4.26)

The changes from [#&#8203;807](https://togithub.com/chronotope/chrono/issues/807) we merged for 0.4.25 unfortunately restricted parsing in a way that was incompatible with earlier 0.4.x releases. We reverted this in [#&#8203;1113](https://togithub.com/chronotope/chrono/issues/1113). A small amount of other changes were merged since.

-   Update README ([#&#8203;1111](https://togithub.com/chronotope/chrono/issues/1111), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Revert backport of [#&#8203;807](https://togithub.com/chronotope/chrono/issues/807) ([#&#8203;1113](https://togithub.com/chronotope/chrono/issues/1113), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Update to 2021 edition ([#&#8203;1109](https://togithub.com/chronotope/chrono/issues/1109), thanks to [@&#8203;tottoto](https://togithub.com/tottoto))
-   Fix `DurationRound` panics from issue [#&#8203;1010](https://togithub.com/chronotope/chrono/issues/1010) ([#&#8203;1093](https://togithub.com/chronotope/chrono/issues/1093), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   tests: date path consolidate (branch 0.4.x) ([#&#8203;1090](https://togithub.com/chronotope/chrono/issues/1090), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Parse tests nanosecond bare dot (branch 0.4.x) ([#&#8203;1098](https://togithub.com/chronotope/chrono/issues/1098), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   yamllint cleanup lint.yml test.yml ([#&#8203;1102](https://togithub.com/chronotope/chrono/issues/1102), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Remove num-iter dependency ([#&#8203;1107](https://togithub.com/chronotope/chrono/issues/1107), thanks to [@&#8203;tottoto](https://togithub.com/tottoto))

Thanks on behalf of the chrono team ([@&#8203;djc](https://togithub.com/djc) and [@&#8203;esheppa](https://togithub.com/esheppa)) to all contributors!

### [`v0.4.25`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.25): 0.4.25

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.24...v0.4.25)

Time for another maintenance release. This release bumps the MSRV to 1.56; given MSRV bumps in chrono's dependencies (notably for syn 2), we felt that it no longer made sense to support any older versions. Feedback welcome in our issue tracker!

#### Additions

-   Bump the MSRV to 1.56 ([#&#8203;1053](https://togithub.com/chronotope/chrono/issues/1053))
-   Apply comments from MSRV bump ([#&#8203;1026](https://togithub.com/chronotope/chrono/issues/1026), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Remove num-integer dependency ([#&#8203;1037](https://togithub.com/chronotope/chrono/issues/1037), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add `NaiveDateTime::and_utc()` method ([#&#8203;952](https://togithub.com/chronotope/chrono/issues/952), thanks to [@&#8203;klnusbaum](https://togithub.com/klnusbaum))
-   derive `Hash` for most pub types that also derive `PartialEq` ([#&#8203;938](https://togithub.com/chronotope/chrono/issues/938), thanks to [@&#8203;bruceg](https://togithub.com/bruceg))
-   Add `parse_and_remainder()` methods ([#&#8203;1011](https://togithub.com/chronotope/chrono/issues/1011), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add `DateTime::fix_offset()` ([#&#8203;1030](https://togithub.com/chronotope/chrono/issues/1030), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add `#[track_caller]` to `LocalResult::unwrap` ([#&#8203;1046](https://togithub.com/chronotope/chrono/issues/1046), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add `#[must_use]` to some methods ([#&#8203;1007](https://togithub.com/chronotope/chrono/issues/1007), thanks to [@&#8203;aceArt-GmbH](https://togithub.com/aceArt-GmbH))
-   Implement `PartialOrd` for `Month` ([#&#8203;999](https://togithub.com/chronotope/chrono/issues/999), thanks to [@&#8203;Munksgaard](https://togithub.com/Munksgaard))
-   Add `impl From<NaiveDateTime> for NaiveDate` ([#&#8203;1012](https://togithub.com/chronotope/chrono/issues/1012), thanks to [@&#8203;pezcore](https://togithub.com/pezcore))
-   Extract timezone info from tzdata file on Android ([#&#8203;978](https://togithub.com/chronotope/chrono/issues/978), thanks to [@&#8203;RumovZ](https://togithub.com/RumovZ))

#### Fixes

-   Prevent string slicing inside char boundaries ([#&#8203;1024](https://togithub.com/chronotope/chrono/issues/1024), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   fix IsoWeek so that its flags are always correct ([#&#8203;991](https://togithub.com/chronotope/chrono/issues/991), thanks to [@&#8203;moshevds](https://togithub.com/moshevds))
-   Fix out-of-range panic in `NaiveWeek::last_day` ([#&#8203;1070](https://togithub.com/chronotope/chrono/issues/1070), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Use correct offset in conversion from `Local` to `FixedOffset` ([#&#8203;1041](https://togithub.com/chronotope/chrono/issues/1041), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix military timezones in RFC 2822 parsing ([#&#8203;1013](https://togithub.com/chronotope/chrono/issues/1013), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Guard against overflow in NaiveDate::with_\*0 methods ([#&#8203;1023](https://togithub.com/chronotope/chrono/issues/1023), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix panic in from_num_days_from_ce_opt ([#&#8203;1052](https://togithub.com/chronotope/chrono/issues/1052), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))

#### Refactoring

-   Rely on std for getting local time offset ([#&#8203;1072](https://togithub.com/chronotope/chrono/issues/1072), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Make functions in internals const ([#&#8203;1043](https://togithub.com/chronotope/chrono/issues/1043), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Refactor windows module in `Local` ([#&#8203;992](https://togithub.com/chronotope/chrono/issues/992), thanks to [@&#8203;nekevss](https://togithub.com/nekevss))
-   Simplify from_timestamp_millis, from_timestamp_micros ([#&#8203;1032](https://togithub.com/chronotope/chrono/issues/1032), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Backport [#&#8203;983](https://togithub.com/chronotope/chrono/issues/983) and [#&#8203;1000](https://togithub.com/chronotope/chrono/issues/1000) ([#&#8203;1063](https://togithub.com/chronotope/chrono/issues/1063), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))

#### Documentation

-   Backport documentation improvements ([#&#8203;1066](https://togithub.com/chronotope/chrono/issues/1066), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add documentation for %Z quirk ([#&#8203;1051](https://togithub.com/chronotope/chrono/issues/1051), thanks to [@&#8203;campbellcole](https://togithub.com/campbellcole))
-   Add an example to Weekday ([#&#8203;1019](https://togithub.com/chronotope/chrono/issues/1019), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))

#### Internal improvements

-   Gate test on `clock` feature ([#&#8203;1061](https://togithub.com/chronotope/chrono/issues/1061), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   CI: Also run tests with `--no-default-features` ([#&#8203;1059](https://togithub.com/chronotope/chrono/issues/1059), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Prevent `bench_year_flags_from_year` from being optimized out ([#&#8203;1034](https://togithub.com/chronotope/chrono/issues/1034), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix test_leap_second during DST transition ([#&#8203;1064](https://togithub.com/chronotope/chrono/issues/1064), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix warnings when running tests on Windows ([#&#8203;1038](https://togithub.com/chronotope/chrono/issues/1038), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix tests on AIX ([#&#8203;1028](https://togithub.com/chronotope/chrono/issues/1028), thanks to [@&#8203;ecnelises](https://togithub.com/ecnelises))
-   Fix doctest warnings, remove mention of deprecated methods from main doc ([#&#8203;1081](https://togithub.com/chronotope/chrono/issues/1081), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Reformat `test_datetime_parse_from_str` ([#&#8203;1078](https://togithub.com/chronotope/chrono/issues/1078), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   GitHub yml shell `set -eux`, use bash ([#&#8203;1103](https://togithub.com/chronotope/chrono/issues/1103), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   test: explicitly set `LANG` to `c` in gnu `date` ([#&#8203;1089](https://togithub.com/chronotope/chrono/issues/1089), thanks to [@&#8203;scarf005](https://togithub.com/scarf005))
-   Switch test to `TryFrom` ([#&#8203;1086](https://togithub.com/chronotope/chrono/issues/1086), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add test for issue 551 ([#&#8203;1020](https://togithub.com/chronotope/chrono/issues/1020), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   RFC 2822 single-letter obsolete tests ([#&#8203;1014](https://togithub.com/chronotope/chrono/issues/1014), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   \[CI] Lint Windows target and documentation links ([#&#8203;1062](https://togithub.com/chronotope/chrono/issues/1062), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   add test_issue\_866 ([#&#8203;1077](https://togithub.com/chronotope/chrono/issues/1077), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Remove AUTHORS metadata ([#&#8203;1074](https://togithub.com/chronotope/chrono/issues/1074))

On behalf of [@&#8203;djc](https://togithub.com/djc) and [@&#8203;esheppa](https://togithub.com/esheppa), thanks to all contributors!

### [`v0.4.24`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.24): 0.4.24

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.23...v0.4.24)

This is a small maintenance release with accumulated fixes and improvements.

-   Fix doc on `Days::new()` to refer to days, not months ([#&#8203;874](https://togithub.com/chronotope/chrono/issues/874), thanks to [@&#8203;brotskydotcom](https://togithub.com/brotskydotcom))
-   Clarify out of range value for `from_timestamp_opt()` ([#&#8203;879](https://togithub.com/chronotope/chrono/issues/879), thanks to [@&#8203;xmo-odoo](https://togithub.com/xmo-odoo))
-   Add `format_localized()` for `NaiveDate` ([#&#8203;881](https://togithub.com/chronotope/chrono/issues/881), thanks to [@&#8203;mseele](https://togithub.com/mseele))
-   Fix bug in `Add`/`Sub` `Days`, add tests with DST timezone ([#&#8203;878](https://togithub.com/chronotope/chrono/issues/878))
-   Make `NaiveTime::MIN` public ([#&#8203;890](https://togithub.com/chronotope/chrono/issues/890))
-   Fix `from_timestamp_millis()` implementation and add more tests ([#&#8203;885](https://togithub.com/chronotope/chrono/issues/885))
-   Fix typo in docstrings ([#&#8203;897](https://togithub.com/chronotope/chrono/issues/897), thanks to [@&#8203;dandxy89](https://togithub.com/dandxy89))
-   Add test proving that [#&#8203;903](https://togithub.com/chronotope/chrono/issues/903) is fixed in 0.4.x head ([#&#8203;905](https://togithub.com/chronotope/chrono/issues/905), thanks to [@&#8203;umanwizard](https://togithub.com/umanwizard))
-   Add `from_timestamp_micros()` function ([#&#8203;906](https://togithub.com/chronotope/chrono/issues/906), thanks to [@&#8203;umanwizard](https://togithub.com/umanwizard))
-   Check cargo-deny in CI ([#&#8203;909](https://togithub.com/chronotope/chrono/issues/909))
-   Derive `Hash` for most pub types that also derive `PartialEq` ([#&#8203;938](https://togithub.com/chronotope/chrono/issues/938), thanks to [@&#8203;bruceg](https://togithub.com/bruceg))
-   Update deprecated methods in `from_utc()` example ([#&#8203;939](https://togithub.com/chronotope/chrono/issues/939), thanks to [@&#8203;greg-el](https://togithub.com/greg-el))
-   Fix panic in `DateTime::checked_add_days()` ([#&#8203;942](https://togithub.com/chronotope/chrono/issues/942), thanks to [@&#8203;Ekleog](https://togithub.com/Ekleog))
-   More documentation for dates before 1 BCE or after 9999 CE ([#&#8203;950](https://togithub.com/chronotope/chrono/issues/950), thanks to [@&#8203;cgit](https://togithub.com/cgit))
-   Improve `FixedOffset` docs ([#&#8203;953](https://togithub.com/chronotope/chrono/issues/953), thanks to [@&#8203;klnusbaum](https://togithub.com/klnusbaum))
-   Add chrono-fuzz to CI and update its libfuzzer-sys dependency ([#&#8203;968](https://togithub.com/chronotope/chrono/issues/968), thanks to [@&#8203;LingMan](https://togithub.com/LingMan))
-   Fixes to parsing and calculation of week numbers ([#&#8203;966](https://togithub.com/chronotope/chrono/issues/966), thanks to [@&#8203;raphaelroosz](https://togithub.com/raphaelroosz))
-   Make iana-time-zone a target specific dependency ([#&#8203;980](https://togithub.com/chronotope/chrono/issues/980), thanks to [@&#8203;krtab](https://togithub.com/krtab))
-   Make eligible functions `const` ([#&#8203;984](https://togithub.com/chronotope/chrono/issues/984), thanks to [@&#8203;tormeh](https://togithub.com/tormeh))

Thanks to all contributors from the chrono team, [@&#8203;esheppa](https://togithub.com/esheppa) and [@&#8203;djc](https://togithub.com/djc).

</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 [Mend Renovate](https://www.mend.io/free-developer-tools/renovate/). View repository job log [here](https://developer.mend.io/github/sammyfilly/Nextjs).
kodiakhq bot pushed a commit to X-oss-byte/Canary-nextjs that referenced this pull request May 1, 2024
[![Mend Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [chrono](https://togithub.com/chronotope/chrono) | dependencies | patch | `0.4` -> `0.4.38` |

---

> [!WARNING]
> Some dependencies could not be looked up. Check the Dependency Dashboard for more information.

---

### Release Notes

<details>
<summary>chronotope/chrono (chrono)</summary>

### [`v0.4.38`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.38)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.37...v0.4.38)

This release bring a ca. 20% improvement to the performance of the formatting code, and a convenient `days_since` method for the `Weekday` type.

Chrono 0.4.38 also removes the long deprecated `rustc-serialize` feature. Support for `rustc-serialize` will be [soft-destabilized in the next Rust edition](https://togithub.com/rust-lang/rust/pull/116016). Removing the feature will not break existing users of the feature; Cargo will just not update dependents that rely on it to newer versions of chrono.

In chrono 0.4.36 we made an accidental breaking change by switching to `derive(Copy)` for `DateTime` instead of a manual implementation. It is reverted in this release.

### Removals

-   Remove `rustc-serialize` feature ([#&#8203;1548](https://togithub.com/chronotope/chrono/issues/1548), thanks [@&#8203;workingjubilee](https://togithub.com/workingjubilee))

### Additions

-   Add `Weekday::days_since` ([#&#8203;1249](https://togithub.com/chronotope/chrono/issues/1249), based on [#&#8203;216](https://togithub.com/chronotope/chrono/issues/216) by [@&#8203;clarfonthey](https://togithub.com/clarfonthey))
-   Add `TimeDelta::checked_mul` and `TimeDelta::checked_div` ([#&#8203;1565](https://togithub.com/chronotope/chrono/issues/1565), thanks [@&#8203;Zomtir](https://togithub.com/Zomtir))

### Fixes

-   Return error when rounding with a zero duration ([#&#8203;1474](https://togithub.com/chronotope/chrono/issues/1474), thanks [@&#8203;Dav1dde](https://togithub.com/Dav1dde))
-   Manually implement `Copy` for `DateTime` if offset is `Copy` ([#&#8203;1573](https://togithub.com/chronotope/chrono/issues/1573))

### Internal

-   Inline `test_encodable_json` and `test_decodable_json` functions ([#&#8203;1550](https://togithub.com/chronotope/chrono/issues/1550))
-   CI: Reduce combinations in `cargo hack check` ([#&#8203;1553](https://togithub.com/chronotope/chrono/issues/1553))
-   Refactor formatting code ([#&#8203;1335](https://togithub.com/chronotope/chrono/issues/1335))
-   Optimize number formatting ([#&#8203;1558](https://togithub.com/chronotope/chrono/issues/1558))
-   Only package files needed for building and testing ([#&#8203;1554](https://togithub.com/chronotope/chrono/issues/1554))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.37`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.37)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.36...v0.4.37)

Version 0.4.36 introduced an unexpected breaking change and was yanked. In it `LocalResult` was renamed to `MappedLocalTime` to avoid the impression that it is a `Result` type were some of the results are errors. For backwards compatibility a type alias with the old name was added.

As it turns out there is one case where a type alias behaves differently from the regular enum: you can't import enum variants from a type alias with `use chrono::LocalResult::*`. With 0.4.37 we make the new name `MappedLocalTime` the alias, but keep using it in function signatures and the documentation as much as possible.

See also the release notes of [chrono 0.4.36](https://togithub.com/chronotope/chrono/releases/tag/v0.4.36) from yesterday for the yanked release.

### [`v0.4.36`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.36)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.35...v0.4.36)

This release un-deprecates the methods on `TimeDelta` that were deprecated with the 0.4.35 release because of the churn they are causing for the ecosystem.

New is the `DateTime::with_time()` method. As an example of when it is useful:

```rust
use chrono::{Local, NaiveTime};
// Today at 12:00:00
let today_noon = Local::now().with_time(NaiveTime::from_hms_opt(12, 0, 0).unwrap());
```

### Additions

-   Add `DateTime::with_time()` ([#&#8203;1510](https://togithub.com/chronotope/chrono/issues/1510))

### Deprecations

-   Revert `TimeDelta` deprecations ([#&#8203;1543](https://togithub.com/chronotope/chrono/issues/1543))
-   Deprecate `TimeStamp::timestamp_subsec_nanos`, which was missed in the 0.4.35 release ([#&#8203;1486](https://togithub.com/chronotope/chrono/issues/1486))

### Documentation

-   Correct version number of deprecation notices ([#&#8203;1486](https://togithub.com/chronotope/chrono/issues/1486))
-   Fix some typos ([#&#8203;1505](https://togithub.com/chronotope/chrono/issues/1505))
-   Slightly improve serde documentation ([#&#8203;1519](https://togithub.com/chronotope/chrono/issues/1519))
-   Main documentation: simplify links and reflow text ([#&#8203;1535](https://togithub.com/chronotope/chrono/issues/1535))

### Internal

-   CI: Lint benchmarks ([#&#8203;1489](https://togithub.com/chronotope/chrono/issues/1489))
-   Remove unnessary `Copy` and `Send` impls ([#&#8203;1492](https://togithub.com/chronotope/chrono/issues/1492), thanks [@&#8203;erickt](https://togithub.com/erickt))
-   Backport streamlined `NaiveDate` unit tests ([#&#8203;1500](https://togithub.com/chronotope/chrono/issues/1500), thanks [@&#8203;Zomtir](https://togithub.com/Zomtir))
-   Rename `LocalResult` to `TzResolution`, add alias ([#&#8203;1501](https://togithub.com/chronotope/chrono/issues/1501))
-   Update windows-bindgen to 0.55 ([#&#8203;1504](https://togithub.com/chronotope/chrono/issues/1504))
-   Avoid duplicate imports, which generate warnings on nightly ([#&#8203;1507](https://togithub.com/chronotope/chrono/issues/1507))
-   Add extra debug assertions to `NaiveDate::from_yof` ([#&#8203;1518](https://togithub.com/chronotope/chrono/issues/1518))
-   Some small simplifications to `DateTime::date_naive` and `NaiveDate::diff_months` ([#&#8203;1530](https://togithub.com/chronotope/chrono/issues/1530))
-   Remove `unwrap` in Unix `Local` type ([#&#8203;1533](https://togithub.com/chronotope/chrono/issues/1533))
-   Use different method to ignore feature-dependent doctests ([#&#8203;1534](https://togithub.com/chronotope/chrono/issues/1534))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`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<Utc>` type, or from the `TimeZone` trait.

    Converting from `NaiveDateTime` to `DateTime<Utc>` 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<NaiveDate>`, `Option<NaiveDateTime>` and `Option<DateTime<Tz>>` 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}` ([#&#8203;1234](https://togithub.com/chronotope/chrono/issues/1234))
-   Add getters to `Parsed` ([#&#8203;1465](https://togithub.com/chronotope/chrono/issues/1465))

### Deprecations

-   Deprecate timestamp methods on `NaiveDateTime` ([#&#8203;1473](https://togithub.com/chronotope/chrono/issues/1473))
-   Deprecate panicking constructors of `TimeDelta` ([#&#8203;1450](https://togithub.com/chronotope/chrono/issues/1450))

### Changes/fixes

-   Use `NonZeroI32` inside `NaiveDate` ([#&#8203;1207](https://togithub.com/chronotope/chrono/issues/1207))
-   Mark `format::Numeric` and `format::Fixed` as `non_exhaustive` ([#&#8203;1430](https://togithub.com/chronotope/chrono/issues/1430))
-   `Parsed` fixes to error values ([#&#8203;1439](https://togithub.com/chronotope/chrono/issues/1439))
-   Use `overflowing_naive_local` in `DateTime::checked_add*` ([#&#8203;1333](https://togithub.com/chronotope/chrono/issues/1333))
-   Do complete range checks in `Parsed::set_*` ([#&#8203;1465](https://togithub.com/chronotope/chrono/issues/1465))

### Documentation

-   Rustfmt doctests ([#&#8203;1452](https://togithub.com/chronotope/chrono/issues/1452))
-   Improve docs for crate features ([#&#8203;1455](https://togithub.com/chronotope/chrono/issues/1455), thanks [@&#8203;edmorley](https://togithub.com/edmorley))
-   Add more documentation and examples to `Parsed` ([#&#8203;1439](https://togithub.com/chronotope/chrono/issues/1439))

### Internal

-   Refactor `internals` module ([#&#8203;1428](https://togithub.com/chronotope/chrono/issues/1428), [#&#8203;1429](https://togithub.com/chronotope/chrono/issues/1429), [#&#8203;1431](https://togithub.com/chronotope/chrono/issues/1431), [#&#8203;1432](https://togithub.com/chronotope/chrono/issues/1432), [#&#8203;1433](https://togithub.com/chronotope/chrono/issues/1433), [#&#8203;1438](https://togithub.com/chronotope/chrono/issues/1438))
-   CI: test cross-compiling to `x86_64-unknown-illumos` instead of Solaris ([#&#8203;1437](https://togithub.com/chronotope/chrono/issues/1437))
-   CI: lint Windows target, fix clippy warning ([#&#8203;1441](https://togithub.com/chronotope/chrono/issues/1441))
-   CI: only run `cargo hack check` on Linux ([#&#8203;1442](https://togithub.com/chronotope/chrono/issues/1442))
-   Update windows-bindgen to 0.54 ([#&#8203;1462](https://togithub.com/chronotope/chrono/issues/1462), [#&#8203;1483](https://togithub.com/chronotope/chrono/issues/1483))
-   Simplify error value of `parse_internal` ([#&#8203;1459](https://togithub.com/chronotope/chrono/issues/1459))
-   Simplify `SerdeError` ([#&#8203;1458](https://togithub.com/chronotope/chrono/issues/1458))
-   Simplify `NaiveDate::from_isoywd` a bit ([#&#8203;1464](https://togithub.com/chronotope/chrono/issues/1464))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.34`](https://togithub.com/chronotope/chrono/releases/tag/v0.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` ([#&#8203;1385](https://togithub.com/chronotope/chrono/issues/1385), thanks [@&#8203;danwilliams](https://togithub.com/danwilliams))
-   Remove check for `DurationExceedsTimestamp` in `DurationRound` ([#&#8203;1403](https://togithub.com/chronotope/chrono/issues/1403), thanks [@&#8203;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), [#&#8203;1420](https://togithub.com/chronotope/chrono/issues/1420))
-   Windows: base implementation on `GetTimeZoneInformationForYear` ([#&#8203;1017](https://togithub.com/chronotope/chrono/issues/1017))

### Additions

-   Add `TimeDelta::try_milliseconds` ([#&#8203;1385](https://togithub.com/chronotope/chrono/issues/1385), thanks [@&#8203;danwilliams](https://togithub.com/danwilliams))
-   Add `TimeDelta::new` ([#&#8203;1337](https://togithub.com/chronotope/chrono/issues/1337))
-   Add `StrftimeItems::{parse, parse_to_owned}` and more documentation ([#&#8203;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 ([#&#8203;1406](https://togithub.com/chronotope/chrono/issues/1406))
-   Make `TimeDelta` methods const ([#&#8203;1337](https://togithub.com/chronotope/chrono/issues/1337))
-   Make remaining methods of `NaiveDate`, `NaiveWeek`, `NaiveTime` and `NaiveDateTime` const where possible ([#&#8203;1337](https://togithub.com/chronotope/chrono/issues/1337))
-   Make methods on `DateTime` const where possible ([#&#8203;1400](https://togithub.com/chronotope/chrono/issues/1400))
-   Make `Display` format of `TimeDelta` conform better to ISO 8601 ([#&#8203;1328](https://togithub.com/chronotope/chrono/issues/1328))

### Documentation

-   Fix the formatting of `timestamp_micros`'s Example doc ([#&#8203;1338](https://togithub.com/chronotope/chrono/issues/1338) via [#&#8203;1386](https://togithub.com/chronotope/chrono/issues/1386), thanks [@&#8203;emikitas](https://togithub.com/emikitas))
-   Specify branch for GitHub Actions badge and fix link ([#&#8203;1388](https://togithub.com/chronotope/chrono/issues/1388))
-   Don't mention some deprecated methods in docs ([#&#8203;1395](https://togithub.com/chronotope/chrono/issues/1395))
-   Remove stray documentation from main ([#&#8203;1397](https://togithub.com/chronotope/chrono/issues/1397))
-   Improved documentation of `TimeDelta` constructors ([#&#8203;1385](https://togithub.com/chronotope/chrono/issues/1385), thanks [@&#8203;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 ([#&#8203;1390](https://togithub.com/chronotope/chrono/issues/1390), [#&#8203;1402](https://togithub.com/chronotope/chrono/issues/1402)).
-   Don't use deprecated method in `impl Arbitrary for DateTime` and set up CI test ([#&#8203;1336](https://togithub.com/chronotope/chrono/issues/1336))
-   Remove workaround for Rust < 1.61 ([#&#8203;1393](https://togithub.com/chronotope/chrono/issues/1393))
-   Bump `codecov/codecov-action` from 3 to 4 ([#&#8203;1404](https://togithub.com/chronotope/chrono/issues/1404))
-   Remove partial support for handling `-0000` offset ([#&#8203;1411](https://togithub.com/chronotope/chrono/issues/1411))
-   Move `TOO_LONG` error out of `parse_internal` ([#&#8203;1419](https://togithub.com/chronotope/chrono/issues/1419))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.33`](https://togithub.com/chronotope/chrono/releases/tag/v0.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` ([#&#8203;1383](https://togithub.com/chronotope/chrono/issues/1383))
-   Fixed typo in `Duration::hours()` exception ([#&#8203;1384](https://togithub.com/chronotope/chrono/issues/1384), thanks [@&#8203;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` ([#&#8203;1071](https://togithub.com/chronotope/chrono/issues/1071))
-   Fix out of range panics in `DateTime` getters and setters ([#&#8203;1317](https://togithub.com/chronotope/chrono/issues/1317), [#&#8203;1329](https://togithub.com/chronotope/chrono/issues/1329))

#### Additions

-   Add `NaiveDateTime::checked_(add|sub)_offset` ([#&#8203;1313](https://togithub.com/chronotope/chrono/issues/1313))
-   Add `DateTime::to_utc` ([#&#8203;1325](https://togithub.com/chronotope/chrono/issues/1325))
-   Derive `Default` for `Duration` ([#&#8203;1327](https://togithub.com/chronotope/chrono/issues/1327))
-   Add `Duration::subsec_nanos` ([#&#8203;1327](https://togithub.com/chronotope/chrono/issues/1327))
-   Add `try_*` builders to `Duration` ([#&#8203;1327](https://togithub.com/chronotope/chrono/issues/1327))
-   Implement `AddAssign` and `SubAssign` for `Duration` ([#&#8203;1327](https://togithub.com/chronotope/chrono/issues/1327))
-   Make methods on `NaiveDateTime` const where possible ([#&#8203;1286](https://togithub.com/chronotope/chrono/issues/1286))
-   Split `clock` feature into `clock` and `now` ([#&#8203;1343](https://togithub.com/chronotope/chrono/issues/1343), thanks [@&#8203;mmastrac](https://togithub.com/mmastrac))
-   Add `From<NaiveDate>` for `NaiveDateTime` ([#&#8203;1355](https://togithub.com/chronotope/chrono/issues/1355), thanks [@&#8203;dcechano](https://togithub.com/dcechano))
-   Add `NaiveDateTime::from_timestamp_nanos` ([#&#8203;1357](https://togithub.com/chronotope/chrono/issues/1357), thanks [@&#8203;Ali-Mirghasemi](https://togithub.com/Ali-Mirghasemi))
-   Add `Months::num_months()` and `num_years()` ([#&#8203;1373](https://togithub.com/chronotope/chrono/issues/1373), thanks [@&#8203;danwilliams](https://togithub.com/danwilliams))
-   Add `DateTime<Utc>::from_timestamp_millis` ([#&#8203;1374](https://togithub.com/chronotope/chrono/issues/1374), thanks [@&#8203;xmakro](https://togithub.com/xmakro))

#### Changes

-   Fix panic in `Duration::MIN.abs()` (adjust `Duration::MIN` by 1 millisecond) ([#&#8203;1334](https://togithub.com/chronotope/chrono/issues/1334))
-   Bump MSRV to 1.61 ([#&#8203;1347](https://togithub.com/chronotope/chrono/issues/1347))
-   Update windows-targets requirement from 0.48 to 0.52 ([#&#8203;1360](https://togithub.com/chronotope/chrono/issues/1360))
-   Update windows-bindgen to 0.52 ([#&#8203;1379](https://togithub.com/chronotope/chrono/issues/1379))

#### Deprecations

-   Deprecate standalone `format` functions ([#&#8203;1306](https://togithub.com/chronotope/chrono/issues/1306))

#### Documentation

-   Improve doc comment and tests for timestamp_nanos_opt ([#&#8203;1299](https://togithub.com/chronotope/chrono/issues/1299), thanks [@&#8203;mlegner](https://togithub.com/mlegner))
-   Switch to `doc_auto_cfg` ([#&#8203;1305](https://togithub.com/chronotope/chrono/issues/1305), [#&#8203;1326](https://togithub.com/chronotope/chrono/issues/1326))
-   Document panics in `Add`/`Sub` impls and use `expect` ([#&#8203;1316](https://togithub.com/chronotope/chrono/issues/1316))
-   Improve types listed in top-level documentation ([#&#8203;1274](https://togithub.com/chronotope/chrono/issues/1274))
-   Improve deprecation note of `TimeZone::datetime_from_str` ([#&#8203;1342](https://togithub.com/chronotope/chrono/issues/1342), thanks [@&#8203;tmccombs](https://togithub.com/tmccombs))
-   Fix typos in `Datelike` impl for `DateTime` ([#&#8203;1376](https://togithub.com/chronotope/chrono/issues/1376), thanks [@&#8203;ElectrifyPro](https://togithub.com/ElectrifyPro))

#### Rkyv support

-   Export `Archived*` types in `rkyv` module ([#&#8203;1304](https://togithub.com/chronotope/chrono/issues/1304))
-   Duplicate derives on `Archived*` types ([#&#8203;1271](https://togithub.com/chronotope/chrono/issues/1271), thanks [@&#8203;Awpteamoose](https://togithub.com/Awpteamoose))
-   Archive derive of PartialEq for rkyv ([#&#8203;959](https://togithub.com/chronotope/chrono/issues/959), thanks [@&#8203;mkatychev](https://togithub.com/mkatychev))
-   Expose rkyv features as features for chrono users ([#&#8203;1368](https://togithub.com/chronotope/chrono/issues/1368), thanks [@&#8203;gz](https://togithub.com/gz))

#### Changes to unstable features

-   Don't let `unstable-locales` imply the `alloc` feature ([#&#8203;1307](https://togithub.com/chronotope/chrono/issues/1307))
-   Remove `format::{format_localized, format_item_localized}` ([#&#8203;1311](https://togithub.com/chronotope/chrono/issues/1311))
-   Inline `write_rfc2822_inner`, don't localize ([#&#8203;1322](https://togithub.com/chronotope/chrono/issues/1322))

#### Internal

-   Add benchmark for `DateTime::with_*` ([#&#8203;1309](https://togithub.com/chronotope/chrono/issues/1309))
-   Fix `*_DAYS_FROM_YEAR_0` calculation ([#&#8203;1312](https://togithub.com/chronotope/chrono/issues/1312))
-   Add `NaiveTime::overflowing_(add|sub)_offset` ([#&#8203;1310](https://togithub.com/chronotope/chrono/issues/1310))
-   Rewrite `DateTime::overflowing_(add|sub)_offset` ([#&#8203;1069](https://togithub.com/chronotope/chrono/issues/1069))
-   Tests calling date command `set env LC_ALL` ([#&#8203;1315](https://togithub.com/chronotope/chrono/issues/1315), thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Update `deny.toml` ([#&#8203;1320](https://togithub.com/chronotope/chrono/issues/1320))
-   Bump actions/setup-node from 3 to 4 ([#&#8203;1346](https://togithub.com/chronotope/chrono/issues/1346))
-   test.yml remove errant `with: node-version` ([#&#8203;1352](https://togithub.com/chronotope/chrono/issues/1352), thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   CI Linting: Fix missing sources checkout in `toml` job ([#&#8203;1371](https://togithub.com/chronotope/chrono/issues/1371), thanks [@&#8203;gibbz00](https://togithub.com/gibbz00))
-   Silence clippy lint for test code with Rust 1.74.0 ([#&#8203;1362](https://togithub.com/chronotope/chrono/issues/1362))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.31`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.31)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.30...v0.4.31)

Another maintenance release.
It was not a planned effort to improve our support for UNIX timestamps, yet most PRs seem related to this.

##### Deprecations

-   Deprecate `timestamp_nanos` in favor of the non-panicking `timestamp_nanos_opt` ([#&#8203;1275](https://togithub.com/chronotope/chrono/issues/1275))

##### Additions

-   Add `DateTime::<Utc>::from_timestamp` ([#&#8203;1279](https://togithub.com/chronotope/chrono/issues/1279), thanks [@&#8203;demurgos](https://togithub.com/demurgos))
-   Add `TimeZone::timestamp_micros` ([#&#8203;1285](https://togithub.com/chronotope/chrono/issues/1285), thanks [@&#8203;emikitas](https://togithub.com/emikitas))
-   Add `DateTime<Tz>::timestamp_nanos_opt` and `NaiveDateTime::timestamp_nanos_opt` ([#&#8203;1275](https://togithub.com/chronotope/chrono/issues/1275))
-   Add `UNIX_EPOCH` constants ([#&#8203;1291](https://togithub.com/chronotope/chrono/issues/1291))

##### Fixes

-   Format day of month in RFC 2822 without padding ([#&#8203;1272](https://togithub.com/chronotope/chrono/issues/1272))
-   Don't allow strange leap seconds which are not on a minute boundary initialization methods ([#&#8203;1283](https://togithub.com/chronotope/chrono/issues/1283))
    This makes many methods a little more strict:
    -   `NaiveTime::from_hms_milli`
    -   `NaiveTime::from_hms_milli_opt`
    -   `NaiveTime::from_hms_micro`
    -   `NaiveTime::from_hms_micro_opt`
    -   `NaiveTime::from_hms_nano`
    -   `NaiveTime::from_hms_nano_opt`
    -   `NaiveTime::from_num_seconds_from_midnight`
    -   `NaiveTime::from_num_seconds_from_midnight_opt`
    -   `NaiveDate::and_hms_milli`
    -   `NaiveDate::and_hms_milli_opt`
    -   `NaiveDate::and_hms_micro`
    -   `NaiveDate::and_hms_micro_opt`
    -   `NaiveDate::and_hms_nano`
    -   `NaiveDate::and_hms_nano_opt`
    -   `NaiveDateTime::from_timestamp`
    -   `NaiveDateTime::from_timestamp_opt`
    -   `TimeZone::timestamp`
    -   `TimeZone::timestamp_opt`
-   Fix underflow in `NaiveDateTime::timestamp_nanos_opt` ([#&#8203;1294](https://togithub.com/chronotope/chrono/issues/1294), thanks [@&#8203;crepererum](https://togithub.com/crepererum))

##### Documentation

-   Add more documentation about the RFC 2822 obsolete date format ([#&#8203;1267](https://togithub.com/chronotope/chrono/issues/1267))

##### Internal

-   Remove internal `__doctest` feature and `doc_comment` dependency ([#&#8203;1276](https://togithub.com/chronotope/chrono/issues/1276))
-   CI: Bump `actions/checkout` from 3 to 4 ([#&#8203;1280](https://togithub.com/chronotope/chrono/issues/1280))
-   Optimize `NaiveDate::add_days` for small values ([#&#8203;1214](https://togithub.com/chronotope/chrono/issues/1214))
-   Upgrade `pure-rust-locales` to 0.7.0 ([#&#8203;1288](https://togithub.com/chronotope/chrono/issues/1288), thanks [@&#8203;jeremija](https://togithub.com/jeremija) wo did good improvements on `pure-rust-locales`)

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.30`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.30)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.29...v0.4.30)

In this release, we have decided to swap out the `chrono::Duration` type (which has been a re-export of time 0.1 `Duration` type) with our own definition, which exposes a strict superset of the `time::Duration` API. This helps avoid warnings about the [CVE-2020-26235] and [RUSTSEC-2020-0071] advisories for downstream users and allows us to improve the `Duration` API going forward.

While this is technically a SemVer-breaking change, we expect the risk of downstream users experiencing actual incompatibility to be exceedingly limited (see [our analysis](https://togithub.com/chronotope/chrono/pull/1095#issuecomment-1571716955) of public code using a crater-like experiment), and not enough justification for the large ecosystem churn of a 0.5 release. If you have any feedback on these changes, please let us know in [#&#8203;1268](https://togithub.com/chronotope/chrono/issues/1268).

##### Additions

-   Add `NaiveDate::leap_year` ([#&#8203;1261](https://togithub.com/chronotope/chrono/issues/1261))

##### Documentation

-   Update main documentation from README ([#&#8203;1260](https://togithub.com/chronotope/chrono/issues/1260), thanks [@&#8203;Stygmates](https://togithub.com/Stygmates))
-   Add history of relation between chrono and time 0.1 to documentation ([https://github.com/chronotope/chrono/pull/1264](https://togithub.com/chronotope/chrono/pull/1264), [https://github.com/chronotope/chrono/pull/1266](https://togithub.com/chronotope/chrono/pull/1266))
-   Clarify `Timelike::num_seconds_from_midnight` is a simple mapping ([#&#8203;1255](https://togithub.com/chronotope/chrono/issues/1255))

#### Relation between chrono and time 0.1

Rust first had a `time` module added to `std` in its 0.7 release. It later moved to `libextra`, and then to a `libtime` library shipped alongside the standard library. In 2014 work on chrono started in order to provide a full-featured date and time library in Rust. Some improvements from chrono made it into the standard library; notably, `chrono::Duration` was included as `std::time::Duration` ([rust#15934]) in 2014.

In preparation of Rust 1.0 at the end of 2014 `libtime` was moved out of the Rust distro and into the `time` crate to eventually be redesigned ([rust#18832], [rust#18858]), like the `num` and `rand` crates. Of course chrono kept its dependency on this `time` crate. `time` started re-exporting `std::time::Duration` during this period. Later, the standard library was changed to have a more limited unsigned `Duration` type ([rust#24920], [RFC 1040]), while the `time` crate kept the full functionality with `time::Duration`. `time::Duration` had been a part of chrono's public API.

By 2016 `time` 0.1 lived under the `rust-lang-deprecated` organisation and was not actively maintained ([time#136]). chrono absorbed the platform functionality and `Duration` type of the `time` crate in [chrono#478] (the work started in [chrono#286]). In order to preserve compatibility with downstream crates depending on `time` and `chrono` sharing a `Duration` type, chrono kept depending on time 0.1. chrono offered the option to opt out of the `time` dependency by disabling the `oldtime` feature (swapping it out for an effectively similar chrono type). In 2019, [@&#8203;jhpratt](https://togithub.com/jhpratt) took over maintenance on the `time` crate and released what amounts to a new crate as `time` 0.2.

[rust#15934]: https://togithub.com/rust-lang/rust/pull/15934

[rust#18832]: https://togithub.com/rust-lang/rust/pull/18832#issuecomment-62448221

[rust#18858]: https://togithub.com/rust-lang/rust/pull/18858

[rust#24920]: https://togithub.com/rust-lang/rust/pull/24920

[RFC 1040]: https://rust-lang.github.io/rfcs/1040-duration-reform.html

[time#136]: https://togithub.com/time-rs/time/issues/136

[chrono#286]: https://togithub.com/chronotope/chrono/pull/286

[chrono#478]: https://togithub.com/chronotope/chrono/pull/478

##### Security advisories

In November of 2020 [CVE-2020-26235] and [RUSTSEC-2020-0071] were opened against the `time` crate. [@&#8203;quininer](https://togithub.com/quininer) had found that calls to `localtime_r` may be unsound ([chrono#499]). Eventually, almost a year later, this was also made into a security advisory against chrono as [RUSTSEC-2020-0159], which had platform code similar to `time`.

On Unix-like systems a process is given a timezone id or description via the `TZ` environment variable. We need this timezone data to calculate the current local time from a value that is in UTC, such as the time from the system clock. `time` 0.1 and chrono used the POSIX function `localtime_r` to do the conversion to local time, which reads the `TZ` variable.

Rust assumes the environment to be writable and uses locks to access it from multiple threads. Some other programming languages and libraries use similar locking strategies, but these are typically not shared across languages. More importantly, POSIX declares modifying the environment in a multi-threaded process as unsafe, and `getenv` in libc can't be changed to take a lock because it returns a pointer to the data (see [rust#27970] for more discussion).

Since version 4.20 chrono no longer uses `localtime_r`, instead using Rust code to query the timezone (from the `TZ` variable or via `iana-time-zone` as a fallback) and work with data from the system timezone database directly. The code for this was forked from the [tz-rs crate] by [@&#8203;x-hgg-x](https://togithub.com/x-hgg-x). As such, chrono now respects the Rust lock when reading the `TZ` environment variable. In general, code should avoid modifying the environment.

[CVE-2020-26235]: https://nvd.nist.gov/vuln/detail/CVE-2020-26235

[RUSTSEC-2020-0071]: https://rustsec.org/advisories/RUSTSEC-2020-0071

[chrono#499]: https://togithub.com/chronotope/chrono/pull/499

[RUSTSEC-2020-0159]: https://rustsec.org/advisories/RUSTSEC-2020-0159.html

[rust#27970]: https://togithub.com/rust-lang/rust/issues/27970

[chrono#677]: https://togithub.com/chronotope/chrono/pull/677

[tz-rs crate]: https://crates.io/crates/tz-rs

##### Removing time 0.1

Because time 0.1 has been unmaintained for years, however, the security advisory mentioned above has not been addressed. While chrono maintainers were careful not to break backwards compatibility with the `time::Duration` type, there has been a long stream of issues from users inquiring about the time 0.1 dependency with the vulnerability. We investigated the potential breakage of removing the time 0.1 dependency in [chrono#1095] using a crater-like experiment and determined that the potential for breaking (public) dependencies is very low. We reached out to those few crates that did still depend on compatibility with time 0.1.

As such, for chrono 0.4.30 we have decided to swap out the time 0.1 `Duration` implementation for a local one that will offer a strict superset of the existing API going forward. This will prevent most downstream users from being affected by the security vulnerability in time 0.1 while minimizing the ecosystem impact of semver-incompatible version churn.

[chrono#1095]: https://togithub.com/chronotope/chrono/pull/1095

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.29`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.29)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.28...v0.4.29)

This release fixes a panic introduced in chrono 0.4.27 in `FromStr<DateTime<Utc>>` ([#&#8203;1253](https://togithub.com/chronotope/chrono/issues/1253)).

Chrono now has a [Discord channel](https://discord.gg/sXpav4PS7M).

#### Fixes

-   Fix arbitrary string slicing in `parse_rfc3339_relaxed` ([#&#8203;1254](https://togithub.com/chronotope/chrono/issues/1254))

#### Deprecations

-   Deprecate `TimeZone::datetime_from_str` ([#&#8203;1251](https://togithub.com/chronotope/chrono/issues/1251))

#### Documentation

-   Correct documentation for `FromStr` for `Weekday` and `Month` ([#&#8203;1226](https://togithub.com/chronotope/chrono/issues/1226), thanks [@&#8203;wfraser](https://togithub.com/wfraser))

#### Internal improvements

-   Revert "add test_issue\_866" ([#&#8203;1238](https://togithub.com/chronotope/chrono/issues/1238))
-   CI: run tests on `i686` and `wasm32-wasi` ([#&#8203;1237](https://togithub.com/chronotope/chrono/issues/1237))
-   CI: Include doctests for code coverage ([#&#8203;1248](https://togithub.com/chronotope/chrono/issues/1248))
-   Move benchmarks to a separate crate ([#&#8203;1243](https://togithub.com/chronotope/chrono/issues/1243))
    This allows us to upgrade the criterion dependency to 5.1 without changing our MSRV.
-   Add Discord link to README ([#&#8203;1240](https://togithub.com/chronotope/chrono/issues/1240), backported in [#&#8203;1256](https://togithub.com/chronotope/chrono/issues/1256))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.28`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.28)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.27...v0.4.28)

This release fixes a test failure on 32-bit targets introduced with 0.4.27, see [https://github.com/chronotope/chrono/issues/1234](https://togithub.com/chronotope/chrono/issues/1234).

### [`v0.4.27`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.27)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.26...v0.4.27)

This release bumps the MSRV from 1.56 to 1.57. This allows us to take advantage of the panicking in const feature. In this release most methods on `NaiveDate` and `NaiveTime` are made const, `NaiveDateTime` and others will follow in a later release.

The parser for the `%+` formatting specifier and the `RFC3339` formatting item is switched from a strict to a relaxed parser (see [https://github.com/chronotope/chrono/pull/1145](https://togithub.com/chronotope/chrono/pull/1145)). This matches the existing documentation, and the parser used by `DateTime::from_str`. If you need to validate the input, consider using `DateTime::from_rfc3339`.

#### Deprecations

-   Deprecate `DateTime::{from_local, from_utc}` ([https://github.com/chronotope/chrono/pull/1175](https://togithub.com/chronotope/chrono/pull/1175))

#### Additions

-   Let `DateTime::signed_duration_since` take argument with `Borrow` ([https://github.com/chronotope/chrono/pull/1119](https://togithub.com/chronotope/chrono/pull/1119))
-   Implement `PartialOrd` for `Month` ([https://github.com/chronotope/chrono/pull/999](https://togithub.com/chronotope/chrono/pull/999), thanks [@&#8203;Munksgaard](https://togithub.com/Munksgaard))
-   Add `Ord` and `Eq` for types which already derive `PartialOrd` and `PartialEq` ([https://github.com/chronotope/chrono/pull/1128](https://togithub.com/chronotope/chrono/pull/1128), thanks [@&#8203;totikom](https://togithub.com/totikom))
-   implement `FusedIterator` for `NaiveDateDaysIterator` and `NaiveDateWeeksIterator` ([https://github.com/chronotope/chrono/pull/1134](https://togithub.com/chronotope/chrono/pull/1134))
-   Make `NaiveDateDaysIterator` and `NaiveDateWeeksIterator` public ([https://github.com/chronotope/chrono/pull/1134](https://togithub.com/chronotope/chrono/pull/1134))
-   Add `FromStr` for `FixedOffset` ([https://github.com/chronotope/chrono/pull/1157](https://togithub.com/chronotope/chrono/pull/1157), thanks [@&#8203;mcronce](https://togithub.com/mcronce))
-   Remove `Tz::Offset: Display` requirement from `DateTime::to_rfc*` ([https://github.com/chronotope/chrono/pull/1160](https://togithub.com/chronotope/chrono/pull/1160))
-   More flexible offset formatting (not exposed yet) ([https://github.com/chronotope/chrono/pull/1160](https://togithub.com/chronotope/chrono/pull/1160))
-   Make `StrftimeItems` with `unstable-locales` work without allocating ([https://github.com/chronotope/chrono/pull/1152](https://togithub.com/chronotope/chrono/pull/1152))
-   Make `NaiveDate::from_ymd_opt` const ([https://github.com/chronotope/chrono/pull/1172](https://togithub.com/chronotope/chrono/pull/1172), thanks [@&#8203;kamadorueda](https://togithub.com/kamadorueda))
-   Implement `Error` trait for `ParseWeekdayError` and `ParseMonthError` ([https://github.com/chronotope/chrono/pull/539](https://togithub.com/chronotope/chrono/pull/539), thanks [@&#8203;mike-kfed](https://togithub.com/mike-kfed))
-   Make methods on `NaiveTime` const, update MSRV to 1.57 ([https://github.com/chronotope/chrono/pull/1080](https://togithub.com/chronotope/chrono/pull/1080))
-   Make methods on `NaiveDate` const ([https://github.com/chronotope/chrono/pull/1205](https://togithub.com/chronotope/chrono/pull/1205))
-   Implement operations for `core::time::Duration` on `DateTime` types ([https://github.com/chronotope/chrono/pull/1229](https://togithub.com/chronotope/chrono/pull/1229))

#### Fixes

-   Ensure `timestamp_nanos` panics on overflow in release builds ([https://github.com/chronotope/chrono/pull/1123](https://togithub.com/chronotope/chrono/pull/1123))
-   Fix `offset_from_local_datetime` for `wasm_bindgen` ([https://github.com/chronotope/chrono/pull/1131](https://togithub.com/chronotope/chrono/pull/1131))
-   Parsing: Consider `%s` to be a timestamp in UTC ([https://github.com/chronotope/chrono/pull/1136](https://togithub.com/chronotope/chrono/pull/1136))
-   Don't panic when formatting with `%#z` ([https://github.com/chronotope/chrono/pull/1140](https://togithub.com/chronotope/chrono/pull/1140), thanks [@&#8203;domodwyer](https://togithub.com/domodwyer))
-   Parsing: allow MINUS SIGN (U+2212) in offset ([https://github.com/chronotope/chrono/pull/1087](https://togithub.com/chronotope/chrono/pull/1087), thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Fix locale formatting for `%c` and `%r` ([https://github.com/chronotope/chrono/pull/1165](https://togithub.com/chronotope/chrono/pull/1165))
-   Localize decimal point with `unstable-locales` feature ([https://github.com/chronotope/chrono/pull/1168](https://togithub.com/chronotope/chrono/pull/1168))
-   Fix panic on macOS 10.12 caused by using version 1 of the TZif file format ([https://github.com/chronotope/chrono/pull/1201](https://togithub.com/chronotope/chrono/pull/1201), thanks to help from [@&#8203;jfro](https://togithub.com/jfro))
-   Fix deserialization of negative timestamps ([https://github.com/chronotope/chrono/pull/1194](https://togithub.com/chronotope/chrono/pull/1194))
-   Do not use `Offset`'s `Debug` impl when serializing `DateTime` ([https://github.com/chronotope/chrono/pull/1035](https://togithub.com/chronotope/chrono/pull/1035))
-   Allow missing seconds in `NaiveTime::from_str` ([https://github.com/chronotope/chrono/pull/1181](https://togithub.com/chronotope/chrono/pull/1181))
-   Do not depend on `android-tzdata` if the `clock` feature is not enabled ([https://github.com/chronotope/chrono/pull/1220](https://togithub.com/chronotope/chrono/pull/1220), thanks [@&#8203;AlexTMjugador](https://togithub.com/AlexTMjugador))
-   Small fixes to the RFC 3339 parsers ([https://github.com/chronotope/chrono/pull/1145](https://togithub.com/chronotope/chrono/pull/1145))

#### Documentation

-   Add "Errors" and "Panics" sections to API docs ([https://github.com/chronotope/chrono/pull/1120](https://togithub.com/chronotope/chrono/pull/1120))
-   Specify licenses in SPDX format ([https://github.com/chronotope/chrono/pull/1132](https://togithub.com/chronotope/chrono/pull/1132), backport of [https://github.com/chronotope/chrono/issues/910](https://togithub.com/chronotope/chrono/issues/910), thanks [@&#8203;LingMan](https://togithub.com/LingMan))
-   Fix `NaiveTime` doc typo ([https://github.com/chronotope/chrono/pull/1146](https://togithub.com/chronotope/chrono/pull/1146), thanks [@&#8203;zachs18](https://togithub.com/zachs18))
-   Clarify nanosecond formatting specifier doc ([https://github.com/chronotope/chrono/pull/1173](https://togithub.com/chronotope/chrono/pull/1173))
-   Add warning against combining multiple `Datelike::with_*` ([https://github.com/chronotope/chrono/pull/1199](https://togithub.com/chronotope/chrono/pull/1199))
-   Fix typo "accepted" ([https://github.com/chronotope/chrono/pull/1209](https://togithub.com/chronotope/chrono/pull/1209), thanks [@&#8203;simon04](https://togithub.com/simon04))
-   Add some examples to `Utc::now` and `Local::now` ([https://github.com/chronotope/chrono/pull/1192](https://togithub.com/chronotope/chrono/pull/1192))
-   Add example to `Weekday::num_days_from_monday` ([https://github.com/chronotope/chrono/pull/1193](https://togithub.com/chronotope/chrono/pull/1193))
-   Fix some comments and panic messages ([https://github.com/chronotope/chrono/pull/1221](https://togithub.com/chronotope/chrono/pull/1221), thanks [@&#8203;umanwizard](https://togithub.com/umanwizard))

#### Internal improvements

-   `DateTime::to_rfc_*` optimizations ([https://github.com/chronotope/chrono/pull/1200](https://togithub.com/chronotope/chrono/pull/1200))
-   Move all tests into modules, fix clippy warnings ([https://github.com/chronotope/chrono/pull/1138](https://togithub.com/chronotope/chrono/pull/1138))
-   Offset parsing cleanup ([https://github.com/chronotope/chrono/pull/1158](https://togithub.com/chronotope/chrono/pull/1158))
-   Factor out formatting to `format/formatting.rs` ([https://github.com/chronotope/chrono/pull/1156](https://togithub.com/chronotope/chrono/pull/1156))
-   Format refactorings ([https://github.com/chronotope/chrono/pull/1198](https://togithub.com/chronotope/chrono/pull/1198))
-   Format toml files with taplo ([https://github.com/chronotope/chrono/pull/1117](https://togithub.com/chronotope/chrono/pull/1117), thanks [@&#8203;tottoto](https://togithub.com/tottoto))
-   Stop vendoring `saturating_abs` ([https://github.com/chronotope/chrono/pull/1124](https://togithub.com/chronotope/chrono/pull/1124))
-   CI: shell set -eux, use bash ([https://github.com/chronotope/chrono/pull/1103](https://togithub.com/chronotope/chrono/pull/1103), thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Fix dead code error when running dateutils test on Windows ([https://github.com/chronotope/chrono/pull/1125](https://togithub.com/chronotope/chrono/pull/1125))
-   Remove `Makefile` ([https://github.com/chronotope/chrono/pull/1133](https://togithub.com/chronotope/chrono/pull/1133))
-   CI: Test `wasm-bindgen` feature ([https://github.com/chronotope/chrono/pull/1131](https://togithub.com/chronotope/chrono/pull/1131))
-   Stop using deprecated methods in parse module ([https://github.com/chronotope/chrono/pull/1142](https://togithub.com/chronotope/chrono/pull/1142))
-   Add formatting benchmarks ([https://github.com/chronotope/chrono/pull/1155](https://togithub.com/chronotope/chrono/pull/1155))
-   Feature gate tests instead of methods ([https://github.com/chronotope/chrono/pull/1159](https://togithub.com/chronotope/chrono/pull/1159), [https://github.com/chronotope/chrono/pull/1162](https://togithub.com/chronotope/chrono/pull/1162))
-   Parallelize `try_verify_against_date_command` ([https://github.com/chronotope/chrono/pull/1161](https://togithub.com/chronotope/chrono/pull/1161))
-   CI: also run integration tests with `no_std` ([https://github.com/chronotope/chrono/pull/1166](https://togithub.com/chronotope/chrono/pull/1166))
-   Split ` test_parse  ` ([https://github.com/chronotope/chrono/pull/1170](https://togithub.com/chronotope/chrono/pull/1170))
-   Remove `#![deny(dead_code)]` ([https://github.com/chronotope/chrono/pull/1187](https://togithub.com/chronotope/chrono/pull/1187))
-   Clippy fixes for Rust 1.71 ([https://github.com/chronotope/chrono/pull/1186](https://togithub.com/chronotope/chrono/pull/1186))
-   Various small improvements ([https://github.com/chronotope/chrono/pull/1191](https://togithub.com/chronotope/chrono/pull/1191))
-   Add unit test for uncovered regions ([https://github.com/chronotope/chrono/pull/1149](https://togithub.com/chronotope/chrono/pull/1149), thanks [@&#8203;CXWorks](https://togithub.com/CXWorks))
-   Don't test the same thing twice in `test_date_extreme_offset` ([https://github.com/chronotope/chrono/pull/1195](https://togithub.com/chronotope/chrono/pull/1195))
-   CI: Add workflow code coverage report and upload ([https://github.com/chronotope/chrono/pull/1178](https://togithub.com/chronotope/chrono/pull/1178), [https://github.com/chronotope/chrono/pull/1215](https://togithub.com/chronotope/chrono/pull/1215), thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   CI: fail on warnings in `features-check` ([https://github.com/chronotope/chrono/pull/1216](https://togithub.com/chronotope/chrono/pull/1216))
-   Switch to windows-bindgen ([https://github.com/chronotope/chrono/pull/1202](https://togithub.com/chronotope/chrono/pull/1202), thanks to help from [@&#8203;MarijnS95](https://togithub.com/MarijnS95))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.26`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.26)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.25...v0.4.26)

The changes from [#&#8203;807](https://togithub.com/chronotope/chrono/issues/807) we merged for 0.4.25 unfortunately restricted parsing in a way that was incompatible with earlier 0.4.x releases. We reverted this in [#&#8203;1113](https://togithub.com/chronotope/chrono/issues/1113). A small amount of other changes were merged since.

-   Update README ([#&#8203;1111](https://togithub.com/chronotope/chrono/issues/1111), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Revert backport of [#&#8203;807](https://togithub.com/chronotope/chrono/issues/807) ([#&#8203;1113](https://togithub.com/chronotope/chrono/issues/1113), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Update to 2021 edition ([#&#8203;1109](https://togithub.com/chronotope/chrono/issues/1109), thanks to [@&#8203;tottoto](https://togithub.com/tottoto))
-   Fix `DurationRound` panics from issue [#&#8203;1010](https://togithub.com/chronotope/chrono/issues/1010) ([#&#8203;1093](https://togithub.com/chronotope/chrono/issues/1093), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   tests: date path consolidate (branch 0.4.x) ([#&#8203;1090](https://togithub.com/chronotope/chrono/issues/1090), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Parse tests nanosecond bare dot (branch 0.4.x) ([#&#8203;1098](https://togithub.com/chronotope/chrono/issues/1098), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   yamllint cleanup lint.yml test.yml ([#&#8203;1102](https://togithub.com/chronotope/chrono/issues/1102), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Remove num-iter dependency ([#&#8203;1107](https://togithub.com/chronotope/chrono/issues/1107), thanks to [@&#8203;tottoto](https://togithub.com/tottoto))

Thanks on behalf of the chrono team ([@&#8203;djc](https://togithub.com/djc) and [@&#8203;esheppa](https://togithub.com/esheppa)) to all contributors!

### [`v0.4.25`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.25)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.24...v0.4.25)

Time for another maintenance release. This release bumps the MSRV to 1.56; given MSRV bumps in chrono's dependencies (notably for syn 2), we felt that it no longer made sense to support any older versions. Feedback welcome in our issue tracker!

#### Additions

-   Bump the MSRV to 1.56 ([#&#8203;1053](https://togithub.com/chronotope/chrono/issues/1053))
-   Apply comments from MSRV bump ([#&#8203;1026](https://togithub.com/chronotope/chrono/issues/1026), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Remove num-integer dependency ([#&#8203;1037](https://togithub.com/chronotope/chrono/issues/1037), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add `NaiveDateTime::and_utc()` method ([#&#8203;952](https://togithub.com/chronotope/chrono/issues/952), thanks to [@&#8203;klnusbaum](https://togithub.com/klnusbaum))
-   derive `Hash` for most pub types that also derive `PartialEq` ([#&#8203;938](https://togithub.com/chronotope/chrono/issues/938), thanks to [@&#8203;bruceg](https://togithub.com/bruceg))
-   Add `parse_and_remainder()` methods ([#&#8203;1011](https://togithub.com/chronotope/chrono/issues/1011), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add `DateTime::fix_offset()` ([#&#8203;1030](https://togithub.com/chronotope/chrono/issues/1030), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add `#[track_caller]` to `LocalResult::unwrap` ([#&#8203;1046](https://togithub.com/chronotope/chrono/issues/1046), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add `#[must_use]` to some methods ([#&#8203;1007](https://togithub.com/chronotope/chrono/issues/1007), thanks to [@&#8203;aceArt-GmbH](https://togithub.com/aceArt-GmbH))
-   Implement `PartialOrd` for `Month` ([#&#8203;999](https://togithub.com/chronotope/chrono/issues/999), thanks to [@&#8203;Munksgaard](https://togithub.com/Munksgaard))
-   Add `impl From<NaiveDateTime> for NaiveDate` ([#&#8203;1012](https://togithub.com/chronotope/chrono/issues/1012), thanks to [@&#8203;pezcore](https://togithub.com/pezcore))
-   Extract timezone info from tzdata file on Android ([#&#8203;978](https://togithub.com/chronotope/chrono/issues/978), thanks to [@&#8203;RumovZ](https://togithub.com/RumovZ))

#### Fixes

-   Prevent string slicing inside char boundaries ([#&#8203;1024](https://togithub.com/chronotope/chrono/issues/1024), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   fix IsoWeek so that its flags are always correct ([#&#8203;991](https://togithub.com/chronotope/chrono/issues/991), thanks to [@&#8203;moshevds](https://togithub.com/moshevds))
-   Fix out-of-range panic in `NaiveWeek::last_day` ([#&#8203;1070](https://togithub.com/chronotope/chrono/issues/1070), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Use correct offset in conversion from `Local` to `FixedOffset` ([#&#8203;1041](https://togithub.com/chronotope/chrono/issues/1041), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix military timezones in RFC 2822 parsing ([#&#8203;1013](https://togithub.com/chronotope/chrono/issues/1013), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Guard against overflow in NaiveDate::with_\*0 methods ([#&#8203;1023](https://togithub.com/chronotope/chrono/issues/1023), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix panic in from_num_days_from_ce_opt ([#&#8203;1052](https://togithub.com/chronotope/chrono/issues/1052), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))

#### Refactoring

-   Rely on std for getting local time offset ([#&#8203;1072](https://togithub.com/chronotope/chrono/issues/1072), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Make functions in internals const ([#&#8203;1043](https://togithub.com/chronotope/chrono/issues/1043), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Refactor windows module in `Local` ([#&#8203;992](https://togithub.com/chronotope/chrono/issues/992), thanks to [@&#8203;nekevss](https://togithub.com/nekevss))
-   Simplify from_timestamp_millis, from_timestamp_micros ([#&#8203;1032](https://togithub.com/chronotope/chrono/issues/1032), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Backport [#&#8203;983](https://togithub.com/chronotope/chrono/issues/983) and [#&#8203;1000](https://togithub.com/chronotope/chrono/issues/1000) ([#&#8203;1063](https://togithub.com/chronotope/chrono/issues/1063), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))

#### Documentation

-   Backport documentation improvements ([#&#8203;1066](https://togithub.com/chronotope/chrono/issues/1066), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add documentation for %Z quirk ([#&#8203;1051](https://togithub.com/chronotope/chrono/issues/1051), thanks to [@&#8203;campbellcole](https://togithub.com/campbellcole))
-   Add an example to Weekday ([#&#8203;1019](https://togithub.com/chronotope/chrono/issues/1019), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))

#### Internal improvements

-   Gate test on `clock` feature ([#&#8203;1061](https://togithub.com/chronotope/chrono/issues/1061), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   CI: Also run tests with `--no-default-features` ([#&#8203;1059](https://togithub.com/chronotope/chrono/issues/1059), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Prevent `bench_year_flags_from_year` from being optimized out ([#&#8203;1034](https://togithub.com/chronotope/chrono/issues/1034), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix test_leap_second during DST transition ([#&#8203;1064](https://togithub.com/chronotope/chrono/issues/1064), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix warnings when running tests on Windows ([#&#8203;1038](https://togithub.com/chronotope/chrono/issues/1038), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix tests on AIX ([#&#8203;1028](https://togithub.com/chronotope/chrono/issues/1028), thanks to [@&#8203;ecnelises](https://togithub.com/ecnelises))
-   Fix doctest warnings, remove mention of deprecated methods from main doc ([#&#8203;1081](https://togithub.com/chronotope/chrono/issues/1081), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Reformat `test_datetime_parse_from_str` ([#&#8203;1078](https://togithub.com/chronotope/chrono/issues/1078), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   GitHub yml shell `set -eux`, use bash ([#&#8203;1103](https://togithub.com/chronotope/chrono/issues/1103), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   test: explicitly set `LANG` to `c` in gnu `date` ([#&#8203;1089](https://togithub.com/chronotope/chrono/issues/1089), thanks to [@&#8203;scarf005](https://togithub.com/scarf005))
-   Switch test to `TryFrom` ([#&#8203;1086](https://togithub.com/chronotope/chrono/issues/1086), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add test for issue 551 ([#&#8203;1020](https://togithub.com/chronotope/chrono/issues/1020), thanks to [@&#8203;pitdicker](https://togithub.co

</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 [Mend Renovate](https://www.mend.io/free-developer-tools/renovate/). View repository job log [here](https://developer.mend.io/github/X-oss-byte/Canary-nextjs).
kodiakhq bot pushed a commit to X-oss-byte/Nextjs that referenced this pull request May 1, 2024
[![Mend Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [chrono](https://togithub.com/chronotope/chrono) | dependencies | patch | `0.4` -> `0.4.38` |

---

### Release Notes

<details>
<summary>chronotope/chrono (chrono)</summary>

### [`v0.4.38`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.38)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.37...v0.4.38)

This release bring a ca. 20% improvement to the performance of the formatting code, and a convenient `days_since` method for the `Weekday` type.

Chrono 0.4.38 also removes the long deprecated `rustc-serialize` feature. Support for `rustc-serialize` will be [soft-destabilized in the next Rust edition](https://togithub.com/rust-lang/rust/pull/116016). Removing the feature will not break existing users of the feature; Cargo will just not update dependents that rely on it to newer versions of chrono.

In chrono 0.4.36 we made an accidental breaking change by switching to `derive(Copy)` for `DateTime` instead of a manual implementation. It is reverted in this release.

### Removals

-   Remove `rustc-serialize` feature ([#&#8203;1548](https://togithub.com/chronotope/chrono/issues/1548), thanks [@&#8203;workingjubilee](https://togithub.com/workingjubilee))

### Additions

-   Add `Weekday::days_since` ([#&#8203;1249](https://togithub.com/chronotope/chrono/issues/1249), based on [#&#8203;216](https://togithub.com/chronotope/chrono/issues/216) by [@&#8203;clarfonthey](https://togithub.com/clarfonthey))
-   Add `TimeDelta::checked_mul` and `TimeDelta::checked_div` ([#&#8203;1565](https://togithub.com/chronotope/chrono/issues/1565), thanks [@&#8203;Zomtir](https://togithub.com/Zomtir))

### Fixes

-   Return error when rounding with a zero duration ([#&#8203;1474](https://togithub.com/chronotope/chrono/issues/1474), thanks [@&#8203;Dav1dde](https://togithub.com/Dav1dde))
-   Manually implement `Copy` for `DateTime` if offset is `Copy` ([#&#8203;1573](https://togithub.com/chronotope/chrono/issues/1573))

### Internal

-   Inline `test_encodable_json` and `test_decodable_json` functions ([#&#8203;1550](https://togithub.com/chronotope/chrono/issues/1550))
-   CI: Reduce combinations in `cargo hack check` ([#&#8203;1553](https://togithub.com/chronotope/chrono/issues/1553))
-   Refactor formatting code ([#&#8203;1335](https://togithub.com/chronotope/chrono/issues/1335))
-   Optimize number formatting ([#&#8203;1558](https://togithub.com/chronotope/chrono/issues/1558))
-   Only package files needed for building and testing ([#&#8203;1554](https://togithub.com/chronotope/chrono/issues/1554))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.37`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.37)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.36...v0.4.37)

Version 0.4.36 introduced an unexpected breaking change and was yanked. In it `LocalResult` was renamed to `MappedLocalTime` to avoid the impression that it is a `Result` type were some of the results are errors. For backwards compatibility a type alias with the old name was added.

As it turns out there is one case where a type alias behaves differently from the regular enum: you can't import enum variants from a type alias with `use chrono::LocalResult::*`. With 0.4.37 we make the new name `MappedLocalTime` the alias, but keep using it in function signatures and the documentation as much as possible.

See also the release notes of [chrono 0.4.36](https://togithub.com/chronotope/chrono/releases/tag/v0.4.36) from yesterday for the yanked release.

### [`v0.4.36`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.36)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.35...v0.4.36)

This release un-deprecates the methods on `TimeDelta` that were deprecated with the 0.4.35 release because of the churn they are causing for the ecosystem.

New is the `DateTime::with_time()` method. As an example of when it is useful:

```rust
use chrono::{Local, NaiveTime};
// Today at 12:00:00
let today_noon = Local::now().with_time(NaiveTime::from_hms_opt(12, 0, 0).unwrap());
```

### Additions

-   Add `DateTime::with_time()` ([#&#8203;1510](https://togithub.com/chronotope/chrono/issues/1510))

### Deprecations

-   Revert `TimeDelta` deprecations ([#&#8203;1543](https://togithub.com/chronotope/chrono/issues/1543))
-   Deprecate `TimeStamp::timestamp_subsec_nanos`, which was missed in the 0.4.35 release ([#&#8203;1486](https://togithub.com/chronotope/chrono/issues/1486))

### Documentation

-   Correct version number of deprecation notices ([#&#8203;1486](https://togithub.com/chronotope/chrono/issues/1486))
-   Fix some typos ([#&#8203;1505](https://togithub.com/chronotope/chrono/issues/1505))
-   Slightly improve serde documentation ([#&#8203;1519](https://togithub.com/chronotope/chrono/issues/1519))
-   Main documentation: simplify links and reflow text ([#&#8203;1535](https://togithub.com/chronotope/chrono/issues/1535))

### Internal

-   CI: Lint benchmarks ([#&#8203;1489](https://togithub.com/chronotope/chrono/issues/1489))
-   Remove unnessary `Copy` and `Send` impls ([#&#8203;1492](https://togithub.com/chronotope/chrono/issues/1492), thanks [@&#8203;erickt](https://togithub.com/erickt))
-   Backport streamlined `NaiveDate` unit tests ([#&#8203;1500](https://togithub.com/chronotope/chrono/issues/1500), thanks [@&#8203;Zomtir](https://togithub.com/Zomtir))
-   Rename `LocalResult` to `TzResolution`, add alias ([#&#8203;1501](https://togithub.com/chronotope/chrono/issues/1501))
-   Update windows-bindgen to 0.55 ([#&#8203;1504](https://togithub.com/chronotope/chrono/issues/1504))
-   Avoid duplicate imports, which generate warnings on nightly ([#&#8203;1507](https://togithub.com/chronotope/chrono/issues/1507))
-   Add extra debug assertions to `NaiveDate::from_yof` ([#&#8203;1518](https://togithub.com/chronotope/chrono/issues/1518))
-   Some small simplifications to `DateTime::date_naive` and `NaiveDate::diff_months` ([#&#8203;1530](https://togithub.com/chronotope/chrono/issues/1530))
-   Remove `unwrap` in Unix `Local` type ([#&#8203;1533](https://togithub.com/chronotope/chrono/issues/1533))
-   Use different method to ignore feature-dependent doctests ([#&#8203;1534](https://togithub.com/chronotope/chrono/issues/1534))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`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<Utc>` type, or from the `TimeZone` trait.

    Converting from `NaiveDateTime` to `DateTime<Utc>` 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<NaiveDate>`, `Option<NaiveDateTime>` and `Option<DateTime<Tz>>` 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}` ([#&#8203;1234](https://togithub.com/chronotope/chrono/issues/1234))
-   Add getters to `Parsed` ([#&#8203;1465](https://togithub.com/chronotope/chrono/issues/1465))

### Deprecations

-   Deprecate timestamp methods on `NaiveDateTime` ([#&#8203;1473](https://togithub.com/chronotope/chrono/issues/1473))
-   Deprecate panicking constructors of `TimeDelta` ([#&#8203;1450](https://togithub.com/chronotope/chrono/issues/1450))

### Changes/fixes

-   Use `NonZeroI32` inside `NaiveDate` ([#&#8203;1207](https://togithub.com/chronotope/chrono/issues/1207))
-   Mark `format::Numeric` and `format::Fixed` as `non_exhaustive` ([#&#8203;1430](https://togithub.com/chronotope/chrono/issues/1430))
-   `Parsed` fixes to error values ([#&#8203;1439](https://togithub.com/chronotope/chrono/issues/1439))
-   Use `overflowing_naive_local` in `DateTime::checked_add*` ([#&#8203;1333](https://togithub.com/chronotope/chrono/issues/1333))
-   Do complete range checks in `Parsed::set_*` ([#&#8203;1465](https://togithub.com/chronotope/chrono/issues/1465))

### Documentation

-   Rustfmt doctests ([#&#8203;1452](https://togithub.com/chronotope/chrono/issues/1452))
-   Improve docs for crate features ([#&#8203;1455](https://togithub.com/chronotope/chrono/issues/1455), thanks [@&#8203;edmorley](https://togithub.com/edmorley))
-   Add more documentation and examples to `Parsed` ([#&#8203;1439](https://togithub.com/chronotope/chrono/issues/1439))

### Internal

-   Refactor `internals` module ([#&#8203;1428](https://togithub.com/chronotope/chrono/issues/1428), [#&#8203;1429](https://togithub.com/chronotope/chrono/issues/1429), [#&#8203;1431](https://togithub.com/chronotope/chrono/issues/1431), [#&#8203;1432](https://togithub.com/chronotope/chrono/issues/1432), [#&#8203;1433](https://togithub.com/chronotope/chrono/issues/1433), [#&#8203;1438](https://togithub.com/chronotope/chrono/issues/1438))
-   CI: test cross-compiling to `x86_64-unknown-illumos` instead of Solaris ([#&#8203;1437](https://togithub.com/chronotope/chrono/issues/1437))
-   CI: lint Windows target, fix clippy warning ([#&#8203;1441](https://togithub.com/chronotope/chrono/issues/1441))
-   CI: only run `cargo hack check` on Linux ([#&#8203;1442](https://togithub.com/chronotope/chrono/issues/1442))
-   Update windows-bindgen to 0.54 ([#&#8203;1462](https://togithub.com/chronotope/chrono/issues/1462), [#&#8203;1483](https://togithub.com/chronotope/chrono/issues/1483))
-   Simplify error value of `parse_internal` ([#&#8203;1459](https://togithub.com/chronotope/chrono/issues/1459))
-   Simplify `SerdeError` ([#&#8203;1458](https://togithub.com/chronotope/chrono/issues/1458))
-   Simplify `NaiveDate::from_isoywd` a bit ([#&#8203;1464](https://togithub.com/chronotope/chrono/issues/1464))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.34`](https://togithub.com/chronotope/chrono/releases/tag/v0.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` ([#&#8203;1385](https://togithub.com/chronotope/chrono/issues/1385), thanks [@&#8203;danwilliams](https://togithub.com/danwilliams))
-   Remove check for `DurationExceedsTimestamp` in `DurationRound` ([#&#8203;1403](https://togithub.com/chronotope/chrono/issues/1403), thanks [@&#8203;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), [#&#8203;1420](https://togithub.com/chronotope/chrono/issues/1420))
-   Windows: base implementation on `GetTimeZoneInformationForYear` ([#&#8203;1017](https://togithub.com/chronotope/chrono/issues/1017))

### Additions

-   Add `TimeDelta::try_milliseconds` ([#&#8203;1385](https://togithub.com/chronotope/chrono/issues/1385), thanks [@&#8203;danwilliams](https://togithub.com/danwilliams))
-   Add `TimeDelta::new` ([#&#8203;1337](https://togithub.com/chronotope/chrono/issues/1337))
-   Add `StrftimeItems::{parse, parse_to_owned}` and more documentation ([#&#8203;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 ([#&#8203;1406](https://togithub.com/chronotope/chrono/issues/1406))
-   Make `TimeDelta` methods const ([#&#8203;1337](https://togithub.com/chronotope/chrono/issues/1337))
-   Make remaining methods of `NaiveDate`, `NaiveWeek`, `NaiveTime` and `NaiveDateTime` const where possible ([#&#8203;1337](https://togithub.com/chronotope/chrono/issues/1337))
-   Make methods on `DateTime` const where possible ([#&#8203;1400](https://togithub.com/chronotope/chrono/issues/1400))
-   Make `Display` format of `TimeDelta` conform better to ISO 8601 ([#&#8203;1328](https://togithub.com/chronotope/chrono/issues/1328))

### Documentation

-   Fix the formatting of `timestamp_micros`'s Example doc ([#&#8203;1338](https://togithub.com/chronotope/chrono/issues/1338) via [#&#8203;1386](https://togithub.com/chronotope/chrono/issues/1386), thanks [@&#8203;emikitas](https://togithub.com/emikitas))
-   Specify branch for GitHub Actions badge and fix link ([#&#8203;1388](https://togithub.com/chronotope/chrono/issues/1388))
-   Don't mention some deprecated methods in docs ([#&#8203;1395](https://togithub.com/chronotope/chrono/issues/1395))
-   Remove stray documentation from main ([#&#8203;1397](https://togithub.com/chronotope/chrono/issues/1397))
-   Improved documentation of `TimeDelta` constructors ([#&#8203;1385](https://togithub.com/chronotope/chrono/issues/1385), thanks [@&#8203;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 ([#&#8203;1390](https://togithub.com/chronotope/chrono/issues/1390), [#&#8203;1402](https://togithub.com/chronotope/chrono/issues/1402)).
-   Don't use deprecated method in `impl Arbitrary for DateTime` and set up CI test ([#&#8203;1336](https://togithub.com/chronotope/chrono/issues/1336))
-   Remove workaround for Rust < 1.61 ([#&#8203;1393](https://togithub.com/chronotope/chrono/issues/1393))
-   Bump `codecov/codecov-action` from 3 to 4 ([#&#8203;1404](https://togithub.com/chronotope/chrono/issues/1404))
-   Remove partial support for handling `-0000` offset ([#&#8203;1411](https://togithub.com/chronotope/chrono/issues/1411))
-   Move `TOO_LONG` error out of `parse_internal` ([#&#8203;1419](https://togithub.com/chronotope/chrono/issues/1419))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.33`](https://togithub.com/chronotope/chrono/releases/tag/v0.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` ([#&#8203;1383](https://togithub.com/chronotope/chrono/issues/1383))
-   Fixed typo in `Duration::hours()` exception ([#&#8203;1384](https://togithub.com/chronotope/chrono/issues/1384), thanks [@&#8203;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` ([#&#8203;1071](https://togithub.com/chronotope/chrono/issues/1071))
-   Fix out of range panics in `DateTime` getters and setters ([#&#8203;1317](https://togithub.com/chronotope/chrono/issues/1317), [#&#8203;1329](https://togithub.com/chronotope/chrono/issues/1329))

#### Additions

-   Add `NaiveDateTime::checked_(add|sub)_offset` ([#&#8203;1313](https://togithub.com/chronotope/chrono/issues/1313))
-   Add `DateTime::to_utc` ([#&#8203;1325](https://togithub.com/chronotope/chrono/issues/1325))
-   Derive `Default` for `Duration` ([#&#8203;1327](https://togithub.com/chronotope/chrono/issues/1327))
-   Add `Duration::subsec_nanos` ([#&#8203;1327](https://togithub.com/chronotope/chrono/issues/1327))
-   Add `try_*` builders to `Duration` ([#&#8203;1327](https://togithub.com/chronotope/chrono/issues/1327))
-   Implement `AddAssign` and `SubAssign` for `Duration` ([#&#8203;1327](https://togithub.com/chronotope/chrono/issues/1327))
-   Make methods on `NaiveDateTime` const where possible ([#&#8203;1286](https://togithub.com/chronotope/chrono/issues/1286))
-   Split `clock` feature into `clock` and `now` ([#&#8203;1343](https://togithub.com/chronotope/chrono/issues/1343), thanks [@&#8203;mmastrac](https://togithub.com/mmastrac))
-   Add `From<NaiveDate>` for `NaiveDateTime` ([#&#8203;1355](https://togithub.com/chronotope/chrono/issues/1355), thanks [@&#8203;dcechano](https://togithub.com/dcechano))
-   Add `NaiveDateTime::from_timestamp_nanos` ([#&#8203;1357](https://togithub.com/chronotope/chrono/issues/1357), thanks [@&#8203;Ali-Mirghasemi](https://togithub.com/Ali-Mirghasemi))
-   Add `Months::num_months()` and `num_years()` ([#&#8203;1373](https://togithub.com/chronotope/chrono/issues/1373), thanks [@&#8203;danwilliams](https://togithub.com/danwilliams))
-   Add `DateTime<Utc>::from_timestamp_millis` ([#&#8203;1374](https://togithub.com/chronotope/chrono/issues/1374), thanks [@&#8203;xmakro](https://togithub.com/xmakro))

#### Changes

-   Fix panic in `Duration::MIN.abs()` (adjust `Duration::MIN` by 1 millisecond) ([#&#8203;1334](https://togithub.com/chronotope/chrono/issues/1334))
-   Bump MSRV to 1.61 ([#&#8203;1347](https://togithub.com/chronotope/chrono/issues/1347))
-   Update windows-targets requirement from 0.48 to 0.52 ([#&#8203;1360](https://togithub.com/chronotope/chrono/issues/1360))
-   Update windows-bindgen to 0.52 ([#&#8203;1379](https://togithub.com/chronotope/chrono/issues/1379))

#### Deprecations

-   Deprecate standalone `format` functions ([#&#8203;1306](https://togithub.com/chronotope/chrono/issues/1306))

#### Documentation

-   Improve doc comment and tests for timestamp_nanos_opt ([#&#8203;1299](https://togithub.com/chronotope/chrono/issues/1299), thanks [@&#8203;mlegner](https://togithub.com/mlegner))
-   Switch to `doc_auto_cfg` ([#&#8203;1305](https://togithub.com/chronotope/chrono/issues/1305), [#&#8203;1326](https://togithub.com/chronotope/chrono/issues/1326))
-   Document panics in `Add`/`Sub` impls and use `expect` ([#&#8203;1316](https://togithub.com/chronotope/chrono/issues/1316))
-   Improve types listed in top-level documentation ([#&#8203;1274](https://togithub.com/chronotope/chrono/issues/1274))
-   Improve deprecation note of `TimeZone::datetime_from_str` ([#&#8203;1342](https://togithub.com/chronotope/chrono/issues/1342), thanks [@&#8203;tmccombs](https://togithub.com/tmccombs))
-   Fix typos in `Datelike` impl for `DateTime` ([#&#8203;1376](https://togithub.com/chronotope/chrono/issues/1376), thanks [@&#8203;ElectrifyPro](https://togithub.com/ElectrifyPro))

#### Rkyv support

-   Export `Archived*` types in `rkyv` module ([#&#8203;1304](https://togithub.com/chronotope/chrono/issues/1304))
-   Duplicate derives on `Archived*` types ([#&#8203;1271](https://togithub.com/chronotope/chrono/issues/1271), thanks [@&#8203;Awpteamoose](https://togithub.com/Awpteamoose))
-   Archive derive of PartialEq for rkyv ([#&#8203;959](https://togithub.com/chronotope/chrono/issues/959), thanks [@&#8203;mkatychev](https://togithub.com/mkatychev))
-   Expose rkyv features as features for chrono users ([#&#8203;1368](https://togithub.com/chronotope/chrono/issues/1368), thanks [@&#8203;gz](https://togithub.com/gz))

#### Changes to unstable features

-   Don't let `unstable-locales` imply the `alloc` feature ([#&#8203;1307](https://togithub.com/chronotope/chrono/issues/1307))
-   Remove `format::{format_localized, format_item_localized}` ([#&#8203;1311](https://togithub.com/chronotope/chrono/issues/1311))
-   Inline `write_rfc2822_inner`, don't localize ([#&#8203;1322](https://togithub.com/chronotope/chrono/issues/1322))

#### Internal

-   Add benchmark for `DateTime::with_*` ([#&#8203;1309](https://togithub.com/chronotope/chrono/issues/1309))
-   Fix `*_DAYS_FROM_YEAR_0` calculation ([#&#8203;1312](https://togithub.com/chronotope/chrono/issues/1312))
-   Add `NaiveTime::overflowing_(add|sub)_offset` ([#&#8203;1310](https://togithub.com/chronotope/chrono/issues/1310))
-   Rewrite `DateTime::overflowing_(add|sub)_offset` ([#&#8203;1069](https://togithub.com/chronotope/chrono/issues/1069))
-   Tests calling date command `set env LC_ALL` ([#&#8203;1315](https://togithub.com/chronotope/chrono/issues/1315), thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Update `deny.toml` ([#&#8203;1320](https://togithub.com/chronotope/chrono/issues/1320))
-   Bump actions/setup-node from 3 to 4 ([#&#8203;1346](https://togithub.com/chronotope/chrono/issues/1346))
-   test.yml remove errant `with: node-version` ([#&#8203;1352](https://togithub.com/chronotope/chrono/issues/1352), thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   CI Linting: Fix missing sources checkout in `toml` job ([#&#8203;1371](https://togithub.com/chronotope/chrono/issues/1371), thanks [@&#8203;gibbz00](https://togithub.com/gibbz00))
-   Silence clippy lint for test code with Rust 1.74.0 ([#&#8203;1362](https://togithub.com/chronotope/chrono/issues/1362))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.31`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.31)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.30...v0.4.31)

Another maintenance release.
It was not a planned effort to improve our support for UNIX timestamps, yet most PRs seem related to this.

##### Deprecations

-   Deprecate `timestamp_nanos` in favor of the non-panicking `timestamp_nanos_opt` ([#&#8203;1275](https://togithub.com/chronotope/chrono/issues/1275))

##### Additions

-   Add `DateTime::<Utc>::from_timestamp` ([#&#8203;1279](https://togithub.com/chronotope/chrono/issues/1279), thanks [@&#8203;demurgos](https://togithub.com/demurgos))
-   Add `TimeZone::timestamp_micros` ([#&#8203;1285](https://togithub.com/chronotope/chrono/issues/1285), thanks [@&#8203;emikitas](https://togithub.com/emikitas))
-   Add `DateTime<Tz>::timestamp_nanos_opt` and `NaiveDateTime::timestamp_nanos_opt` ([#&#8203;1275](https://togithub.com/chronotope/chrono/issues/1275))
-   Add `UNIX_EPOCH` constants ([#&#8203;1291](https://togithub.com/chronotope/chrono/issues/1291))

##### Fixes

-   Format day of month in RFC 2822 without padding ([#&#8203;1272](https://togithub.com/chronotope/chrono/issues/1272))
-   Don't allow strange leap seconds which are not on a minute boundary initialization methods ([#&#8203;1283](https://togithub.com/chronotope/chrono/issues/1283))
    This makes many methods a little more strict:
    -   `NaiveTime::from_hms_milli`
    -   `NaiveTime::from_hms_milli_opt`
    -   `NaiveTime::from_hms_micro`
    -   `NaiveTime::from_hms_micro_opt`
    -   `NaiveTime::from_hms_nano`
    -   `NaiveTime::from_hms_nano_opt`
    -   `NaiveTime::from_num_seconds_from_midnight`
    -   `NaiveTime::from_num_seconds_from_midnight_opt`
    -   `NaiveDate::and_hms_milli`
    -   `NaiveDate::and_hms_milli_opt`
    -   `NaiveDate::and_hms_micro`
    -   `NaiveDate::and_hms_micro_opt`
    -   `NaiveDate::and_hms_nano`
    -   `NaiveDate::and_hms_nano_opt`
    -   `NaiveDateTime::from_timestamp`
    -   `NaiveDateTime::from_timestamp_opt`
    -   `TimeZone::timestamp`
    -   `TimeZone::timestamp_opt`
-   Fix underflow in `NaiveDateTime::timestamp_nanos_opt` ([#&#8203;1294](https://togithub.com/chronotope/chrono/issues/1294), thanks [@&#8203;crepererum](https://togithub.com/crepererum))

##### Documentation

-   Add more documentation about the RFC 2822 obsolete date format ([#&#8203;1267](https://togithub.com/chronotope/chrono/issues/1267))

##### Internal

-   Remove internal `__doctest` feature and `doc_comment` dependency ([#&#8203;1276](https://togithub.com/chronotope/chrono/issues/1276))
-   CI: Bump `actions/checkout` from 3 to 4 ([#&#8203;1280](https://togithub.com/chronotope/chrono/issues/1280))
-   Optimize `NaiveDate::add_days` for small values ([#&#8203;1214](https://togithub.com/chronotope/chrono/issues/1214))
-   Upgrade `pure-rust-locales` to 0.7.0 ([#&#8203;1288](https://togithub.com/chronotope/chrono/issues/1288), thanks [@&#8203;jeremija](https://togithub.com/jeremija) wo did good improvements on `pure-rust-locales`)

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.30`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.30)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.29...v0.4.30)

In this release, we have decided to swap out the `chrono::Duration` type (which has been a re-export of time 0.1 `Duration` type) with our own definition, which exposes a strict superset of the `time::Duration` API. This helps avoid warnings about the [CVE-2020-26235] and [RUSTSEC-2020-0071] advisories for downstream users and allows us to improve the `Duration` API going forward.

While this is technically a SemVer-breaking change, we expect the risk of downstream users experiencing actual incompatibility to be exceedingly limited (see [our analysis](https://togithub.com/chronotope/chrono/pull/1095#issuecomment-1571716955) of public code using a crater-like experiment), and not enough justification for the large ecosystem churn of a 0.5 release. If you have any feedback on these changes, please let us know in [#&#8203;1268](https://togithub.com/chronotope/chrono/issues/1268).

##### Additions

-   Add `NaiveDate::leap_year` ([#&#8203;1261](https://togithub.com/chronotope/chrono/issues/1261))

##### Documentation

-   Update main documentation from README ([#&#8203;1260](https://togithub.com/chronotope/chrono/issues/1260), thanks [@&#8203;Stygmates](https://togithub.com/Stygmates))
-   Add history of relation between chrono and time 0.1 to documentation ([https://github.com/chronotope/chrono/pull/1264](https://togithub.com/chronotope/chrono/pull/1264), [https://github.com/chronotope/chrono/pull/1266](https://togithub.com/chronotope/chrono/pull/1266))
-   Clarify `Timelike::num_seconds_from_midnight` is a simple mapping ([#&#8203;1255](https://togithub.com/chronotope/chrono/issues/1255))

#### Relation between chrono and time 0.1

Rust first had a `time` module added to `std` in its 0.7 release. It later moved to `libextra`, and then to a `libtime` library shipped alongside the standard library. In 2014 work on chrono started in order to provide a full-featured date and time library in Rust. Some improvements from chrono made it into the standard library; notably, `chrono::Duration` was included as `std::time::Duration` ([rust#15934]) in 2014.

In preparation of Rust 1.0 at the end of 2014 `libtime` was moved out of the Rust distro and into the `time` crate to eventually be redesigned ([rust#18832], [rust#18858]), like the `num` and `rand` crates. Of course chrono kept its dependency on this `time` crate. `time` started re-exporting `std::time::Duration` during this period. Later, the standard library was changed to have a more limited unsigned `Duration` type ([rust#24920], [RFC 1040]), while the `time` crate kept the full functionality with `time::Duration`. `time::Duration` had been a part of chrono's public API.

By 2016 `time` 0.1 lived under the `rust-lang-deprecated` organisation and was not actively maintained ([time#136]). chrono absorbed the platform functionality and `Duration` type of the `time` crate in [chrono#478] (the work started in [chrono#286]). In order to preserve compatibility with downstream crates depending on `time` and `chrono` sharing a `Duration` type, chrono kept depending on time 0.1. chrono offered the option to opt out of the `time` dependency by disabling the `oldtime` feature (swapping it out for an effectively similar chrono type). In 2019, [@&#8203;jhpratt](https://togithub.com/jhpratt) took over maintenance on the `time` crate and released what amounts to a new crate as `time` 0.2.

[rust#15934]: https://togithub.com/rust-lang/rust/pull/15934

[rust#18832]: https://togithub.com/rust-lang/rust/pull/18832#issuecomment-62448221

[rust#18858]: https://togithub.com/rust-lang/rust/pull/18858

[rust#24920]: https://togithub.com/rust-lang/rust/pull/24920

[RFC 1040]: https://rust-lang.github.io/rfcs/1040-duration-reform.html

[time#136]: https://togithub.com/time-rs/time/issues/136

[chrono#286]: https://togithub.com/chronotope/chrono/pull/286

[chrono#478]: https://togithub.com/chronotope/chrono/pull/478

##### Security advisories

In November of 2020 [CVE-2020-26235] and [RUSTSEC-2020-0071] were opened against the `time` crate. [@&#8203;quininer](https://togithub.com/quininer) had found that calls to `localtime_r` may be unsound ([chrono#499]). Eventually, almost a year later, this was also made into a security advisory against chrono as [RUSTSEC-2020-0159], which had platform code similar to `time`.

On Unix-like systems a process is given a timezone id or description via the `TZ` environment variable. We need this timezone data to calculate the current local time from a value that is in UTC, such as the time from the system clock. `time` 0.1 and chrono used the POSIX function `localtime_r` to do the conversion to local time, which reads the `TZ` variable.

Rust assumes the environment to be writable and uses locks to access it from multiple threads. Some other programming languages and libraries use similar locking strategies, but these are typically not shared across languages. More importantly, POSIX declares modifying the environment in a multi-threaded process as unsafe, and `getenv` in libc can't be changed to take a lock because it returns a pointer to the data (see [rust#27970] for more discussion).

Since version 4.20 chrono no longer uses `localtime_r`, instead using Rust code to query the timezone (from the `TZ` variable or via `iana-time-zone` as a fallback) and work with data from the system timezone database directly. The code for this was forked from the [tz-rs crate] by [@&#8203;x-hgg-x](https://togithub.com/x-hgg-x). As such, chrono now respects the Rust lock when reading the `TZ` environment variable. In general, code should avoid modifying the environment.

[CVE-2020-26235]: https://nvd.nist.gov/vuln/detail/CVE-2020-26235

[RUSTSEC-2020-0071]: https://rustsec.org/advisories/RUSTSEC-2020-0071

[chrono#499]: https://togithub.com/chronotope/chrono/pull/499

[RUSTSEC-2020-0159]: https://rustsec.org/advisories/RUSTSEC-2020-0159.html

[rust#27970]: https://togithub.com/rust-lang/rust/issues/27970

[chrono#677]: https://togithub.com/chronotope/chrono/pull/677

[tz-rs crate]: https://crates.io/crates/tz-rs

##### Removing time 0.1

Because time 0.1 has been unmaintained for years, however, the security advisory mentioned above has not been addressed. While chrono maintainers were careful not to break backwards compatibility with the `time::Duration` type, there has been a long stream of issues from users inquiring about the time 0.1 dependency with the vulnerability. We investigated the potential breakage of removing the time 0.1 dependency in [chrono#1095] using a crater-like experiment and determined that the potential for breaking (public) dependencies is very low. We reached out to those few crates that did still depend on compatibility with time 0.1.

As such, for chrono 0.4.30 we have decided to swap out the time 0.1 `Duration` implementation for a local one that will offer a strict superset of the existing API going forward. This will prevent most downstream users from being affected by the security vulnerability in time 0.1 while minimizing the ecosystem impact of semver-incompatible version churn.

[chrono#1095]: https://togithub.com/chronotope/chrono/pull/1095

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.29`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.29)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.28...v0.4.29)

This release fixes a panic introduced in chrono 0.4.27 in `FromStr<DateTime<Utc>>` ([#&#8203;1253](https://togithub.com/chronotope/chrono/issues/1253)).

Chrono now has a [Discord channel](https://discord.gg/sXpav4PS7M).

#### Fixes

-   Fix arbitrary string slicing in `parse_rfc3339_relaxed` ([#&#8203;1254](https://togithub.com/chronotope/chrono/issues/1254))

#### Deprecations

-   Deprecate `TimeZone::datetime_from_str` ([#&#8203;1251](https://togithub.com/chronotope/chrono/issues/1251))

#### Documentation

-   Correct documentation for `FromStr` for `Weekday` and `Month` ([#&#8203;1226](https://togithub.com/chronotope/chrono/issues/1226), thanks [@&#8203;wfraser](https://togithub.com/wfraser))

#### Internal improvements

-   Revert "add test_issue\_866" ([#&#8203;1238](https://togithub.com/chronotope/chrono/issues/1238))
-   CI: run tests on `i686` and `wasm32-wasi` ([#&#8203;1237](https://togithub.com/chronotope/chrono/issues/1237))
-   CI: Include doctests for code coverage ([#&#8203;1248](https://togithub.com/chronotope/chrono/issues/1248))
-   Move benchmarks to a separate crate ([#&#8203;1243](https://togithub.com/chronotope/chrono/issues/1243))
    This allows us to upgrade the criterion dependency to 5.1 without changing our MSRV.
-   Add Discord link to README ([#&#8203;1240](https://togithub.com/chronotope/chrono/issues/1240), backported in [#&#8203;1256](https://togithub.com/chronotope/chrono/issues/1256))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.28`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.28)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.27...v0.4.28)

This release fixes a test failure on 32-bit targets introduced with 0.4.27, see [https://github.com/chronotope/chrono/issues/1234](https://togithub.com/chronotope/chrono/issues/1234).

### [`v0.4.27`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.27)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.26...v0.4.27)

This release bumps the MSRV from 1.56 to 1.57. This allows us to take advantage of the panicking in const feature. In this release most methods on `NaiveDate` and `NaiveTime` are made const, `NaiveDateTime` and others will follow in a later release.

The parser for the `%+` formatting specifier and the `RFC3339` formatting item is switched from a strict to a relaxed parser (see [https://github.com/chronotope/chrono/pull/1145](https://togithub.com/chronotope/chrono/pull/1145)). This matches the existing documentation, and the parser used by `DateTime::from_str`. If you need to validate the input, consider using `DateTime::from_rfc3339`.

#### Deprecations

-   Deprecate `DateTime::{from_local, from_utc}` ([https://github.com/chronotope/chrono/pull/1175](https://togithub.com/chronotope/chrono/pull/1175))

#### Additions

-   Let `DateTime::signed_duration_since` take argument with `Borrow` ([https://github.com/chronotope/chrono/pull/1119](https://togithub.com/chronotope/chrono/pull/1119))
-   Implement `PartialOrd` for `Month` ([https://github.com/chronotope/chrono/pull/999](https://togithub.com/chronotope/chrono/pull/999), thanks [@&#8203;Munksgaard](https://togithub.com/Munksgaard))
-   Add `Ord` and `Eq` for types which already derive `PartialOrd` and `PartialEq` ([https://github.com/chronotope/chrono/pull/1128](https://togithub.com/chronotope/chrono/pull/1128), thanks [@&#8203;totikom](https://togithub.com/totikom))
-   implement `FusedIterator` for `NaiveDateDaysIterator` and `NaiveDateWeeksIterator` ([https://github.com/chronotope/chrono/pull/1134](https://togithub.com/chronotope/chrono/pull/1134))
-   Make `NaiveDateDaysIterator` and `NaiveDateWeeksIterator` public ([https://github.com/chronotope/chrono/pull/1134](https://togithub.com/chronotope/chrono/pull/1134))
-   Add `FromStr` for `FixedOffset` ([https://github.com/chronotope/chrono/pull/1157](https://togithub.com/chronotope/chrono/pull/1157), thanks [@&#8203;mcronce](https://togithub.com/mcronce))
-   Remove `Tz::Offset: Display` requirement from `DateTime::to_rfc*` ([https://github.com/chronotope/chrono/pull/1160](https://togithub.com/chronotope/chrono/pull/1160))
-   More flexible offset formatting (not exposed yet) ([https://github.com/chronotope/chrono/pull/1160](https://togithub.com/chronotope/chrono/pull/1160))
-   Make `StrftimeItems` with `unstable-locales` work without allocating ([https://github.com/chronotope/chrono/pull/1152](https://togithub.com/chronotope/chrono/pull/1152))
-   Make `NaiveDate::from_ymd_opt` const ([https://github.com/chronotope/chrono/pull/1172](https://togithub.com/chronotope/chrono/pull/1172), thanks [@&#8203;kamadorueda](https://togithub.com/kamadorueda))
-   Implement `Error` trait for `ParseWeekdayError` and `ParseMonthError` ([https://github.com/chronotope/chrono/pull/539](https://togithub.com/chronotope/chrono/pull/539), thanks [@&#8203;mike-kfed](https://togithub.com/mike-kfed))
-   Make methods on `NaiveTime` const, update MSRV to 1.57 ([https://github.com/chronotope/chrono/pull/1080](https://togithub.com/chronotope/chrono/pull/1080))
-   Make methods on `NaiveDate` const ([https://github.com/chronotope/chrono/pull/1205](https://togithub.com/chronotope/chrono/pull/1205))
-   Implement operations for `core::time::Duration` on `DateTime` types ([https://github.com/chronotope/chrono/pull/1229](https://togithub.com/chronotope/chrono/pull/1229))

#### Fixes

-   Ensure `timestamp_nanos` panics on overflow in release builds ([https://github.com/chronotope/chrono/pull/1123](https://togithub.com/chronotope/chrono/pull/1123))
-   Fix `offset_from_local_datetime` for `wasm_bindgen` ([https://github.com/chronotope/chrono/pull/1131](https://togithub.com/chronotope/chrono/pull/1131))
-   Parsing: Consider `%s` to be a timestamp in UTC ([https://github.com/chronotope/chrono/pull/1136](https://togithub.com/chronotope/chrono/pull/1136))
-   Don't panic when formatting with `%#z` ([https://github.com/chronotope/chrono/pull/1140](https://togithub.com/chronotope/chrono/pull/1140), thanks [@&#8203;domodwyer](https://togithub.com/domodwyer))
-   Parsing: allow MINUS SIGN (U+2212) in offset ([https://github.com/chronotope/chrono/pull/1087](https://togithub.com/chronotope/chrono/pull/1087), thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Fix locale formatting for `%c` and `%r` ([https://github.com/chronotope/chrono/pull/1165](https://togithub.com/chronotope/chrono/pull/1165))
-   Localize decimal point with `unstable-locales` feature ([https://github.com/chronotope/chrono/pull/1168](https://togithub.com/chronotope/chrono/pull/1168))
-   Fix panic on macOS 10.12 caused by using version 1 of the TZif file format ([https://github.com/chronotope/chrono/pull/1201](https://togithub.com/chronotope/chrono/pull/1201), thanks to help from [@&#8203;jfro](https://togithub.com/jfro))
-   Fix deserialization of negative timestamps ([https://github.com/chronotope/chrono/pull/1194](https://togithub.com/chronotope/chrono/pull/1194))
-   Do not use `Offset`'s `Debug` impl when serializing `DateTime` ([https://github.com/chronotope/chrono/pull/1035](https://togithub.com/chronotope/chrono/pull/1035))
-   Allow missing seconds in `NaiveTime::from_str` ([https://github.com/chronotope/chrono/pull/1181](https://togithub.com/chronotope/chrono/pull/1181))
-   Do not depend on `android-tzdata` if the `clock` feature is not enabled ([https://github.com/chronotope/chrono/pull/1220](https://togithub.com/chronotope/chrono/pull/1220), thanks [@&#8203;AlexTMjugador](https://togithub.com/AlexTMjugador))
-   Small fixes to the RFC 3339 parsers ([https://github.com/chronotope/chrono/pull/1145](https://togithub.com/chronotope/chrono/pull/1145))

#### Documentation

-   Add "Errors" and "Panics" sections to API docs ([https://github.com/chronotope/chrono/pull/1120](https://togithub.com/chronotope/chrono/pull/1120))
-   Specify licenses in SPDX format ([https://github.com/chronotope/chrono/pull/1132](https://togithub.com/chronotope/chrono/pull/1132), backport of [https://github.com/chronotope/chrono/issues/910](https://togithub.com/chronotope/chrono/issues/910), thanks [@&#8203;LingMan](https://togithub.com/LingMan))
-   Fix `NaiveTime` doc typo ([https://github.com/chronotope/chrono/pull/1146](https://togithub.com/chronotope/chrono/pull/1146), thanks [@&#8203;zachs18](https://togithub.com/zachs18))
-   Clarify nanosecond formatting specifier doc ([https://github.com/chronotope/chrono/pull/1173](https://togithub.com/chronotope/chrono/pull/1173))
-   Add warning against combining multiple `Datelike::with_*` ([https://github.com/chronotope/chrono/pull/1199](https://togithub.com/chronotope/chrono/pull/1199))
-   Fix typo "accepted" ([https://github.com/chronotope/chrono/pull/1209](https://togithub.com/chronotope/chrono/pull/1209), thanks [@&#8203;simon04](https://togithub.com/simon04))
-   Add some examples to `Utc::now` and `Local::now` ([https://github.com/chronotope/chrono/pull/1192](https://togithub.com/chronotope/chrono/pull/1192))
-   Add example to `Weekday::num_days_from_monday` ([https://github.com/chronotope/chrono/pull/1193](https://togithub.com/chronotope/chrono/pull/1193))
-   Fix some comments and panic messages ([https://github.com/chronotope/chrono/pull/1221](https://togithub.com/chronotope/chrono/pull/1221), thanks [@&#8203;umanwizard](https://togithub.com/umanwizard))

#### Internal improvements

-   `DateTime::to_rfc_*` optimizations ([https://github.com/chronotope/chrono/pull/1200](https://togithub.com/chronotope/chrono/pull/1200))
-   Move all tests into modules, fix clippy warnings ([https://github.com/chronotope/chrono/pull/1138](https://togithub.com/chronotope/chrono/pull/1138))
-   Offset parsing cleanup ([https://github.com/chronotope/chrono/pull/1158](https://togithub.com/chronotope/chrono/pull/1158))
-   Factor out formatting to `format/formatting.rs` ([https://github.com/chronotope/chrono/pull/1156](https://togithub.com/chronotope/chrono/pull/1156))
-   Format refactorings ([https://github.com/chronotope/chrono/pull/1198](https://togithub.com/chronotope/chrono/pull/1198))
-   Format toml files with taplo ([https://github.com/chronotope/chrono/pull/1117](https://togithub.com/chronotope/chrono/pull/1117), thanks [@&#8203;tottoto](https://togithub.com/tottoto))
-   Stop vendoring `saturating_abs` ([https://github.com/chronotope/chrono/pull/1124](https://togithub.com/chronotope/chrono/pull/1124))
-   CI: shell set -eux, use bash ([https://github.com/chronotope/chrono/pull/1103](https://togithub.com/chronotope/chrono/pull/1103), thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Fix dead code error when running dateutils test on Windows ([https://github.com/chronotope/chrono/pull/1125](https://togithub.com/chronotope/chrono/pull/1125))
-   Remove `Makefile` ([https://github.com/chronotope/chrono/pull/1133](https://togithub.com/chronotope/chrono/pull/1133))
-   CI: Test `wasm-bindgen` feature ([https://github.com/chronotope/chrono/pull/1131](https://togithub.com/chronotope/chrono/pull/1131))
-   Stop using deprecated methods in parse module ([https://github.com/chronotope/chrono/pull/1142](https://togithub.com/chronotope/chrono/pull/1142))
-   Add formatting benchmarks ([https://github.com/chronotope/chrono/pull/1155](https://togithub.com/chronotope/chrono/pull/1155))
-   Feature gate tests instead of methods ([https://github.com/chronotope/chrono/pull/1159](https://togithub.com/chronotope/chrono/pull/1159), [https://github.com/chronotope/chrono/pull/1162](https://togithub.com/chronotope/chrono/pull/1162))
-   Parallelize `try_verify_against_date_command` ([https://github.com/chronotope/chrono/pull/1161](https://togithub.com/chronotope/chrono/pull/1161))
-   CI: also run integration tests with `no_std` ([https://github.com/chronotope/chrono/pull/1166](https://togithub.com/chronotope/chrono/pull/1166))
-   Split ` test_parse  ` ([https://github.com/chronotope/chrono/pull/1170](https://togithub.com/chronotope/chrono/pull/1170))
-   Remove `#![deny(dead_code)]` ([https://github.com/chronotope/chrono/pull/1187](https://togithub.com/chronotope/chrono/pull/1187))
-   Clippy fixes for Rust 1.71 ([https://github.com/chronotope/chrono/pull/1186](https://togithub.com/chronotope/chrono/pull/1186))
-   Various small improvements ([https://github.com/chronotope/chrono/pull/1191](https://togithub.com/chronotope/chrono/pull/1191))
-   Add unit test for uncovered regions ([https://github.com/chronotope/chrono/pull/1149](https://togithub.com/chronotope/chrono/pull/1149), thanks [@&#8203;CXWorks](https://togithub.com/CXWorks))
-   Don't test the same thing twice in `test_date_extreme_offset` ([https://github.com/chronotope/chrono/pull/1195](https://togithub.com/chronotope/chrono/pull/1195))
-   CI: Add workflow code coverage report and upload ([https://github.com/chronotope/chrono/pull/1178](https://togithub.com/chronotope/chrono/pull/1178), [https://github.com/chronotope/chrono/pull/1215](https://togithub.com/chronotope/chrono/pull/1215), thanks [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   CI: fail on warnings in `features-check` ([https://github.com/chronotope/chrono/pull/1216](https://togithub.com/chronotope/chrono/pull/1216))
-   Switch to windows-bindgen ([https://github.com/chronotope/chrono/pull/1202](https://togithub.com/chronotope/chrono/pull/1202), thanks to help from [@&#8203;MarijnS95](https://togithub.com/MarijnS95))

Thanks to all contributors on behalf of the chrono team, [@&#8203;djc](https://togithub.com/djc) and [@&#8203;pitdicker](https://togithub.com/pitdicker)!

### [`v0.4.26`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.26)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.25...v0.4.26)

The changes from [#&#8203;807](https://togithub.com/chronotope/chrono/issues/807) we merged for 0.4.25 unfortunately restricted parsing in a way that was incompatible with earlier 0.4.x releases. We reverted this in [#&#8203;1113](https://togithub.com/chronotope/chrono/issues/1113). A small amount of other changes were merged since.

-   Update README ([#&#8203;1111](https://togithub.com/chronotope/chrono/issues/1111), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Revert backport of [#&#8203;807](https://togithub.com/chronotope/chrono/issues/807) ([#&#8203;1113](https://togithub.com/chronotope/chrono/issues/1113), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Update to 2021 edition ([#&#8203;1109](https://togithub.com/chronotope/chrono/issues/1109), thanks to [@&#8203;tottoto](https://togithub.com/tottoto))
-   Fix `DurationRound` panics from issue [#&#8203;1010](https://togithub.com/chronotope/chrono/issues/1010) ([#&#8203;1093](https://togithub.com/chronotope/chrono/issues/1093), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   tests: date path consolidate (branch 0.4.x) ([#&#8203;1090](https://togithub.com/chronotope/chrono/issues/1090), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Parse tests nanosecond bare dot (branch 0.4.x) ([#&#8203;1098](https://togithub.com/chronotope/chrono/issues/1098), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   yamllint cleanup lint.yml test.yml ([#&#8203;1102](https://togithub.com/chronotope/chrono/issues/1102), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   Remove num-iter dependency ([#&#8203;1107](https://togithub.com/chronotope/chrono/issues/1107), thanks to [@&#8203;tottoto](https://togithub.com/tottoto))

Thanks on behalf of the chrono team ([@&#8203;djc](https://togithub.com/djc) and [@&#8203;esheppa](https://togithub.com/esheppa)) to all contributors!

### [`v0.4.25`](https://togithub.com/chronotope/chrono/releases/tag/v0.4.25)

[Compare Source](https://togithub.com/chronotope/chrono/compare/v0.4.24...v0.4.25)

Time for another maintenance release. This release bumps the MSRV to 1.56; given MSRV bumps in chrono's dependencies (notably for syn 2), we felt that it no longer made sense to support any older versions. Feedback welcome in our issue tracker!

#### Additions

-   Bump the MSRV to 1.56 ([#&#8203;1053](https://togithub.com/chronotope/chrono/issues/1053))
-   Apply comments from MSRV bump ([#&#8203;1026](https://togithub.com/chronotope/chrono/issues/1026), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Remove num-integer dependency ([#&#8203;1037](https://togithub.com/chronotope/chrono/issues/1037), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add `NaiveDateTime::and_utc()` method ([#&#8203;952](https://togithub.com/chronotope/chrono/issues/952), thanks to [@&#8203;klnusbaum](https://togithub.com/klnusbaum))
-   derive `Hash` for most pub types that also derive `PartialEq` ([#&#8203;938](https://togithub.com/chronotope/chrono/issues/938), thanks to [@&#8203;bruceg](https://togithub.com/bruceg))
-   Add `parse_and_remainder()` methods ([#&#8203;1011](https://togithub.com/chronotope/chrono/issues/1011), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add `DateTime::fix_offset()` ([#&#8203;1030](https://togithub.com/chronotope/chrono/issues/1030), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add `#[track_caller]` to `LocalResult::unwrap` ([#&#8203;1046](https://togithub.com/chronotope/chrono/issues/1046), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add `#[must_use]` to some methods ([#&#8203;1007](https://togithub.com/chronotope/chrono/issues/1007), thanks to [@&#8203;aceArt-GmbH](https://togithub.com/aceArt-GmbH))
-   Implement `PartialOrd` for `Month` ([#&#8203;999](https://togithub.com/chronotope/chrono/issues/999), thanks to [@&#8203;Munksgaard](https://togithub.com/Munksgaard))
-   Add `impl From<NaiveDateTime> for NaiveDate` ([#&#8203;1012](https://togithub.com/chronotope/chrono/issues/1012), thanks to [@&#8203;pezcore](https://togithub.com/pezcore))
-   Extract timezone info from tzdata file on Android ([#&#8203;978](https://togithub.com/chronotope/chrono/issues/978), thanks to [@&#8203;RumovZ](https://togithub.com/RumovZ))

#### Fixes

-   Prevent string slicing inside char boundaries ([#&#8203;1024](https://togithub.com/chronotope/chrono/issues/1024), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   fix IsoWeek so that its flags are always correct ([#&#8203;991](https://togithub.com/chronotope/chrono/issues/991), thanks to [@&#8203;moshevds](https://togithub.com/moshevds))
-   Fix out-of-range panic in `NaiveWeek::last_day` ([#&#8203;1070](https://togithub.com/chronotope/chrono/issues/1070), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Use correct offset in conversion from `Local` to `FixedOffset` ([#&#8203;1041](https://togithub.com/chronotope/chrono/issues/1041), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix military timezones in RFC 2822 parsing ([#&#8203;1013](https://togithub.com/chronotope/chrono/issues/1013), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Guard against overflow in NaiveDate::with_\*0 methods ([#&#8203;1023](https://togithub.com/chronotope/chrono/issues/1023), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix panic in from_num_days_from_ce_opt ([#&#8203;1052](https://togithub.com/chronotope/chrono/issues/1052), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))

#### Refactoring

-   Rely on std for getting local time offset ([#&#8203;1072](https://togithub.com/chronotope/chrono/issues/1072), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Make functions in internals const ([#&#8203;1043](https://togithub.com/chronotope/chrono/issues/1043), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Refactor windows module in `Local` ([#&#8203;992](https://togithub.com/chronotope/chrono/issues/992), thanks to [@&#8203;nekevss](https://togithub.com/nekevss))
-   Simplify from_timestamp_millis, from_timestamp_micros ([#&#8203;1032](https://togithub.com/chronotope/chrono/issues/1032), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Backport [#&#8203;983](https://togithub.com/chronotope/chrono/issues/983) and [#&#8203;1000](https://togithub.com/chronotope/chrono/issues/1000) ([#&#8203;1063](https://togithub.com/chronotope/chrono/issues/1063), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))

#### Documentation

-   Backport documentation improvements ([#&#8203;1066](https://togithub.com/chronotope/chrono/issues/1066), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add documentation for %Z quirk ([#&#8203;1051](https://togithub.com/chronotope/chrono/issues/1051), thanks to [@&#8203;campbellcole](https://togithub.com/campbellcole))
-   Add an example to Weekday ([#&#8203;1019](https://togithub.com/chronotope/chrono/issues/1019), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))

#### Internal improvements

-   Gate test on `clock` feature ([#&#8203;1061](https://togithub.com/chronotope/chrono/issues/1061), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   CI: Also run tests with `--no-default-features` ([#&#8203;1059](https://togithub.com/chronotope/chrono/issues/1059), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Prevent `bench_year_flags_from_year` from being optimized out ([#&#8203;1034](https://togithub.com/chronotope/chrono/issues/1034), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix test_leap_second during DST transition ([#&#8203;1064](https://togithub.com/chronotope/chrono/issues/1064), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix warnings when running tests on Windows ([#&#8203;1038](https://togithub.com/chronotope/chrono/issues/1038), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Fix tests on AIX ([#&#8203;1028](https://togithub.com/chronotope/chrono/issues/1028), thanks to [@&#8203;ecnelises](https://togithub.com/ecnelises))
-   Fix doctest warnings, remove mention of deprecated methods from main doc ([#&#8203;1081](https://togithub.com/chronotope/chrono/issues/1081), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Reformat `test_datetime_parse_from_str` ([#&#8203;1078](https://togithub.com/chronotope/chrono/issues/1078), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   GitHub yml shell `set -eux`, use bash ([#&#8203;1103](https://togithub.com/chronotope/chrono/issues/1103), thanks to [@&#8203;jtmoon79](https://togithub.com/jtmoon79))
-   test: explicitly set `LANG` to `c` in gnu `date` ([#&#8203;1089](https://togithub.com/chronotope/chrono/issues/1089), thanks to [@&#8203;scarf005](https://togithub.com/scarf005))
-   Switch test to `TryFrom` ([#&#8203;1086](https://togithub.com/chronotope/chrono/issues/1086), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   Add test for issue 551 ([#&#8203;1020](https://togithub.com/chronotope/chrono/issues/1020), thanks to [@&#8203;pitdicker](https://togithub.com/pitdicker))
-   RFC 2822 single-letter obsolete tests ([#&#8203;1014](https://togithub.com/chronotope/chrono/issues/1014), thanks to [@&#8203;jtmoon79](h

</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 [Mend Renovate](https://www.mend.io/free-developer-tools/renovate/). View repository job log [here](https://developer.mend.io/github/X-oss-byte/Nextjs).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants