Шпаргалка по Moment.js

Moment.js — классическая библиотека JavaScript для парсинга, валидации, манипуляций и форматирования дат.

Парсинг и создание дат

// Текущий момент времени
const now = moment();

// Парсинг с явным указанием формата
const m = moment('2026-10-25', 'YYYY-MM-DD');

// Парсинг таймстампа Unix (в секундах или миллисекундах)
moment.unix(1730000000); // из секунд
moment(1730000000000);   // из миллисекунд

// Проверка корректности даты
m.isValid(); // -> true

---

Токены форматирования

m.format();                  // "2026-10-25T00:00:00+08:00" (// Стандартный формат ISO 8601)
m.format('dddd');            // "Sunday"
m.format('MMM Do YY');       // "Oct 25th 26"
m.fromNow();                 // "// Относительное время (например, 3 часа назад)"
m.calendar();                // "// Календарный формат"

Таблица токенов даты

Таблица токенов времени

---

Манипуляции с датами

Объекты Moment мутабельны. Операции изменяют исходный объект напрямую:

// Прибавление и вычитание
moment().add(7, 'days');
moment().subtract(1, 'month');

// Установка границ единицы времени
moment().startOf('day');  // 00:00:00.000 начала сегодняшнего дня
moment().endOf('month');  // 23:59:59.999 конца текущего месяца

// Клонирование для предотвращения непреднамеренной мутации
const original = moment();
const nextWeek = original.clone().add(7, 'days');

---

Локализованные готовые шаблоны

---

Рекомендуемые современные альтернативы

Moment.js находится в режиме поддержки. Рекомендуемые современные решения:

• date-fns: Иммутабельные модульные утилиты с поддержкой tree-shaking.
• Day.js: Легковесная библиотека размером 2 КБ с похожим API.
• Luxon: Современная библиотека от создателей Moment на базе стандартного Intl.
• Native Intl.DateTimeFormat: Встроено в современные браузеры и Node.js без сторонних зависимостей.

---

Ссылки и материалы

• Шпаргалка по форматам даты и времени ISO 8601
• Шпаргалка по объекту Date в JavaScript
• Официальная документация Moment.js
• Руководство You-Dont-Need-Momentjs