TIP: Try navigating through list using left & right arrow keys


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

Github issues
Github stars
about 16 hours ago
Github last update date
NPM current week downloads

English | g.d=d8-f | f%f,h* | PortuguC*s Brasileiro | mj5-l4 | EspaC1ol (EspaC1a) | P QQQP:P8P9


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.

dayjs().startOf('month').add(1, 'day').set('year', 2018).format('YYYY-MM-DD HH:mm:ss');
  • p Familiar Moment.js API & patterns
  • p* Immutable
  • p% Chainable
  • p  I18n support
  • p& 2kb mini library
  • p+ All browsers supported

Getting Started


You can find for more details, API, and other docs on day.js.org website.


npm install dayjs --save

pInstallation Guide


It's easy to use Day.js APIs to parse, validate, manipulate, and display dates and times.

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

pAPI Reference


Day.js has great support for internationalization.

But none of them will be included in your build unless you use it.

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



A plugin is an independent module that can be added to Day.js to extend functionality or add new features.

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

pPlugin List


Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]


This project exists thanks to all the people who contribute.

Please give us a p star p to support us. Thank you.

And thank you to all our backers! p


Day.js is licensed under a MIT License.

Buy us a coffeeBuy us a coffee