# dayjs > 2KB immutable date time library alternative to Moment.js with the same modern API Latest version **1.11.23** (published 2026-08-17) · MIT license · 0 weekly downloads ## Install ```sh npm install dayjs pnpm add dayjs yarn add dayjs bun add dayjs ``` ## Health **Score 75/100 (B)** — status: active. Positive: has types; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score; popular repo. Warnings: low downloads; no esm support. ## Facts | | | |---|---| | Version | 1.11.23 | | Published | 2026-08-17 | | First published | 2018-04-10 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Dependencies | 0 | | Unpacked size | 665.7 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 48666 | | Author | iamkun | | Maintainers | iamkun | | Keywords | dayjs, date, time, immutable, moment | ## Links - npm: https://www.npmjs.com/package/dayjs - Repository: https://github.com/iamkun/dayjs - Homepage: https://day.js.org - Issues: https://github.com/iamkun/dayjs/issues - npm.io page: https://npm.io/package/dayjs ## Alternatives - [@js-joda/timezone](https://npm.io/package/@js-joda/timezone.md) — 383.4K weekly downloads - [chartjs-adapter-moment](https://npm.io/package/chartjs-adapter-moment.md) — 210.8K weekly downloads - [strftime](https://npm.io/package/strftime.md) — 171.2K weekly downloads - [vue-flatpickr-component](https://npm.io/package/vue-flatpickr-component.md) — 115.8K weekly downloads - [timepicker](https://npm.io/package/timepicker.md) — 51.0K weekly downloads ## Recent versions - 1.11.23 (latest) — 2026-08-17 - 2.0.0-alpha.4 (alpha) — 2022-09-26 - 1.11.22 — 2026-08-16 - 1.11.21 — 2026-05-26 - 1.11.20 — 2026-03-12 - 1.11.19 — 2025-10-31 - 1.11.18 — 2025-08-30 - 1.11.17 — 2025-08-29 - 1.11.16 — 2025-08-29 - 1.11.15 — 2025-08-28 - 1.11.14 — 2025-08-27 - 1.11.13 — 2024-08-20 - 1.11.12 — 2024-07-18 - 1.11.11 — 2024-04-28 - 1.11.10 — 2023-09-19 - … 121 more at https://npm.io/package/dayjs/versions ## 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 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](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) ## Downloads ![Day.js Chart](./docs/assets/download.png) ## 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)]                                              Instagram Story Viewer          Sayfone Cheap international calls                   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). --- _Source: https://npm.io/package/dayjs · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._