#[non_exhaustive]pub struct T {
pub length: Length,
pub alignment: Option<Alignment>,
pub time_precision: Option<TimePrecision>,
}
Expand description
“3:47:50 PM” ⇒ time (locale-dependent hour cycle)
§Examples
use icu::calendar::Time;
use icu::datetime::TimeFormatter;
use icu::datetime::fieldsets::T;
use icu::locale::locale;
use writeable::assert_writeable_eq;
let fmt = TimeFormatter::try_new(
locale!("en").into(),
T::medium(),
)
.unwrap();
let time = Time::try_new(15, 47, 50, 0).unwrap();
assert_writeable_eq!(
fmt.format(&time),
"3:47:50 PM"
);
Hours can be switched between 12-hour and 24-hour time via the u-hc
locale keyword
or DateTimeFormatterPreferences
.
use icu::calendar::Time;
use icu::datetime::fieldsets::T;
use icu::datetime::TimeFormatter;
use icu::locale::locale;
use writeable::assert_writeable_eq;
// By default, en-US uses 12-hour time and fr-FR uses 24-hour time,
// but we can set overrides.
let formatter = TimeFormatter::try_new(
locale!("en-US-u-hc-h12").into(),
T::short().hm(),
)
.unwrap();
assert_writeable_eq!(
formatter.format(&Time::try_new(16, 12, 20, 0).unwrap()),
"4:12 PM"
);
let formatter = TimeFormatter::try_new(
locale!("en-US-u-hc-h23").into(),
T::short().hm(),
)
.unwrap();
assert_writeable_eq!(
formatter.format(&Time::try_new(16, 12, 20, 0).unwrap()),
"16:12"
);
let formatter = TimeFormatter::try_new(
locale!("fr-FR-u-hc-h12").into(),
T::short().hm(),
)
.unwrap();
assert_writeable_eq!(
formatter.format(&Time::try_new(16, 12, 20, 0).unwrap()),
"4:12 PM"
);
let formatter = TimeFormatter::try_new(
locale!("fr-FR-u-hc-h23").into(),
T::short().hm(),
)
.unwrap();
assert_writeable_eq!(
formatter.format(&Time::try_new(16, 12, 20, 0).unwrap()),
"16:12"
);
Hour cycles h11
and h24
are supported, too:
use icu::calendar::Time;
use icu::datetime::fieldsets::T;
use icu::datetime::TimeFormatter;
use icu::locale::locale;
use writeable::assert_writeable_eq;
let formatter = TimeFormatter::try_new(
locale!("und-u-hc-h11").into(),
T::short().hm(),
)
.unwrap();
assert_writeable_eq!(
formatter.format(&Time::try_new(0, 0, 0, 0).unwrap()),
"0:00 AM"
);
let formatter = TimeFormatter::try_new(
locale!("und-u-hc-h24").into(),
T::short().hm(),
)
.unwrap();
assert_writeable_eq!(
formatter.format(&Time::try_new(0, 0, 0, 0).unwrap()),
"24:00"
);
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
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§
source§impl T
impl T
sourcepub const fn with_alignment(self, alignment: Alignment) -> T
pub const fn with_alignment(self, alignment: Alignment) -> T
Sets the alignment option.
source§impl T
impl T
sourcepub const fn with_time_precision(self, time_precision: TimePrecision) -> T
pub const fn with_time_precision(self, time_precision: TimePrecision) -> T
Sets the time precision option.
sourcepub fn hm(self) -> T
pub fn hm(self) -> T
Sets the time precision to TimePrecision::MinuteExact
source§impl T
impl T
sourcepub const fn with_length(length: Length) -> T
pub const fn with_length(length: Length) -> T
Creates a T skeleton with the given formatting length.
source§impl T
impl T
sourcepub fn with_zone_specific_long(self) -> Combo<T, Z>
pub fn with_zone_specific_long(self) -> Combo<T, Z>
Associates this field set with a long specific non-location format time zone, as in “Pacific Daylight Time”.
sourcepub fn with_zone_specific(self) -> Combo<T, Zs>
pub fn with_zone_specific(self) -> Combo<T, Zs>
Associates this field set with a short specific non-location format time zone, as in “PDT”.
sourcepub fn with_zone_offset_long(self) -> Combo<T, O>
pub fn with_zone_offset_long(self) -> Combo<T, O>
Associates this field set with a long offset format time zone, as in “GMT−08:00”.
sourcepub fn with_zone_offset(self) -> Combo<T, Os>
pub fn with_zone_offset(self) -> Combo<T, Os>
Associates this field set with a short offset format time zone, as in “GMT−8”.
sourcepub fn with_zone_generic_long(self) -> Combo<T, V>
pub fn with_zone_generic_long(self) -> Combo<T, V>
Associates this field set with a long generic non-location format time zone, as in “Pacific Time”.
sourcepub fn with_zone_generic(self) -> Combo<T, Vs>
pub fn with_zone_generic(self) -> Combo<T, Vs>
Associates this field set with a short generic non-location format time zone, as in “PT”.
sourcepub fn with_zone_location(self) -> Combo<T, L>
pub fn with_zone_location(self) -> Combo<T, L>
Associates this field set with a location format time zone, as in “Los Angeles time”.
Trait Implementations§
source§impl DateTimeMarkers for T
impl DateTimeMarkers for T
source§type GluePatternV1Marker = NeverMarker<GluePatternV1<'static>>
type GluePatternV1Marker = NeverMarker<GluePatternV1<'static>>
source§impl DateTimeNamesMarker for T
impl DateTimeNamesMarker for T
type YearNames = ()
type MonthNames = ()
type WeekdayNames = ()
type DayPeriodNames = DayPeriodNamesV1Marker
type ZoneEssentials = ()
type ZoneLocations = ()
type ZoneGenericLong = ()
type ZoneGenericShort = ()
type ZoneSpecificLong = ()
type ZoneSpecificShort = ()
type MetazoneLookup = ()
source§impl GetField<CompositeFieldSet> for T
impl GetField<CompositeFieldSet> for T
source§fn get_field(&self) -> CompositeFieldSet
fn get_field(&self) -> CompositeFieldSet
T
.source§impl TimeMarkers for T
impl TimeMarkers for T
source§type DayPeriodNamesV1Marker = DayPeriodNamesV1Marker
type DayPeriodNamesV1Marker = DayPeriodNamesV1Marker
source§type TimeSkeletonPatternsV1Marker = TimeNeoSkeletonPatternsV1Marker
type TimeSkeletonPatternsV1Marker = TimeNeoSkeletonPatternsV1Marker
source§type MinuteInput = IsoMinute
type MinuteInput = IsoMinute
source§type SecondInput = IsoSecond
type SecondInput = IsoSecond
source§type NanoSecondInput = NanoSecond
type NanoSecondInput = NanoSecond
impl Copy for T
impl Eq for T
impl StructuralPartialEq for T
impl UnstableSealed for T
Auto Trait Implementations§
impl Freeze for T
impl RefUnwindSafe for T
impl Send for T
impl Sync for T
impl Unpin for T
impl UnwindSafe for T
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)source§impl<M, T> DateTimeNamesFrom<M> for Twhere
M: DateTimeNamesMarker,
T: DateTimeNamesMarker,
<<T as DateTimeNamesMarker>::YearNames as NamesContainer<YearNamesV1Marker, FieldLength>>::Container: From<<<M as DateTimeNamesMarker>::YearNames as NamesContainer<YearNamesV1Marker, FieldLength>>::Container>,
<<T as DateTimeNamesMarker>::MonthNames as NamesContainer<MonthNamesV1Marker, (Month, FieldLength)>>::Container: From<<<M as DateTimeNamesMarker>::MonthNames as NamesContainer<MonthNamesV1Marker, (Month, FieldLength)>>::Container>,
<<T as DateTimeNamesMarker>::WeekdayNames as NamesContainer<WeekdayNamesV1Marker, (Weekday, FieldLength)>>::Container: From<<<M as DateTimeNamesMarker>::WeekdayNames as NamesContainer<WeekdayNamesV1Marker, (Weekday, FieldLength)>>::Container>,
<<T as DateTimeNamesMarker>::DayPeriodNames as NamesContainer<DayPeriodNamesV1Marker, FieldLength>>::Container: From<<<M as DateTimeNamesMarker>::DayPeriodNames as NamesContainer<DayPeriodNamesV1Marker, FieldLength>>::Container>,
<<T as DateTimeNamesMarker>::ZoneEssentials as NamesContainer<TimeZoneEssentialsV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::ZoneEssentials as NamesContainer<TimeZoneEssentialsV1Marker, ()>>::Container>,
<<T as DateTimeNamesMarker>::ZoneLocations as NamesContainer<LocationsV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::ZoneLocations as NamesContainer<LocationsV1Marker, ()>>::Container>,
<<T as DateTimeNamesMarker>::ZoneGenericLong as NamesContainer<MetazoneGenericNamesLongV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::ZoneGenericLong as NamesContainer<MetazoneGenericNamesLongV1Marker, ()>>::Container>,
<<T as DateTimeNamesMarker>::ZoneGenericShort as NamesContainer<MetazoneGenericNamesShortV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::ZoneGenericShort as NamesContainer<MetazoneGenericNamesShortV1Marker, ()>>::Container>,
<<T as DateTimeNamesMarker>::ZoneSpecificLong as NamesContainer<MetazoneSpecificNamesLongV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::ZoneSpecificLong as NamesContainer<MetazoneSpecificNamesLongV1Marker, ()>>::Container>,
<<T as DateTimeNamesMarker>::ZoneSpecificShort as NamesContainer<MetazoneSpecificNamesShortV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::ZoneSpecificShort as NamesContainer<MetazoneSpecificNamesShortV1Marker, ()>>::Container>,
<<T as DateTimeNamesMarker>::MetazoneLookup as NamesContainer<MetazonePeriodV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::MetazoneLookup as NamesContainer<MetazonePeriodV1Marker, ()>>::Container>,
impl<M, T> DateTimeNamesFrom<M> for Twhere
M: DateTimeNamesMarker,
T: DateTimeNamesMarker,
<<T as DateTimeNamesMarker>::YearNames as NamesContainer<YearNamesV1Marker, FieldLength>>::Container: From<<<M as DateTimeNamesMarker>::YearNames as NamesContainer<YearNamesV1Marker, FieldLength>>::Container>,
<<T as DateTimeNamesMarker>::MonthNames as NamesContainer<MonthNamesV1Marker, (Month, FieldLength)>>::Container: From<<<M as DateTimeNamesMarker>::MonthNames as NamesContainer<MonthNamesV1Marker, (Month, FieldLength)>>::Container>,
<<T as DateTimeNamesMarker>::WeekdayNames as NamesContainer<WeekdayNamesV1Marker, (Weekday, FieldLength)>>::Container: From<<<M as DateTimeNamesMarker>::WeekdayNames as NamesContainer<WeekdayNamesV1Marker, (Weekday, FieldLength)>>::Container>,
<<T as DateTimeNamesMarker>::DayPeriodNames as NamesContainer<DayPeriodNamesV1Marker, FieldLength>>::Container: From<<<M as DateTimeNamesMarker>::DayPeriodNames as NamesContainer<DayPeriodNamesV1Marker, FieldLength>>::Container>,
<<T as DateTimeNamesMarker>::ZoneEssentials as NamesContainer<TimeZoneEssentialsV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::ZoneEssentials as NamesContainer<TimeZoneEssentialsV1Marker, ()>>::Container>,
<<T as DateTimeNamesMarker>::ZoneLocations as NamesContainer<LocationsV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::ZoneLocations as NamesContainer<LocationsV1Marker, ()>>::Container>,
<<T as DateTimeNamesMarker>::ZoneGenericLong as NamesContainer<MetazoneGenericNamesLongV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::ZoneGenericLong as NamesContainer<MetazoneGenericNamesLongV1Marker, ()>>::Container>,
<<T as DateTimeNamesMarker>::ZoneGenericShort as NamesContainer<MetazoneGenericNamesShortV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::ZoneGenericShort as NamesContainer<MetazoneGenericNamesShortV1Marker, ()>>::Container>,
<<T as DateTimeNamesMarker>::ZoneSpecificLong as NamesContainer<MetazoneSpecificNamesLongV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::ZoneSpecificLong as NamesContainer<MetazoneSpecificNamesLongV1Marker, ()>>::Container>,
<<T as DateTimeNamesMarker>::ZoneSpecificShort as NamesContainer<MetazoneSpecificNamesShortV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::ZoneSpecificShort as NamesContainer<MetazoneSpecificNamesShortV1Marker, ()>>::Container>,
<<T as DateTimeNamesMarker>::MetazoneLookup as NamesContainer<MetazonePeriodV1Marker, ()>>::Container: From<<<M as DateTimeNamesMarker>::MetazoneLookup as NamesContainer<MetazonePeriodV1Marker, ()>>::Container>,
fn map_year_names( other: <<M as DateTimeNamesMarker>::YearNames as NamesContainer<YearNamesV1Marker, FieldLength>>::Container, ) -> <<T as DateTimeNamesMarker>::YearNames as NamesContainer<YearNamesV1Marker, FieldLength>>::Container
fn map_month_names( other: <<M as DateTimeNamesMarker>::MonthNames as NamesContainer<MonthNamesV1Marker, (Month, FieldLength)>>::Container, ) -> <<T as DateTimeNamesMarker>::MonthNames as NamesContainer<MonthNamesV1Marker, (Month, FieldLength)>>::Container
fn map_weekday_names( other: <<M as DateTimeNamesMarker>::WeekdayNames as NamesContainer<WeekdayNamesV1Marker, (Weekday, FieldLength)>>::Container, ) -> <<T as DateTimeNamesMarker>::WeekdayNames as NamesContainer<WeekdayNamesV1Marker, (Weekday, FieldLength)>>::Container
fn map_day_period_names( other: <<M as DateTimeNamesMarker>::DayPeriodNames as NamesContainer<DayPeriodNamesV1Marker, FieldLength>>::Container, ) -> <<T as DateTimeNamesMarker>::DayPeriodNames as NamesContainer<DayPeriodNamesV1Marker, FieldLength>>::Container
fn map_zone_essentials( other: <<M as DateTimeNamesMarker>::ZoneEssentials as NamesContainer<TimeZoneEssentialsV1Marker, ()>>::Container, ) -> <<T as DateTimeNamesMarker>::ZoneEssentials as NamesContainer<TimeZoneEssentialsV1Marker, ()>>::Container
fn map_zone_locations( other: <<M as DateTimeNamesMarker>::ZoneLocations as NamesContainer<LocationsV1Marker, ()>>::Container, ) -> <<T as DateTimeNamesMarker>::ZoneLocations as NamesContainer<LocationsV1Marker, ()>>::Container
fn map_zone_generic_long( other: <<M as DateTimeNamesMarker>::ZoneGenericLong as NamesContainer<MetazoneGenericNamesLongV1Marker, ()>>::Container, ) -> <<T as DateTimeNamesMarker>::ZoneGenericLong as NamesContainer<MetazoneGenericNamesLongV1Marker, ()>>::Container
fn map_zone_generic_short( other: <<M as DateTimeNamesMarker>::ZoneGenericShort as NamesContainer<MetazoneGenericNamesShortV1Marker, ()>>::Container, ) -> <<T as DateTimeNamesMarker>::ZoneGenericShort as NamesContainer<MetazoneGenericNamesShortV1Marker, ()>>::Container
fn map_zone_specific_long( other: <<M as DateTimeNamesMarker>::ZoneSpecificLong as NamesContainer<MetazoneSpecificNamesLongV1Marker, ()>>::Container, ) -> <<T as DateTimeNamesMarker>::ZoneSpecificLong as NamesContainer<MetazoneSpecificNamesLongV1Marker, ()>>::Container
fn map_zone_specific_short( other: <<M as DateTimeNamesMarker>::ZoneSpecificShort as NamesContainer<MetazoneSpecificNamesShortV1Marker, ()>>::Container, ) -> <<T as DateTimeNamesMarker>::ZoneSpecificShort as NamesContainer<MetazoneSpecificNamesShortV1Marker, ()>>::Container
fn map_metazone_lookup( other: <<M as DateTimeNamesMarker>::MetazoneLookup as NamesContainer<MetazonePeriodV1Marker, ()>>::Container, ) -> <<T as DateTimeNamesMarker>::MetazoneLookup as NamesContainer<MetazonePeriodV1Marker, ()>>::Container
source§impl<T> GetField<T> for Twhere
T: Copy + UnstableSealed,
impl<T> GetField<T> for Twhere
T: Copy + UnstableSealed,
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more