Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje