Начало работы

Содержание

Введение
Подмодули
Установка

Введение

date-fns предоставляет самый полный, но при этом простой и согласованный набор инструментов для работы с датами JavaScript в браузере и Node.js.

date-fns — это аналог lodash для дат. Он содержит более 200 функций для всех случаев.

import { format, compareAsc } from 'date-fns'

format(new Date(2014, 1, 11), 'MM/dd/yyyy')
//=> '02/11/2014'

const dates = [
  new Date(1995, 6, 2),
  new Date(1987, 1, 11),
  new Date(1989, 6, 10),
]
dates.sort(compareAsc)
//=> [
//   Wed Feb 11 1987 00:00:00,
//   Mon Jul 10 1989 00:00:00,
//   Sun Jul 02 1995 00:00:00
// ]

Подмодули

date-fns включает некоторые дополнительные функции в качестве подмодулей в пакете npm. Вот список подмодулей, упорядоченных по уровню вложенности:

FP — функции, адаптированные для функционального программирования. См. Руководство по FP;
UTC (в разработке) — функции, вычисляющие даты в часовом поясе UTC±00:00.

Более поздние подмодули также включены в предыдущие, если вы хотите использовать несколько функций из списка.

Чтобы использовать функции подмодулей, установите пакет npm, а затем импортируйте функцию из подмодуля:

// The main submodule:
import addDays from 'date-fns/addDays'

// FP variation:
import addDays from 'date-fns/fp/addDays'

// UTC variation:
import addDays from 'date-fns/utc/addDays'

// Both FP and UTC:
import addDays from 'date-fns/fp/utc/addDays'

// With tree-shaking enabled:
import { addDays, format } from 'date-fns/fp'

Установка

Библиотека доступна в качестве пакета npm.

Для установки пакета выполните:

npm install date-fns --save
# or
yarn add date-fns

Начните использовать:

import { formatDistance, subDays } from 'date-fns'

formatDistance(subDays(new Date(), 3), new Date(), { addSuffix: true })
//=> "3 days ago"