Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/iamkun/dayjs

⏰ Day.js 2kB immutable date-time library alternative to Moment.js with the same modern API
https://github.com/iamkun/dayjs

date date-formatting datetime dayjs moment time

Last synced: 11 days ago
JSON representation

⏰ Day.js 2kB immutable date-time library alternative to Moment.js with the same modern API

Awesome Lists containing this project

README 

        
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)



Day.js


Fast 2kB alternative to Moment.js with the same modern API




    Gzip Size

    NPM Version

    Build Status

    Codecov

    License

    


    

        Sauce Test Status

    




> 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)



### Usage Trend





  




## 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)]





  



        



  



        



  



        



  



        



  



        



  



        



  



        



  



        



  



        



  BestKru



        



  



        



  Route Optimizer and Route Planner Software




## 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! 🙏

















## License



Day.js is licensed under a [MIT License](./LICENSE).