Struct icu_datetime::fieldset::Combo

pub struct Combo<DT, Z> { /* private fields */ }

Struct for combining date/time fields with zone fields.

This struct produces “composite field sets” as defined in UTS 35.

Examples

Two ways to construct the same combo field set (in this case, weekday with location-based zone):

use icu::datetime::fieldset::{Combo, E, L};

let field_set_1 = E::long().zone_l();
let field_set_2 = Combo::<E, L>::long();

assert_eq!(field_set_1, field_set_2);

Format the weekday, hour, and location-based zone:

use icu::datetime::fieldset::{Combo, ET, L};
use icu::datetime::DateTimeFormatter;
use icu::locale::locale;
use icu::timezone::IxdtfParser;
use writeable::assert_try_writeable_eq;

// Note: Combo type can be elided, but it is shown here for demonstration
let formatter = DateTimeFormatter::<Combo<ET, L>>::try_new(
    &locale!("en-US").into(),
    ET::short().hm().zone_l(),
)
.unwrap();

let zdt = IxdtfParser::new().try_location_only_from_str(
    "2024-10-18T15:44[America/Los_Angeles]",
)
.unwrap();

assert_try_writeable_eq!(
    formatter.convert_and_format(&zdt),
    "Fri, 3:44 PM Los Angeles Time"
);

Same thing with a fixed calendar formatter:

use icu::calendar::Gregorian;
use icu::datetime::fieldset::{Combo, ET, L};
use icu::datetime::FixedCalendarDateTimeFormatter;
use icu::locale::locale;
use icu::timezone::IxdtfParser;
use writeable::assert_try_writeable_eq;

// Note: Combo type can be elided, but it is shown here for demonstration
let formatter = FixedCalendarDateTimeFormatter::<_, Combo<ET, L>>::try_new(
    &locale!("en-US").into(),
    ET::short().hm().zone_l(),
)
.unwrap();

let zdt = IxdtfParser::new().try_location_only_iso_from_str(
    "2024-10-18T15:44[America/Los_Angeles]",
)
.unwrap()
.to_calendar(Gregorian);

assert_try_writeable_eq!(
    formatter.format(&zdt),
    "Fri, 3:44 PM Los Angeles Time"
);

Mix a dynamic DateFieldSet with a static time zone:

use icu::datetime::fieldset::{Combo, YMD, Vs, dynamic::DateFieldSet};
use icu::datetime::DateTimeFormatter;
use icu::locale::locale;
use icu::timezone::IxdtfParser;
use writeable::assert_try_writeable_eq;

// Note: Combo type can be elided, but it is shown here for demonstration
let formatter = DateTimeFormatter::<Combo<DateFieldSet, Vs>>::try_new(
    &locale!("en-US").into(),
    DateFieldSet::YMD(YMD::long()).zone_v(),
)
.unwrap();

let zdt = IxdtfParser::new().try_location_only_from_str(
    "2024-10-18T15:44[America/Los_Angeles]",
)
.unwrap();

assert_try_writeable_eq!(
    formatter.convert_and_format(&zdt),
    "October 18, 2024 PT"
);

Implementations

impl<Z> Combo<D, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a D skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a D skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a D skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a D skeleton with a short length and a time zone.

impl<Z> Combo<DT, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a DT skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a DT skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a DT skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a DT skeleton with a short length and a time zone.

impl<Z> Combo<E, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a E skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a E skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a E skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a E skeleton with a short length and a time zone.

impl<Z> Combo<ET, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a ET skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a ET skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a ET skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a ET skeleton with a short length and a time zone.

impl<Z> Combo<DE, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a DE skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a DE skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a DE skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a DE skeleton with a short length and a time zone.

impl<Z> Combo<DET, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a DET skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a DET skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a DET skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a DET skeleton with a short length and a time zone.

impl<Z> Combo<MD, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a MD skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a MD skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a MD skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a MD skeleton with a short length and a time zone.

impl<Z> Combo<MDT, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a MDT skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a MDT skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a MDT skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a MDT skeleton with a short length and a time zone.

impl<Z> Combo<MDE, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a MDE skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a MDE skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a MDE skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a MDE skeleton with a short length and a time zone.

impl<Z> Combo<MDET, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a MDET skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a MDET skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a MDET skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a MDET skeleton with a short length and a time zone.

impl<Z> Combo<YMD, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a YMD skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a YMD skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a YMD skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a YMD skeleton with a short length and a time zone.

impl<Z> Combo<YMDT, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a YMDT skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a YMDT skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a YMDT skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a YMDT skeleton with a short length and a time zone.

impl<Z> Combo<YMDE, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a YMDE skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a YMDE skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a YMDE skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a YMDE skeleton with a short length and a time zone.

impl<Z> Combo<YMDET, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a YMDET skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a YMDET skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a YMDET skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a YMDET skeleton with a short length and a time zone.

impl<Z> Combo<T, Z>

pub fn with_length(length: NeoSkeletonLength) -> Self

Creates a T skeleton with the given formatting length and a time zone.

pub const fn long() -> Self

Creates a T skeleton with a long length and a time zone.

pub const fn medium() -> Self

Creates a T skeleton with a medium length and a time zone.

pub const fn short() -> Self

Creates a T skeleton with a short length and a time zone.

Trait Implementations

impl<DT: Clone, Z: Clone> Clone for Combo<DT, Z>

fn clone(&self) -> Combo<DT, Z>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<DT, Z> DateTimeMarkers for Combo<DT, Z>

where DT: DateTimeMarkers, Z: DateTimeMarkers,

type D = <DT as DateTimeMarkers>::D

Associated types for date formatting.

type T = <DT as DateTimeMarkers>::T

Associated types for time formatting.

type Z = <Z as DateTimeMarkers>::Z

Associated types for time zone formatting.

type GluePatternV1Marker = GluePatternV1Marker

Marker for loading the date/time glue pattern.

impl<DT, Z> DateTimeNamesMarker for Combo<DT, Z>

where DT: DateTimeNamesMarker, Z: DateTimeNamesMarker,

type YearNames = <DT as DateTimeNamesMarker>::YearNames

type MonthNames = <DT as DateTimeNamesMarker>::MonthNames

type WeekdayNames = <DT as DateTimeNamesMarker>::WeekdayNames

type DayPeriodNames = <DT as DateTimeNamesMarker>::DayPeriodNames

type ZoneEssentials = <Z as DateTimeNamesMarker>::ZoneEssentials

type ZoneLocations = <Z as DateTimeNamesMarker>::ZoneLocations

type ZoneGenericLong = <Z as DateTimeNamesMarker>::ZoneGenericLong

type ZoneGenericShort = <Z as DateTimeNamesMarker>::ZoneGenericShort

type ZoneSpecificLong = <Z as DateTimeNamesMarker>::ZoneSpecificLong

type ZoneSpecificShort = <Z as DateTimeNamesMarker>::ZoneSpecificShort

type MetazoneLookup = <Z as DateTimeNamesMarker>::MetazoneLookup

impl<DT: Debug, Z: Debug> Debug for Combo<DT, Z>

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

Formats the value using the given formatter.

impl GetField<CompositeFieldSet> for Combo<D, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<D, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<D, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<D, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DE, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DE, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DE, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DE, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DET, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DET, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DET, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DET, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DT, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DT, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DT, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DT, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DateAndTimeFieldSet, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DateAndTimeFieldSet, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DateAndTimeFieldSet, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DateAndTimeFieldSet, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DateFieldSet, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DateFieldSet, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DateFieldSet, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<DateFieldSet, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<E, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<E, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<E, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<E, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<ET, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<ET, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<ET, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<ET, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MD, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MD, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MD, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MD, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MDE, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MDE, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MDE, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MDE, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MDET, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MDET, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MDET, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MDET, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MDT, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MDT, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MDT, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<MDT, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<T, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<T, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<T, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<T, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<TimeFieldSet, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<TimeFieldSet, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<TimeFieldSet, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<TimeFieldSet, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMD, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMD, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMD, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMD, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMDE, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMDE, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMDE, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMDE, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMDET, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMDET, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMDET, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMDET, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMDT, L>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMDT, O>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMDT, Vs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl GetField<CompositeFieldSet> for Combo<YMDT, Zs>

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl<DT: PartialEq, Z: PartialEq> PartialEq for Combo<DT, Z>

fn eq(&self, other: &Combo<DT, Z>) -> 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<DT: Copy, Z: Copy> Copy for Combo<DT, Z>

impl<DT: Eq, Z: Eq> Eq for Combo<DT, Z>

impl<DT, Z> StructuralPartialEq for Combo<DT, Z>

impl<DT, Z> UnstableSealed for Combo<DT, Z>