# 入门

URL: https://caijiao.org/date-fns/general/getting-started
Source: docs/date-fns/general/getting-started.md
Description: date-fns 为在浏览器和 Node.js 中操作 JavaScript 日期提供了最全面、但最简单和一致的工具集。date-fns 就像日期的 lodash。 它具有适用于所有场合的 200 多种功能。

## 介绍

[date-fns](/date-fns/) 为在浏览器和 Node.js 中操作 JavaScript 日期提供了最全面、但最简单和一致的工具集。

date-fns 就像日期的 [lodash](https://lodash.com/)。 它具有适用于所有场合的 200 多种功能。

## 子模块

[date-fns](/date-fns/) 在 npm 包中包含一些可选功能作为子模块。 以下是它们的列表，按嵌套顺序排列：

- FP — 函数式编程友好的函数变体。 见 FP 指南；

- UTC（开发中）- 计算 UTC±00:00 时区日期的函数的变体。

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

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

```javascript
// 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 包](https://www.npmjs.com/package/date-fns)的形式提供。

要安装软件包，请运行：

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

开始使用：

```javascript
import { formatDistance, subDays } from "date-fns";

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