48,654
stars
+-3
2,987
forks
271
watchers
1,467
prs
1,866
issues
129
releases
0
discussions
README
English | 简体中文 | 日本語 | Português Brasileiro | 한국어 | Español (España) | Русский | Türkçe | සිංහල | עברית
Fast 2kB alternative to Moment.js with the same modern API
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 website.
Installation
console
npm install dayjs --save
📚Installation Guide
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
I18n
Day.js has great support for internationalization.
But none of them will be included in your build unless you use them.
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
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
Downloads
!Day.js Chart
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] [Become a sponsor via OpenCollective]
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.Top issues
#1377The timezone plugin is not compatible with React Native Hermes engine57 comments · 2021-02-09#961Add Latin locale49 comments · 2020-07-19#1260Timezone conversion incorrect when daylight saving in effect42 comments · 2020-12-07#1227day.js default timezone problem42 comments · 2020-11-16#1281🎁 2.0 Milestones【Breaking Change】38 comments · 2020-12-19#1765`dayjs` does not actually support Node.js ESM28 comments · 2022-01-13#1154Abbreviated Timezone for IST/GMT+5:3028 comments · 2020-10-20#1827`dayjs.tz()` is building dates with incorrect timezone for many cases25 comments · 2022-03-11
Latest release
v1.11.23 v1.11.23 2026-08-171.11.23 (2026-08-17) Bug Fixes plugin: timezone plugin prevent RangeError for invalid Day.js values (3180) (dad46e6) plugin: timezone plugin prevent RangeError for invalid Day.js values (3180) (3181) (2a3785f)