Struct icu_datetime::neo_marker::NeoYearMonthMarker

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

“May 2024” ⇒ year and month (era elided when possible)

Examples

In NeoFormatter:

use icu::calendar::Date;
use icu::datetime::neo::NeoFormatter;
use icu::datetime::neo_marker::NeoYearMonthMarker;
use icu::datetime::neo_skeleton::NeoSkeletonLength;
use icu::locale::locale;
use writeable::assert_try_writeable_eq;
let fmt = NeoFormatter::<NeoYearMonthMarker>::try_new(
    &locale!("en").into(),
   NeoYearMonthMarker::with_length(NeoSkeletonLength::Medium),
)
.unwrap();
let dt = Date::try_new_iso(2024, 5, 17).unwrap();

assert_try_writeable_eq!(
    fmt.convert_and_format(&dt),
   "May 2024"
);

In TypedNeoFormatter:

use icu::calendar::Date;
use icu::calendar::Gregorian;
use icu::datetime::neo::TypedNeoFormatter;
use icu::datetime::neo_marker::NeoYearMonthMarker;
use icu::datetime::neo_skeleton::NeoSkeletonLength;
use icu::locale::locale;
use writeable::assert_try_writeable_eq;

let fmt = TypedNeoFormatter::<Gregorian, NeoYearMonthMarker>::try_new(
    &locale!("en").into(),
   NeoYearMonthMarker::with_length(NeoSkeletonLength::Medium),
)
.unwrap();
let dt = Date::try_new_gregorian(2024, 5, 17).unwrap();

assert_try_writeable_eq!(
    fmt.format(&dt),
   "May 2024"
);

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

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 NeoYearMonthMarker

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

Creates a NeoYearMonthMarker skeleton with the given formatting length.

impl NeoYearMonthMarker

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

Sets the alignment option.

impl NeoYearMonthMarker

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

Sets the year style option.

Trait Implementations

impl DateDataMarkers for NeoYearMonthMarker

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 NeoYearMonthMarker

type YearInput = YearInfo

Marker for resolving the year input field.

type MonthInput = MonthInfo

Marker for resolving the month input field.

type DayOfMonthInput = ()

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

type DayOfWeekInput = ()

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

type AnyCalendarKindInput = AnyCalendarKind

Marker for resolving the any-calendar-kind input field.

impl DateTimeMarkers for NeoYearMonthMarker

type D = NeoYearMonthMarker

Associated types for date formatting.

type T = NeoNeverMarker

Associated types for time formatting.

type Z = NeoNeverMarker

Associated types for time zone formatting.

type LengthOption = NeoSkeletonLength

Type of the length option in the constructor.

type AlignmentOption = Option<Alignment>

Type of the alignment option in the constructor.

type YearStyleOption = Option<YearStyle>

Type of the year style option in the constructor.

type FractionalSecondDigitsOption = ()

Type of the fractional seconds display option in the constructor.

type GluePatternV1Marker = NeverMarker<GluePatternV1<'static>>

Marker for loading the date/time glue pattern.

impl Debug for NeoYearMonthMarker

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

Formats the value using the given formatter.

impl GetField<()> for NeoYearMonthMarker

fn get_field(&self)

Returns the value of this trait’s field T.

impl GetField<NeoSkeletonLength> for NeoYearMonthMarker

fn get_field(&self) -> NeoSkeletonLength

Returns the value of this trait’s field T.

impl GetField<Option<Alignment>> for NeoYearMonthMarker

fn get_field(&self) -> Option<Alignment>

Returns the value of this trait’s field T.

impl GetField<Option<YearStyle>> for NeoYearMonthMarker

fn get_field(&self) -> Option<YearStyle>

Returns the value of this trait’s field T.

impl HasConstComponents for NeoYearMonthMarker

const COMPONENTS: NeoComponents = _

The associated components.

impl<C: CldrCalendar> TypedDateDataMarkers<C> for NeoYearMonthMarker

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 UnstableSealed for NeoYearMonthMarker