Modern JavaScript date utility library
import { format, formatDistance, formatRelative, subDays } from 'date-fns'
format(new Date(), "'Today is a' eeee")
//=> "Today is a Wednesday"
formatDistance(subDays(new Date(), 3), new Date(), { addSuffix: true })
//=> "3 days ago"
formatRelative(subDays(new Date(), 3), new Date())
//=> "last Friday at 7:26 p.m."- Modular
With the function-per-file style, you can pick just what you need and stop bloating your project with useless functionality.
It works well with modern module bundlers such as , Browserify, and and also supports tree-shaking. - Native Date
date-fns uses the native Datetype and doesn't reinvent the wheel. It doesn't extend core objects for safety's sake. Functions in date-fns work predictably and stick to ECMAScript behavior in edge cases.
- Immutable & Pure
date-fns is built using pure functions and always returns a new date instance instead of changing the passed one.
It helps to prevent bugs and avoid long debugging sessions.
- TypeScript & Flow
date-fns supports both TypeScriptand . The typings are generated from the source code and bundled with the package, so they're always up-to-date.
- FPThe functional programming submodule provides a better alternative to chaining: composition; which makes your code clean and safe and doesn't bloat your build.
- I18nWith support from the amazing community, date-fns has dozens of locales. Only the ones that you use will be included in your project.
- Consistent
date-fns always returns a date in the same time zone, no matter what's passed - a timestamp, a string or a date object.
The API is tailored to have predictable names and arguments order.
- Reliable
date-fns respects timezones & DST.
It follows semantic versioning so, always backward compatible.
Each build CI checks more than 650 000 examples in about 400 time zones.
- Simple
The best API is an API that doesn't exist. With date-fns you always have one function that does one thing.
The API is unambiguous, and there is always a single approach to a problem.
- FastIn addition to tiny size, date-fns is fast. You can be sure that your users will have the best user experience.
- DocsEvery date-fns function has a detailed description with examples. The documentation is accessible both online on the website and offline thanks to JSDoc annotations.
- More Coming!date-fns is an active development and we are constantly adding new features.
