The Intl.Locale
constructor is a standard built-in property of the Intl object that represents a Unicode locale identifier.
Intl.Locale() constructor
Try it
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"
Specifications
Browser compatibility
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | Deno | Node.js | |
Locale |
74
|
79
|
75
|
No
|
62
|
14
|
74
|
74
|
79
|
53
|
14
|
11.0
|
1.8
|
12.0.0
|
See also
© 2005–2022 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