The Intl.Locale.prototype.region
property is an accessor property that returns the region of the world (usually a country) associated with the locale.
Description
The region is an essential part of the locale identifier, as it places the locale in a specific area of the world. Knowing the locale's region is vital to identifying differences between locales. For example, English is spoken in the United Kingdom and the United States of America, but there are differences in spelling and other language conventions between those two countries. Knowing the locale's region helps JavaScript programmers make sure that the content from their sites and applications is correctly displayed when viewed from different areas of the world.
Examples
Setting the region in the locale identifer string argument
The region is the third part of a valid Unicode language identifier string, and can be set by adding it to the locale identifier string that is passed into the Locale
constructor. The region is a mandatory part of a
let regionStr = new Intl.Locale("en-Latn-US"); console.log(regionStr.region); // Prints "US"
Setting the region via the configuration object
The Locale
constructor takes a configuration object, which can be used to set the region subtag and property.
let regionObj = new Intl.Locale("fr-Latn", {region: "FR"}); console.log(regionObj.region); // Prints "FR"
Specifications
Specification |
---|
ECMAScript Internationalization API (ECMA-402) |
Browser compatibility
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
region | Chrome Full support 74 | Edge Full support 79 | Firefox Full support 75 | IE No support No | Opera Full support 62 | Safari Full support 14 | WebView Android Full support 74 | Chrome Android Full support 74 | Firefox Android No support No | Opera Android Full support 53 | Safari iOS Full support 14 | Samsung Internet Android Full support 11.0 | nodejs
Full support
12.0.0
|
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
- See implementation notes.