Struct icu::datetime::fieldsets::O

#[non_exhaustive]
pub struct O {}

“GMT-05:00” ⇒ UTC offset, long length

Examples

use icu::calendar::{Date, Time};
use icu::timezone::{TimeZoneBcp47Id, TimeZoneInfo, UtcOffset, ZoneVariant};
use icu::datetime::TimeFormatter;
use icu::datetime::fieldsets::O;
use icu::locale::locale;
use tinystr::tinystr;
use writeable::assert_writeable_eq;

let fmt = TimeFormatter::try_new(
    locale!("en").into(),
   O::new(),
)
.unwrap();

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

assert_writeable_eq!(
    fmt.format(&zone),
   "GMT-05:00"
);

All shapes of time zones can be formatted with this style.

use icu::calendar::{Date, Time};
use icu::datetime::TimeFormatter;
use icu::datetime::fieldsets::O;
use icu::timezone::{TimeZoneBcp47Id, UtcOffset, ZoneVariant};
use tinystr::tinystr;
use icu::locale::locale;
use writeable::assert_writeable_eq;

let utc_offset = "-06".parse().unwrap();
let time_zone_basic = TimeZoneBcp47Id(tinystr!(8, "uschi")).with_offset(Some(utc_offset));

let date = Date::try_new_iso(2024, 10, 18).unwrap();
let time = Time::midnight();
let time_zone_at_time = time_zone_basic.at_time((date, time));

let time_zone_full = time_zone_at_time.with_zone_variant(ZoneVariant::Standard);

let formatter = TimeFormatter::try_new(
    locale!("en-US").into(),
    O::new(),
)
.unwrap();

assert_writeable_eq!(
    formatter.format(&utc_offset),
    "GMT-06:00"
);

assert_writeable_eq!(
    formatter.format(&time_zone_basic),
    "GMT-06:00"
);

assert_writeable_eq!(
    formatter.format(&time_zone_at_time),
    "GMT-06:00"
);

assert_writeable_eq!(
    formatter.format(&time_zone_full),
    "GMT-06:00"
);

Implementations

impl O

pub const fn new() -> O

Creates a new field set with default options.

Trait Implementations

impl Clone for O

fn clone(&self) -> O

Returns a copy of the value.

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

Performs copy-assignment from source.

impl DateTimeMarkers for O

type D = ()

Associated types for date formatting.

type T = ()

Associated types for time formatting.

type Z = O

Associated types for time zone formatting.

type GluePatternV1Marker = NeverMarker<GluePatternV1<'static>>

Marker for loading the date/time glue pattern.

impl DateTimeNamesMarker for O

type YearNames = ()

type MonthNames = ()

type WeekdayNames = ()

type DayPeriodNames = ()

type ZoneEssentials = TimeZoneEssentialsV1Marker

type ZoneLocations = ()

type ZoneGenericLong = ()

type ZoneGenericShort = ()

type ZoneSpecificLong = ()

type ZoneSpecificShort = ()

type MetazoneLookup = ()

impl Debug for O

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

Formats the value using the given formatter.

impl Default for O

fn default() -> O

Returns the “default value” for a type.

impl GetField<CompositeFieldSet> for O

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl PartialEq for O

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

type TimeZoneIdInput = ()

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 = ()

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

type EssentialsV1Marker = TimeZoneEssentialsV1Marker

Marker for loading core time zone data.

type LocationsV1Marker = NeverMarker<LocationsV1<'static>>

Marker for loading location names for time zone formatting

type GenericLongV1Marker = NeverMarker<MetazoneGenericNamesV1<'static>>

Marker for loading generic long time zone names.

type GenericShortV1Marker = NeverMarker<MetazoneGenericNamesV1<'static>>

Marker for loading generic short time zone names.

type SpecificLongV1Marker = NeverMarker<MetazoneSpecificNamesV1<'static>>

Marker for loading specific long time zone names.

type SpecificShortV1Marker = NeverMarker<MetazoneSpecificNamesV1<'static>>

Marker for loading generic short time zone names.

type MetazonePeriodV1Marker = NeverMarker<MetazonePeriodV1<'static>>

Marker for loading metazone periods.

impl Copy for O

impl Eq for O

impl StructuralPartialEq for O

impl UnstableSealed for O