Date.prototype.toLocaleDateString()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..
Метод toLocaleDateString() возвращает строку с языкозависимым представлением части с датой в этой дате. Новые аргументы locales и options позволяют приложениям определять язык, чьи соглашения по форматированию должны использоваться, а также менять поведение этого метода. В старых реализациях, игнорирующих аргументы locales и options, используемая локаль и форма возвращённой строки целиком зависит от реализации.
При форматировании большого количества дат лучшим вариантом будет создание объекта Intl.DateTimeFormat и использование функции, предоставляемой его свойством format.
Интерактивный пример
Синтаксис
Параметры
Параметры locales и options изменяют поведение функции и позволяют приложениям определять язык, правила форматирования которого, следует использовать.
В реализациях, поддерживающих Intl.DateTimeFormat API, эти параметры соответствуют параметрам конструктора Intl.DateTimeFormat(). Реализации без поддержки Intl.DateTimeFormat должны игнорировать оба параметра, используя локаль и формат возвращаемой строки определяемые самой реализацией.
localesНеобязательный-
Строка с языковым тегом BCP 47 или массив таких строк. Соответствует параметру
localesконструктора `Intl.DateTimeFormat().В реализациях без поддержки
Intl.DateTimeFormatэтот параметр игнорируется и обычно используется локаль устройства. optionsНеобязательный-
Объект определяющий выходной формат. Соответствует параметру
optionsконструктораIntl.DateTimeFormat(). ОпцияtimeStyleдолжна бытьundefinedили будет возникатьTypeError. Еслиweekday,year,monthиdayодновременно равныundefined, тоyear,monthиdayбудут установлены в"numeric".В реализациях без поддержки
Intl.DateTimeFormatэтот параметр игнорируется.
Смотрите описание конструктора Intl.DateTimeFormat() для подробностей использования этих параметров.
Примеры
Использование метода toLocaleDateString()
При использовании без указания локали возвращается строка, отформатированная в соответствии с локалью и опциями по умолчанию.
Проверка поддержки параметров locales и options
Параметры locales и options поддерживаются ещё не всеми браузерами. Для проверки того, поддерживает ли их уже реализация, можно затребовать несуществующую метку языка и проверить, будет ли выброшено исключение RangeError:
Использование параметра locales
Этот пример показывает некоторые локализованные форматы даты. Для получения формата языка, используемого в пользовательском интерфейсе вашего приложения, убедитесь, что вы указали этот язык (и, возможно, несколько запасных языков) через аргумент locales:
Использование параметра options
Результат, предоставляемый методом toLocaleDateString(), может быть настроен с помощью параметра options:
Спецификации
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.tolocaledatestring |
| ECMAScript® 2026 Internationalization API Specification # sup-date.prototype.tolocaledatestring |