Struct icu_datetime::fieldsets::YMD

#[non_exhaustive]
pub struct YMD {
    pub length: Length,
    pub alignment: Option<Alignment>,
    pub year_style: Option<YearStyle>,
}

“5/17/24” ⇒ year, month, and day

This is a field set marker. For more information, see fieldsets.

Examples

In DateTimeFormatter:

use icu::calendar::Date;
use icu::datetime::DateTimeFormatter;
use icu::datetime::fieldsets::YMD;
use icu::locale::locale;
use writeable::assert_writeable_eq;
let fmt = DateTimeFormatter::<YMD>::try_new(
    locale!("en").into(),
   YMD::short(),
)
.unwrap();
let dt = Date::try_new_iso(2024, 5, 17).unwrap();

assert_writeable_eq!(
    fmt.format_any_calendar(&dt),
   "5/17/24"
);

In FixedCalendarDateTimeFormatter:

use icu::calendar::Date;
use icu::calendar::Gregorian;
use icu::datetime::FixedCalendarDateTimeFormatter;
use icu::datetime::fieldsets::YMD;
use icu::locale::locale;
use writeable::assert_writeable_eq;

let fmt = FixedCalendarDateTimeFormatter::<Gregorian, YMD>::try_new(
    locale!("en").into(),
   YMD::short(),
)
.unwrap();
let dt = Date::try_new_gregorian(2024, 5, 17).unwrap();

assert_writeable_eq!(
    fmt.format(&dt),
   "5/17/24"
);

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: Length

The desired length of the formatted string.

See: Length

alignment: Option<Alignment>

Whether fields should be aligned for a column-like layout.

See: Alignment

year_style: Option<YearStyle>

When to display the era field in the formatted string.

See: YearStyle

Implementations

impl YMD

pub const fn with_alignment(self, alignment: Alignment) -> Self

Sets the alignment option.

impl YMD

pub const fn with_year_style(self, year_style: YearStyle) -> Self

Sets the year style option.

impl YMD

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

Creates a YMD skeleton with the given formatting length.

pub const fn long() -> Self

Creates a YMD skeleton with a long length.

pub const fn medium() -> Self

Creates a YMD skeleton with a medium length.

pub const fn short() -> Self

Creates a YMD skeleton with a short length.

impl YMD

pub fn with_zone_specific_long(self) -> Combo<Self, Z>

Associates this field set with a long specific non-location format time zone, as in “Pacific Daylight Time”.

pub fn with_zone_specific(self) -> Combo<Self, Zs>

Associates this field set with a short specific non-location format time zone, as in “PDT”.

pub fn with_zone_offset_long(self) -> Combo<Self, O>

Associates this field set with a long offset format time zone, as in “GMT−08:00”.

pub fn with_zone_offset(self) -> Combo<Self, Os>

Associates this field set with a short offset format time zone, as in “GMT−8”.

pub fn with_zone_generic_long(self) -> Combo<Self, V>

Associates this field set with a long generic non-location format time zone, as in “Pacific Time”.

pub fn with_zone_generic(self) -> Combo<Self, Vs>

Associates this field set with a short generic non-location format time zone, as in “PT”.

pub fn with_zone_location(self) -> Combo<Self, L>

Associates this field set with a location format time zone, as in “Los Angeles time”.

Trait Implementations

impl Clone for YMD

fn clone(&self) -> YMD

Returns a copy of the value.

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

Performs copy-assignment from source.

impl DateDataMarkers for YMD

type Skel = FullDataCalMarkers

Cross-calendar data markers for date skeleta.

type Year = FullDataCalMarkers

Cross-calendar data markers for year names.

type Month = FullDataCalMarkers

Cross-calendar data markers for month names.

type WeekdayNamesV1Marker = NeverMarker<LinearNamesV1<'static>>

Marker for loading weekday names.

impl DateInputMarkers for YMD

type YearInput = YearInfo

Marker for resolving the year input field.

type MonthInput = MonthInfo

Marker for resolving the month input field.

type DayOfMonthInput = DayOfMonth

Marker for resolving the day-of-month input field.

type DayOfYearInput = ()

Marker for resolving the day-of-year input field.

type DayOfWeekInput = ()

Marker for resolving the day-of-week input field.

impl DateTimeMarkers for YMD

type D = YMD

Associated types for date formatting.

type T = ()

Associated types for time formatting.

type Z = ()

Associated types for time zone formatting.

type GluePatternV1Marker = NeverMarker<GluePatternV1<'static>>

Marker for loading the date/time glue pattern.

impl DateTimeNamesMarker for YMD

type YearNames = YearNamesV1Marker

type MonthNames = MonthNamesV1Marker

type WeekdayNames = ()

type DayPeriodNames = ()

type ZoneEssentials = ()

type ZoneLocations = ()

type ZoneGenericLong = ()

type ZoneGenericShort = ()

type ZoneSpecificLong = ()

type ZoneSpecificShort = ()

type MetazoneLookup = ()

impl Debug for YMD

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

Formats the value using the given formatter.

impl GetField<CompositeFieldSet> for YMD

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl PartialEq for YMD

fn eq(&self, other: &YMD) -> 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<C: CldrCalendar> TypedDateDataMarkers<C> for YMD

type DateSkeletonPatternsV1Marker = <C as CldrCalendar>::SkeletaV1Marker

Marker for loading date skeleton patterns.

type YearNamesV1Marker = <C as CldrCalendar>::YearNamesV1Marker

Marker for loading year names.

type MonthNamesV1Marker = <C as CldrCalendar>::MonthNamesV1Marker

Marker for loading month names.

type WeekdayNamesV1Marker = NeverMarker<LinearNamesV1<'static>>

Marker for loading weekday names.

impl Copy for YMD

impl Eq for YMD

impl StructuralPartialEq for YMD

impl UnstableSealed for YMD