CKTIS / JavaScript
Intl.NumberFormat: volby pro měny a procenta
Formátujte částky a poměry podle jazykového a regionálního nastavení. Zjistěte, kdy potřebujete kód měny, proč 0,125 odpovídá 12,5 % a jak nastavit počet desetinných míst.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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) vytvoří objekt pro opakované formátování; format(value) vrátí lokalizovaný text. Jazykové a regionální nastavení ovlivňuje například oddělovače a umístění symbolů. Volba style určuje druh zobrazení a výchozí hodnota je "decimal".
Při style: "currency" zadejte do currency kód, například "USD". Částku předávejte v hlavních měnových jednotkách, nikoli v centech: formátování měny nepřevádí. Chybějící kód vyvolá TypeError; kód, který netvoří tři písmena ASCII, vyvolá RangeError. Správně zapsaný kód nemusí být přiřazen žádné měně. currencyDisplay vybírá "symbol" (výchozí), "narrowSymbol" (kratší symbol), "code" nebo "name". Výchozí hodnota currencySign je "standard"; "accounting" může podle jazykového a regionálního nastavení zobrazit záporné částky v závorkách.
Při style: "percent" předejte poměr: formátování jej před zaokrouhlením vynásobí 100. Pro zobrazení 12,5 % předejte 0.125, nikoli 12.5. Při standardním zápisu a bez nastavení platných číslic se výchozí počet desetinných míst řídí dílčí jednotkou měny (dvě místa pro USD); u procent je výchozí počet nula. minimumFractionDigits podle potřeby doplňuje nuly; maximumFractionDigits omezuje počet desetinných míst při zaokrouhlení. Při výchozím nastavení trailingZeroDisplay: "auto" nastavte obě volby na stejnou hodnotu, chcete-li zobrazit přesně daný počet míst. Při trailingZeroDisplay: "stripIfInteger" se desetinná část vynechá, pokud je výsledek po zaokrouhlení celé číslo.
Lokalizační data a podpora v běhovém prostředí se mohou lišit. Mezery a symboly se mohou lišit i při stejném jazykovém a regionálním nastavení, proto neporovnávejte celý lokalizovaný řetězec s pevně zadanou hodnotou. Pomocí formatToParts() můžete zkoumat jednotlivé části podle typu.
Pří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ýsledek
["USD","19","90"] ["12","5",true]
První řádek ukazuje kód USD a obě části částky včetně koncové nuly. Druhý ukazuje číselné části hodnoty 12,5 % a potvrzuje přítomnost znaku procenta, aniž by kontroloval jeho přesnou podobu nebo umístění.
Související lekce
- JavaScript · Lekce 24 · Středně pokročilá · Verze: 3