Дата и время

Объект даты создаётся конструктором new Date. Без аргументов он берёт текущий момент — тот, что показывают часы на машине пользователя.

const now = new Date();
console.log(now.getFullYear());

С аргументами вариантов три. Строку движок разбирает по формату ISO. Отдельные числа перечисляются от крупного к мелкому: год, месяц, день, часы, минуты — и месяц здесь считается с нуля, к этому мы ещё вернёмся. Одно число — это миллисекунды от начала эпохи, поэтому new Date(0) даёт ту самую точку отсчёта.

const byString = new Date("2026-03-08T12:30:00");
const byParts = new Date(2026, 2, 8, 12, 30);
const epoch = new Date(0);
console.log(byString.getHours());
console.log(byParts.getDate());
console.log(epoch.getUTCFullYear());

const utc = new Date("2026-03-08");
const local = new Date("2026-03-08T00:00");
console.log(utc.getDate());
console.log(local.getDate());
console.log(utc.toISOString());

Достать из даты кусочек можно только методом — свойств у Date нет. Все геттеры без приставки UTC отвечают в часовом поясе того, кто открыл страницу.

const d = new Date(2026, 1, 14, 9, 5, 30);
console.log(d.getFullYear());
console.log(d.getDate());
console.log(d.getDay());
console.log(d.getHours(), d.getMinutes());

Самая частая опечатка новичка живёт в этой таблице: getDate — это число месяца, а getDay — день недели. Имена похожи, смысл разный, ошибка тихая.

Январь — это 0, декабрь — 11. Правило действует и в конструкторе, и в getMonth, и в setMonth. А вот дни месяца нумеруются по-человечески, с единицы — то есть в одной строке кода уживаются две системы счёта.

const d = new Date(2026, 2, 8);
console.log(d.getMonth());
console.log(d.getDate());
const names = ["январь", "февраль", "март"];
console.log(names[d.getMonth()]);

Месяцы — с нуля, дни — с единицы. Логики нет, это наследство языка C. Просто держите в голове.

Зато нумерация с нуля отлично дружит с массивами: индекс из getMonth кладётся в массив названий без всяких - 1. Именно так обычно и делают, когда нужны свои подписи месяцев.

Метод getTime отдаёт то самое внутреннее число — таймстемп. Когда дата попадает в арифметическое выражение, движок вызывает его сам, поэтому две даты можно просто вычесть: получится разница в миллисекундах, которую остаётся поделить на длину суток.

const start = new Date(2026, 1, 1);
const end = new Date(2026, 1, 15);
const ms = end - start;
console.log(ms);
console.log(ms / (1000 * 60 * 60 * 24));
console.log(start < end);

Если нужен только таймстемп, объект создавать незачем: Date.now() сразу возвращает число. Это самый дешёвый способ замерить, сколько выполнялся кусок кода.

const t1 = Date.now();
let sum = 0;
for (let i = 0; i < 100000; i++) sum += i;
const t2 = Date.now();
console.log(sum);
console.log(t2 - t1 >= 0);

const a = new Date(2026, 1, 1);
const b = new Date(2026, 1, 1);
console.log(a === b);
console.log(a > b);
console.log(+a === +b);

У каждого геттера есть парный сеттер: setDate, setMonth, setHours. И у них есть приятная особенность — выход за границы разрешён. Попросите 31 февраля, и дата спокойно переедет на март, пересчитав заодно год, если понадобится.

const d = new Date(2026, 1, 26);
d.setDate(d.getDate() + 5);
console.log(d.getDate());
console.log(d.getMonth());

Тот же автоперенос работает и в конструкторе: new Date(2026, 12, 1) — это январь 2027-го. Но обратите внимание на слово «переедет»: сеттеры меняют существующий объект, а не создают новый. Если дату где-то ещё используют, изменение прилетит и туда. Поэтому функции-помощники начинают с копии.

function addDays(date, days) {
  const copy = new Date(date);
  copy.setDate(copy.getDate() + days);
  return copy;
}
const last = new Date(2026, 11, 31);
console.log(addDays(last, 1).getFullYear());
console.log(last.getDate());

Печатать дату вручную не нужно: браузер знает форматы всех локалей. Метод toLocaleDateString принимает код языка и объект настроек — какие части показывать и насколько подробно.

const d = new Date(2026, 2, 8);
console.log(d.toLocaleDateString("ru-RU"));
console.log(d.toLocaleDateString("en-US"));
console.log(d.toLocaleDateString("ru-RU", { day: "numeric", month: "long" }));

Если форматировать нужно много дат подряд, создайте форматтер один раз через Intl.DateTimeFormat и вызывайте у него format. Разбор настроек — операция небыстрая, а так она случится однажды.

const fmt = new Intl.DateTimeFormat("ru-RU", { weekday: "long", day: "numeric", month: "long" });
console.log(fmt.format(new Date(2026, 2, 8)));
console.log(fmt.format(new Date(2026, 8, 1)));

Встроенного Date хватает, пока задачи простые: показать, сравнить, прибавить день. Дальше начинается больно — разбор произвольных строк, «через два месяца» с учётом разной длины месяцев, работа в чужом часовом поясе, склонения вида «3 дня назад». Тут берут библиотеку: date-fns или dayjs. Причина не в моде: Date изменяем, разбирает строки по-разному в разных браузерах и не умеет часовые пояса, кроме местного и UTC. В самом языке эти дыры чинит новый объект Temporal — он уже появляется в браузерах, но пока не везде. Что из этого брать сегодня и во что обходится каждый вариант — на полке браузера в части II.