Intl.Locale.prototype.region

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

Описание

Регион является одним из основных атрибутов локали. Он позволяет выбирать различия между одним и тем же языком в, скажем, разных странах. Например, английский язык используется в Соединенном Королевстве и в Соединенных Штатах Америки, но между этими двумя странами существуют различия в написании и других языковых соглашениях. Знание региона локали помогает JavaScript-программистам убедиться, что контент их сайтов и приложений правильно отображается при просмотре из разных регионов мира.

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

Сеттер свойства region является undefined. Вы не можете изменить это свойство напрямую.

Примеры

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

Добавление региона через строку локали

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

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

Добавление региона через аргумент объекта конфигурации

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

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

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

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

См. также

• Intl.Locale
• Таблица регионов Unicode