CKTIS / JavaScript
Intl.NumberFormat: možnosti za valute in odstotke
Oblikujte zneske in razmerja glede na jezikovne in območne nastavitve. Izvedite, kdaj je obvezna koda valute, zakaj 0,125 pomeni 12,5 % in kako določiti število decimalnih mest.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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) ustvari oblikovalnik za večkratno uporabo; format(value) vrne lokalizirano besedilo. Jezikovne in območne nastavitve vplivajo na ločila in položaj simbolov. Možnost style določa vrsto prikaza in ima privzeto vrednost "decimal".
Pri style: "currency" v currency navedite kodo, na primer "USD". Podajte znesek v osnovni denarni enoti in ne v centih: oblikovanje ne preračunava valut. Manjkajoča koda sproži TypeError; koda, ki ni sestavljena iz treh črk ASCII, sproži RangeError. Pravilno zapisana koda ni nujno dodeljena kateri od valut. currencyDisplay izbira med "symbol" (privzeto), "narrowSymbol" (krajši simbol), "code" in "name". Privzeta vrednost currencySign je "standard"; "accounting" lahko glede na jezikovne in območne nastavitve prikaže negativne zneske v oklepajih.
Pri style: "percent" podajte razmerje: oblikovalnik ga pred zaokroževanjem pomnoži s 100. Za prikaz 12,5 % podajte 0.125 in ne 12.5. Pri standardnem zapisu in brez nastavitev za značilne števke je privzeto število decimalnih mest odvisno od podenote valute (dve mesti za USD), pri odstotkih pa je privzeto nič. minimumFractionDigits po potrebi doda ničle, maximumFractionDigits pa omeji število decimalnih mest pri zaokroževanju. Pri privzeti nastavitvi trailingZeroDisplay: "auto" nastavite obe možnosti na isto vrednost, če želite prikazati natanko toliko decimalnih mest. Pri trailingZeroDisplay: "stripIfInteger" se decimalni del izpusti, če je zaokroženi rezultat celo število.
Lokalizacijski podatki in podpora v izvajalnem okolju se lahko razlikujejo. Presledki in simboli se lahko razlikujejo tudi pri enakih jezikovnih in območnih nastavitvah, zato celotnega lokaliziranega niza ne primerjajte z vnaprej določeno vrednostjo. Z formatToParts() lahko pregledate sestavne dele po vrstah.
Primeri
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"),
]));Rezultat
["USD","19","90"] ["12","5",true]
Prva vrstica prikaže kodo USD in oba dela zneska, vključno s končno ničlo. Druga prikaže številska dela vrednosti 12,5 % in potrdi prisotnost znaka za odstotek, ne da bi preverjala njegov natančen znak ali položaj.
Povezane lekcije
- JavaScript · Lekcija 24 · Srednja · Različica: 3