La méthode toLocaleString() renvoie une chaîne de caractères uqi représente les éléments du tableau typé. Les éléments sont convertis en chaînes de caractères et séparés par une chaîne de caractères qui est fonction de la locale (la virgule « , » par exemple). Cette méthode utilise le même algorithme que Array.prototype.toLocaleString() et vu que les éléments d'un tableau typé sont des nombres, elle utilise le même algorithme que Number.prototype.toLocaleString() pour chaque élément. Dans la suite de cet article, TypedArray fait référence à l'un des types de tableau typé listés ici.
Syntaxe
typedarray.toLocaleString([locales [, options]]);
Paramètres
locales-
Paramètre optionnel. Une chaine de caractères avec un identifiant de langue BCP 47, ou un tableau de ce type de chaine de caractères. Pour le format général et l'interprétation de l'argument
locales, voir la pageIntl. Les clefs d'extensions Unicode suivantes sont autorisées :- nu
- Le système numérique à utiliser. Parmi les valeurs possibles, on a :
"arab", "arabext", "bali", "beng", "deva", "fullwide", "gujr", "guru", "hanidec", "khmr", "knda", "laoo", "latn", "limb", "mlym", "mong", "mymr", "orya", "tamldec", "telu", "thai", "tibt".
options-
Paramètre optionnel. Un objet avec certaines ou toutes les propriétés suivantes :
localeMatcher- L'algorithme de correspondance à utiliser pour la locale. Les valeurs possibles sont
"lookup"et"best fit"; le défaut est"best fit". Pour des informations sur cette option, voir la pageIntl.
-
style- Le style de formatage. Les valeurs possibles sont
"decimal"pour l'affichage de nombres simple,"currency"pour un affichage en fonction de la devise et"percent"pour afficher des pourcentages. La valeur par défaut est"decimal". currency- La devise à utiliser pour le formatage. Les valeurs possibles sont les codes ISO 4217 pour les devises, tels que
"USD"pour le dollar américain,"EUR"pour l'euro, ou"CNY"pour le yuan chinois. Voir la page listant les codes actuels pour les devises et les fonds (en anglais). Il n'y a pas de valeur par défaut. Si le style choisi avec l'optionstyleest "currency", la propriétécurrencydoit être définie. currencyDisplay- La façon d'afficher la devise dans le format courant. Les valeurs possibles sont
"symbol"qui permet d'utiliser un symbole localisé comme '€',"code"qui affichera le code ISO de la devise (voir ci-avant),"name"affichera un nom localisé pour la devise comme"dollar". La valeur par défaut est"symbol". useGrouping- Cette option indique si on doit utiliser des séparateurs de groupes (comme les séparateurs de milliers ou autres comme lakhs et crores). Les valeurs possibles sont
trueetfalse. La valeur par défauttrue.
Les propriétés suivantes peuvent être classées en deux groupes. Dans le premier on aura
minimumIntegerDigits,minimumFractionDigits,maximumFractionDigitset dans le second on auraminimumSignificantDigitsetmaximumSignificantDigits. S'il existe une option définie pour le second groupe, les options du premier groupe seront ignorées.minimumIntegerDigits- Le nombre minimal de chiffres à utiliser pour la partie entière. Les valeurs possibles sont comprises entre 1 to 21. La valeur par défaut est 1.
minimumFractionDigits- Le nombre minimal de chiffres à utiliser pour la partie fractionnaire. Les valeurs possibles sont comprises entre 0 et 20. Pour les formats
"decimal"et"percent", la valeur par défaut est 0. La valeur par défaut pour le formatage monétaire ("currency") correspond au nombre de chiffres défini par la liste de codes de devises ISO 4217, si cette valeur n'est pas définie dans cette liste, on aura 2 chiffres. maximumFractionDigits- Le nombre maximal de chiffres à utiliser pour représenter la partie fractionnaire. Les valeurs possibles sont comprises entre 0 et 20. Pour le format
"decimal", la valeur par défaut est le maximum entre 3 etminimumFractionDigits. Pour le format monétaire ("currency"), la valeur par défaut est le maximum entreminimumFractionDigitset le nombre de chiffres prévus par la liste ISO 4217 des codes de devises (ou 2 si cette information n'est pas disponible dans cette liste). Pour le format en pourcent, la valeur par défaut est le maximum entreminimumFractionDigitset 0. minimumSignificantDigits- Le nombre minimal de chiffres significatifs à utiliser. Les valeurs possibles sont comprises entre 1 et 21. La valeur par défaut est 1.
maximumSignificantDigits- Le nombre maximal de chiffres significatifs à utiliser. Les valeurs possibles sont comprises entre 1 et 21. La valeur par défaut est
minimumSignificantDigits.
Valeur de retour
Une chaîne de caractères qui représente les éléments du tableau typé.
Exemples
var uint = new Uint32Array([2000, 500, 8123, 12, 4212]);
uint.toLocaleString();
// Si on utilise la locale de-DE
// "2.000,500,8.123,12,4.212"
uint.toLocaleString("en-US");
// "2,000,500,8,123,12,4,212"
uint.toLocaleString('ja-JP', { style: 'currency', currency: 'JPY' });
// "￥2,000,￥500,￥8,123,￥12,￥4,212"
Spécifications
| Spécification | État | Commentaires |
|---|---|---|
| ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'TypedArray.prototype.toLocaleString' dans cette spécification. |
Standard | Définition initiale. |
| ECMAScript 2017 Draft (ECMA-262) La définition de 'TypedArray.prototype.toLocaleString' dans cette spécification. |
Projet |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Support simple | (Oui) | 51 (51) | (Oui) | (Oui) | (Oui) |
| Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Support simple | (Oui) | (Oui) | 51.0 (51) | (Oui) | (Oui) | (Oui) |