这是笔者对日期时间操作库 date-fns 的整理和翻译。

官方文档不利于查找和索引，所以创建此文档。

如果对您有用，欢迎收藏本网站。

---

date-fns 提供了最全面，简单且一致的工具集，用于在浏览器和 Node.js 中操作 JavaScript 日期时间。

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 指南

如果您想使用列表中的多个功能，后面的子模块也包含在前者中。

要使用子模块功能，请安装 npm 包，然后从子模块导入函数：

// 普通模式
import { addDays } from 'date-fns';

// 函数式模式
import { addDays, format } from 'date-fns/fp';

安装

该库可作为 npm 包使用。

要安装该包，请运行：

npm install date-fns --save
# 或者
yarn add date-fns
# 或者
pnpm add date-fns

开始使用：

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

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