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, currently in the version 2022c (released 2022-08-16).

See the documentation for a full list the the contained time zones: https://docs.rs/tzdb/latest/tzdb/time_zone/index.html

Usage examples

use tz::{DateTime, TimeZone};
use tzdb::{time_zone, tz_by_name};

// access by identifier
DateTime::now(time_zone::europe::KYIV);
// access by name
DateTime::now(tz_by_name("Europe/Berlin").unwrap());
// names are case insensitive
DateTime::now(tz_by_name("ArCtIc/LongYeArByEn").unwrap());

Feature flags

• by-name ^{(enabled by default, enabled by local)} — enables tz_by_name() to get a time zone at runtime by name

• list ^{(enabled by default)} — enables TZ_NAMES to get a list of all shipped time zones

• local ^{(enabled by default)} — enables local_tz() to get the system time zone

• binary — make the unparsed, binary tzdata of a time zone available

• std ^{(enabled by default)} — enable features that need the standard library std

• alloc ^{(enabled by default, enabled by std)} — enable features that need the standard library alloc

• fallback ^{(enabled by default)} — compile for unknown target platforms, too

Modules

changelog

Changes between the versions

time_zone

All defined time zones statically accessible

Constants

TZ_NAMESlist

A list of all known time zones

VERSION

The version of the source Time Zone Database

VERSION_HASH

The SHA512 hash of the source Time Zone Database (using the “Complete Distribution”)

Functions

local_tzlocal

Find the time zone of the current system

raw_tz_by_namebinary and by-name

Find the raw, unparsed time zone data by name, e.g. "Europe/Berlin" (case-insensitive)

tz_by_nameby-name

Find a time zone by name, e.g. "Europe/Berlin" (case-insensitive)