Struct FixedCalendarDateRangeFormatter 

pub struct FixedCalendarDateRangeFormatter<C: CldrCalendar, FSet: DateTimeNamesMarker> { /* private fields */ }

A formatter capable of formatting date/time ranges for a specific calendar.

This formatter is statically typed to a specific calendar C. It is highly optimized and avoids the overhead of dynamic calendar conversion, but can only format dates that are in the calendar C (or can be statically converted to it).

Examples

use icu::calendar::Date;
use icu::datetime::input::{DateTime, Time};
use icu::datetime::fieldsets::YMD;
use icu::datetime::range::FixedCalendarDateRangeFormatter;
use icu::locale::locale;
use writeable::assert_writeable_eq;

let fmt = FixedCalendarDateRangeFormatter::try_new(
    locale!("en").into(),
    YMD::medium(),
)
.unwrap();

let start = DateTime {
    date: Date::try_new_gregorian(2023, 12, 22).unwrap(),
    time: Time::try_new(9, 0, 0, 0).unwrap(),
};
let end = DateTime {
    date: Date::try_new_gregorian(2023, 12, 23).unwrap(),
    time: Time::try_new(17, 0, 0, 0).unwrap(),
};

// English medium YMD day-difference range uses thin spaces (\u{2009}) around en-dash:
assert_writeable_eq!(
    fmt.format(&start, &end),
    "Dec 22\u{2009}–\u{2009}23, 2023"
);

Implementations

impl<C: CldrCalendar, FSet> FixedCalendarDateRangeFormatter<C, FSet>

where FSet::D: TypedDateDataMarkers<C>, FSet::T: TimeMarkers, FSet::Z: ZoneMarkers, FSet: GetField<CompositeFieldSet> + DateTimeMarkers + Clone,

pub fn try_new_unstable<P>( provider: &P, prefs: DateTimeFormatterPreferences, field_set_with_options: FSet, ) -> Result<Self, DateTimeFormatterLoadError>

where P: ?Sized + AllFixedCalendarFormattingDataMarkers<C, FSet> + AllFixedCalendarExternalDataMarkers + AllFixedCalendarRangePatternDataMarkers<C, FSet>,

A version of Self::try_new that uses custom data provided by a DataProvider.

📚 Help choosing a constructor

⚠️ The bounds on provider may change over time, including in SemVer minor releases.

pub fn try_new( prefs: DateTimeFormatterPreferences, field_set_with_options: FSet, ) -> Result<Self, DateTimeFormatterLoadError>

where Baked: AllFixedCalendarFormattingDataMarkers<C, FSet> + AllFixedCalendarRangePatternDataMarkers<C, FSet>,

Constructor using compiled data.

✨ Enabled with the compiled_data Cargo feature.

📚 Help choosing a constructor

pub fn try_new_with_buffer_provider<P>( provider: &P, prefs: DateTimeFormatterPreferences, field_set_with_options: FSet, ) -> Result<Self, DateTimeFormatterLoadError>

where P: BufferProvider + ?Sized,

A version of Self::try_new that uses custom data provided by a BufferProvider.

✨ Enabled with the serde Cargo feature.

📚 Help choosing a constructor

pub fn cast_into_fset<FSet2: DateTimeNamesFrom<FSet>>( self, ) -> FixedCalendarDateRangeFormatter<C, FSet2>

Casts the field set of this FixedCalendarDateRangeFormatter to a dynamic field set.

impl<C: CldrCalendar, FSet: DateTimeMarkers + DateTimeNamesMarker> FixedCalendarDateRangeFormatter<C, FSet>

where FSet::D: DateInputMarkers, FSet::T: TimeMarkers, FSet::Z: ZoneMarkers,

pub fn format<'a, I>(&'a self, start: &I, end: &I) -> FormattedDateRange<'a>

where I: ?Sized + InFixedCalendar<C> + AllInputMarkers<FSet>,

Formats a date/time range.

This method formats the input dates directly, enforcing that they must be in the statically typed calendar C.

Trait Implementations

impl<C: Debug + CldrCalendar, FSet: Debug + DateTimeNamesMarker> Debug for FixedCalendarDateRangeFormatter<C, FSet>

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

Formats the value using the given formatter.