Méthode toLocaleString() de Number JavaScript

Définition et utilisation

toLocaleString() Retourne un nombre sous forme de chaîne en utilisant le formatage linguistique local.

Le formatage linguistique dépend du réglage régional de votre ordinateur.

Exemple

Exemple 1

Utilisez le réglage régional pour formater un nombre en chaîne :

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

Essayer personnellement

Exemple 2

Utilisez l'environnement linguistique spécifique de la Finlande pour formater un nombre en chaîne :

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

Essayer personnellement

Exemple 3

Utilisez l'environnement linguistique spécifique des États-Unis pour formater un nombre en chaîne de devise :

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

Essayer personnellement

Exemple 4

Utiliser options Paramètres (objet) pour le formatage monétaire :

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

Essayer personnellement

Exemple 5

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

Essayer personnellement

Exemple 6

Utiliser l'environnement linguistique spécifique du JAPON :

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

Essayer personnellement

grammaire

number.toLocaleString(locales, options)

Paramètres

Paramètres Description
locales Optionnel. Format spécifique à la langue à utiliser. Voir le tableau suivant.
options Optionnel. Objet possédant des options de format. Voir le tableau suivant.

locales Valeurs acceptables :

  • ar-SA Arabe (Arabie saoudite)
  • bn-BD Bengali (Bangladesh)
  • bn-IN Bengali (Inde)
  • cs-CZ Tchèque (République tchèque)
  • da-DK Danois (Danemark)
  • de-AT Allemand autrichien
  • de-CH Allemand suisse
  • de-DE Allemand standard (utilisé en Allemagne)
  • el-GR Grec moderne
  • en-AU Anglais australien
  • en-CA Anglais canadien
  • en-GB Anglais britannique
  • en-IE Anglais irlandais
  • en-IN Anglais indien
  • en-NZ Anglais néo-zélandais
  • en-US Anglais américain
  • en-ZA Anglais (Afrique du Sud)
  • es-AR Espagnol argentin
  • es-CL Espagnol chilien
  • es-CO Espagnol colombien
  • es-ES Espagnol castillan (utilisé dans le nord-est de l'Espagne)
  • es-MX Espagnol mexicain
  • es-US Espagnol américain
  • fi-FI Finnois (Finlande)
  • fr-BE Français belge
  • fr-CA Français canadien
  • fr-CH Français suisse
  • fr-FR Français standard (surtout en France)
  • he-IL Hébreu (Israël)
  • hi-IN Hindi (Inde)
  • hu-HU Hongrie (Hongrie)
  • id-ID Indonésien (Indonésie)
  • it-CH Italien suisse
  • it-IT Italien standard (utilisé en Italie)
  • ja-JP Japonais (Japon)
  • ko-KR Coréen (République de Corée)
  • nl-BE Hollandais belge
  • nl-NL Hollandais standard (hollandais)
  • no-NO Norvégien (Norvège)
  • pl-PL Polonais (Pologne)
  • pt-BR Portugais brésilien
  • pt-PT Portugais européen (portugais écrit et parlé en Europe)
  • ro-RO Roumain (Roumanie)
  • ru-RU Russe (Fédération de Russie)
  • sk-SK Slovaque (Slovaquie)
  • sv-SE Suédois (Suède)
  • ta-IN Tamil de l'Inde
  • ta-LK Tamil du Sri Lanka
  • th-TH Thaï (Thaïlande)
  • tr-TR Turc (Turquie)
  • zh-CN Chine continentale, caractères chinois simplifiés
  • zh-HK Hong Kong, caractères chinois traditionnels
  • zh-TW Taïwan, caractères chinois traditionnels

options Options acceptées par le paramètre :

options valeur
currency Valeurs valides : tout code monétaire (comme "EUR", "USD", "INR" et autres)
currencyDisplay

Valeurs valides :

  • "symbol"(par défaut)
  • "code"
  • "name"
localeMatcher

Valeurs valides :

  • "best-fit"(par défaut)
  • "lookup"
maximumFractionDigits Nombre de 0 à 20 (par défaut 3)
maximumSignificantDigits Nombre de 1 à 21 (par défaut 21)
minimumFractionDigits Nombre de 0 à 20 (par défaut 3)
minimumIntegerDigits Nombre de 1 à 21 (par défaut 1)
minimumSignificantDigits Nombre de 1 à 21 (par défaut 21)
style

Valeurs valides :

  • "currency"
  • "decimal"(par défaut)
  • "percent"
useGrouping

Valeurs valides :

  • "true"(par défaut)
  • "false"

Valeur de retour

Type Description
Chaîne Représentation en chaîne de caractères de la valeur numérique locale.

Détails techniques

Valeur de retour

Représentation en chaîne de caractères du nombre, déterminée par l'implémentation, formatée selon les normes locales, ce qui peut affecter les points de séparation décimaux ou les séparateurs de milliers des points.

Lancée

Exception Description
TypeError Exception lancée lorsque l'objet appelant la méthode n'est pas un Number.

Compatibilité du navigateur

toLocaleString() C'est une caractéristique de ECMAScript3 (ES3).

Tous les navigateurs supportent complètement ES3 (JavaScript 1999) :

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Support Support Support Support Support Support