Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Intl.NumberFormat: opcje walut i procentów

Formatuj kwoty i udziały zgodnie z ustawieniami regionalnymi. Sprawdź, kiedy trzeba podać kod waluty, dlaczego 0,125 oznacza 12,5% i jak ustawić liczbę miejsc po separatorze dziesiętnym.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

new Intl.NumberFormat(locale, { style: "currency", currency: "USD" }).format(amount)
new Intl.NumberFormat(locale, { style: "percent", minimumFractionDigits: 1, maximumFractionDigits: 1 }).format(ratio)

new Intl.NumberFormat(locale, options) tworzy obiekt formatujący, którego można używać wielokrotnie. Metoda format(value) zwraca zlokalizowany tekst. locale wpływa m.in. na separatory i położenie symboli; style wybiera sposób prezentacji. Jeśli pominiesz style, domyślnie zostanie użyte "decimal".

Dla style: "currency" podaj w currency kod waluty, np. "USD". Kwotę przekaż w głównej jednostce waluty, nie w centach: formatowanie nie przelicza walut. Brak kodu powoduje TypeError, a kod, który nie ma postaci trzech liter ASCII, powoduje RangeError. Sam poprawny zapis nie oznacza, że kod jest przypisany do waluty. currencyDisplay wybiera "symbol" (domyślnie), "narrowSymbol" (węższy symbol), "code" (kod) lub "name" (nazwę). currencySign domyślnie ma wartość "standard"; wariant "accounting" w niektórych ustawieniach regionalnych pokazuje kwoty ujemne w nawiasach.

Dla style: "percent" podaj udział: formatowanie mnoży go przez 100 przed zaokrągleniem. Aby wyświetlić 12,5%, przekaż 0.125, nie 12.5. Przy standardowej notacji i bez ustawiania cyfr znaczących waluta domyślnie używa liczby miejsc dziesiętnych wynikającej z jej jednostki pomocniczej (dwa miejsca dla USD), a procent nie ma miejsc dziesiętnych. minimumFractionDigits uzupełnia brakujące miejsca zerami, a maximumFractionDigits wyznacza granicę zaokrąglania. Przy domyślnym ustawieniu trailingZeroDisplay: "auto" ustaw oba na tę samą wartość, jeśli potrzebujesz dokładnie tylu miejsc. Przy trailingZeroDisplay: "stripIfInteger" część ułamkowa jest pomijana, jeśli wynik po zaokrągleniu jest liczbą całkowitą.

Dane regionalne i obsługa przez środowisko wykonawcze mogą się różnić. Odstępy i symbole mogą być inne nawet dla tego samego locale, więc nie porównuj pełnego zlokalizowanego tekstu ze stałą. Użyj formatToParts(), aby sprawdzać elementy według typu.

Przykłady

const locale = "en-US-u-nu-latn";
const money = new Intl.NumberFormat(locale, {
  style: "currency",
  currency: "USD",
  currencyDisplay: "code",
});
const percent = new Intl.NumberFormat(locale, {
  style: "percent",
  minimumFractionDigits: 1,
  maximumFractionDigits: 1,
});

const moneyParts = money.formatToParts(19.9);
const percentParts = percent.formatToParts(0.125);
const valueOf = (parts, type) => parts.find(part => part.type === type)?.value;

console.log(JSON.stringify([
  valueOf(moneyParts, "currency"),
  valueOf(moneyParts, "integer"),
  valueOf(moneyParts, "fraction"),
]));
console.log(JSON.stringify([
  valueOf(percentParts, "integer"),
  valueOf(percentParts, "fraction"),
  percentParts.some(part => part.type === "percentSign"),
]));

Wynik

["USD","19","90"]
["12","5",true]

Pierwszy wiersz pokazuje kod USD i obie części kwoty, w tym końcowe zero. Drugi pokazuje części wyniku 12,5% oraz potwierdza obecność znaku procentu. Kod nie sprawdza jego dokładnej postaci ani położenia.

Powiązane lekcje

  • JavaScript · Lekcja 24 · Średniozaawansowany · Wersja: 3

Źródła