Intl.Locale.prototype.region

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

DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
regionChrome Full support 74Edge Full support 79Firefox Full support 75IE No support NoOpera Full support 62Safari Full support 14WebView Android Full support 74Chrome Android Full support 74Firefox Android No support NoOpera Android Full support 53Safari iOS Full support 14Samsung Internet Android Full support 11.0nodejs Full support 12.0.0
Notes
Full support 12.0.0
Notes
Notes Before version 13.0.0, only the locale data for en-US is available by default. See the Locale() constructor for more details.

Legend

Full support
Full support
No support
No support
See implementation notes.
See implementation notes.

See also