Intl.Locale

Объект Intl.Locale — это стандартное встроенное свойство объекта Intl, представляющее идентификатор локали Unicode.

Попробуйте

const korean = new Intl.Locale("ko", {
  script: "Kore",
  region: "KR",
  hourCycle: "h23",
  calendar: "gregory",
});

const japanese = new Intl.Locale("ja-Jpan-JP-u-ca-japanese-hc-h12");

console.log(korean.baseName, japanese.baseName);
// Expected output: "ko-Kore-KR" "ja-Jpan-JP"

console.log(korean.hourCycle, japanese.hourCycle);
// Expected output: "h23" "h12"

Описание

Объект Intl.Locale был создан для упрощения работы с локалями Unicode. В Unicode локали представлены строкой, называемой идентификатором локали. Идентификатор локали состоит из идентификатора языка и тегов расширений. Идентификаторы языка — это основа локали, состоящая из под-тегов языка, письменности, региона и вариантов. Дополнительные сведения о локали хранятся в необязательных тегах расширений. Теги расширений содержат информацию о таких характеристиках локали, как тип календаря, формат часов и система счисления.

Традиционно API Intl использовал для представления локалей строки, как и Unicode. Это простое и компактное решение, которое хорошо работает. Однако добавление класса Locale упрощает разбор и изменение языка, письменности и региона, а также тегов расширений. Следующие свойства Intl.Locale соответствуют под-тегам идентификатора локали Unicode:

Приведённая выше информация предоставляется в точности в исходном виде при создании объекта Locale без обращения к внешним базам данных. Объект Intl.Locale также предоставляет методы, возвращающие сведения о локали в реальном мире, например о доступных календарях, правилах сортировки и системах счисления.

Конструктор

Intl.Locale()

Создаёт новый объект Locale.

Свойства экземпляра

Эти свойства определены в Intl.Locale.prototype и доступны всем экземплярам Intl.Locale.

Intl.Locale.prototype.baseName

Возвращает основные сведения о Locale в виде подстроки полной строки данных.

Intl.Locale.prototype.calendar

Возвращает часть Locale, указывающую на календарную эру локали.

Intl.Locale.prototype.caseFirst

Возвращает сведения о том, учитывается ли регистр в правилах сортировки локали.

Intl.Locale.prototype.collation

Возвращает тип сортировки для Locale, используемый для упорядочивания строк согласно правилам локали.

Intl.Locale.prototype.constructor

Функция-конструктор, создавшая объект экземпляра. Для экземпляров Intl.Locale начальным значением является конструктор Intl.Locale.

Intl.Locale.prototype.hourCycle

Возвращает принятый в локали формат отображения времени.

Intl.Locale.prototype.language

Возвращает язык, связанный с локалью.

Intl.Locale.prototype.numberingSystem

Возвращает систему счисления, используемую в локали.

Intl.Locale.prototype.numeric

Возвращает сведения о том, применяются ли в локали особые правила сортировки для числовых символов.

Intl.Locale.prototype.region

Возвращает регион мира (обычно страну), связанный с локалью.

Intl.Locale.prototype.script

Возвращает письменность, используемую для записи языка, указанного в локали.

Intl.Locale.prototype.variants

Возвращает под-теги вариантов (например, различные варианты орфографии), связанные с локалью.

Intl.Locale.prototype[Symbol.toStringTag]

Начальное значение свойства [Symbol.toStringTag] — строка "Intl.Locale". Это свойство используется в Object.prototype.toString().

Методы экземпляра

Intl.Locale.prototype.getCalendars()

Возвращает Array доступных идентификаторов календарей согласно правилам локали.

Intl.Locale.prototype.getCollations()

Возвращает Array типов сортировки для Locale.

Intl.Locale.prototype.getHourCycles()

Возвращает Array идентификаторов формата часов: 12-часовой формат ("h12"), японский 12-часовой формат ("h11"), 24-часовой формат ("h23") или неиспользуемый формат "h24".

Intl.Locale.prototype.getNumberingSystems()

Возвращает Array идентификаторов систем счисления, доступных согласно правилам локали.

Intl.Locale.prototype.getTextInfo()

Возвращает часть, указывающую направление текста: ltr (слева направо) или rtl (справа налево).

Intl.Locale.prototype.getTimeZones()

Возвращает Array идентификаторов часовых поясов, связанных с Locale.

Intl.Locale.prototype.getWeekInfo()

Возвращает элементы недель из UTS 35 согласно правилам локали: элементы недель UTS 35.

Intl.Locale.prototype.maximize()

Определяет наиболее вероятные значения языка, письменности и региона локали на основе имеющихся значений.

Intl.Locale.prototype.minimize()

Пытается удалить сведения о локали, которые были бы добавлены при вызове maximize().

Intl.Locale.prototype.toString()

Возвращает полную строку идентификатора локали.

Примеры

Основное использование

В самом простом случае конструктор Intl.Locale() принимает строку идентификатора локали в качестве аргумента:

const us = new Intl.Locale("en-US");

Использование конструктора Locale с объектом параметров

Конструктор также принимает необязательный аргумент — объект конфигурации, который может содержать один из нескольких типов расширений. Например, задайте свойству hourCycle объекта конфигурации нужный формат часов, а затем передайте его конструктору:

const us12hour = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(us12hour.hourCycle); // Prints "h12"

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

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

См. также

• Полифил для Intl.Locale в FormatJS
• Intl
• Канонические идентификаторы локалей Unicode в спецификации языка разметки данных локалей Unicode