Google Git
Sign in
android / platform / external / rust / crates / chrono / 0f8e46f63aac7f9666e74bcf52e1c9daa8e9c508
commit0f8e46f63aac7f9666e74bcf52e1c9daa8e9c508[log] [tgz]
authorAndroid Build Coastguard Worker <[email protected]>Wed Apr 17 23:12:43 2024 +0000
committerAndroid Build Coastguard Worker <[email protected]>Wed Apr 17 23:12:43 2024 +0000
tree5da872d46a1e7a00ed4b39bff28fa89c4d4fe1f2
parentecaa3b6aef58d5143730c0c518fd2f734732af19 [diff]
parente10f9a6523c263e9bbd2f5af1094200311434f5d [diff]
Snap for 11728787 from e10f9a6523c263e9bbd2f5af1094200311434f5d to 24Q3-release

Change-Id: I34358e527fb3518e7c81a1e506be8fd43e1af777
tree: 5da872d46a1e7a00ed4b39bff28fa89c4d4fe1f2
  1. .github/
  2. src/
  3. tests/
  4. LICENSE ⇨ LICENSE.txt
  5. .cargo_vcs_info.json
  6. .git-ignore-revs
  7. .gitignore
  8. Android.bp
  9. appveyor.yml
  10. Cargo.toml
  11. Cargo.toml.orig
  12. cargo_embargo.json
  13. CHANGELOG.md
  14. CITATION.cff
  15. deny.toml
  16. LICENSE.txt
  17. METADATA
  18. MODULE_LICENSE_APACHE2
  19. OWNERS
  20. README.md
  21. rustfmt.toml
  22. taplo.toml
  23. TEST_MAPPING
README.md

Chrono: Timezone-aware date and time handling

Chrono GitHub Actions Chrono on crates.io Chrono on docs.rs Chat codecov.io

Chrono aims to provide all functionality needed to do correct operations on dates and times in the proleptic Gregorian calendar:

  • The DateTime type is timezone-aware by default, with separate timezone-naive types.
  • Operations that may produce an invalid or ambiguous date and time return Option or LocalResult.
  • Configurable parsing and formatting with an strftime inspired date and time formatting syntax.
  • The Local timezone works with the current timezone of the OS.
  • Types and operations are implemented to be reasonably efficient.

Timezone data is not shipped with chrono by default to limit binary sizes. Use the companion crate Chrono-TZ or tzfile for full timezone support.

Documentation

See docs.rs for the API reference.

Limitations

  • Only the proleptic Gregorian calendar (i.e. extended to support older dates) is supported.
  • Date types are limited to about +/- 262,000 years from the common epoch.
  • Time types are limited to nanosecond accuracy.
  • Leap seconds can be represented, but Chrono does not fully support them. See Leap Second Handling.

Crate features

Default features:

  • alloc: Enable features that depend on allocation (primarily string formatting)
  • std: Enables functionality that depends on the standard library. This is a superset of alloc and adds interoperation with standard library types and traits.
  • clock: Enables reading the local timezone (Local). This is a superset of now.
  • now: Enables reading the system time (now)
  • wasmbind: Interface with the JS Date API for the wasm32 target.

Optional features:

  • serde: Enable serialization/deserialization via serde.
  • rkyv: Enable serialization/deserialization via rkyv.
  • rustc-serialize: Enable serialization/deserialization via rustc-serialize (deprecated).
  • arbitrary: construct arbitrary instances of a type with the Arbitrary crate.
  • unstable-locales: Enable localization. This adds various methods with a _localized suffix. The implementation and API may change or even be removed in a patch release. Feedback welcome.

Rust version requirements

The Minimum Supported Rust Version (MSRV) is currently Rust 1.61.0.

The MSRV is explicitly tested in CI. It may be bumped in minor releases, but this is not done lightly.

License

This project is licensed under either of

at your option.