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.

Dans cet article

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()

js
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"

L'objet Intl.Locale
La propriété baseName

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 26 avr. 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Intl.Locale
Constructeur
1. Intl.Locale()
Méthodes d'instance
1. getCalendars()
2. getCollations()
3. getHourCycles()
4. getNumberingSystems()
5. getTextInfo()
6. getTimeZones()
7. getWeekInfo()
8. maximize()
9. minimize()
10. toString()
Propriétés d'instance
1. baseName
2. calendar
3. caseFirst
4. collation
5. hourCycle
6. language
7. numberingSystem
8. numeric
9. region
10. script
11. variants
Héritage
Object/Function
Méthodes statiques
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Propriétés statiques
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Méthodes d'instance
1. Object.prototype.__defineGetter__()
2. Object.prototype.__defineSetter__()
3. Object.prototype.__lookupGetter__()
4. Object.prototype.__lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. Object.prototype.isPrototypeOf()
7. Object.prototype.propertyIsEnumerable()
8. Object.prototype.toLocaleString()
9. Object.prototype.toString()
10. Object.prototype.valueOf()
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor
Pages similaires
Intl
Intl.Collator
Intl.DateTimeFormat
Intl.DisplayNames
Intl.DurationFormat
Intl.ListFormat
Intl.NumberFormat
Intl.PluralRules
Intl.RelativeTimeFormat
Intl.Segmenter

Intl.Locale : méthode toString()

Dans cet article

Exemple interactif

Syntaxe

Paramètres

Valeur de retour

Description

Exemples

Utiliser la méthode toString()

Spécifications

Compatibilité des navigateurs

Voir aussi

Aider à améliorer MDN