Intl.Locale : méthode toString()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2020.

La méthode toString() des instances de Intl.Locale retourne l'identifiant complet de la locale ^(angl.) pour cette locale.

Exemple interactif

const french = new Intl.Locale("fr-Latn-FR", {
  calendar: "gregory",
  hourCycle: "h12",
});
const korean = new Intl.Locale("ko-Kore-KR", {
  numeric: true,
  caseFirst: "upper",
});

console.log(french.toString());
// Résultat attendu : "fr-Latn-FR-u-ca-gregory-hc-h12"

console.log(korean.toString());
// Résultat attendu : "ko-Kore-KR-u-kf-upper-kn"

Syntaxe

toString()

Valeur de retour

La chaîne de caractères Unicode identifiant la locale.

L'objet Locale est une représentation JavaScript d'un identifiant de locale Unicode. Les informations concernant une locale particulière (langue, script, type de calendrier, etc.) peuvent être encodées dans une chaîne de caractères identifiant la locale. Pour faciliter le travail avec ces identifiants de locale, l'objet Locale a été introduit en JavaScript. Appeler la méthode toString sur un objet Locale renverra la chaîne de caractères d'identifiant pour cette locale particulière. La méthode toString permet de fournir des instances de Locale comme argument aux constructeurs Intl existants, de les sérialiser en JSON ou de les utiliser dans tout autre contexte où une représentation exacte sous forme de chaîne de caractères est utile.

Exemples

Utiliser la méthode `toString()`

const maLocale = new Intl.Locale("fr-Latn-FR", {
  hourCycle: "h12",
  calendar: "gregory",
});
console.log(maLocale.baseName); // Affiche "fr-Latn-FR"
console.log(maLocale.toString()); // Affiche "fr-Latn-FR-u-ca-gregory-hc-h12"