15 releases (7 stable)

2.0.0-beta2 Feb 26, 2025
2.0.0-beta1 Nov 23, 2024
1.5.0 May 28, 2024
1.4.0 Nov 16, 2023
0.3.0 Jul 30, 2021

#348 in Internationalization (i18n)

Download history 31545/week @ 2024-11-19 17832/week @ 2024-11-26 30605/week @ 2024-12-03 27440/week @ 2024-12-10 26476/week @ 2024-12-17 7459/week @ 2024-12-24 14694/week @ 2024-12-31 29533/week @ 2025-01-07 34296/week @ 2025-01-14 32911/week @ 2025-01-21 33456/week @ 2025-01-28 42612/week @ 2025-02-04 35740/week @ 2025-02-11 40048/week @ 2025-02-18 39877/week @ 2025-02-25 29046/week @ 2025-03-04

151,453 downloads per month
Used in 51 crates (16 directly)

Unicode-3.0

1.5MB
27K SLoC

icu_decimal crates.io

Formatting basic decimal numbers.

This module is published as its own crate (icu_decimal) and as part of the icu crate. See the latter for more details on the ICU4X project.

Support for currencies, measurement units, and compact notation is planned. To track progress, follow icu4x#275.

Examples

Format a number with Bangla digits

use icu::decimal::input::Decimal;
use icu::decimal::DecimalFormatter;
use icu::locale::locale;
use writeable::assert_writeable_eq;

let formatter =
    DecimalFormatter::try_new(locale!("bn").into(), Default::default())
        .expect("locale should be present");

let decimal = Decimal::from(1000007);

assert_writeable_eq!(formatter.format(&decimal), "১০,০০,০০৭");

Format a number with digits after the decimal separator

use icu::decimal::input::Decimal;
use icu::decimal::DecimalFormatter;
use icu::locale::Locale;
use writeable::assert_writeable_eq;

let formatter =
    DecimalFormatter::try_new(Default::default(), Default::default())
        .expect("locale should be present");

let decimal = {
    let mut decimal = Decimal::from(200050);
    decimal.multiply_pow10(-2);
    decimal
};

assert_writeable_eq!(formatter.format(&decimal), "2,000.50");

Format a number using an alternative numbering system

Numbering systems specified in the -u-nu subtag will be followed.

use icu::decimal::input::Decimal;
use icu::decimal::DecimalFormatter;
use icu::locale::locale;
use writeable::assert_writeable_eq;

let formatter = DecimalFormatter::try_new(
    locale!("th-u-nu-thai").into(),
    Default::default(),
)
.expect("locale should be present");

let decimal = Decimal::from(1000007);

assert_writeable_eq!(formatter.format(&decimal), "๑,๐๐๐,๐๐๗");

More Information

For more information on development, authorship, contributing etc. please visit ICU4X home page.

Dependencies

~0.6–1.4MB
~28K SLoC