Struct icu_timezone::ZoneOffsetCalculator

pub struct ZoneOffsetCalculator { /* private fields */ }

ZoneOffsetCalculator uses data from the data provider to calculate time zone offsets.

Implementations

impl ZoneOffsetCalculator

pub const fn new() -> Self

Constructs a ZoneOffsetCalculator using compiled data.

✨ Enabled with the compiled_data Cargo feature.

📚 Help choosing a constructor

pub fn try_new_with_any_provider( provider: &(impl AnyProvider + ?Sized), ) -> Result<Self, DataError>

A version of [Self :: new] that uses custom data provided by an AnyProvider.

📚 Help choosing a constructor

pub fn try_new_with_buffer_provider( provider: &(impl BufferProvider + ?Sized), ) -> Result<Self, DataError>

A version of [Self :: new] that uses custom data provided by a BufferProvider.

✨ Enabled with the serde feature.

📚 Help choosing a constructor

pub fn try_new_unstable( provider: &(impl DataProvider<ZoneOffsetPeriodV1Marker> + ?Sized), ) -> Result<Self, DataError>

A version of Self::new that uses custom data provided by a DataProvider.

📚 Help choosing a constructor

⚠️ The bounds on provider may change over time, including in SemVer minor releases.

pub fn compute_offsets_from_time_zone( &self, time_zone_id: TimeZoneBcp47Id, (date, time): (Date<Iso>, Time), ) -> Option<ZoneOffsets>

Calculate zone offsets from timezone and local datetime.

Examples

use icu::calendar::{Date, Time};
use icu::timezone::TimeZoneBcp47Id;
use icu::timezone::UtcOffset;
use icu::timezone::ZoneOffsetCalculator;
use tinystr::tinystr;

let zoc = ZoneOffsetCalculator::new();

// America/Denver observes DST
let offsets = zoc
    .compute_offsets_from_time_zone(
        TimeZoneBcp47Id(tinystr!(8, "usden")),
        (Date::try_new_iso(2024, 1, 1).unwrap(), Time::midnight()),
    )
    .unwrap();
assert_eq!(
    offsets.standard,
    UtcOffset::try_from_seconds(-7 * 3600).unwrap()
);
assert_eq!(
    offsets.daylight,
    Some(UtcOffset::try_from_seconds(-6 * 3600).unwrap())
);

// America/Phoenix does not
let offsets = zoc
    .compute_offsets_from_time_zone(
        TimeZoneBcp47Id(tinystr!(8, "usphx")),
        (Date::try_new_iso(2024, 1, 1).unwrap(), Time::midnight()),
    )
    .unwrap();
assert_eq!(
    offsets.standard,
    UtcOffset::try_from_seconds(-7 * 3600).unwrap()
);
assert_eq!(offsets.daylight, None);

Trait Implementations

impl Debug for ZoneOffsetCalculator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ZoneOffsetCalculator

fn default() -> Self

Returns the “default value” for a type.