Intl.Locale() constructor

The Intl.Locale constructor is a standard built-in property of the Intl object that represents a Unicode locale identifier.

tag

The Unicode locale identifier string.

options

An object that contains configuration for the Locale. Keys are Unicode locale tags, values are valid Unicode tag values.

At its very simplest, the Intl.Locale constructor takes a locale identifier string as its argument:

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

The constructor also takes an optional configuration object argument, which can contain any of several extension types. For example, set the hourCycle property of the configuration object to your desired hour cycle type, and then pass it into the constructor:

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

• Intl.Collator
• Unicode locale identifiers spec
• A polyfill of Intl.Locale in FormatJS