Constructeur Intl.Locale()

Le constructeur Intl.Locale est une propriété native de l'objet Intl qui permet de créer des objets qui représentent des locales Unicode.

Exemple interactif

Syntaxe

js
new Intl.Locale(tag);
new Intl.Locale(tag, options);

Paramètres

tag

La balise Unicode qui représente une locale.

options

Un objet qui contient la configuration à utiliser pour la locale. Les propriétés sont des balises de locale Unicode et les valeurs de ces propriétés sont les valeurs autorisées pour ces balises.

Exemples

Usage simple

Sous sa forme la plus simple, le constructeur [Intl.Locale] prend comme argument une chaîne de caractères représentant un identifiant de locale :

js
let us = new Intl.Locale("en-US");

Utiliser le constructeur Locale avec un objet options

Le constructeur prend un deuxième argument qui permet de configurer la locale et d'indiquer plusieurs types d'extensions. Ainsi, la propriété hourCycle utilisée sur l'objet de configuration permettra d'indiquer le type de cycle horaire souhaité :

js
let locale = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(locale.hourCycle); // affiche "h12"

Prothèse d'émulation (polyfill)

Spécifications

Specification
ECMAScript Internationalization API Specification
# sec-intl-locale-constructor

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi