Enum icu_datetime::options::Length

#[non_exhaustive]
#[repr(u8)]
pub enum Length {
    Long = 4,
    Medium = 3,
    Short = 1,
}

The length of a formatted date/time string.

Length settings are always a hint, not a guarantee. For example, certain locales and calendar systems do not define numeric names, so spelled-out names could occur even if a short length was requested, and likewise with numeric names with a medium or long length.

Examples

use icu::calendar::Date;
use icu::calendar::Gregorian;
use icu::datetime::fieldsets::YMD;
use icu::datetime::FixedCalendarDateTimeFormatter;
use icu::locale::locale;
use writeable::assert_writeable_eq;

let short_formatter = FixedCalendarDateTimeFormatter::try_new(
    locale!("en-US").into(),
    YMD::short(),
)
.unwrap();

let medium_formatter = FixedCalendarDateTimeFormatter::try_new(
    locale!("en-US").into(),
    YMD::medium(),
)
.unwrap();

let long_formatter = FixedCalendarDateTimeFormatter::try_new(
    locale!("en-US").into(),
    YMD::long(),
)
.unwrap();

assert_writeable_eq!(
    short_formatter.format(&Date::try_new_gregorian(2000, 1, 1).unwrap()),
    "1/1/00"
);

assert_writeable_eq!(
    medium_formatter.format(&Date::try_new_gregorian(2000, 1, 1).unwrap()),
    "Jan 1, 2000"
);

assert_writeable_eq!(
    long_formatter.format(&Date::try_new_gregorian(2000, 1, 1).unwrap()),
    "January 1, 2000"
);

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.

Long = 4

A long date; typically spelled-out, as in “January 1, 2000”.

Medium = 3

A medium-sized date; typically abbreviated, as in “Jan. 1, 2000”.

Short = 1

A short date; typically numeric, as in “1/1/2000”.

Trait Implementations

impl Clone for Length

fn clone(&self) -> Length

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Length

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Length

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for Length

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 IntoOption<Length> for Length

fn into_option(self) -> Option<Self>

Return self as an Option<T>

impl PartialEq for Length

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Length

impl Eq for Length

impl StructuralPartialEq for Length