Struct MDT

#[non_exhaustive]
pub struct MDT {
    pub length: Length,
    pub alignment: Option<Alignment>,
    pub time_precision: Option<TimePrecision>,
}

“May 17, 3:47:50 PM” ⇒ month and day with time

Examples

In DateTimeFormatter:

use icu::datetime::input::Date;
use icu::datetime::DateTimeFormatter;
use icu::datetime::fieldsets::MDT;
use icu::locale::locale;
use icu::datetime::input::{DateTime, Time};
use writeable::assert_writeable_eq;

let fmt = DateTimeFormatter::try_new(
    locale!("en").into(),
   MDT::medium(),
)
.unwrap();
let dt = DateTime { date: Date::try_new_iso(2024, 5, 17).unwrap(), time: Time::try_new(15, 47, 50, 0).unwrap() };

assert_writeable_eq!(
    fmt.format(&dt),
   "May 17, 3:47:50 PM"
);

In FixedCalendarDateTimeFormatter:

use icu::datetime::input::Date;
use icu::calendar::Gregorian;
use icu::datetime::FixedCalendarDateTimeFormatter;
use icu::datetime::fieldsets::MDT;
use icu::locale::locale;
use icu::datetime::input::{DateTime, Time};
use writeable::assert_writeable_eq;

let fmt = FixedCalendarDateTimeFormatter::try_new(
    locale!("en").into(),
   MDT::medium(),
)
.unwrap();
let dt = DateTime { date: Date::try_new_gregorian(2024, 5, 17).unwrap(), time: Time::try_new(15, 47, 50, 0).unwrap() };

assert_writeable_eq!(
    fmt.format(&dt),
   "May 17, 3:47:50 PM"
);

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

time_precision: Option<TimePrecision>

How precisely to display the time of day

See: TimePrecision

Implementations

impl MDT

pub const fn with_length(self, length: Length) -> MDT

Sets the length option.

impl MDT

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

Sets the alignment option.

impl MDT

pub const fn with_time_precision(self, time_precision: TimePrecision) -> MDT

Sets the time precision option.

impl MDT

pub const fn for_length(length: Length) -> MDT

Creates a MDT skeleton with the given formatting length.

pub const fn long() -> MDT

Creates a MDT skeleton with a long length.

pub const fn medium() -> MDT

Creates a MDT skeleton with a medium length.

pub const fn short() -> MDT

Creates a MDT skeleton with a short length.

impl MDT

pub fn with_zone<Z>(self, zone: Z) -> Combo<MDT, Z>

where Z: ZoneMarkers,

Associates this field set with a time zone field set.

Trait Implementations

impl Clone for MDT

fn clone(&self) -> MDT

Returns a copy of the value.

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

Performs copy-assignment from source.

impl DateDataMarkers for MDT

type Skel = FullDataCalMarkers

Cross-calendar data markers for date skeleta.

type Year = NoDataCalMarkers

Cross-calendar data markers for year names.

type Month = FullDataCalMarkers

Cross-calendar data markers for month names.

type WeekdayNamesV1 = NeverMarker<LinearNames<'static>>

Marker for loading weekday names.

impl DateInputMarkers for MDT

type YearInput = ()

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 MDT

type D = MDT

Associated types for date formatting.

type T = MDT

Associated types for time formatting.

type Z = ()

Associated types for time zone formatting.

type GluePatternV1 = DatetimePatternsGlueV1

Marker for loading the date/time glue pattern.

impl DateTimeNamesMarker for MDT

type YearNames = ()

type MonthNames = MonthNamesV1

type WeekdayNames = ()

type DayPeriodNames = DatetimeNamesDayperiodV1

type ZoneEssentials = ()

type ZoneLocations = ()

type ZoneLocationsRoot = ()

type ZoneExemplars = ()

type ZoneExemplarsRoot = ()

type ZoneGenericLong = ()

type ZoneGenericShort = ()

type ZoneStandardLong = ()

type ZoneSpecificLong = ()

type ZoneSpecificShort = ()

type MetazoneLookup = ()

impl Debug for MDT

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

Formats the value using the given formatter.

impl GetField<CompositeFieldSet> for MDT

fn get_field(&self) -> CompositeFieldSet

Returns the value of this trait’s field T.

impl PartialEq for MDT

fn eq(&self, other: &MDT) -> 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 TimeMarkers for MDT

type DayPeriodNamesV1 = DatetimeNamesDayperiodV1

Marker for loading day period names.

type TimeSkeletonPatternsV1 = DatetimePatternsTimeV1

Marker for loading time skeleton patterns.

type HourInput = Hour

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

type MinuteInput = Minute

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

type SecondInput = Second

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

type NanosecondInput = Nanosecond

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

impl<C> TypedDateDataMarkers<C> for MDT

where C: CldrCalendar,

type DateSkeletonPatternsV1 = <C as CldrCalendar>::SkeletaV1

Marker for loading date skeleton patterns.

type YearNamesV1 = NeverMarker<YearNames<'static>>

Marker for loading year names.

type MonthNamesV1 = <C as CldrCalendar>::MonthNamesV1

Marker for loading month names.

type WeekdayNamesV1 = NeverMarker<LinearNames<'static>>

Marker for loading weekday names.

impl Copy for MDT

impl Eq for MDT

impl StructuralPartialEq for MDT

impl UnstableSealed for MDT