Date
Дата и время: создание, чтение частей, вычисления.
Доступно с: ES1
Синтаксис
new Date(value) / new Date(year, monthIndex, day, hours, minutes)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| value | number | string | Необязательный. Метка времени в миллисекундах или строка с датой. Без аргументов — текущий момент. |
| year, monthIndex, … | number | Необязательные. Части даты; месяцы считаются с нуля: 0 — январь, 11 — декабрь. |
Возвращаемое значение
DateОбъект с датой и временем.
Примеры
Дата из частей — месяц считается с нуля:
const date = new Date(2026, 2, 15);
console.log(date.getFullYear(), date.getMonth() + 1, date.getDate());Результат:
2026 3 15Дата из строки ISO:
const date = new Date('2026-03-15T10:30:00Z');
console.log(date.toISOString());Результат:
2026-03-15T10:30:00.000ZТекущий момент:
const now = new Date();
console.log(now.getFullYear());Результат:
2026Примечания
Месяцы в Date нумеруются с нуля, а дни месяца — с единицы: new Date(2026, 0, 1) — это 1 января. Это самая частая ошибка при работе с датами.
Объект Date хранит один момент времени, а показывает его в часовом поясе компьютера. Строка '2026-03-15' без времени читается как полночь по UTC, а '2026-03-15T00:00' — как полночь по местному времени.
См. также
- Date.now — Возвращает текущее время как число миллисекунд.
- Date.prototype.toISOString — Возвращает дату в формате ISO 8601 по UTC.
- Intl.DateTimeFormat — Форматирует даты и время по правилам языка.
- Date.prototype.getFullYear — Возвращает год.
В учебнике
- Дата и время — Объект Date в JavaScript: создание даты, чтение года, месяца и дня, изменение даты, разница между датами и формат ISO.