Temporal.Instant.prototype.toLocaleString()

Метод toLocaleString() экземпляров Temporal.Instant возвращает строку с языково-чувствительным представлением этого момента времени. В реализациях с поддержкой Intl.DateTimeFormat API этот метод делегирует выполнение Intl.DateTimeFormat.

Каждый раз, когда вызывается toLocaleString, ему приходится выполнять поиск в большой базе данных строк локализации, что потенциально неэффективно. Когда метод вызывается многократно с одними и теми же аргументами, лучше создать объект Intl.DateTimeFormat и использовать его метод format(), поскольку объект DateTimeFormat запоминает переданные ему аргументы и может решить кэшировать часть базы данных, чтобы будущие вызовы format могли искать строки локализации в более ограниченном контексте.

Синтаксис

toLocaleString()
toLocaleString(locales)
toLocaleString(locales, options)

Параметры

Параметры locales и options настраивают поведение функции и позволяют приложениям указывать язык, чьи соглашения о форматировании должны использоваться.

В реализациях, поддерживающих Intl.DateTimeFormat API, эти параметры точно соответствуют параметрам конструктора Intl.DateTimeFormat(). Реализации без поддержки Intl.DateTimeFormat возвращают точно такую же строку, как toString(), игнорируя оба параметра.

locales Необязательно

Строка с тегом языка BCP 47, или массив таких строк. Соответствует параметру locales конструктора Intl.DateTimeFormat().

options Необязательно

Объект, настраивающий формат вывода. Соответствует параметру options конструктора Intl.DateTimeFormat().

См. конструктор Intl.DateTimeFormat() для получения подробной информации об этих параметрах и способах их использования.

Возвращаемое значение

Строка, представляющая данный момент времени в соответствии с языковыми соглашениями.

В реализациях с Intl.DateTimeFormat это эквивалентно new Intl.DateTimeFormat(locales, options).format(instant).

Примеры

Использование toLocaleString()

Базовое использование этого метода без указания locale возвращает отформатированную строку в локали по умолчанию и с опциями по умолчанию.

const instant = Temporal.Instant.from("2021-08-01T12:34:56Z");

console.log(instant.toLocaleString()); // 8/1/2021, 12:34:56 AM (assuming en-US locale and device in UTC time zone)

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

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

Смотрите также

• Temporal.Instant
• Intl.DateTimeFormat
• Temporal.Instant.prototype.toJSON()
• Temporal.Instant.prototype.toString()