Intl.Locale.prototype.language

Свойство доступа (аксессор) language экземпляров Intl.Locale возвращает язык, связанный с этой локалью.

Описание

Язык является одним из основных атрибутов локали. Спецификация Unicode рассматривает языковой идентификатор локали как сочетание языка и региона (чтобы провести различие между диалектами и вариациями, например, британский английский против американского английского). Свойство language экземпляра Intl.Locale возвращает строго языковой субтег локали.

Значение свойства language устанавливается во время конструирования либо через первую часть идентификатора локали, либо через опцию language конструктора Intl.Locale(). Последний имеет приоритет, если оба присутствуют.

Сет-аксессор (set accessor) свойства language — undefined. Вы не можете изменить это свойство напрямую.

Примеры

Как и другие субтеги локали, язык может быть добавлен к объекту Intl.Locale через строку локали или аргумент объекта конфигурации конструктора.

Установка языка с помощью строки локали

Чтобы быть действительным идентификатором локали Unicode, строка должна начинаться с языкового субтега. Основной аргумент конструктора Intl.Locale() должен быть действительным идентификатором локали Unicode, поэтому всякий раз, когда используется конструктор, ему должен быть передан идентификатор с языковым субтегом.

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

Переопределение языка с помощью аргумента объекта конфигурации

Хотя языковой субтег должен быть указан, конструктор Intl.Locale() имеет необязательный аргумент объекта конфигурации, который может переопределить языковой субтег.

const locale = new Intl.Locale("en-Latn-US", { language: "es" });
console.log(locale.language); // "es"

Спецификации

Совместимость с браузерами

См. также

• Intl.Locale
• Unicode language subtag в спецификации языка разметки данных локали Unicode