Date.prototype.toLocaleDateString
Форматирует дату без времени по правилам языка.
Доступно с: ES1
Синтаксис
date.toLocaleDateString(locales, options)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| locales | string | Необязательный. Язык и регион, например en-US, de-DE, ru-RU. |
| options | object | Необязательный. Что показывать: weekday, year, month, day, а также dateStyle и timeZone. |
Возвращаемое значение
stringДата без времени, отформатированная по правилам языка.
Примеры
Один день в разных странах:
const date = new Date(2026, 2, 15);
console.log(date.toLocaleDateString('en-US'));
console.log(date.toLocaleDateString('de-DE'));
console.log(date.toLocaleDateString('en-GB'));Результат:
3/15/2026
15.3.2026
15/03/2026С названием месяца и дня недели:
const date = new Date(2026, 2, 15);
console.log(date.toLocaleDateString('en-US', { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' }));
console.log(date.toLocaleDateString('en-US', { dateStyle: 'medium' }));Результат:
Sunday, March 15, 2026
Mar 15, 2026Примечания
Без locales используется язык браузера, поэтому результат у разных пользователей разный. Если нужно форматировать много дат, быстрее один раз создать Intl.DateTimeFormat.
См. также
- Date.prototype.toLocaleString — Форматирует дату вместе со временем по правилам языка.
- Date.prototype.toLocaleTimeString — Форматирует время без даты по правилам языка.
- Intl.DateTimeFormat — Форматирует даты и время по правилам языка.
Вопросы и ответы по теме
В учебнике
- Форматирование: Intl — Форматирование чисел, денег, дат и окончаний слов в JavaScript с учётом языка: toLocaleString, Intl.NumberFormat, Intl.DateTimeFormat и Intl.PluralRules.