Chrono: Timezone-aware date and time handling

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.

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.

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 system time (now) and local timezone (Local).
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.

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

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

This project is licensed under either of

at your option.

Project Name	Stars	Repos Using This	Packages Using This	Most Recent Commit	Total Releases	Latest Release	Open Issues	License	Language
Dayjs	43,217	5,371	6,309	20 hours ago	116	August 12, 2022	737	mit	JavaScript
⏰ Day.js 2kB immutable date-time library alternative to Moment.js with the same modern API
Date Fns	31,615	68,280	8,107	2 days ago	179	September 13, 2022	578	mit	TypeScript
⏳ Modern JavaScript date utility library ⌛️
Awesome Falsehood	20,728			12 days ago			1	cc0-1.0
😱 Falsehoods Programmers Believe in
Luxon	13,915	1,936	1,900	12 days ago	130	August 29, 2022	126	mit	JavaScript
⏱ A library for working with dates and times in JS
Arrow	8,302	3,711	888	a month ago	63	January 27, 2022	97	apache-2.0	Python
🏹 Better dates & times for Python
Pickadate.js	7,707			3 years ago			285	mit	JavaScript
The mobile-friendly, responsive, and lightweight jQuery date & time input picker.
Datetools	7,089	663		2 years ago	13	September 28, 2017	118	mit	Objective-C
Dates and times made easy in iOS
Pendulum	5,448	540	310	19 days ago	52	July 24, 2020	245	mit	Python
Python datetimes made easy
Joda Time	4,903	31,269	5,499	13 days ago	51	August 25, 2022	43	apache-2.0	Java
Joda-Time is the widely used replacement for the Java date and time classes prior to Java SE 8.
Maya	3,362	149	59	8 months ago	24	January 06, 2019	19	mit	Python
Datetimes for Humans™