Struct GenericLong

pub struct GenericLong;

“Central Time” ⇒ time zone in generic non-location format, long length

Examples

use icu::datetime::input::Date;
use icu::datetime::input::{Time, TimeZone,TimeZoneInfo,  UtcOffset};
use icu::datetime::NoCalendarFormatter;
use icu::time::zone::TimeZoneVariant;
use icu::datetime::fieldsets::zone::GenericLong;
use icu::locale::locale;
use tinystr::tinystr;
use writeable::assert_writeable_eq;

let fmt = NoCalendarFormatter::try_new(
    locale!("en").into(),
    GenericLong
)
.unwrap();

// Time zone info for America/Chicago in the summer
let zone = TimeZone(tinystr!(8, "uschi"))
    .with_offset("-05".parse().ok())
    .at_time((Date::try_new_iso(2022, 8, 29).unwrap(), Time::midnight()))
    .with_zone_variant(TimeZoneVariant::Daylight);

assert_writeable_eq!(
    fmt.format(&zone),
    "Central Time"
);

When a display name is unavailable, falls back to the location format:

use icu::datetime::input::Date;
use icu::datetime::input::{Time, TimeZone};
use icu::calendar::Gregorian;
use icu::datetime::FixedCalendarDateTimeFormatter;
use icu::datetime::fieldsets::zone::GenericShort;
use icu::locale::locale;
use tinystr::tinystr;
use writeable::assert_writeable_eq;

// Time zone info for Europe/Istanbul
let zone = TimeZone(tinystr!(8, "trist"))
    .without_offset()
    .at_time((Date::try_new_iso(2022, 1, 29).unwrap(), Time::midnight()));

let fmt = FixedCalendarDateTimeFormatter::<Gregorian, _>::try_new(
    locale!("en").into(),
    GenericShort,
)
.unwrap();

assert_writeable_eq!(
    fmt.format(&zone),
    "Türkiye Time"
);

Can also fall back to the UTC offset:

use icu::datetime::input::Date;
use icu::datetime::input::Time;
use icu::datetime::NoCalendarFormatter;
use icu::datetime::fieldsets::zone::GenericShort;
use icu::datetime::DateTimeWriteError;
use icu::locale::locale;
use icu::time::zone::IanaParser;
use tinystr::tinystr;
use writeable::assert_writeable_eq;

// Set up the formatter
let mut tzf = NoCalendarFormatter::try_new(
    locale!("en").into(),
    GenericShort,
)
.unwrap();

// "uschi" - has symbol data for short generic non-location
let time_zone = IanaParser::new()
    .parse("America/Chicago")
    .with_offset("-05".parse().ok())
    .at_time((Date::try_new_iso(2022, 8, 29).unwrap(), Time::midnight()));
assert_writeable_eq!(
    tzf.format(&time_zone),
    "CT"
);

// "ushnl" - has time zone override symbol data for short generic non-location
let time_zone = IanaParser::new()
    .parse("Pacific/Honolulu")
    .with_offset("-10".parse().ok())
    .at_time((Date::try_new_iso(2022, 8, 29).unwrap(), Time::midnight()));
assert_writeable_eq!(
    tzf.format(&time_zone),
    "HST"
);

// Mis-spelling of "America/Chicago" results in a fallback to offset format
let time_zone = IanaParser::new()
    .parse("America/Chigagou")
    .with_offset("-05".parse().ok())
    .at_time((Date::try_new_iso(2022, 8, 29).unwrap(), Time::midnight()));
assert_writeable_eq!(
    tzf.format(&time_zone),
    "GMT-5"
);

Since non-location names might change over time, this time zone style requires a reference time.

use icu::datetime::NoCalendarFormatter;
use icu::datetime::fieldsets::zone::GenericLong;
use icu::datetime::input::TimeZone;
use tinystr::tinystr;
use icu::locale::locale;
use writeable::assert_writeable_eq;

let time_zone_basic = TimeZone(tinystr!(8, "uschi")).without_offset();

let formatter = NoCalendarFormatter::try_new(
    locale!("en-US").into(),
    GenericLong,
)
.unwrap();

// error[E0271]: type mismatch resolving `<Base as TimeZoneModel>::LocalTime == (Date<Iso>, Time)`
// note: required by a bound in `NoCalendarFormatter::<C, FSet>::format`
formatter.format(&time_zone_basic);

Trait Implementations

impl Clone for GenericLong

fn clone(&self) -> GenericLong

Returns a copy of the value.

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

Performs copy-assignment from source.

impl DateTimeMarkers for GenericLong

type D = ()

Associated types for date formatting.

type T = ()

Associated types for time formatting.

type Z = GenericLong

Associated types for time zone formatting.

type GluePatternV1 = NeverMarker<GluePattern<'static>>

Marker for loading the date/time glue pattern.

impl DateTimeNamesMarker for GenericLong

type YearNames = ()

type MonthNames = ()

type WeekdayNames = ()

type DayPeriodNames = ()

type ZoneEssentials = TimeZoneEssentialsV1

type ZoneLocations = LocationsV1

type ZoneLocationsRoot = LocationsRootV1

type ZoneExemplars = ()

type ZoneExemplarsRoot = ()

type ZoneGenericLong = MetazoneGenericNamesLongV1

type ZoneGenericShort = ()

type ZoneStandardLong = MetazoneStandardNamesLongV1

type ZoneSpecificLong = ()

type ZoneSpecificShort = ()

type MetazoneLookup = MetazonePeriodV1

impl Debug for GenericLong

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

Formats the value using the given formatter.

impl GetField<CompositeFieldSet> for GenericLong

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl PartialEq for GenericLong

fn eq(&self, other: &GenericLong) -> 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 ZoneMarkers for GenericLong

type TimeZoneIdInput = TimeZone

Marker for resolving the time zone id input field.

type TimeZoneOffsetInput = Option<UtcOffset>

Marker for resolving the time zone offset input field.

type TimeZoneVariantInput = ()

Marker for resolving the time zone variant input field.

type TimeZoneLocalTimeInput = (Date<Iso>, Time)

Marker for resolving the time zone non-location display names, which depend on the datetime.

type EssentialsV1 = TimeZoneEssentialsV1

Marker for loading core time zone data.

type LocationsV1 = LocationsV1

Marker for loading location names for time zone formatting

type LocationsRootV1 = LocationsRootV1

Marker for loading location names for time zone formatting

type ExemplarCitiesV1 = NeverMarker<ExemplarCities<'static>>

Marker for loading exemplar city names for time zone formatting

type ExemplarCitiesRootV1 = NeverMarker<ExemplarCities<'static>>

Marker for loading exemplar city names for time zone formatting

type GenericLongV1 = MetazoneGenericNamesLongV1

Marker for loading generic long time zone names.

type GenericShortV1 = NeverMarker<MetazoneGenericNames<'static>>

Marker for loading generic short time zone names.

type StandardLongV1 = MetazoneStandardNamesLongV1

Marker for loading standard long time zone names.

type SpecificLongV1 = NeverMarker<MetazoneSpecificNames<'static>>

Marker for loading specific long time zone names.

type SpecificShortV1 = NeverMarker<MetazoneSpecificNames<'static>>

Marker for loading generic short time zone names.

type MetazonePeriodV1 = MetazonePeriodV1

Marker for loading metazone periods.

impl Copy for GenericLong

impl Eq for GenericLong

impl StructuralPartialEq for GenericLong

impl UnstableSealed for GenericLong