Constructeur Intl.Locale()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

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

const korean = new Intl.Locale("ko", {
  script: "Kore",
  region: "KR",
  hourCycle: "h23",
  calendar: "gregory",
});

const japanese = new Intl.Locale("ja-Jpan-JP-u-ca-japanese-hc-h12");

console.log(korean.baseName, japanese.baseName);
// Expected output: "ko-Kore-KR" "ja-Jpan-JP"

console.log(korean.hourCycle, japanese.hourCycle);
// Expected output: "h23" "h12"

Syntaxe

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 :

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é :

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

Prothèse d'émulation (polyfill)

Prothèse formatjs pour Intl.Locale

Spécifications

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