# Changelog
All notable changes to the time project will be documented in this file.
The format is based on [Keep a Changelog]. This project adheres to [Semantic
Versioning].
---
## 0.2.18 [2020-09-08]
### Changed
- The following functions are `const fn` on rustc ≥ 1.46:
- `Date::try_from_ymd`
- `Date::try_from_yo`
- `Time::try_from_hms`
- `Time::try_from_hms_milli`
- `Time::try_from_hms_micro`
- `Time::try_from_hms_nano`
- An `error` module has been created where all existing error types are
contained. The `Error` suffix has been dropped from these types.
- An `ext` module has been created where extension traits are contained.
- A `util` module has been created where utility functions are contained.
- `error::ComponentRange` now implements `Copy`.
For back-compatibility, all items that were moved to newly-contained modules
have been re-exported from their previous locations (and in the case of the
`error` module, with their previous name).
### Fixes
Parsing `format::Rfc3339` now correctly handles the UTC offset (#274).
## 0.2.17 [2020-09-01]
### Changed
The following functions are `const fn` on rustc ≥ 1.46:
- `Date::year`
- `Date::month`
- `Date::day`
- `Date::month_day`
- `Date::ordinal`
- `Date::as_ymd`
- `Date::as_yo`
- `Date::julian_day`
- `Duration::checked_div`
- `PrimitiveDateTime::year`
- `PrimitiveDateTime::month`
- `PrimitiveDateTime::day`
- `PrimitiveDateTime::month_day`
- `PrimitiveDateTime::ordinal`
- `Weekday::previous`
- `Weekday::next`
### Improvements
- `size_of::<Date>()` has been reduced from 8 to 4. As a consequence,
`size_of::<PrimitiveDatetime>()` went from 16 to 12 and
`size_of::<OffsetDateTime>()` from 20 to 16. This change also results in a
performance improvement of approximately 30% on the `Date::year` and
`Date::ordinal` methods.
- `cfg-if` has been removed as a dependency.
### Fixed
- `cfg` flags passed to rustc will no longer collide with other crates (at least
unless they're doing something very stupid).
- The crate will successfully compile with any combination of feature flags.
Previously, some combinations would fail.
## 0.2.16 [2020-05-12]
### Added
`OffsetDateTime`s can now be represented as Unix timestamps with serde. To do
this, you can use the `time::serde::timestamp` and
`time::serde::timestamp::option` modules.
## 0.2.15 [2020-05-04]
### Fixed
`cargo-web` support works, and is now explicitly checked in CI. A previous
change was made that made a method call ambiguous.
## 0.2.14 [2020-05-02]
### Fixed
Adding/subtracting a `core::time::Duration` now correctly takes subsecond
values into account. This also affects `PrimitiveDateTime` and `OffsetDateTime`.
## 0.2.13 [2020-05-01]
### Fixed
Panicking APIs are re-exposed.
## 0.2.12 [2020-04-30]
### Fixed
Subtracting `Instant`s can correctly result in a negative duration, rather than
resulting in the absolute value of it.
## 0.2.11 [2020-04-27]
### Added
- `OffsetDateTime::now_utc`
### Deprecated
- `OffsetDateTime::now` due to the offset not being clear from the method name
alone.
### Fixed
`Date`s are now uniformly random when using the `rand` crate. Previously, both
the year and day within the year were uniform, but this meant that any given day
in a leap year was slightly less likely to be chosen than a day in a non-leap
year.
### Changed
- MSRV is lowered to 1.32.0.
## 0.2.10 [2020-04-19]
### Added
- Support for formatting and parsing `OffsetDateTime`s as RFC3339.
- Lazy formatting. To avoid exposing implementation details, we're just
returning `impl Display`, rather than a concrete type.
- Add support for Illumos.
### Fixed
- Deprecated APIs from time v0.1 are public again. They were previously hidden
by accident in 0.2.9.
## 0.2.9 [2020-03-13]
### Fixed
`cfg-if` now has a mandatory minimum of 0.1.10, rather than just 0.1. This is
because compilation fails when using 0.1.9.
## 0.2.8 [2020-03-12]
### Added
- `cargo_web` support has been added for getting a local offset. A general
catch-all defaulting to UTC has also been added.
- `Error::source` has been implemented for the wrapper `time::Error`.
- `UtcOffset::try_local_offset`, `UtcOffset::try_current_local_offset`,
`OffsetDateTime::try_now_local()` provide fallible alternatives when the
default of UTC is not desired. To facilitate this change,
`IndeterminateOffsetError` has been added.
- Support for parsing and formatting subsecond nanoseconds.
### Changed
- `#[non_exhaustive]` is simulated on compilers prior to 1.40.0.
## 0.2.7 [2020-02-22]
### Added
- `Display` has been implemented for `Date`, `OffsetDateTime`,
`PrimitiveDateTime`, `Time`, `UtcOffset`, and `Weekday`.
- `Hash` is now derived for `Duration`.
- `SystemTime` can be converted to and from `OffsetDateTime`. The following
trait implementations have been made for interoperability:
- `impl Sub<SystemTime> for OffsetDateTime`
- `impl Sub<OffsetDateTime> for SystemTime`
- `impl PartialEq<SystemTime> for OffsetDateTime`
- `impl PartialEq<OffsetDateTime> for SystemTime`
- `impl PartialOrd<SystemTime> for OffsetDateTime`
- `impl PartialOrd<OffsetDateTime> for SystemTime`
- `impl From<SystemTime> for OffsetDateTime`
- `impl From<OffsetDateTime> for SystemTime`
- All structs now `impl Duration<T> for Standard`, allowing usage with the
`rand` crate. This is gated behind the `rand` feature flag.
- Documentation can now be built on stable. Some annotations will be missing if
you do this.
- `NumericalDuration` has been implemented for `f32` and `f64`.
`NumericalStdDuration` and `NumericalStdDurationShort` have been implemented
for `f64` only.
- `UtcOffset::local_offset_at(OffsetDateTime)`, which will obtain the system's
local offset at the provided moment in time.
- `OffsetDateTime::now_local()` is equivalent to calling
`OffsetDateTime::now().to_offset(UtcOffset::local_offset_at(OffsetDateTime::now()))`
(but more efficient).
- `UtcOffset::current_local_offset()` will return the equivalent of
`OffsetDateTime::now_local().offset()`.
### Changed
- All formatting and parsing methods now accept `impl AsRef<str>` as parameters,
rather than just `&str`. `time::validate_format_string` does this as well.
- The requirement of a `Date` being between the years -100,000 and +100,000
(inclusive) is now strictly enforced.
- Overflow checks for `Duration` are now enabled by default. This behavior is
the identical to what the standard library does.
- The `time`, `date`, and `offset` macros have been added to the prelude.
### Deprecated
- `Sign` has been deprecated in its entirety, along with `Duration::sign`.
To obtain the sign of a `Duration`, you can use the `Sign::is_positive`,
`Sign::is_negative`, and `Sign::is_zero` methods.
- A number of functions and trait implementations that implicitly assumed a
timezone (generally UTC) have been deprecated. These are:
- `Date::today`
- `Time::now`
- `PrimitiveDateTime::now`
- `PrimitiveDateTime::unix_epoch`
- `PrimitiveDateTime::from_unix_timestamp`
- `PrimitiveDateTime::timestamp`
- `impl Sub<SystemTime> for PrimitiveDateTime`
- `impl Sub<PrimitiveDateTime> for SystemTime`
- `impl PartialEq<SystemTime> for PrimitiveDateTime`
- `impl PartialEq<PrimitiveDateTime> for SystemTime>`
- `impl PartialOrd<SystemTime> for PrimitiveDateTime`
- `impl PartialOrd<PrimitiveDateTime> for SystemTime>`
- `impl From<SystemTime> for PrimitiveDateTime`
- `impl From<PrimitiveDateTime> for SystemTime`
### Fixed
- Avoid panics when parsing an empty string (#215).
- The nanoseconds component of a `Duration` is now always in range. Previously,
it was possible (via addition and/or subtraction) to obtain a value that was
not internally consistent.
- `Time::parse` erroneously returned an `InvalidMinute` error when it was
actually the second that was invalid.
- `Date::parse("0000-01-01", "%Y-%m-%d")` incorrectly returned an `Err` (#221).
## Pre-0.2.7
Prior to v0.2.7, changes were listed in GitHub releases.
[keep a changelog]: https://keepachangelog.com/en/1.0.0/
[semantic versioning]: https://semver.org/spec/v2.0.0.html
