Date.prototype.toLocaleString
Форматирует дату вместе со временем по правилам языка.
Доступно с: ES1
Синтаксис
date.toLocaleString(locales, options)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| locales | string | Необязательный. Язык и регион. |
| options | object | Необязательный. Например dateStyle, timeStyle, timeZone. |
Возвращаемое значение
stringДата и время по правилам языка.
Примеры
Дата и время:
const date = new Date(2026, 2, 15, 18, 5);
console.log(date.toLocaleString('de-DE'));
console.log(date.toLocaleString('en-GB', { dateStyle: 'long', timeStyle: 'short' }));Результат:
15.3.2026, 18:05:00
15 March 2026 at 18:05Тот же момент в другом часовом поясе:
const date = new Date('2026-03-15T12:00:00Z');
console.log(date.toLocaleString('en-GB', { timeZone: 'Asia/Tokyo' }));
console.log(date.toLocaleString('en-GB', { timeZone: 'America/New_York' }));Результат:
15/03/2026, 21:00:00
15/03/2026, 08:00:00Примечания
Опция timeZone показывает момент в любом часовом поясе, не меняя саму дату. У чисел есть свой toLocaleString() — для разделителей разрядов и валют.
См. также
- Date.prototype.toLocaleDateString — Форматирует дату без времени по правилам языка.
- Date.prototype.toLocaleTimeString — Форматирует время без даты по правилам языка.
- Intl.DateTimeFormat — Форматирует даты и время по правилам языка.
Вопросы и ответы по теме
В учебнике
- Форматирование: Intl — Форматирование чисел, денег, дат и окончаний слов в JavaScript с учётом языка: toLocaleString, Intl.NumberFormat, Intl.DateTimeFormat и Intl.PluralRules.