Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła