v0.4.29

This release fixes a panic introduced in chrono 0.4.27 in FromStr<DateTime<Utc>> (#1253).

Chrono now has a Discord channel.

Fixes

• Fix arbitrary string slicing in parse_rfc3339_relaxed (#1254)

Deprecations

• Deprecate TimeZone::datetime_from_str (#1251)

Documentation

• Correct documentation for FromStr for Weekday and Month (#1226, thanks @wfraser)

Internal improvements

• Revert "add test_issue_866" (#1238)
• CI: run tests on i686 and wasm32-wasi (#1237)
• CI: Include doctests for code coverage (#1248)
• Move benchmarks to a separate crate (#1243)
  This allows us to upgrade the criterion dependency to 5.1 without changing our MSRV.
• Add Discord link to README (#1240, backported in #1256)

Thanks to all contributors on behalf of the chrono team, @djc and @pitdicker!

v0.4.28

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

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 #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} (#1175)

Additions

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

Fixes

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

Documentation

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

Internal improvements

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

Thanks to all contributors on behalf of the chrono team, @djc and @pitdicker!

v0.4.26

The changes from #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 #1113. A small amount of other changes were merged since.

• Update README (#1111, thanks to @pitdicker)
• Revert backport of #807 (#1113, thanks to @pitdicker)
• Update to 2021 edition (#1109, thanks to @tottoto)
• Fix DurationRound panics from issue #1010 (#1093, thanks to @pitdicker)
• tests: date path consolidate (branch 0.4.x) (#1090, thanks to @jtmoon79)
• Parse tests nanosecond bare dot (branch 0.4.x) (#1098, thanks to @jtmoon79)
• yamllint cleanup lint.yml test.yml (#1102, thanks to @jtmoon79)
• Remove num-iter dependency (#1107, thanks to @tottoto)

Thanks on behalf of the chrono team (@djc and @esheppa) to all contributors!

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 (#1053)
• Apply comments from MSRV bump (#1026, thanks to @pitdicker)
• Remove num-integer dependency (#1037, thanks to @pitdicker)
• Add NaiveDateTime::and_utc() method (#952, thanks to @klnusbaum)
• derive Hash for most pub types that also derive PartialEq (#938, thanks to @bruceg)
• Add parse_and_remainder() methods (#1011, thanks to @pitdicker)
• Add DateTime::fix_offset() (#1030, thanks to @pitdicker)
• Add #[track_caller] to LocalResult::unwrap (#1046, thanks to @pitdicker)
• Add #[must_use] to some methods (#1007, thanks to @aceArt-GmbH)
• Implement PartialOrd for Month (#999, thanks to @Munksgaard)
• Add impl From<NaiveDateTime> for NaiveDate (#1012, thanks to @pezcore)
• Extract timezone info from tzdata file on Android (#978, thanks to @RumovZ)

Fixes

• Prevent string slicing inside char boundaries (#1024, thanks to @pitdicker)
• fix IsoWeek so that its flags are always correct (#991, thanks to @moshevds)
• Fix out-of-range panic in NaiveWeek::last_day (#1070, thanks to @pitdicker)
• Use correct offset in conversion from Local to FixedOffset (#1041, thanks to @pitdicker)
• Fix military timezones in RFC 2822 parsing (#1013, thanks to @pitdicker)
• Guard against overflow in NaiveDate::with_*0 methods (#1023, thanks to @pitdicker)
• Fix panic in from_num_days_from_ce_opt (#1052, thanks to @pitdicker)

Refactoring

• Rely on std for getting local time offset (#1072, thanks to @pitdicker)
• Make functions in internals const (#1043, thanks to @pitdicker)
• Refactor windows module in Local (#992, thanks to @nekevss)
• Simplify from_timestamp_millis, from_timestamp_micros (#1032, thanks to @pitdicker)
• Backport #983 and #1000 (#1063, thanks to @pitdicker)

Documentation

• Backport documentation improvements (#1066, thanks to @pitdicker)
• Add documentation for %Z quirk (#1051, thanks to @campbellcole)
• Add an example to Weekday (#1019, thanks to @pitdicker)

Internal improvements

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

On behalf of @djc and @esheppa, thanks to all contributors!

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

Thanks to all contributors from the chrono team, @esheppa and @djc.

v0.4.23

0.4.23 is the next 0.4 release of the popular chrono date and time library for Rust. After the 0.4.20-0.4.22 series that brought chrono back to life after a long hiatus, development has been fairly quiet, allowing us to start planning changes for the 0.5.0 release. As such, we've started deprecating some APIs that are likely to be removed in 0.5. If you have any feedback on these changes, please let us know in the issue tracker!

Deprecations

• Deprecate methods that have an _opt() alternative (#827)
• Deprecate usage of the Date<Tz> type (#851)

Features

• Optimize RFC 3339 (and RFC 2822) encoding (#844, thanks to @conradludgate)
• Addition and subtraction with the Days type (#784)
• Add NaiveDateTime::from_timestamp_millis(_opt) (#818, thanks to @Pscheidl -- backported in #823)
• Allow for changing TZ variable and cache it for Local timezone (#853)
• Add optional support for the arbitrary::Arbitrary trait (#849, thanks to @greyblake and @asayers)

Fixes

• Support tzdb location on AIX (#826)
• Fix warnings in documentation (#847)

On behalf of @esheppa and @djc, thanks to all contributors!

v0.4.22

Unfortunately the introduction of the iana-time-zone dependency in 0.4.21 caused some new regressions with lesser known platforms. This release fixes all of the issues we've encountered, improving the situation on some WebAssembly targets, SGX and on macOS/iOS. We've improved our CI setup to hopefully catch more of these issues before release in the future.

• Make wasm-bindgen optional on wasm32-unknown-unknown target (#771)
• Avoid iana-time-zone dependency on x86_64-fortanix-unknown-sgx (#767, thanks to @trevor-crypto)
• Update iana-time-zone version to 0.1.44 to avoid cyclic dependencies (#773, thanks to @Kijewski for the upstream PRs)
• Clarify documentation about year range in formatting/parsing (#765)

v0.4.21

0.4.21 is a bugfix release that mainly fixes one regression from 0.4.20:

• Fall back to UTC in case no timezone is found. Unfortunately this is a regression from the changes we made in 0.4.20 where we now parse the timezone database ourselves. Before 0.4.20, TimeZone::now() fell back to UTC in the case it could not find the current timezone, but the new implementation panicked in that case.
• Correctly detect timezone on Android (also #756). Android does have the timezone database installed, but it's in a different path, and it does not use /etc/localtime to keep track of the current timezone. Instead we now use the iana-time-zone crate as a dependency, since it already has quite a bit of logic for finding the current timezone on a host of platforms.

Additionally, there is a documentation fix that reverts an incorrect guarantee:

• Document that %Y can have a negative value, both in formatting and in parsing (#760, thanks to @alex)

v0.4.20

chrono is a date and time library for Rust and 0.4.20 is the first chrono release since Sep 2020. There has been a long hiatus since the previous maintainer was no longer able to spend much time on the crate; thanks to @quodlibetor for their stewardship of the chrono crate for many years! The new maintainers are @djc and @esheppa. Our first priority has been fixing the soundness issues with calls to localtime_r() as first reported in #499 and the RUSTSEC-2020-0159 advisory. In order to do this we adapted code from the tz-rs crate maintained by @x-hgg-x for use within chrono -- thanks for working on that! With the new implementation, chrono uses safe Rust code to parse the timezone data files on Unix platforms directly instead of relying on libc.

Due to compatibility reasons, this release does not yet remove the time 0.1 dependency, though chrono 0.4.20 does not depend on the vulnerable parts of the time 0.1.x versions. In a future 0.5 release, we will remove the time dependency.

The minimum supported Rust version for 0.4.20 is 1.32.0, which is intentionally still quite conservative. If you are using chrono 0.4 with a Rust version older than 1.52, we'd like to hear from you since we'd like to further modernize the code base to ease maintenance.

Fixes

• Fix unsound call to localtime_r() by parsing timezone files in Rust on Unix (#677 and #728)
• Allow RFC 2822 parser to deal with comments (#733 then #737, thanks to @Finomnis)
• Avoid panicking during parsing (#686, thanks to @botahamec)
• Avoid panics when rounding durations (#659, thanks to @ARBaart)
• Fix Duration::abs() behavior in case of negative durations with nanoseconds (#734, thanks to @abreis)

Additions

• Make ParserErrorKind public and available through ParseError::kind() (#588, thanks to @sbrocket)
• Expose associated MIN and MAX const values in favor of free-standing consts (#726)
• Add (optional) support for rkyv (#644 and #701, thanks to @dovahcrow)
• Support month-based calculations against NaiveDate (#732 with follow up in #752, thanks to @avantgardnerio)
• Add NaiveWeek type to facilitate week-based calculations (#666, thanks to @sestrella)
• Add NaiveDateTime::and_local_timezone() method (#711, thanks to @botahamec)
• Add DateTime::from_local() method (#572, thanks to @retrhelo)
• Extend serde integration for NaiveDateTime (#664, thanks to @nickelc)
• Implement DoubleEndedIterator for NaiveDateDaysIterator/NaiveDateWeeksIterator (#697, thanks to @teobouvard)
• Implement std::iter::Sum for Duration (#522, thanks to @jakevossen5)
• Add years_since() method to DateTime/Date (#557 then #707, thanks to @yozhgoor)
• Implement AddAssign/SubAssign for DateTime/Date (#698, thanks to @MrGunflame)
• Fix imports on WASM targets (#672, thanks to @danielalvsaaker)
• Implement std::error::Error for ParseWeekdayError (#745)

Non-functional improvements

• Improve CI to better exercise WASM targets (#662, thanks to @AmateurECE)
• More WASM testing improvements, enable dependencies by default (#746)
• Fix compiling for wasm32-unknown-emscripten target (#568, thanks to @orion78fr)
• Use stub implementation for anything not unix and not windows (#593, thanks to @yu-re-ka)
• Remove now unused libc dependency (#710, thanks to @metent)
• Clean up some clippy warnings (#721, thanks to @botahamec)
• Clarify documentation for Utc::now() (#647, thanks to @ModProg)
• Clarify documentation for DateTime::with_timezone() (#747, thanks to @kevincox)
• Improve examples for naive serde integration (#616, thanks to @nickelc)
• Clean up extern crate statements and outdated comments (#665, thanks to @nickelc)
• Fix typo in deprecation notice (#744, thanks to @Mike-Dax)
• Fix some typos in documentation (#680 and #695, thanks to @cuishuang and @fxredeemer)
• Implement caching for CI (#609, thanks to @Milo123459)