Metodo Number toLocaleString() di JavaScript

Definizione e uso

toLocaleString() Restituisce il numero come una stringa utilizzando il formato della lingua locale.

Il formato della lingua dipende dalla configurazione della regione del tuo computer.

Esempio

Esempio 1

Utilizzando la configurazione della regione, formatta il numero come una stringa:

let num = 1000000;
let text = num.toLocaleString();

Prova personalmente

Esempio 2

Utilizzando l'ambiente linguistico specifico della Finlandia, formatta il numero come una stringa:

let num = 1000000;
let text = num.toLocaleString("fi-FI");

Prova personalmente

Esempio 3

Utilizzando l'ambiente linguistico specifico degli Stati Uniti, formatta il numero come una stringa di valuta:

let num = 1000000;
let text = num.toLocaleString("en-US", {style:"currency", currency:"USD"});

Prova personalmente

Esempio 4

Utilizza options Parametro (oggetto) per la formattazione monetaria:

let num = new Number(1000000);
const myObj = {
  style: "currency",
  currency: "EUR"
}
let text = num.toLocaleString("en-GB", myObj);

Prova personalmente

Esempio 5

let num = new Number(1000000);
let text = num.toLocaleString("en-GB", {style:"currency", currency:"EUR"});

Prova personalmente

Esempio 6

Utilizza l'ambiente linguistico specifico del JAPAN:

let num = 1000000;
let text = num.toLocaleString("ja-JP", {style:"currency", currency:"JPY"});

Prova personalmente

Grammatica

number.toLocaleString(locales, options)

Parametro

Parametro Descrizione
locales Opzionale. Formato linguistico da utilizzare. Vedi la tabella sottostante.
options Opzionale. Oggetto con opzioni di formato. Vedi la tabella sottostante.

locales Valori accettabili:

  • ar-SA Arabo (Arabia Saudita)
  • bn-BD Bengalese (Bangladesh)
  • bn-IN Bengalese (India)
  • cs-CZ Ceseno (Repubblica Ceca)
  • da-DK Danese (Danimarca)
  • de-AT Tedesco austriaco
  • de-CH Tedesco "Svizzero"
  • de-DE Tedesco standard (utilizzato in Germania)
  • el-GR Greco moderno
  • en-AU Inglese australiano
  • en-CA Inglese canadese
  • en-GB Inglese britannico
  • en-IE Inglese irlandese
  • en-IN Inglese indiano
  • en-NZ Inglese neozelandese
  • en-US Inglese americano
  • en-ZA Inglese (Sud Africa)
  • es-AR Spagnolo argentino
  • es-CL Spagnolo cileno
  • es-CO Spagnolo colombiano
  • es-ES Spagnolo castigliano (utilizzato nella parte centro-meridionale della Spagna)
  • es-MX Spagnolo messicano
  • es-US Spagnolo americano
  • fi-FI Finlandese (Finlandia)
  • fr-BE Francese belga
  • fr-CA Francese canadese
  • fr-CH Francese "Svizzero"
  • fr-FR Francese standard (soprattutto in Francia)
  • he-IL Ebraico (Israele)
  • hi-IN Hindi (India)
  • hu-HU Ungherese (Ungheria)
  • id-ID Indonesiano (Indonesia)
  • it-CH Italiano svizzero
  • it-IT Italiano standard (utilizzato in Italia)
  • ja-JP Giapponese (Giappone)
  • ko-KR Coreano (Repubblica di Corea)
  • nl-BE Olandese belga
  • nl-NL Olandese standard (olandese)
  • no-NO Norvegese (Norvegia)
  • pl-PL Polacco (Polonia)
  • pt-BR Portoghese brasiliano
  • pt-PT Portoghese europeo (portoghese scritto e parlato)
  • ro-RO Rumeno (Romania)
  • ru-RU Russo (Federazione Russa)
  • sk-SK Slovacco (Slovacchia)
  • sv-SE Svedese (Svezia)
  • ta-IN Tamil dell'India
  • ta-LK Tamil dello Sri Lanka
  • th-TH Tailandese (Tailandia)
  • tr-TR Turchese (Turchia)
  • zh-CN Cina continentale, caratteri cinesi semplificati
  • zh-HK Hong Kong, caratteri cinesi tradizionali
  • zh-TW Taiwan, caratteri cinesi tradizionali

options Opzioni accettate dai parametri:

Opzioni Valore
currency Valori validi: qualsiasi codice di valuta (ad esempio "EUR", "USD", "INR" ecc.)
currencyDisplay

Valori validi:

  • "symbol"(predefinito)
  • "code"
  • "name"
localeMatcher

Valori validi:

  • "best-fit"(predefinito)
  • "lookup"
maximumFractionDigits Numero da 0 a 20 (predefinito a 3)
maximumSignificantDigits Numero da 1 a 21 (predefinito a 21)
minimumFractionDigits Numero da 0 a 20 (predefinito a 3)
minimumIntegerDigits Numero da 1 a 21 (predefinito a 1)
minimumSignificantDigits Numero da 1 a 21 (predefinito a 21)
style

Valori validi:

  • "currency"
  • "decimal"(predefinito)
  • "percent"
useGrouping

Valori validi:

  • "true"(predefinito)
  • "false"

Valore di ritorno

Tipo Descrizione
Stringa Rappresentazione in stringa del numero in formato locale.

Dettagli tecnici

Valore di ritorno

La rappresentazione in stringa del numero, decisa dall'implementazione, viene formattata secondo la norma locale, può influenzare i simboli di separazione dei decimali o dei separatori di migliaia.

Lancia

Eccezione Descrizione
TypeError L'oggetto che chiama questo metodo non è Number, viene lanciata un'eccezione.

Supporto del browser

toLocaleString() È una caratteristica di ECMAScript3 (ES3).

Tutti i browser supportano completamente ES3 (JavaScript 1999):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Supporto Supporto Supporto Supporto Supporto Supporto