Даты и время — это головная боль любого разработчика. Часовые пояса, летнее время, форматирование — всё это может сломать даже самый простой проект. Но в JavaScript есть встроенный объект Date, который, если научиться с ним обращаться, решает большинство задач. В этой статье я расскажу, как работать с Date без слёз и багов.

Digital-студия WNDER

Что такое 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. Удачи в коде!

Студия WNDER