CKTIS / JavaScript
Intl.NumberFormat: opties voor valuta en percentages
Geef bedragen en verhoudingen weer volgens de gekozen taal- en regio-instellingen. Leer wanneer een valutacode verplicht is, waarom 0,125 staat voor 12,5% en hoe je het aantal decimalen instelt.
Versie: 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) maakt een herbruikbare formatter; format(value) geeft tekst terug die is aangepast aan de taal en regio. De locale beïnvloedt onder meer de scheidingstekens en de positie van symbolen. style bepaalt het soort weergave en is standaard "decimal".
Bij style: "currency" geef je in currency een code zoals "USD" op. Geef het bedrag in de hoofdeenheid van de valuta door, niet in centen: formatteren rekent geen valuta om. Een ontbrekende code geeft een TypeError; een code die niet uit drie ASCII-letters bestaat geeft een RangeError. Een code met de juiste vorm hoeft niet aan een valuta te zijn toegewezen. currencyDisplay kiest "symbol" (standaard), "narrowSymbol" (kort symbool), "code" of "name". currencySign staat standaard op "standard"; "accounting" kan negatieve bedragen tussen haakjes weergeven, afhankelijk van de locale.
Bij style: "percent" geef je een verhouding door: de formatter vermenigvuldigt die vóór het afronden met 100. Geef voor 12,5% 0.125 door, niet 12.5. Bij standaardnotatie en zonder instellingen voor significante cijfers hangt het standaardaantal decimalen af van de ondereenheid van de valuta (twee voor USD); bij percentages is het nul. minimumFractionDigits vult zo nodig aan met nullen; maximumFractionDigits begrenst het aantal decimalen bij het afronden. Met de standaardinstelling trailingZeroDisplay: "auto" geef je beide dezelfde waarde om precies zoveel decimalen weer te geven. Met trailingZeroDisplay: "stripIfInteger" wordt het deel na het decimaalteken weggelaten als het afgeronde resultaat een geheel getal is.
Localegegevens en ondersteuning door de runtime kunnen variëren. Spaties en symbolen kunnen zelfs voor dezelfde locale verschillen. Vergelijk daarom niet de volledige gelokaliseerde tekenreeks met een vaste waarde. Gebruik formatToParts() om onderdelen per type te bekijken.
Voorbeelden
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"),
]));Resultaat
["USD","19","90"] ["12","5",true]
De eerste regel toont de code USD en beide delen van het bedrag, inclusief de afsluitende nul. De tweede toont de numerieke delen van 12,5% en bevestigt dat er een procentteken is, zonder het exacte teken of de positie te controleren.
Gerelateerde lessen
- JavaScript · Les 24 · Gemiddeld · Versie: 3