CKTIS / JavaScript
Intl.NumberFormat: možnosti pre meny a percentá
Formátujte sumy a pomery podľa jazykového a regionálneho nastavenia. Zistite, kedy je povinný kód meny, prečo 0,125 znamená 12,5 % a ako nastaviť počet desatinných miest.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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) vytvorí objekt na opakované formátovanie; format(value) vráti lokalizovaný text. Jazykové a regionálne nastavenie ovplyvňuje napríklad oddeľovače a umiestnenie symbolov. Voľba style určuje druh zobrazenia a jej predvolená hodnota je "decimal".
Pri style: "currency" zadajte do currency kód, napríklad "USD". Sumu odovzdajte v hlavnej jednotke meny, nie v centoch: formátovanie meny neprepočítava. Chýbajúci kód vyvolá TypeError; kód, ktorý netvoria tri písmená ASCII, vyvolá RangeError. Správne zapísaný kód nemusí byť pridelený žiadnej mene. currencyDisplay vyberá "symbol" (predvolené), "narrowSymbol" (kratší symbol), "code" alebo "name". Predvolená hodnota currencySign je "standard"; "accounting" môže podľa jazykového a regionálneho nastavenia zobraziť záporné sumy v zátvorkách.
Pri style: "percent" odovzdajte pomer: formátovanie ho pred zaokrúhlením vynásobí 100. Ak chcete zobraziť 12,5 %, odovzdajte 0.125, nie 12.5. Pri štandardnom zápise a bez nastavenia platných číslic sa predvolený počet desatinných miest riadi čiastkovou jednotkou meny (dve miesta pre USD); pri percentách je predvolený počet nula. minimumFractionDigits podľa potreby dopĺňa nuly; maximumFractionDigits obmedzuje počet desatinných miest pri zaokrúhľovaní. Pri predvolenom nastavení trailingZeroDisplay: "auto" nastavte obe voľby na rovnakú hodnotu, ak chcete zobraziť presne daný počet miest. Pri trailingZeroDisplay: "stripIfInteger" sa desatinná časť vynechá, ak je výsledok po zaokrúhlení celé číslo.
Lokalizačné údaje a podpora v prostredí vykonávania sa môžu líšiť. Medzery a symboly sa môžu líšiť aj pri rovnakom jazykovom a regionálnom nastavení, preto neporovnávajte celý lokalizovaný reťazec s pevne zadanou hodnotou. Pomocou formatToParts() môžete skúmať jednotlivé časti podľa typu.
Príklady
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"),
]));Výsledok
["USD","19","90"] ["12","5",true]
Prvý riadok zobrazuje kód USD a obe časti sumy vrátane koncovej nuly. Druhý zobrazuje číselné časti hodnoty 12,5 % a potvrdzuje prítomnosť znaku percenta bez kontroly jeho presnej podoby alebo umiestnenia.
Súvisiace lekcie
- JavaScript · Lekcia 24 · Stredne pokročilá · Verzia: 3