summaryrefslogtreecommitdiff
path: root/date-fns/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'date-fns/README.md')
-rw-r--r--date-fns/README.md69
1 files changed, 69 insertions, 0 deletions
diff --git a/date-fns/README.md b/date-fns/README.md
new file mode 100644
index 0000000..8ac6395
--- /dev/null
+++ b/date-fns/README.md
@@ -0,0 +1,69 @@
+<p align="center">
+ <a href="https://date-fns.org/">
+ <img alt="date-fns" title="date-fns" src="https://raw.githubusercontent.com/date-fns/date-fns/master/docs/logotype.svg" width="300" />
+ </a>
+</p>
+
+<p align="center">
+ <b>date-fns</b> provides the most comprehensive, yet simple and consistent toolset
+ <br>
+ for manipulating <b>JavaScript dates</b> in <b>a browser</b> & <b>Node.js</b>.</b>
+</p>
+
+<div align="center">
+
+[📖&nbsp; Documentation](https://date-fns.org/docs/Getting-Started/)&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;[🧑‍💻&nbsp; JavaScript Jobs](https://jobs.date-fns.org/)
+
+</div>
+
+<hr>
+
+# It's like [Lodash](https://lodash.com) for dates
+
+- It has [**200+ functions** for all occasions](https://date-fns.org/docs/Getting-Started/).
+- **Modular**: Pick what you need. Works with webpack, Browserify, or Rollup and also supports tree-shaking.
+- **Native dates**: Uses existing native type. It doesn't extend core objects for safety's sake.
+- **Immutable & Pure**: Built using pure functions and always returns a new date instance.
+- **TypeScript & Flow**: Supports both Flow and TypeScript
+- **I18n**: Dozens of locales. Include only what you need.
+- [and many more benefits](https://date-fns.org/)
+
+```js
+import { compareAsc, format } from 'date-fns'
+
+format(new Date(2014, 1, 11), 'yyyy-MM-dd')
+//=> '2014-02-11'
+
+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](https://www.npmjs.com/package/date-fns).
+To install the package run:
+
+```bash
+npm install date-fns --save
+# or with yarn
+yarn add date-fns
+```
+
+## Docs
+
+[See date-fns.org](https://date-fns.org/) for more details, API,
+and other docs.
+
+<br />
+<!-- END OF README-JOB SECTION -->
+
+## License
+
+[MIT © Sasha Koss](https://kossnocorp.mit-license.org/)