[][src]Module icu::datetime::options::style

Style is a model of encoding information on how to format date and time by specifying the preferred length of date and time fields.

If either of the fields is omitted, the value will be formatted according to the pattern associated with the preferred length of the present field in a given locale.

If both fields are present, both parts of the value will be formatted and an additional connector pattern will be used to construct a full result. The type of the connector is determined by the length of the Date field.

Additionally, the bag contains an optional set of Preferences which represent user preferred adjustments that can be applied onto the pattern right before formatting.

Examples

use icu_datetime::options::style;

let options = style::Bag {
     date: Some(style::Date::Medium), // `Medium` length connector will be used
     time: Some(style::Time::Short),
     preferences: None,
};

Note: The exact result returned from [DateTimeFormat] is a subject to change over time. Formatted result should be treated as opaque and displayed to the user as-is, and it is strongly recommended to never write tests that expect a particular formatted output.

Structs

Bag

style::Bag is a structure to represent the set of styles in which the DateTime should be formatted to.

Enums

Date

Date represents different length styles DateTime can be formatted into. Each length has associated best pattern for it for a given locale.

Time

Time represents different length styles DateTime can be formatted into. Each length has associated best pattern for it for a given locale.