Enum icu_datetime::neo_skeleton::NeoDayComponents

#[non_exhaustive]
pub enum NeoDayComponents {
    Day,
    MonthDay,
    YearMonthDay,
    EraYearMonthDay,
    DayWeekday,
    MonthDayWeekday,
    YearMonthDayWeekday,
    EraYearMonthDayWeekday,
    Weekday,
    Auto,
    AutoWeekday,
}

A specification for a set of parts of a date that specifies a single day (as opposed to a whole month or a week). Only sets that yield “sensible” dates are allowed: this type cannot describe a date such as “some Tuesday in 2023”.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Day

The day of the month, as in “on the 1st”.

MonthDay

The month and day of the month, as in “January 1st”.

YearMonthDay

The year, month, and day of the month, as in “January 1st, 2000”.

EraYearMonthDay

The era, year, month, and day of the month, as in “January 1st, 2000 A.D.”.

DayWeekday

The day of the month and day of the week, as in “Saturday 1st”.

MonthDayWeekday

The month, day of the month, and day of the week, as in “Saturday, January 1st”.

YearMonthDayWeekday

The year, month, day of the month, and day of the week, as in “Saturday, January 1st, 2000”.

EraYearMonthDayWeekday

The era, year, month, day of the month, and day of the week, as in “Saturday, January 1st, 2000 A.D.”.

Weekday

The day of the week alone, as in “Saturday”.

Auto

Fields to represent the day chosen by locale.

These are the standard date patterns for types “long”, “medium”, and “short” as defined in UTS 35. For “full”, use AutoWeekday.

This is often, but not always, the same as YearMonthDay.

AutoWeekday

Fields to represent the day chosen by locale, hinting to also include a weekday field.

This is the standard date pattern for type “full”, extended with skeleton data in the short and medium forms.

This is often, but not always, the same as YearMonthDayWeekday.

Implementations

impl NeoDayComponents

pub const VALUES: &'static [Self] = _

All values of this enum.

pub const fn id_str(self) -> &'static DataMarkerAttributes

Returns a stable string identifying this set of components.

Encoding Details

The string is based roughly on the UTS 35 symbol table with the following exceptions:

1. Lowercase letters are chosen where there is no ambiguity: G becomes g*
2. Capitals are replaced with their lowercase and a number 0: M becomes m0
3. A single symbol is included for each component: length doesn’t matter
4. The “auto” style is represented as a1

* g represents a different field, but it is never used in skeleta.

Examples

use icu::datetime::neo_skeleton::NeoDayComponents;

assert_eq!(
    "gym0de",
    NeoDayComponents::EraYearMonthDayWeekday.id_str().as_str()
);

pub fn from_id_str(id_str: &DataMarkerAttributes) -> Option<Self>

Returns the set of components for the given stable string.

Examples

use icu::datetime::neo_skeleton::NeoDayComponents;
use icu_provider::prelude::*;

assert_eq!(
    NeoDayComponents::from_id_str(DataMarkerAttributes::from_str_or_panic("gym0de")),
    Some(NeoDayComponents::EraYearMonthDayWeekday)
);

pub fn has_full_year(self) -> bool

Whether this field set contains the full year / eras.

pub fn has_year(self) -> bool

Whether this field set contains the year.

pub fn has_month(self) -> bool

Whether this field set contains the month.

pub fn has_day(self) -> bool

Whether this field set contains the day of the month.

pub fn has_weekday(self) -> bool

Whether this field set contains the weekday.

Trait Implementations

impl Clone for NeoDayComponents

fn clone(&self) -> NeoDayComponents

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NeoDayComponents

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

Formats the value using the given formatter.

impl Hash for NeoDayComponents

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for NeoDayComponents

fn eq(&self, other: &NeoDayComponents) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for NeoDayComponents

impl Eq for NeoDayComponents

impl StructuralPartialEq for NeoDayComponents