Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Intl.NumberFormat: opzioni per valute e percentuali

Formatta importi e proporzioni in base alle impostazioni locali. Scopri quando è obbligatorio il codice della valuta, perché 0,125 equivale al 12,5% e come impostare le cifre decimali.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

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) crea un formattatore riutilizzabile; format(value) restituisce testo localizzato. Le impostazioni locali influiscono, per esempio, sui separatori e sulla posizione dei simboli. style sceglie il tipo di visualizzazione e per impostazione predefinita vale "decimal".

Con style: "currency", indica in currency un codice come "USD". Passa l’importo nell’unità monetaria principale, non in centesimi: la formattazione non converte le valute. Se ometti il codice viene generato un TypeError; se il codice non è composto da tre lettere ASCII viene generato un RangeError. Un codice ben formato non è necessariamente assegnato a una valuta. currencyDisplay sceglie "symbol" (predefinito), "narrowSymbol" (simbolo breve), "code" o "name". Il valore predefinito di currencySign è "standard"; "accounting" può mostrare gli importi negativi tra parentesi, a seconda delle impostazioni locali.

Con style: "percent", passa una proporzione: il formattatore la moltiplica per 100 prima di arrotondarla. Per mostrare il 12,5%, passa 0.125, non 12.5. Con la notazione standard e senza impostare le cifre significative, il numero predefinito di cifre decimali dipende dall’unità frazionaria della valuta (due per USD), mentre per la percentuale è zero. minimumFractionDigits aggiunge zeri se necessario; maximumFractionDigits limita le cifre decimali nell’arrotondamento. Con l’impostazione predefinita trailingZeroDisplay: "auto", imposta entrambe allo stesso valore per visualizzare esattamente quel numero di cifre decimali. Con trailingZeroDisplay: "stripIfInteger", la parte decimale viene omessa se il risultato arrotondato è un numero intero.

I dati locali e il supporto dell’ambiente di esecuzione possono variare. Spazi e simboli possono differire anche con le stesse impostazioni locali, quindi evita di confrontare l’intera stringa localizzata con un valore fisso. Usa formatToParts() per esaminare i componenti per tipo.

Esempi

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"),
]));

Risultato

["USD","19","90"]
["12","5",true]

La prima riga mostra il codice USD e le due parti dell’importo, incluso lo zero finale. La seconda mostra le parti numeriche del 12,5% e conferma la presenza del simbolo di percentuale senza verificarne il carattere esatto o la posizione.

Lezioni correlate

  • JavaScript · Lezione 24 · Intermedio · Versione: 3

Fonti