CKTIS / JavaScript
Intl.NumberFormat — formatowanie liczb według ustawień regionalnych
Intl.NumberFormat zamienia liczby na tekst zgodny z ustawieniami regionalnymi i wybranymi opcjami. Pozwala kontrolować m.in. grupowanie cyfr i miejsca dziesiętne; format zwraca funkcję związaną z konkretnym formatterem.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const formatter = new Intl.NumberFormat(locales, options);
formatter.format(value);Intl.NumberFormat tworzy formatter liczb na podstawie locales i options. To API standardu ECMA-402, a nie API DOM. Wynikiem formatowania jest tekst do wyświetlenia, nie nowa wartość liczbowa ani funkcja odczytująca lokalnie zapisane liczby.
Intl.NumberFormat.prototype.format jest właściwością akcesorową: jej odczyt z instancji zwraca funkcję związaną z tą instancją. Dlatego const format = formatter.format pozwala później wywołać format(value) bez utraty ustawień. Przy wielu wartościach można używać tego samego formattera.
minimumFractionDigits określa minimalną, a maximumFractionDigits maksymalną liczbę cyfr po separatorze dziesiętnym. Gdy te limity mają zastosowanie, przy domyślnym ustawieniu trailingZeroDisplay: "auto" ustawienie obu na 2 daje dwie cyfry po separatorze dziesiętnym, z zaokrągleniem w razie potrzeby. Natomiast przy trailingZeroDisplay: "stripIfInteger" zera po separatorze nie są wyświetlane, jeśli wynik po zaokrągleniu jest liczbą całkowitą. Przy domyślnym roundingPriority: "auto" podanie maximumSignificantDigits sprawia, że formatter ignoruje oba limity liczby cyfr po separatorze. useGrouping: false wyłącza grupowanie. Styl currency wymaga opcji currency, ale nie przelicza kursów walut.
Przykład jawnie wybiera en-US oraz cyfry latn. Dostępność ustawień regionalnych i szczegóły zapisu mogą zależeć od implementacji oraz danych językowych. Sprawdź wynik w docelowej przeglądarce; dostępność w Node 24 nie dowodzi obsługi w przeglądarce.
Przykłady
const formatter = new Intl.NumberFormat("en-US", {
numberingSystem: "latn",
useGrouping: false,
minimumFractionDigits: 2,
maximumFractionDigits: 2
});
const format = formatter.format;
console.log(format(1234.5));Wynik
1234.50
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.