date-fns

v4.1.0MITTree-shakeableTS Ready

Modern JavaScript date utility library like lodash for dates, modular and tree-shakeable.

98/ 100

Excellent Health

Weekly Downloads

19.8M

Bundle Size (gzip)

3.8 kB(12.5 kB min)

Dependencies

Zero Deps

Last Updated

2024-09-10

SPONSORED CLOUD & DEV TOOLS•Google Ads Partner

NPMBot AI Assessment

The Gold Standard of functional, immutable date manipulation in modern TypeScript.

Unlike Moment or Day.js, date-fns works directly on native JS Date instances using pure functions. Import only what you use (`import { format, addDays } from 'date-fns'`), and bundlers will strip everything else. Version 4 provides rock-solid ESM and TypeScript typing.

Key Advantages

•Native JavaScript Date objects: no custom wrapper classes needed
•Unbeatable tree-shaking: pay only for the exact functions imported
•Strictly immutable and side-effect free
•Superb TypeScript first implementation

Gotchas & Limitations

•Functional syntax (`format(addDays(new Date(), 3), 'yyyy-MM-dd')`) can be more verbose than chaining

Recommended For:

Modern React/Next.js/Vue codebases with bundle budgeting, Functional programming and strict TypeScript workflows

Avoid If:

Teams strongly preferring chained method syntax like `date.add().format()`

FEATURED PARTNER•Google Ads Partner

Installation & Quickstart

Package Manager Command

javascript

npm install date-fns

date-fns Usage Example

javascript

import { format, addDays } from 'date-fns';

const formatted = format(addDays(new Date(), 7), 'yyyy-MM-dd');
console.log(formatted);

Compare date-fns with Alternatives

Recommended Alternatives

dayjs-25% size

Chaining API for those who dislike nested functions

View full date-fns alternatives radar →

Repository & Links

NPM Official Registry Official Documentation GitHub Repository