Intl.Locale() constructor
The Intl.Locale
constructor is a standard built-in property of the Intl object that represents a Unicode locale identifier.
Syntax
new Intl.Locale(tag) new Intl.Locale(tag, options)
Parameters
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.
Examples
Basic usage
At its very simplest, the Intl.Locale
constructor takes a locale identifier string as its argument:
let us = new Intl.Locale('en-US');
Using the Locale constructor with an options object
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"
Polyfill
Specifications
Specification |
---|
ECMAScript Internationalization API Specification (ECMAScript Internationalization API) # sec-intl-locale-constructor |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
Locale |
74 |
79 |
75 |
No |
62 |
14 |
74 |
74 |
79 |
53 |
14 |
11.0 |
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/Locale