Mutability и неожиданное поведение

Основная особенность Moment.js, которая часто становится источником ошибок и недопонимания, — это мутабельность объектов даты и времени. В отличие от многих современных библиотек для работы с датами (например, Luxon или date-fns), Moment.js изменяет сам объект при выполнении операций, а не возвращает новый.

Мутабельные операции

Любое изменение даты через методы Moment.js изменяет исходный объект. Например:

const m = moment('2026-05-22');
m.add(7, 'days');
console.log(m.format('YYYY-MM-DD')); // 2026-05-29

Здесь исходная дата m не копируется, а модифицируется на месте. Если требуется сохранить оригинальную дату, необходимо явно создавать её копию:

const original = moment('2026-05-22');
const copy = original.clone().add(7, 'days');

console.log(original.format('YYYY-MM-DD')); // 2026-05-22
console.log(copy.format('YYYY-MM-DD'));     // 2026-05-29

Ключевой момент: методы add(), subtract(), startOf(), endOf(), set() и многие другие возвращают тот же объект, который был вызван, а не новый.

Неожиданное поведение при цепочках методов

Мутабельность влияет на цепочки методов. Следующий пример иллюстрирует потенциальную ловушку:

const m = moment('2026-05-22');
m.add(1, 'month').subtract(3, 'days').startOf('week');
console.log(m.format('YYYY-MM-DD'));

Ожидаемое поведение часто отличается от реального, если разработчик не учитывает, что каждый вызов изменяет объект на месте. В сложных вычислениях это может привести к багам, особенно при использовании одних и тех же объектов в нескольких местах кода.

Методы, создающие новые объекты

Moment.js предоставляет несколько способов безопасно создавать новые объекты:

  • moment() без аргументов создаёт новый объект текущей даты.
  • moment(original) клонирует объект по значению.
  • clone() клонирует существующий объект.

Пример:

const m1 = moment('2026-05-22');
const m2 = m1.clone().add(1, 'week');

console.log(m1.format('YYYY-MM-DD')); // 2026-05-22
console.log(m2.format('YYYY-MM-DD')); // 2026-05-29

Использование clone() ключ к предотвращению неожиданных изменений.

Влияние на сравнения и условия

Мутабельность особенно критична при сравнении дат:

const m1 = moment('2026-05-22');
const m2 = m1.clone().add(1, 'day');

if (m1.isBefore(m2)) {
    console.log('m1 раньше m2'); // Верно
}

m2.subtract(1, 'day'); // теперь m2 = m1
console.log(m1.isBefore(m2)); // Ложно, даты совпадают

Без клонирования один объект может быть изменён, и сравнения дадут неожиданный результат, особенно в сложных условиях и логике календарных расчётов.

Рекомендации по работе с мутабельностью

  1. Использовать clone() при любом копировании дат.
  2. Не передавать один и тот же объект в разные части программы, если он подвергается изменениям.
  3. Избегать цепочек, которые меняют объект несколько раз, без явного клонирования.
  4. Отдавать предпочтение созданию нового объекта, если результат операции нужен отдельно.

Подводные камни при форматировании

Методы форматирования, вроде format(), toISOString(), toDate(), не изменяют объект, но если их чередовать с мутабельными методами, легко запутаться:

const m = moment('2026-05-22');
const formatted = m.add(1, 'month').format('YYYY-MM-DD');

console.log(formatted); // 2026-06-22
console.log(m.format('YYYY-MM-DD')); // 2026-06-22 — объект изменён!

Заключение по mutability

Понимание того, что Moment.js мутабельный по своей природе, является ключевым при разработке сложных приложений с датами. Любое несоблюдение принципов клонирования и контроля изменений ведёт к неожиданным результатам, багам при вычислениях и трудноуловимым ошибкам.

Правильное использование clone() и внимательное управление объектами Moment.js позволяет писать предсказуемый и безопасный код, несмотря на встроенную мутабельность.

Оглавление