Crate tzdb

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

// get the system time zone
let time_zone = tzdb::local_tz().unwrap();       // tz::TimeZoneRef<'_>
let current_time = tzdb::now::local().unwrap();  // 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).unwrap();

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

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

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

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

Re-exports

• pub use tzdb_data::time_zone;
• pub use tzdb_data::TZ_NAMES;
• pub use tzdb_data::VERSION;
• pub use tzdb_data::VERSION_HASH;

Modules

• changelogNowhere
  Changes between the versions
• nownow
  Get the current time in some time zone

Functions

• local_tzlocal
  Find the time zone of the current system
• raw_tz_by_name
  Find the raw, unparsed time zone data by name, e.g. "Europe/Berlin" (case-insensitive)
• tz_by_name
  Find a time zone by name, e.g. "Europe/Berlin" (case-insensitive)