18 releases (10 stable)
new 2.0.0-beta1 | Nov 23, 2024 |
---|---|
1.5.1 | Jun 6, 2024 |
1.5.0 | May 28, 2024 |
1.4.0 | Nov 16, 2023 |
0.1.0 | Oct 15, 2020 |
#122 in Internationalization (i18n)
133,401 downloads per month
Used in 42 crates
(12 directly)
4MB
61K
SLoC
icu_datetime
Localized formatting of dates, times, and time zones.
This module is published as its own crate (icu_datetime
)
and as part of the icu
crate. See the latter for more details on the ICU4X project.
ICU4X datetime formatting follows the Unicode UTS 35 standard for Semantic Skeletons. First you choose a field set, then you configure the formatting options to your desired context.
- Field Sets:
icu::datetime::fieldsets
- Options:
icu::datetime::options
ICU4X supports formatting in over one dozen calendar systems, including Gregorian, Buddhist, Islamic, and more. The calendar system is usually derived from the locale, but it can also be specified explicitly.
The main formatter in this crate is DateTimeFormatter
, which supports all field sets,
options, and calendar systems. Additional formatter types are available to developers in
resource-constrained environments.
The formatters accept input types from the calendar
and
timezone
crates:
Not all inputs are valid for all field sets.
Binary Size Tradeoffs
The datetime crate has been engineered with a focus on giving developers the ability to tune binary size to their needs. The table illustrates the two main tradeoffs, field sets and calendar systems:
Factor | Static (Lower Binary Size) | Dynamic (Greater Binary Size) |
---|---|---|
Field Sets | Specific fieldsets types |
Enumerations from fieldsets::enums |
Calendar Systems | FixedCalendarDateTimeFormatter |
DateTimeFormatter |
If formatting times and time zones without dates, consider using TimeFormatter
.
Examples
use icu::calendar::DateTime;
use icu::datetime::fieldsets;
use icu::datetime::DateTimeFormatter;
use icu::locale::{locale, Locale};
use writeable::assert_writeable_eq;
// Field set for year, month, day, hour, and minute with a medium length:
let field_set = fieldsets::YMDT::medium().hm();
// Create a formatter for Argentinian Spanish:
let locale = locale!("es-AR");
let dtf = DateTimeFormatter::try_new(locale.into(), field_set).unwrap();
// Format something:
let datetime = DateTime::try_new_iso(2025, 1, 15, 16, 9, 35).unwrap();
let formatted_date = dtf.format_any_calendar(&datetime);
assert_writeable_eq!(formatted_date, "15 de ene de 2025, 4:09 p. m.");
More Information
For more information on development, authorship, contributing etc. please visit ICU4X home page
.