Даты и время — это головная боль любого разработчика. Часовые пояса, летнее время, форматирование — всё это может сломать даже самый простой проект. Но в JavaScript есть встроенный объект Date, который, если научиться с ним обращаться, решает большинство задач. В этой статье я расскажу, как работать с Date без слёз и багов.
Что такое Date и с чем его едят
Объект Date — это встроенный конструктор JavaScript для работы с датами и временем. Он хранит момент времени в миллисекундах, прошедших с 1 января 1970 года по UTC. Это называется Unix-время. Звучит сложно, но на практике всё просто: вы создаёте объект, а он уже знает, какой сейчас день, месяц и год.
Создать Date можно несколькими способами. Самый простой — вызвать конструктор без аргументов, и вы получите текущую дату и время.
// Текущая дата и время
const now = new Date();
console.log(now); // Например: 2025-03-15T14:30:00.000Z
Если нужна конкретная дата, передайте строку или компоненты. Например, так:
// Из строки (формат ISO)
const dateFromString = new Date('2025-03-15');
// Из компонентов: год, месяц (0-11), день, часы, минуты, секунды, миллисекунды
const dateFromParts = new Date(2025, 2, 15, 14, 30, 0, 0);
Обратите внимание: месяц в JavaScript начинается с нуля. Январь — это 0, декабрь — 11. Многие на этом спотыкаются. Запомните: месяцы считаются с нуля, а дни месяца — с единицы.
Правило: Всегда проверяйте, в каком часовом поясе создаётся дата. Конструктор с компонентами использует локальное время, а строка ISO — UTC. Это может привести к неожиданным сдвигам.
Основные методы для получения и установки компонентов
Объект Date предоставляет кучу методов для извлечения отдельных частей даты. Вот самые популярные:
getFullYear()— год (например, 2025).getMonth()— месяц от 0 до 11.getDate()— день месяца от 1 до 31.getDay()— день недели от 0 (воскресенье) до 6 (суббота).getHours(),getMinutes(),getSeconds(),getMilliseconds()— время.
Для установки значений есть аналогичные методы с префиксом set: setFullYear(), setMonth(), setDate() и т.д. Они изменяют объект на месте.
const date = new Date(2025, 2, 15); // 15 марта 2025
console.log(date.getFullYear()); // 2025
console.log(date.getMonth()); // 2 (март)
console.log(date.getDate()); // 15
console.log(date.getDay()); // 6 (суббота)
date.setMonth(5); // июнь
console.log(date.getMonth()); // 5
Все эти методы возвращают значения в локальном часовом поясе. Если нужен UTC, используйте версии с приставкой UTC: getUTCFullYear(), getUTCMonth() и т.д.
Форматирование даты в строку
Часто нужно показать дату пользователю в читаемом виде. Встроенные методы вроде toString() дают не самый красивый результат. Лучше использовать toLocaleDateString() и toLocaleTimeString(), которые учитывают локаль и настройки.
const date = new Date(2025, 2, 15, 14, 30);
// Формат по умолчанию для локали
console.log(date.toLocaleDateString()); // '15.03.2025' (для русской локали)
console.log(date.toLocaleTimeString()); // '14:30:00'
// С указанием опций
const options = { year: 'numeric', month: 'long', day: 'numeric' };
console.log(date.toLocaleDateString('ru-RU', options)); // '15 марта 2025 г.'
Можно гибко настраивать формат через объект опций: указать, показывать ли век, день недели, часовой пояс и т.д. Это удобно для интернационализации.
Если нужен полностью кастомный формат, придётся собирать строку вручную. Например, для формата 'DD.MM.YYYY':
function formatDate(date) {
const day = String(date.getDate()).padStart(2, '0');
const month = String(date.getMonth() + 1).padStart(2, '0');
const year = date.getFullYear();
return `${day}.${month}.${year}`;
}
console.log(formatDate(new Date(2025, 2, 15))); // '15.03.2025'
Вычисления с датами: сложение, разница, сравнение
Объект Date можно сравнивать и складывать. При сравнении операторами >, < объекты автоматически преобразуются в миллисекунды. А для разницы можно просто вычесть одну дату из другой — получите количество миллисекунд.
const date1 = new Date(2025, 2, 15);
const date2 = new Date(2025, 2, 20);
console.log(date2 > date1); // true
console.log(date2 - date1); // 432000000 (5 дней в миллисекундах)
// Перевести в дни
const diffDays = (date2 - date1) / (1000 * 60 * 60 * 24);
console.log(diffDays); // 5
Чтобы прибавить к дате определённое количество дней, месяцев или лет, используйте методы set с текущими значениями. Например, прибавить 10 дней:
const date = new Date(2025, 2, 15);
date.setDate(date.getDate() + 10);
console.log(date); // 25 марта 2025
Такой подход автоматически корректирует переход через границу месяца или года. Удобно!
Лайфхак: Для сложных манипуляций с датами (например, добавление месяцев с учётом разной длины) лучше использовать библиотеки вроде date-fns или Luxon. Но для простых задач встроенного Date хватает.
Часовые пояса и UTC: как не запутаться
JavaScript работает с двумя представлениями времени: локальным (по часовому поясу пользователя) и UTC. Объект Date хранит время в UTC, но методы получения/установки по умолчанию используют локальный пояс. Это может сбивать с толку.
Например, если вы создаёте дату из строки '2025-03-15', она интерпретируется как UTC. А если из компонентов (2025, 2, 15) — как локальное время. Разница может составлять несколько часов.
Чтобы всегда быть уверенным, используйте методы с UTC: getUTCFullYear(), getUTCHours() и т.д. Или явно указывайте часовой пояс в строке: '2025-03-15T14:30:00+03:00'.
Для отображения даты в конкретном часовом поясе можно использовать toLocaleString() с опцией timeZone:
const date = new Date('2025-03-15T12:00:00Z');
console.log(date.toLocaleString('ru-RU', { timeZone: 'Europe/Moscow' })); // '15.03.2025, 15:00:00'
Помните, что список поддерживаемых часовых поясов зависит от браузера, но в современных браузерах он полный (IANA).
Сравнение методов и свойств Date
Ниже таблица с основными методами и их назначением. Держите её под рукой как шпаргалку.
| Метод | Что возвращает / делает |
|---|---|
getFullYear() |
Год (локальное время) |
getMonth() |
Месяц от 0 до 11 |
getDate() |
День месяца от 1 до 31 |
getDay() |
День недели от 0 (вс) до 6 (сб) |
getTime() |
Миллисекунды с 1970-01-01 UTC |
toISOString() |
Строка в формате ISO 8601 (UTC) |
toLocaleDateString() |
Дата в локализованном формате |
Что в итоге
Объект Date — мощный инструмент, но требует аккуратности. Запомните главное: месяцы с нуля, локальное время vs UTC, и всегда проверяйте, как создаётся дата. Для сложных сценариев (парсинг, форматирование, работа с часовыми поясами) используйте методы toLocaleString и библиотеки. Практикуйтесь, и даты перестанут быть страшными.
Надеюсь, эта статья помогла вам подружиться с Date. Удачи в коде!



