The language
accessor property of Intl.Locale
instances returns the language associated with this locale.
The language
accessor property of Intl.Locale
instances returns the language associated with this locale.
Language is one of the core features of a locale. The Unicode specification treats the language identifier of a locale as the language and the region together (to make a distinction between dialects and variations, e.g. British English vs. American English). The language
property of a Intl.Locale
returns strictly the locale's language subtag.
In order to be a valid Unicode locale identifier, a string must start with the language subtag. The main argument to the Intl.Locale()
constructor must be a valid Unicode locale identifier, so whenever the constructor is used, it must be passed an identifier with a language subtag.
const locale = new Intl.Locale("en-Latn-US"); console.log(locale.language); // Prints "en"
While the language subtag must be specified, the Intl.Locale()
constructor takes a configuration object, which can override the language subtag.
const locale = new Intl.Locale("en-Latn-US", { language: "es" }); console.log(locale.language); // Prints "es"
Specification |
---|
ECMAScript Internationalization API Specification # sec-Intl.Locale.prototype.language |
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | Deno | Node.js | ||
language |
74 | 79 | 75 | 62 | 14 | 74 | 79 | 53 | 14 | 11.0 | 74 | 1.8 | 12.0.0 |
Intl.Locale
© 2005–2023 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/language