Struct TimeZoneInfo

pub struct TimeZoneInfo<Model>
where
    Model: TimeZoneModel,
{ /* private fields */ }

A utility type that can hold time zone information.

The primary definition of this type is in the icu_time crate. Other ICU4X crates re-export it for convenience.

See the docs on zone for more information.

Examples

use icu::calendar::Date;
use icu::locale::subtags::subtag;
use icu::time::zone::IanaParser;
use icu::time::zone::TimeZoneVariant;
use icu::time::DateTime;
use icu::time::Time;
use icu::time::TimeZone;

// Parse the IANA ID
let id = IanaParser::new().parse("America/Chicago");

// Alternatively, use the BCP47 ID directly
let id = TimeZone(subtag!("uschi"));

// Create a TimeZoneInfo<Base> by associating the ID with an offset
let time_zone = id.with_offset("-0600".parse().ok());

// Extend to a TimeZoneInfo<AtTime> by adding a local time
let time_zone_at_time = time_zone.at_date_time_iso(DateTime {
    date: Date::try_new_iso(2023, 12, 2).unwrap(),
    time: Time::start_of_day(),
});

// Extend to a TimeZoneInfo<Full> by adding a zone variant
let time_zone_with_variant =
    time_zone_at_time.with_variant(TimeZoneVariant::Standard);

Implementations

impl<Model> TimeZoneInfo<Model>

where Model: TimeZoneModel,

pub fn id(self) -> TimeZone

The BCP47 time-zone identifier.

pub fn offset(self) -> Option<UtcOffset>

The UTC offset, if known.

This field is not enforced to be consistent with the time zone id.

impl<Model> TimeZoneInfo<Model>

where Model: TimeZoneModel<ZoneNameTimestamp = ZoneNameTimestamp>,

pub fn zone_name_timestamp(self) -> ZoneNameTimestamp

The time at which to interpret the time zone.

impl<Model> TimeZoneInfo<Model>

where Model: TimeZoneModel<TimeZoneVariant = TimeZoneVariant>,

pub fn variant(self) -> TimeZoneVariant

The time variant e.g. daylight or standard, if known.

This field is not enforced to be consistent with the time zone id and offset.

impl TimeZoneInfo<Base>

pub const fn unknown() -> TimeZoneInfo<Base>

Creates a time zone info with no information.

pub const fn utc() -> TimeZoneInfo<Base>

Creates a new TimeZoneInfo for the UTC time zone.

pub fn with_zone_name_timestamp( self, zone_name_timestamp: ZoneNameTimestamp, ) -> TimeZoneInfo<AtTime>

Sets the ZoneNameTimestamp field.

pub fn at_date_time_iso(self, date_time: DateTime<Iso>) -> TimeZoneInfo<AtTime>

Sets the ZoneNameTimestamp to the given local datetime.

impl TimeZoneInfo<AtTime>

pub const fn with_variant(self, variant: TimeZoneVariant) -> TimeZoneInfo<Full>

Sets a TimeZoneVariant on this time zone.

pub fn infer_variant( self, calculator: VariantOffsetsCalculatorBorrowed<'_>, ) -> TimeZoneInfo<Full>

Sets the zone variant by calculating it using a VariantOffsetsCalculator.

If offset() is None, or if it doesn’t match either of the timezone’s standard or daylight offset around local_time(), the variant will be set to TimeZoneVariant::Standard and the time zone to TimeZone::UNKNOWN.

Example

use icu::calendar::Date;
use icu::locale::subtags::subtag;
use icu::time::zone::TimeZoneVariant;
use icu::time::zone::VariantOffsetsCalculator;
use icu::time::DateTime;
use icu::time::Time;
use icu::time::TimeZone;

// Chicago at UTC-6
let info = TimeZone(subtag!("uschi"))
    .with_offset("-0600".parse().ok())
    .at_date_time_iso(DateTime {
        date: Date::try_new_iso(2023, 12, 2).unwrap(),
        time: Time::start_of_day(),
    })
    .infer_variant(VariantOffsetsCalculator::new());

assert_eq!(info.variant(), TimeZoneVariant::Standard);

// Chicago at at UTC-5
let info = TimeZone(subtag!("uschi"))
    .with_offset("-0500".parse().ok())
    .at_date_time_iso(DateTime {
        date: Date::try_new_iso(2023, 6, 2).unwrap(),
        time: Time::start_of_day(),
    })
    .infer_variant(VariantOffsetsCalculator::new());

assert_eq!(info.variant(), TimeZoneVariant::Daylight);

// Chicago at UTC-7
let info = TimeZone(subtag!("uschi"))
    .with_offset("-0700".parse().ok())
    .at_date_time_iso(DateTime {
        date: Date::try_new_iso(2023, 12, 2).unwrap(),
        time: Time::start_of_day(),
    })
    .infer_variant(VariantOffsetsCalculator::new());

// Whatever it is, it's not Chicago
assert_eq!(info.id(), TimeZone::UNKNOWN);
assert_eq!(info.variant(), TimeZoneVariant::Standard);

Trait Implementations

impl<Model> Clone for TimeZoneInfo<Model>

where Model: TimeZoneModel,

fn clone(&self) -> TimeZoneInfo<Model>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<O> ConvertCalendar for TimeZoneInfo<O>

where O: TimeZoneModel,

type Converted<'a> = TimeZoneInfo<O>

The converted type. This can be the same as the receiver type.

fn to_calendar<'a>( &self, _: &'a AnyCalendar, ) -> <TimeZoneInfo<O> as ConvertCalendar>::Converted<'a>

Converts self to the specified AnyCalendar.

impl<Model> Debug for TimeZoneInfo<Model>

where Model: Debug + TimeZoneModel, <Model as TimeZoneModel>::ZoneNameTimestamp: Debug, <Model as TimeZoneModel>::TimeZoneVariant: Debug,

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

Formats the value using the given formatter.

impl<O> GetField<()> for TimeZoneInfo<O>

where O: TimeZoneModel,

fn get_field(&self)

Returns the value of this trait’s field T.

impl<O> GetField<Option<UtcOffset>> for TimeZoneInfo<O>

where O: TimeZoneModel,

fn get_field(&self) -> Option<UtcOffset>

Returns the value of this trait’s field T.

impl<O> GetField<TimeZone> for TimeZoneInfo<O>

where O: TimeZoneModel,

fn get_field(&self) -> TimeZone

Returns the value of this trait’s field T.

impl<O> GetField<TimeZoneVariant> for TimeZoneInfo<O>

where O: TimeZoneModel<TimeZoneVariant = TimeZoneVariant>,

fn get_field(&self) -> TimeZoneVariant

Returns the value of this trait’s field T.

impl<O> GetField<ZoneNameTimestamp> for TimeZoneInfo<O>

where O: TimeZoneModel<ZoneNameTimestamp = ZoneNameTimestamp>,

fn get_field(&self) -> ZoneNameTimestamp

Returns the value of this trait’s field T.

impl<O> InSameCalendar for TimeZoneInfo<O>

where O: TimeZoneModel,

fn check_any_calendar_kind( &self, _: AnyCalendarKind, ) -> Result<(), MismatchedCalendarError>

Checks whether this type is compatible with the given calendar.

impl<Model> PartialEq for TimeZoneInfo<Model>

where Model: PartialEq + TimeZoneModel, <Model as TimeZoneModel>::ZoneNameTimestamp: PartialEq, <Model as TimeZoneModel>::TimeZoneVariant: PartialEq,

fn eq(&self, other: &TimeZoneInfo<Model>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<Model> Copy for TimeZoneInfo<Model>

where Model: TimeZoneModel,

impl<Model> Eq for TimeZoneInfo<Model>

where Model: Eq + TimeZoneModel, <Model as TimeZoneModel>::ZoneNameTimestamp: Eq, <Model as TimeZoneModel>::TimeZoneVariant: Eq,

impl<C, O> InFixedCalendar<C> for TimeZoneInfo<O>

where O: TimeZoneModel,

impl<Model> StructuralPartialEq for TimeZoneInfo<Model>

where Model: TimeZoneModel,

impl<O> UnstableSealed for TimeZoneInfo<O>

where O: TimeZoneModel,