Как правильно использовать библиотеку Node.js Moment.js

Moment.js — это фреймворк Node.js, способный анализировать и манипулировать датами и их временем. Это один из самых популярных фреймворков для работы с датами, и сегодня мы рассмотрим самые полезные методы, которые может предложить этот фреймворк.

Установка пакета

Мы можем установить пакет, введя эту команду в консоли каталога проекта — npm i moment. Затем мы можем запросить модуль в файле JavaScript, набрав:

const moment = require('moment');

Разбор

Moment.JS использует синтаксический анализ для преобразования любого правдоподобного значения из строки, даты, UTC или другого формата для создания значения даты момента.

Сейчас

Чтобы получить значение текущей даты и времени, мы можем просто вызвать импортированную переменную из пакета — moment().

Строковое значение

Мы можем создать дату момента из переданного ему строкового значения. Поддерживаемые строки: ISO 8601, RFC 2822 и многие другие комбинации. Например, moment('2013-02-08').

Но если мы хотим добавить к дате время, мы можем разделить его с помощью space character или T, например moment('2013-02-08 09:30').

Подробнее о типах строковых значений можно узнать здесь.

Строковое значение и форматирование

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

Например, moment('12-25-1995', 'MM/DD/YYYY') вернет 12/25/1995.

Подробнее о наборе символов можно узнать здесь.

Манипуляции

Вы можете манипулировать выводом дат, добавляя и вычитая любое количество минут, дней, месяцев и/или лет.

Добавление

Мы можем добавить любое количество значений даты к дате момента и получить результат с добавлением. Метод add() является методом подключения с 2-мя параметрами — add(amount, date-type).

Параметр amount указывает, сколько типов дат мы хотим добавить, а параметр date-type указывает, какой тип дат мы хотим добавить.

Например, moment('12-25-1995').add(7, 'days').

Вычитание

Мы можем вычесть любое количество значений даты даты Момента и получить результат с вычитанием. Метод subtract() является методом подключения с 2-мя параметрами — subtract(amount, date-type).

Параметр amount указывает, сколько типов дат мы хотим добавить, а параметр date-type указывает, какой тип дат мы хотим добавить.

Например, moment('12-25-1995').subtract(5, 'months').

Начало времени

Мы можем узнать дату, когда произойдет другой тип даты / например. когда начнется очередной месяц или год. Метод startOf() принимает 1 параметр, и это тип даты.

Например, moment().startOf('month').

Конец времени

Как и начало времени, конец времени скажет вам, когда закончится другой тип даты. Метод endOf() принимает 1 параметр, и это тип даты.

Например, moment().endOf('year').

Заключение

Этот фреймворк имеет гораздо больше утилит, которые не были упомянуты в этой статье, и вы можете прочитать о них в официальной документации здесь. Я считаю их наиболее полезными из всех, надеюсь, вам понравилась эта статья, и вы будете использовать их в своем следующем проекте.

Дополнительные материалы на PlainEnglish.io. Подпишитесь на нашу бесплатную еженедельную рассылку новостей. Подпишитесь на нас в Twitter и LinkedIn. Посетите наш Community Discord и присоединитесь к нашему Коллективу талантов.