English | [简体中文 ](./docs/zh-cn/README.zh-CN.md ) | [日本語 ](./docs/ja/README-ja.md ) | [Português Brasileiro ](./docs/pt-br/README-pt-br.md ) | [한국어 ](./docs/ko/README-ko.md ) | [Español (España) ](./docs/es-es/README-es-es.md ) | [Русский ](./docs/ru/README-ru.md ) | [Türkçe ](./docs/tr/README-tr.md ) | [සි ං ](./docs/si/README-si.md ) | [עברית ](./docs/he/README-he.md )
< p align = "center" > < a href = "https://day.js.org/" target = "_blank" rel = "noopener noreferrer" > < img width = "550"
src="https://user-images.githubusercontent.com/17680888/39081119-3057bbe2-456e-11e8-862c-646133ad4b43.png"
alt="Day.js" />< / a > < / p >
< p align = "center" > Fast < b > 2kB< / b > alternative to Moment.js with the same modern API< / p >
< p align = "center" >
< a href = "https://unpkg.com/dayjs/dayjs.min.js" > < img
src="https://img.badgesize.io/https://unpkg.com/dayjs/dayjs.min.js?compression=gzip& style=flat-square"
alt="Gzip Size">< / a >
< a href = "https://www.npmjs.com/package/dayjs" > < img src = "https://img.shields.io/npm/v/dayjs.svg?style=flat-square&colorB=51C838"
alt="NPM Version">< / a >
< a href = "https://travis-ci.com/iamkun/dayjs" > < img
src="https://img.shields.io/travis/iamkun/dayjs/master.svg?style=flat-square" alt="Build Status">< / a >
< a href = "https://codecov.io/gh/iamkun/dayjs" > < img
src="https://img.shields.io/codecov/c/github/iamkun/dayjs/master.svg?style=flat-square" alt="Codecov">< / a >
< a href = "https://github.com/iamkun/dayjs/blob/master/LICENSE" > < img
src="https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square" alt="License">< / a >
< br >
< a href = "https://saucelabs.com/u/dayjs" >
< img width = "750" src = "https://user-images.githubusercontent.com/17680888/40040137-8e3323a6-584b-11e8-9dba-bbe577ee8a7b.png" alt = "Sauce Test Status" >
< / a >
< / p >
> Day.js is a minimalist JavaScript library that parses, validates, manipulates, and displays dates and times for modern browsers with a largely Moment.js-compatible API. If you use Moment.js, you already know how to use Day.js.
```js
dayjs().startOf('month').add(1, 'day').set('year', 2018).format('YYYY-MM-DD HH:mm:ss');
```
* 🕒 Familiar Moment.js API & patterns
* 💪 Immutable
* 🔥 Chainable
* 🌐 I18n support
* 📦 2kb mini library
* 👫 All browsers supported
---
## Getting Started
### Documentation
You can find more details, API, and other docs on [day.js.org ](https://day.js.org/ ) website.
### Installation
```console
npm install dayjs --save
```
📚[Installation Guide](https://day.js.org/docs/en/installation/installation)
### API
It's easy to use Day.js APIs to parse, validate, manipulate, and display dates and times.
```javascript
dayjs('2018-08-08') // parse
dayjs().format('{YYYY} MM-DDTHH:mm:ss SSS [Z] A') // display
dayjs().set('month', 3).month() // get & set
dayjs().add(1, 'year') // manipulate
dayjs().isBefore(dayjs()) // query
```
📚[API Reference](https://day.js.org/docs/en/parse/parse)
### I18n
Day.js has great support for internationalization.
But none of them will be included in your build unless you use it.
```javascript
import 'dayjs/locale/es' // load on demand
dayjs.locale('es') // use Spanish locale globally
dayjs('2018-05-05').locale('zh-cn').format() // use Chinese Simplified locale in a specific instance
```
📚[Internationalization](https://day.js.org/docs/en/i18n/i18n)
### Plugin
A plugin is an independent module that can be added to Day.js to extend functionality or add new features.
```javascript
import advancedFormat from 'dayjs/plugin/advancedFormat' // load on demand
dayjs.extend(advancedFormat) // use plugin
dayjs().format('Q Do k kk X x') // more available formats
```
📚[Plugin List](https://day.js.org/docs/en/plugin/plugin)
## Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website.
[[Become a sponsor via Github ](https://github.com/sponsors/iamkun/ )] [[Become a sponsor via OpenCollective ](https://opencollective.com/dayjs#sponsor )]
< a href = "https://toyokumo.co.jp" target = "_blank" >
< img width = "70" src = "https://user-images.githubusercontent.com/17680888/197092231-2367b5eb-1e43-467e-a311-23f7cd97b086.png" >
< / a >
< a href = "https://github.com/alan-eu" target = "_blank" >
< img width = "70" src = "https://avatars.githubusercontent.com/u/18175329?s=52&v=4" >
< / a >
< a href = "https://opencollective.com/sight-and-sound-ministries" target = "_blank" >
< img width = "70" src = "https://user-images.githubusercontent.com/17680888/232316426-cb99b4cf-0ccb-4e73-a6ce-e16dba6aadf4.png" >
< / a >
< a href = "https://www.exoflare.com/open-source/?utm_source=dayjs&utm_campaign=open_source" target = "_blank" >
< img width = "70" src = "https://user-images.githubusercontent.com/17680888/162761622-1407a849-0c41-4591-8aa9-f98114ec2092.png" >
< / a >
< a href = "https://rxdb.info/?utm_source=day.js.org&utm_medium=banner&utm_campaign=day.js.org-sponsored" target = "_blank" > < img width = "70" src = "https://user-images.githubusercontent.com/17680888/200301812-9c9bd523-5dc4-4cab-b380-543fbcd3802c.svg" > < / a >
< a href = "https://github.com/vendure-ecommerce" target = "_blank" > < img width = "70" src = "https://avatars.githubusercontent.com/u/39629390?s=52&v=4" > < / a >
< a href = "https://opencollective.com/docbot" target = "_blank" > < img width = "70" src = "https://images.opencollective.com/docbot/457761e/logo.png" > < / a >
< a href = "https://opencollective.com/datawrapper" target = "_blank" > < img width = "70" src = "https://images.opencollective.com/datawrapper/c13e229/logo.png" > < / a >
## Contributors
This project exists thanks to all the people who contribute.
Please give us a 💖 star 💖 to support us. Thank you.
And thank you to all our backers! 🙏
< a href = "https://opencollective.com/dayjs/backer/0/website?requireActive=false" target = "_blank" > < img width = "35" src = "https://opencollective.com/dayjs/backer/0/avatar.svg?requireActive=false" > < / a >
< a href = "https://opencollective.com/dayjs/backer/1/website?requireActive=false" target = "_blank" > < img width = "35" src = "https://opencollective.com/dayjs/backer/1/avatar.svg?requireActive=false" > < / a >
< a href = "https://opencollective.com/dayjs/backer/2/website?requireActive=false" target = "_blank" > < img width = "35" src = "https://opencollective.com/dayjs/backer/2/avatar.svg?requireActive=false" > < / a >
< a href = "https://opencollective.com/dayjs/backer/3/website?requireActive=false" target = "_blank" > < img width = "35" src = "https://opencollective.com/dayjs/backer/3/avatar.svg?requireActive=false" > < / a >
< br / >
< a href = "https://opencollective.com/dayjs#backers" target = "_blank" > < img src = "https://opencollective.com/dayjs/contributors.svg?width=890" / > < / a >
## License
Day.js is licensed under a [MIT License ](./LICENSE ).
