Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Intl.NumberFormat — formattazione dei numeri in base alla lingua e area geografica

Intl.NumberFormat converte i numeri in testo usando una locale e opzioni di formattazione. Consente di controllare, tra l’altro, il raggruppamento delle cifre e i decimali; format restituisce una funzione associata a uno specifico formatter.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

const formatter = new Intl.NumberFormat(locales, options);
formatter.format(value);

Intl.NumberFormat crea un formatter numerico usando locales e options. Fa parte di ECMA-402, non dell’API DOM. La formattazione produce testo da visualizzare, non un nuovo valore numerico né un parser per numeri localizzati.

Intl.NumberFormat.prototype.format è una proprietà accessor: quando viene letta da un’istanza, restituisce una funzione associata a quell’istanza. Perciò, const format = formatter.format permette di chiamare in seguito format(value) senza perdere le impostazioni. Lo stesso formatter può essere riutilizzato per più valori.

minimumFractionDigits imposta il numero minimo e maximumFractionDigits il numero massimo di cifre dopo il separatore decimale. Quando si applicano questi limiti, impostarli entrambi a 2 fa sì che, con l’impostazione predefinita trailingZeroDisplay: "auto", si visualizzino due cifre dopo il separatore decimale, con arrotondamento se necessario. Con trailingZeroDisplay: "stripIfInteger", gli zeri dopo il separatore decimale vengono omessi se il risultato arrotondato è un intero. Con l’impostazione predefinita roundingPriority: "auto", se si specifica maximumSignificantDigits, il formatter ignora entrambi i limiti sulle cifre decimali. useGrouping: false disattiva il raggruppamento. Lo stile currency richiede un’opzione currency, ma non converte i tassi di cambio.

L’esempio seleziona esplicitamente en-US e le cifre latn. La disponibilità delle locale e i dettagli della formattazione possono dipendere dall’implementazione e dai relativi dati locali. Verifica il risultato nel browser di destinazione; la disponibilità in Node 24 non dimostra il supporto nei browser.

Esempi

const formatter = new Intl.NumberFormat("en-US", {
  numberingSystem: "latn",
  useGrouping: false,
  minimumFractionDigits: 2,
  maximumFractionDigits: 2
});
const format = formatter.format;
console.log(format(1234.5));

Risultato

1234.50

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti