Библиотека JS Moment для парсинга, валидации, манипуляции, отображения и форматирования дат

JS Moment - популярная javascript библиотека для работы с датами и временем. Она решает множество задач: парсинг, валидация, манипуляция, отображение и форматирование дат. В этой статье мы подробно разберем основные возможности Moment для управления временем и форматами в js.

1. Основы Moment.js

Moment.js была создана в 2011 году Тимом Вудом для упрощения работы с датами и временем в JavaScript. На тот момент стандартный объект Date JavaScript имел ряд недостатков, что затрудняло его использование.

Первая версия Moment.js вышла в сентябре 2011 года. На данный момент актуальная версия - 2.29.4 от февраля 2023 года. За прошедшие годы библиотека значительно расширила функционал и улучшила производительность.

В разработке Moment.js принимали участие десятки контрибьюторов со всего мира. Основная команда:

Тим Вуд - создатель и мейнтейнер проекта
Искрен Чернев - ключевой разработчик
Мэгги Ву - мейнтейнер документации

Основные цели и задачи Moment.js:

Простота и удобство работы с датами в JS
Парсинг, валидация и форматирование дат
Манипуляции с датами: сложение, вычитание и т.д.
Мультиязычная поддержка локализации
Работа с часовыми поясами и смещениями
Легковесность и производительность

Подключение Moment.js

Подключить Moment.js можно разными способами:

Через CDN сервисы как jsDelivr или cdnjs
Установить через npm
Подключить напрямую js файл библиотеки

После подключения становится доступен глобальный объект moment.

Создание объекта Moment

Для начала работы нужно создать объект Moment. Это можно сделать вызовом конструктора moment() без параметров:

const now = moment();

Это аналогично вызову moment(new Date()) и создаст объект с текущей датой и временем.

Парсинг дат

Объект Moment можно создать из строки, числа, массива или объекта Date:

Из строки в формате ISO 8601: moment("2020-01-25")
Из unix-таймштампа в секундах: moment(1585180400)
Из массива наподобие new Date(): moment([2020, 1, 25])
Из объекта Date: moment(new Date())

Поддерживается парсинг дат в различных форматах: ISO, RFC 2822 и другие.

Валидация дат

Проверить валидность созданного объекта Moment можно с помощью moment().isValid().

А метод moment().invalidAt() вернет причину, по которой дата невалидна.

Получение и установка значений

Для работы с компонентами даты в Moment есть удобные геттеры и сеттеры:

moment().year() - год
moment().month() - месяц
moment().date() - день месяца
moment().hour() - часы
moment().minute() - минуты

Вызов без аргументов - геттер, с аргументом - сеттер значения.

Прибавление и вычитание времени

Для прибавления и вычитания времени есть методы moment().add() и moment().subtract():

moment().add(7, 'days') // прибавить 7 дней moment().subtract(1, 'months') // вычесть 1 месяц

Поддерживаются единицы измерения: годы, месяцы, недели, дни, часы, минуты, секунды, миллисекунды.

Сравнение, проверка диапазонов дат

Для сравнения дат в Moment есть ряд методов:

isBefore() - раньше другой даты
isAfter() - позже другой даты
isBetween() - внутри интервала

Можно указать точность сравнения: по дням, месяцам, годам и т.д.

Форматирование дат

Для форматирования даты в строку используется moment().format():

moment().format('DD/MM/YYYY')

Поддерживаются разнообразные токены форматирования: YYYY, MMM, DD и другие.

Работа со временем и часовыми поясами

Moment.js позволяет гибко управлять представлением времени - в локальном или UTC формате, применять смещения часовых поясов и многое другое.

Локальное и UTC время

По умолчанию Moment работает с локальным временем. Для переключения в UTC режим используется метод moment.utc():

const local = moment(); const utc = moment.utc();

Переключение обратно в локальный режим осуществляется с помощью moment().local().

Часовые пояса и смещения

Чтобы задать часовой пояс, можно использовать moment().zone(num), где num - смещение от UTC в минутах.

А метод moment().utcOffset(num) позволяет установить смещение напрямую.

Летнее время и сдвиги

Проверить, попадает ли дата на летнее время, можно с помощью moment().isDST().

А moment().isDSTShifted() определит, была ли дата сдвинута при переходе на летнее время.

Контроль точности

Чтобы задать часовой пояс для сравнения дат, используется moment().withZone(tz). Это позволяет корректно сравнивать моменты времени с учетом часовых поясов.