Struct icu_datetime::fieldset::Vs

#[non_exhaustive]
pub struct Vs {
    pub length: NeoSkeletonLength,
}

“CT” ⇒ time zone in generic non-location format (only short)

This field set can be used only in combination with others.

Examples

In DateTimeFormatter:

 use icu::calendar::{Date, Time};
 use icu::timezone::{TimeZoneBcp47Id, TimeZoneInfo, UtcOffset, ZoneVariant};
 use icu::datetime::DateTimeFormatter;
use icu::datetime::fieldset::Vs;
 use icu::locale::locale;
 use tinystr::tinystr;
 use writeable::assert_try_writeable_eq;

let fmt = DateTimeFormatter::<Vs>::try_new(
     &locale!("en").into(),
    Vs::short(),
 )
 .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_try_writeable_eq!(
     fmt.convert_and_format(&zone),
    "CT"
 );

In FixedCalendarDateTimeFormatter:

 use icu::calendar::{Date, Time};
 use icu::timezone::{TimeZoneBcp47Id, TimeZoneInfo, UtcOffset, ZoneVariant};
 use icu::calendar::Gregorian;
 use icu::datetime::FixedCalendarDateTimeFormatter;
use icu::datetime::fieldset::Vs;
 use icu::locale::locale;
 use tinystr::tinystr;
 use writeable::assert_try_writeable_eq;

let fmt = FixedCalendarDateTimeFormatter::<Gregorian, Vs>::try_new(
     &locale!("en").into(),
    Vs::short(),
 )
 .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_try_writeable_eq!(
     fmt.format(&zone),
    "CT"
 );

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

use icu::calendar::{DateTime, Iso};
use icu::datetime::FixedCalendarDateTimeFormatter;
use icu::datetime::fieldset::Vs;
use icu::timezone::{TimeZoneBcp47Id, UtcOffset};
use tinystr::tinystr;
use icu::locale::locale;
use writeable::assert_try_writeable_eq;

let time_zone_basic = TimeZoneBcp47Id(tinystr!(8, "uschi")).with_offset("-06".parse().ok());1

let formatter = FixedCalendarDateTimeFormatter::try_new(
    &locale!("en-US").into(),
    Vs::medium(),
)
.unwrap();

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

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

length: NeoSkeletonLength

The desired length of the formatted string.

See: NeoSkeletonLength

Implementations

impl Vs

pub const fn with_length(length: NeoSkeletonLength) -> Self

Creates a Vs skeleton with the given formatting length.

pub const fn long() -> Self

Creates a Vs skeleton with a long length.

pub const fn medium() -> Self

Creates a Vs skeleton with a medium length.

pub const fn short() -> Self

Creates a Vs skeleton with a short length.

Trait Implementations

impl Clone for Vs

fn clone(&self) -> Vs

Returns a copy of the value.

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

Performs copy-assignment from source.

impl DateTimeMarkers for Vs

type D = NeoNeverMarker

Associated types for date formatting.

type T = NeoNeverMarker

Associated types for time formatting.

type Z = Vs

Associated types for time zone formatting.

type GluePatternV1Marker = NeverMarker<GluePatternV1<'static>>

Marker for loading the date/time glue pattern.

impl Debug for Vs

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

Formats the value using the given formatter.

impl GetField<()> for Vs

fn get_field(&self)

Returns the value of this trait’s field T.

impl GetField<NeoSkeletonLength> for Vs

fn get_field(&self) -> NeoSkeletonLength

Returns the value of this trait’s field T.

impl PartialEq for Vs

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

type TimeZoneIdInput = TimeZoneBcp47Id

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 EssentialsV1Marker = TimeZoneEssentialsV1Marker

Marker for loading core time zone data.

type LocationsV1Marker = LocationsV1Marker

Marker for loading location names for time zone formatting

type GenericLongV1Marker = NeverMarker<MetazoneGenericNamesV1<'static>>

Marker for loading generic long time zone names.

type GenericShortV1Marker = MetazoneGenericNamesShortV1Marker

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 = MetazonePeriodV1Marker

Marker for loading metazone periods.

impl Copy for Vs

impl Eq for Vs

impl StructuralPartialEq for Vs

impl UnstableSealed for Vs