Intl.Locale.prototype.region

The region accessor property of Intl.Locale instances returns the region of the world (usually a country) associated with this 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 identifier 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 Intl.Locale() constructor. The region is a mandatory part of a

js

const locale = new Intl.Locale("en-Latn-US");
console.log(locale.region); // Prints "US"

Setting the region via the configuration object

The Intl.Locale() constructor takes a configuration object, which can be used to set the region subtag and property.

js

const locale = new Intl.Locale("fr-Latn", { region: "FR" });
console.log(locale.region); // Prints "FR"

Specifications

Specification
ECMAScript Internationalization API Specification
# sec-Intl.Locale.prototype.region

Browser compatibility

BCD tables only load in the browser

See also