Adding `tzdb` library as a dependency

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

cargo add tzdb

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

tzdb = "0.7.3"

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

Back to the crate overview.

Readme

tzdb — Time Zone Database

Static time zone information for tz-rs.

This crate provides all time zones found in the Time Zone Database.

Usage examples

let time_zone = tzdb::local_tz()?;       // tz::TimeZoneRef<'_>
let current_time = tzdb::now::local()?;  // tz::DateTime

// access by identifier
let time_zone = tzdb::time_zone::europe::KYIV;
let current_time = tzdb::now::in_tz(tzdb::time_zone::europe::KYIV)?;

// access by name
let time_zone = tzdb::tz_by_name("Europe/Berlin")?;
let current_time = tzdb::now::in_named("Europe/Berlin")?;

// names are case insensitive
let time_zone = tzdb::tz_by_name("ArCtIc/LongYeArByEn")?;
let current_time = tzdb::now::in_named("ArCtIc/LoNgYeArByEn")?;

// provide a default time zone
let current_time = tzdb::now::local_or(tzdb::time_zone::GMT)?;
let current_time = tzdb::now::in_named_or(tzdb::time_zone::GMT, "Some/City")?;

Feature flags

local ^{(enabled by default)} — enable functions to query the current system time
now ^{(enabled by default)} — enable functions to query the current system time
std ^{(enabled by default, now and local)} — enable the use of features in the std crate
alloc ^{(enabled by std)} — enable the use of features in the alloc crate

Adding tzdb library as a dependency

Adding `tzdb` library as a dependency