Crate icu_datetime[−][src]
icu_datetime
is one of the ICU4X
components.
This API provides necessary functionality for formatting date and time to user readable textual representation.
DateTimeFormat
is the main structure of the component. It accepts a set of arguments which
allow it to collect necessary data from the DataProvider
, and once instantiated, can be
used to quickly format any date and time provided.
Examples
use icu::locid::Locale; use icu::locid::macros::langid; use icu::datetime::{DateTimeFormat, DateTimeFormatOptions, mock::datetime::MockDateTime, options::length}; let provider = icu_testdata::get_provider(); let locale: Locale = langid!("en").into(); // See the next code example for a more ergonomic example with .into(). let options = DateTimeFormatOptions::Length(length::Bag { date: Some(length::Date::Medium), time: Some(length::Time::Short), ..Default::default() }); let dtf = DateTimeFormat::try_new(locale, &provider, &options) .expect("Failed to create DateTimeFormat instance."); let date: MockDateTime = "2020-09-12T12:35:00".parse() .expect("Failed to parse date."); let formatted_date = dtf.format(&date); assert_eq!(formatted_date.to_string(), "Sep 12, 2020, 12:35 PM");
The options can be created more ergonomically using the Into
trait to automatically
convert a options::length::Bag
into a DateTimeFormatOptions::Length
.
use icu::locid::Locale; use icu::locid::macros::langid; use icu::datetime::{DateTimeFormat, DateTimeFormatOptions, mock::datetime::MockDateTime, options::length}; let options = length::Bag { date: Some(length::Date::Medium), time: Some(length::Time::Short), ..Default::default() }.into(); let dtf = DateTimeFormat::try_new(locale, &provider, &options);
At the moment, the crate provides only options using the Length
bag, but in the future,
we expect to add more ways to customize the output, like skeletons, and components.
Notice: Rust at the moment does not have a canonical way to represent date and time. We are introducing
MockDateTime
as an example of the data necessary for ICU DateTimeFormat
to work, and
we hope to work with the community
to develop core date and time APIs that will work as an input for this component.
Re-exports
pub use datetime::DateTimeFormat; | |
pub use options::DateTimeFormatOptions; | |
pub use zoned_datetime::ZonedDateTimeFormat; |
Modules
date | |
datetime | |
mock | |
options |
|
provider | Data provider struct definitions for this ICU4X component. |
zoned_datetime |
Structs
FormattedDateTime |
|
FormattedZonedDateTime |
Enums
DateTimeFormatError | A list of possible error outcomes for the |