Struct icu::datetime::fieldsets::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::fieldsets::{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::fieldsets::{Combo, ET, L};
use icu::datetime::DateTimeFormatter;
use icu::locale::locale;
use icu::timezone::IxdtfParser;
use writeable::assert_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_writeable_eq!(
    formatter.format_any_calendar(&zdt),
    "Fri, 3:44 PM Los Angeles Time"
);

Same thing with a fixed calendar formatter:

use icu::calendar::Gregorian;
use icu::datetime::fieldsets::{Combo, ET, L};
use icu::datetime::FixedCalendarDateTimeFormatter;
use icu::locale::locale;
use icu::timezone::IxdtfParser;
use writeable::assert_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_writeable_eq!(
    formatter.format(&zdt),
    "Fri, 3:44 PM Los Angeles Time"
);

Mix a dynamic DateFieldSet with a static time zone:

use icu::datetime::fieldsets::{Combo, YMD, Vs, enums::DateFieldSet};
use icu::datetime::DateTimeFormatter;
use icu::locale::locale;
use icu::timezone::IxdtfParser;
use writeable::assert_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_writeable_eq!(
    formatter.format_any_calendar(&zdt),
    "October 18, 2024 PT"
);

Implementations

impl<Z> Combo<D, Z>

pub fn with_length(length: Length) -> Combo<D, Z>

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

pub const fn long() -> Combo<D, Z>

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

pub const fn medium() -> Combo<D, Z>

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

pub const fn short() -> Combo<D, Z>

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

impl<Z> Combo<DT, Z>

pub fn with_length(length: Length) -> Combo<DT, Z>

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

pub const fn long() -> Combo<DT, Z>

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

pub const fn medium() -> Combo<DT, Z>

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

pub const fn short() -> Combo<DT, Z>

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

impl<Z> Combo<E, Z>

pub fn with_length(length: Length) -> Combo<E, Z>

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

pub const fn long() -> Combo<E, Z>

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

pub const fn medium() -> Combo<E, Z>

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

pub const fn short() -> Combo<E, Z>

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

impl<Z> Combo<ET, Z>

pub fn with_length(length: Length) -> Combo<ET, Z>

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

pub const fn long() -> Combo<ET, Z>

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

pub const fn medium() -> Combo<ET, Z>

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

pub const fn short() -> Combo<ET, Z>

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

impl<Z> Combo<DE, Z>

pub fn with_length(length: Length) -> Combo<DE, Z>

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

pub const fn long() -> Combo<DE, Z>

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

pub const fn medium() -> Combo<DE, Z>

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

pub const fn short() -> Combo<DE, Z>

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

impl<Z> Combo<DET, Z>

pub fn with_length(length: Length) -> Combo<DET, Z>

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

pub const fn long() -> Combo<DET, Z>

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

pub const fn medium() -> Combo<DET, Z>

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

pub const fn short() -> Combo<DET, Z>

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

impl<Z> Combo<MD, Z>

pub fn with_length(length: Length) -> Combo<MD, Z>

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

pub const fn long() -> Combo<MD, Z>

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

pub const fn medium() -> Combo<MD, Z>

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

pub const fn short() -> Combo<MD, Z>

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

impl<Z> Combo<MDT, Z>

pub fn with_length(length: Length) -> Combo<MDT, Z>

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

pub const fn long() -> Combo<MDT, Z>

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

pub const fn medium() -> Combo<MDT, Z>

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

pub const fn short() -> Combo<MDT, Z>

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

impl<Z> Combo<MDE, Z>

pub fn with_length(length: Length) -> Combo<MDE, Z>

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

pub const fn long() -> Combo<MDE, Z>

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

pub const fn medium() -> Combo<MDE, Z>

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

pub const fn short() -> Combo<MDE, Z>

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

impl<Z> Combo<MDET, Z>

pub fn with_length(length: Length) -> Combo<MDET, Z>

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

pub const fn long() -> Combo<MDET, Z>

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

pub const fn medium() -> Combo<MDET, Z>

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

pub const fn short() -> Combo<MDET, Z>

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

impl<Z> Combo<YMD, Z>

pub fn with_length(length: Length) -> Combo<YMD, Z>

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

pub const fn long() -> Combo<YMD, Z>

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

pub const fn medium() -> Combo<YMD, Z>

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

pub const fn short() -> Combo<YMD, Z>

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

impl<Z> Combo<YMDT, Z>

pub fn with_length(length: Length) -> Combo<YMDT, Z>

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

pub const fn long() -> Combo<YMDT, Z>

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

pub const fn medium() -> Combo<YMDT, Z>

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

pub const fn short() -> Combo<YMDT, Z>

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

impl<Z> Combo<YMDE, Z>

pub fn with_length(length: Length) -> Combo<YMDE, Z>

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

pub const fn long() -> Combo<YMDE, Z>

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

pub const fn medium() -> Combo<YMDE, Z>

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

pub const fn short() -> Combo<YMDE, Z>

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

impl<Z> Combo<YMDET, Z>

pub fn with_length(length: Length) -> Combo<YMDET, Z>

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

pub const fn long() -> Combo<YMDET, Z>

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

pub const fn medium() -> Combo<YMDET, Z>

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

pub const fn short() -> Combo<YMDET, Z>

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

impl<Z> Combo<T, Z>

pub fn with_length(length: Length) -> Combo<T, Z>

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

pub const fn long() -> Combo<T, Z>

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

pub const fn medium() -> Combo<T, Z>

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

pub const fn short() -> Combo<T, Z>

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

Trait Implementations

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

where DT: Clone, Z: Clone,

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, Z> Debug for Combo<DT, Z>

where DT: Debug, Z: Debug,

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

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, Z> PartialEq for Combo<DT, Z>

where DT: PartialEq, Z: PartialEq,

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, Z> Copy for Combo<DT, Z>

where DT: Copy, Z: Copy,

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

where DT: Eq, Z: Eq,

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

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