Modern JavaScript date utility library ⌛️
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config Add lightFormat function and optimize toDate Dec 13, 2018
docs Update links to blog post in docs Jan 11, 2019
examples Rework toDate and extract parseISO Jan 9, 2019
flow-typed Disable the problematic Galician locale (#886) Sep 21, 2018
scripts Fix DST issue in eachDayOfInterval Jan 9, 2019
src Add pt locale in v2 (closes #1012) (#1033) Jan 10, 2019
test/dst Fix DST issue in eachDayOfInterval Jan 9, 2019
tmp Speed up TZ tests using pre-build tests file Oct 1, 2015
.babelrc ES Modules (closes #179, closes #414) (#404) Jun 20, 2017
.editorconfig Add EditorConfig config Apr 25, 2016
.flowconfig ES Modules (closes #179, closes #414) (#404) Jun 20, 2017
.gitignore Delete and Ignore yarn-error.log (#904) Oct 2, 2018
.travis.yml Try another approach to running Chrome on Travis Sep 18, 2018
CHANGELOG.md Update links to blog post in docs Jan 11, 2019
CONTRIBUTING.md Add more info to CONTRIBUTING.md (#764) May 25, 2018
LICENSE.md Update LICENSE file Apr 25, 2016
README.md Add Open Collective banner to the README Dec 11, 2018
benchmark.js Add performance tests (#289) Dec 9, 2016
outdatedLocales.json Add pt locale in v2 (closes #1012) (#1033) Jan 10, 2019
package.json Add lightFormat function and optimize toDate Dec 13, 2018
test.js Add tests buildFormatFormatters of en locale Oct 11, 2016
testWithoutLocales.js Replace phantomjs with Chrome in `v1.x` (#476) Apr 14, 2017
typings.d.ts Regenerate library with removed options Jan 9, 2019
yarn.lock Add lightFormat function and optimize toDate Dec 13, 2018

README.md

date-fns

🙏 Please help us to make the best date library for JavaScript. We need your support!

⚠️ Warning: the current master represents v2 pre-release version of the library. See v1 branch.

Pinned: see a brief comparison with Moment.js.

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 for dates. It has 140+ functions for all occasions.

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

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
// ]

The library is available as an npm package. To install the package run:

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

Docs

See date-fns.org for more details, API, and other docs.

License

MIT © Sasha Koss