Blame view

天文台pc/tianwentai-ui/node_modules/date-fns/docs/gettingStarted.md 1.72 KB
bc518174   王天杨   提交两个项目文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
  # Getting Started
  
  ## Table of Contents
  
  - [Introduction](#introduction)
  
  - [Submodules](#submodules)
  
  - [Installation](#installation)
  
  ## Introduction
  
  **date-fns** provides the most comprehensive, yet simple and consistent toolset
  for manipulating **JavaScript dates** in **a browser** & **Node.js**.
  
  **date-fns** is like [lodash](https://lodash.com) for dates. It has
  [**200+ functions** for all occasions](https://date-fns.org/docs/).
  
  ```js
  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
  // ]
  ```
  
  ## Submodules
  
  **date-fns** includes some optional features as submodules in the npm package.
  Here is the list of them, in order of nesting:
  
  - FP — functional programming-friendly variations of the functions. See [FP Guide](https://date-fns.org/docs/FP-Guide);
  
  The later submodules are also included inside the former if you want to use multiple features from the list.
  
  To use submodule features, [install the npm package](#npm) and then import a function from a submodule:
  
  ```js
  // The main submodule:
  import { addDays } from "date-fns";
  
  // FP variation:
  import { addDays, format } from "date-fns/fp";
  ```
  
  ## Installation
  
  The library is available as an [npm package](https://www.npmjs.com/package/date-fns).
  
  To install the package, run:
  
  ```bash
  npm install date-fns --save
  # or
  yarn add date-fns
  ```
  
  Start using:
  
  ```js
  import { formatDistance, subDays } from "date-fns";
  
  formatDistance(subDays(new Date(), 3), new Date(), { addSuffix: true });
  //=> "3 days ago"
  ```