Méthode JavaScript Array.toLocaleString()

Array 对象参考手册Objet Array JavaScript


Exemple

Formater selon divers formats régionaux :

const prices = [1234.56, 7890.12, 3456.78]; const dateArray = [new Date(), new Date('2023-01-01')]; //Number les tableaux utilisent le format localisé console.log(prices.toLocaleString('en-US')); //Sortie similaire à : "1,234.56,7,890.12,3,456.78" (format anglais) console.log(prices.toLocaleString('de-DE')); //Sortie similaire à : "1.234,56,7.890,12,3.456,78" (format allemand) //Les tableaux de dates utilisent le format localisé console.log(dateArray.toLocaleString('en-US')); //Sortie similaire à : "5/6/2023, 1/1/2023" (format de date anglais) console.log(dateArray.toLocaleString('ja-JP')); //Sortie similaire à : "2023/5/6, 2023/1/1" (format de date japonais)

Essayez-le vous-même »

Définition et utilisation

Array.toLocaleString()C'est une méthode intégrée de l'objet tableau JavaScript qui renvoie une chaîne représentant les éléments du tableau.

Array.toLocaleString()La particularité de cette méthode est qu'elle formate chaque élément du tableau selon les paramètres régionaux de l'environnement actuel.

En termes simples, cette méthode :

  • Convertit un tableau en chaîne
  • Gère automatiquement les formats localisés (tels que les dates, les nombres, etc.)
  • Les éléments sont séparés par des virgules

Syntaxe de base

array.toLocaleString([locales[, options]])

Description du paramètre

  • locales(Facultatif) : Une chaîne ou un tableau de chaînes représentant le code de langue (par ex., "en-US", "zh-CN")
  • options(Facultatif) : Un objet de configuration utilisé pour spécifier les options de formatage

Comment utiliser

Utilisation de base

Exemple

const numbers = [12345.67, 1000, 3.14159];
console.log(numbers.toLocaleString('en-US'));
// Sortie : "12,345.67,1,000,3.142"

console.log(numbers.toLocaleString('de-DE'));
// Sortie : "12.345,67,1.000,3,142"

Gestion des objets Date

Exemple

const dates = [new Date(), new Date('2023-01-01')];
console.log(dates.toLocaleString('en-US'));
// Sortie possible : "1/2/2024, 2:30:45 PM,1/1/2023, 12:00:00 AM"

Utilisation avancée

Utilisation du paramètre options

Exemple

const numbers = [12345.67, 1000, 3.14159];

// Spécifier le format monétaire
console.log(numbers.toLocaleString('en-US', {
  style: 'currency',
  currency: 'USD'
}));
// Sortie : "$12,345.67,$1,000.00,$3.14"

// Spécifier le format de pourcentage
console.log([0.25, 0.5, 0.75].toLocaleString('en-US', {
  style: 'percent'
}));
// Sortie : "25%,50%,75%"

Différence par rapport à toString()

Méthode Gestion de la localisation Formatage des dates Formatage des nombres
toString() Aucune Convertit en chaîne par défaut Aucun traitement spécial
toLocaleString() Oui Selon le format local Selon le format local

Exemple

const arr = [1000, new Date()];

console.log(arr.toString());
// Sortie : "1000,Wed Jan 03 2024 14:30:00 GMT+0800 (China Standard Time)"

console.log(arr.toLocaleString('zh-CN'));
// Sortie : "1,000,2024/1/3 14:30:00"

Scénarios d'application pratiques

  1. Sites web multilingues: Afficher les données formatées en fonction des préférences linguistiques de l'utilisateur
  2. Applications financières: Afficher correctement les formats monétaires pour différentes régions
  3. Analyse de données: Afficher les nombres et les dates dans des formats familiers
  4. Affichage de formulaire: Afficher les données dans des formats localisés dans les champs de saisie

Notes

  1. Considérations relatives aux performances: Les appels fréquents peuvent affecter les performances, en particulier sur les grands tableaux
  2. Compatibilité des navigateurs: Bien que les navigateurs modernes le prennent en charge, certaines options peuvent différer
  3. Comportement par défaut: Si le paramètre locales n'est pas spécifié, les paramètres de langue par défaut de l'environnement d'exécution sont utilisés
  4. Gestion des éléments: Pour les objets qui ne sont pas des dates/nombres, sa méthode toString() sera appelée

Résumé

Array.toLocaleString()C'est un puissant outil de localisation, particulièrement adapté aux scénarios dans lesquels des données formatées doivent être affichées selon la région de l'utilisateur. Il simplifie la mise en œuvre de l'internationalisation (i18n), permettant aux développeurs de gérer facilement les différences de formats de nombres et de dates entre les régions.

N'oubliez pas : lorsque votre application doit servir des utilisateurs du monde entier, l'utilisation de cette méthode peut considérablement améliorer l'expérience utilisateur !

Array 对象参考手册Objet Array JavaScript

Autres extensions