Adding `utc2k` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add utc2k

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

utc2k = "0.19.0"

The utc2k library will be automatically available globally. Read the utc2k library documentation.

Back to the crate overview.

Readme

UTC2K

UTC2K is a heavily-optimized — and extremely niche — date/time library that only supports UTC happenings in this century.

For the moments between 2000-01-01 00:00:00..=2099-12-31 23:59:59, it can run circles around crates like chrono and time, while still being able to:

Determine "now", at least until the final seconds of 2099;
Convert to/from Unix timestamps;
Convert to/from all sorts of different date/time strings;
Perform checked and saturating addition/subtraction;
Calculate ordinals, weekdays, leap years, etc.;

Examples

The library's main export is Utc2k, a Copy-friendly struct representing a specific UTC datetime.

use utc2k::{Utc2k, Weekday};

// Instantiation, four ways:
let date = Utc2k::now();                             // The current system time.
let date = Utc2k::new(2020, 1, 2, 12, 30, 30);       // From parts.
let date = Utc2k::from_unixtime(4_102_444_799);      // From a timestamp.
let date = Utc2k::from_ascii(b"2024-10-31 00:00:00") // From a datetime string.
               .unwrap();

// What day was Halloween 2024, anyway?
assert_eq!(
    date.weekday(),
    Weekday::Thursday,
);

// Ordinals are a kind of bird, right?
assert_eq!(
    date.ordinal(),
    305,
);

// Boss wants an RFC2822 for some reason?
assert_eq!(
    date.to_rfc2822(),
    "Thu, 31 Oct 2024 00:00:00 +0000",
);

Optional Crate Features

local: Enables the Local2k/FmtLocal2k structs. Refer to the documentation for important caveats and limitations.
serde: Enables serialization/deserialization support.
sqlx: Enables sqlx (mysql) support for Utc2k.

Installation

Add utc2k to your dependencies in Cargo.toml, like:

[dependencies]
utc2k = "0.17.*"

Adding utc2k library as a dependency

Adding `utc2k` library as a dependency