La méthodetoLocaleString() des instances deArray retourne une chaîne de caractères représentant les éléments du tableau. Les éléments sont convertis en chaînes de caractères via leur méthodetoLocaleString et ces chaînes sont séparées par une chaîne spécifique à la locale (comme une virgule,).

Exemple interactif

const array1 = [1, "a", new Date("21 Dec 1997 14:12:00 UTC")];const localeString = array1.toLocaleString("en", { timeZone: "UTC" });console.log(localeString);// Résultat attendu : "1,a,12/21/1997, 2:12:00 PM",// Ceci suppose la locale "en" et le fuseau horaire UTC : votre résultat peut différer

Syntaxe

toLocaleString()toLocaleString(locales)toLocaleString(locales, options)

Paramètres

localesFacultatif

Une chaîne de caractères avec uneétiquette de langue BCP 47, ou un tableau de telles chaînes. Pour la forme générale et l'interprétation de l'argumentlocales, voirla description du paramètre sur la page principale de Intl.

optionsFacultatif

Un objet avec des propriétés de configuration. Ce que vous pouvez passer ici dépend des éléments à convertir. Par exemple, pour les nombres, voirNumber.prototype.toLocaleString().

Valeur de retour

Une chaîne de caractères qui représente les éléments du tableau.

Description

La méthodeArray.prototype.toLocaleString parcourt le contenu du tableau, appelle la méthodetoLocaleString de chaque élément avec les paramètreslocales etoptions fournis, puis concatène les résultats avec un séparateur défini par l'implémentation (par exemple une virgule,).

Si un élément vautundefined ounull, il est converti en chaîne de caractères vide au lieu de la chaîne de caractères"null" ou"undefined".

Lorsqu'elle est utilisée sur untableau creux, la méthodetoLocaleString() parcourt les cases vides comme si elles avaient la valeurundefined.

La méthodetoLocaleString() estgénérique. Elle attend seulement que la valeur dethis possède une propriétélength et des propriétés à clés entières.

Exemples

Utiliser les argumentslocales etoptions

Chaque élément du tableau est converti en chaîne de caractères via sa méthodetoLocaleString(). Par exemple, cet extrait appelle implicitement la méthodeNumber.prototype.toLocaleString() pour afficher la devise pour les chaînes de caractères et les nombres du tableauprix :

const prix = ["￥7", 500, 8123, 12];prix.toLocaleString("ja-JP", { style: "currency", currency: "JPY" });// "￥7,￥500,￥8,123,￥12"

Séparateur de liste

Le séparateur de liste n'est pas affecté par le paramètrelocales. Pour le configurer, utilisez plutôtIntl.ListFormat.

const nums = [8888, 9999];console.log(nums.toLocaleString("zh")); // "8,888,9,999"const formateur = new Intl.ListFormat("zh", {  type: "conjunction",  style: "narrow",});console.log(formateur.format(nums.map((x) => x.toLocaleString("zh"))));// "8,888、9,999"

Tableau creux et méthodetoLocaleString()

toLocaleString() traite les cases vides commeundefined et produit un séparateur supplémentaire :

console.log([1, , 3].toLocaleString()); // '1,,3'

Objet non tableau et méthodetoLocaleString()

La méthodetoLocaleString() lit la propriétélength dethis puis accède à chaque propriété dont la clé est un entier non négatif inférieur àlength.

const objetSimilaireTableau = {  length: 3,  0: 1,  1: 2,  2: 3,  3: 4, // ignoré par toLocaleString() car length vaut 3};console.log(Array.prototype.toLocaleString.call(objetSimilaireTableau));// 1,2,3

Spécifications

Compatibilité des navigateurs

Voir aussi

• Guide des collections indexées
• L'objet globalArray
• La méthodeArray.prototype.toString()
• La méthodeTypedArray.prototype.toLocaleString()
• L'objet globalIntl
• La propriétéIntl.ListFormat
• La méthodeObject.prototype.toLocaleString()
• La méthodeNumber.prototype.toLocaleString()
• La méthodeTemporal.PlainDate.prototype.toLocaleString()