Как правильно использовать библиотеку 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 и присоединитесь к нашему Коллективу талантов.