Méthode JavaScript Number.toLocaleString()Method

Number 对象参考手册Objet Number JavaScript

Exemple

Formater une chaîne à l'aide des paramètres régionaux :

let num1 = 1000000; let text1 = num1.toLocaleString(); //Formater un nombre sous forme de chaîne en utilisant une locale spécifique let num2 = 1000000; let text2 = num2.toLocaleString("fi-FI"); //Formater un nombre sous forme de chaîne monétaire en utilisant une locale spécifique //RMB let num3 = 1000000; let text3 = num3.toLocaleString("zh-CN", {style:"currency", currency:"CNY"}); //Dollar américain let num4 = 1000000; let text4 = num4.toLocaleString("en-US", {style:"currency", currency:"USD"});

Essayez-le vous-même »

Définition et utilisation

La méthode toLocaleString() renvoie une représentation sous forme de chaîne d'un nombre dans une locale spécifique.

Les nouveaux paramètres locales et options permettent à l'application de spécifier la langue à utiliser pour le formatage et de personnaliser le comportement de la fonction. Dans les anciennes implémentations, les paramètres locales et options sont ignorés, et la locale utilisée ainsi que la forme de la chaîne renvoyée dépendent entièrement de l'implémentation.


Prise en charge des navigateurs

Number.toLocaleString() est une fonctionnalité d'ECMAScript3 (ES3).

Tous les navigateurs prennent en charge ES3 (JavaScript 1999).

Chrome IE Edge Firefox Safari Opera
Oui Oui Oui Oui Oui Oui

Pris en charge dans toutes les dernières versions de navigateurs(locales, options)Paramètres :

Chrome IE Edge Firefox Safari Opera
Oui 11 Oui Oui Oui Oui

Syntaxe

number.toLocaleString(locales, options)

Valeurs des paramètres

Paramètre Description
locales Facultatif. Un objet de formatage, peut être :

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
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 centre-nord de l'Espagne)
es-MX Espagnol mexicain
es-US Espagnol d'Amérique latine
fi-FI Finnois (Finlande)
fr-BE Français de Belgique
fr-CA Français canadien
fr-CH Français "suisse"
fr-FR Français standard (en France)
he-IL Hébreu (Israël)
hi-IN Hindi (Inde)
hu-HU Hongrois (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 (Corée du Sud)
nl-BE Néerlandais belge
nl-NL Néerlandais standard
no-NO Norvégien (Norvège)
pl-PL Polonais (Pologne)
pt-BR Portugais brésilien
pt-PT Portugais européen
ro-RO Roumain (Roumanie)
ru-RU Russe (Fédération de Russie)
sk-SK Slovaque (Slovaquie)
sv-SE Suédois (Suède)
ta-IN Tamoul (Inde)
ta-LK Tamoul (Sri Lanka)
th-TH Thaï (Thaïlande)
tr-TR Turc (Turquie)
zh-CN Chine continentale, chinois simplifié
zh-HK Hong Kong, chinois traditionnel
zh-TW Taïwan, chinois traditionnel

options Facultatif. Peut être :
  • "decimal"Utilisé pour le formatage des nombres simples ;
  • "currency"Utilisé pour le formatage des devises ;
  • "percent"Utilisé pour le formatage des pourcentages ;
  • "unit"Utilisé pour le formatage des unités

Valeur de retour

Type Description
String Renvoie une représentation sous forme de chaîne dans une locale.

Détails techniques

Version JavaScript : ECMAScript 6

Plus d’exemples

Exemple

Utilisez des paramètres optionnels pour formater une chaîne de devise:

let num1 = new Number(1000000); const myObj = { style: "currency", currency: "EUR" } let text1 = num1.toLocaleString("en-GB", myObj); let num2 = new Number(1000000); let text2 = num2.toLocaleString("en-GB", {style:"currency", currency:"EUR"}); //RMB let num3 = 1000000; let text3 = num3.toLocaleString("zh-CN", {style:"currency", currency:"CNY"}); //Yen japonais let num4 = 1000000; let text4 = num4.toLocaleString("ja-JP", {style:"currency", currency:"JPY"});

Essayez-le vous-même »

Number 对象参考手册Objet Number JavaScript

Autres extensions