12 releases (6 stable)

1.4.0 Nov 16, 2023
1.3.0 Sep 23, 2023
1.2.0 Apr 14, 2023
1.1.0 Jan 26, 2023
0.3.0 Jul 30, 2021

#354 in Internationalization (i18n)

Download history 2761/week @ 2023-11-23 2472/week @ 2023-11-30 3658/week @ 2023-12-07 3832/week @ 2023-12-14 2984/week @ 2023-12-21 2770/week @ 2023-12-28 3277/week @ 2024-01-04 3640/week @ 2024-01-11 4334/week @ 2024-01-18 4426/week @ 2024-01-25 6184/week @ 2024-02-01 5917/week @ 2024-02-08 4792/week @ 2024-02-15 4874/week @ 2024-02-22 5071/week @ 2024-02-29 3744/week @ 2024-03-07

19,599 downloads per month
Used in 29 crates (12 directly)

Custom license

760KB
12K 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 fixed_decimal::FixedDecimal;
use icu::decimal::FixedDecimalFormatter;
use icu::locid::locale;
use writeable::assert_writeable_eq;

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

let fixed_decimal = FixedDecimal::from(1000007);

assert_writeable_eq!(fdf.format(&fixed_decimal), "১০,০০,০০৭");

Format a number with digits after the decimal separator

use fixed_decimal::FixedDecimal;
use icu::decimal::FixedDecimalFormatter;
use icu::locid::Locale;
use writeable::assert_writeable_eq;

let fdf =
    FixedDecimalFormatter::try_new(&Locale::UND.into(), Default::default())
        .expect("locale should be present");

let fixed_decimal = FixedDecimal::from(200050).multiplied_pow10(-2);

assert_writeable_eq!(fdf.format(&fixed_decimal), "2,000.50");

Format a number using an alternative numbering system

Numbering systems specified in the -u-nu subtag will be followed as long as the locale has symbols for that numbering system.

use fixed_decimal::FixedDecimal;
use icu::decimal::FixedDecimalFormatter;
use icu::locid::locale;
use writeable::assert_writeable_eq;

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

let fixed_decimal = FixedDecimal::from(1000007);

assert_writeable_eq!(fdf.format(&fixed_decimal), "๑,๐๐๐,๐๐๗");

More Information

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

Dependencies

~1.4–2MB
~39K SLoC