Day.js 2kB immutable date-time library alternative to Moment.js with the same modern API
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
iamkun b5b7be121c
Update README.md
1 week ago
.github chore: add action lint & test (#1939) 2 months ago
build Fix broken UTC plugin due to rollup (#1453) 1 year ago
docs Add & update Sinhala README (#1958) 2 months ago
src fix: zh-tw / zh-hk locale ordinal error (#1976) 3 weeks ago
test test: update test case 3 weeks ago
types fix: fix objectSupport plugin ConfigTypeMap type (#1441) (#1990) 3 weeks ago
.editorconfig chore: add .editorconfig (#660) 3 years ago
.eslintrc.json chore: Update travis check node 12 LTS (#847) 2 years ago
.gitignore chore: update moment.js to 2.29.2 (#1856) 4 months ago
.npmignore chore: update npmignore 4 years ago
.travis.yml ci: fix node 18 travis issue 3 weeks ago
CHANGELOG.md chore(release): 1.11.3 [skip ci] 2 months ago
CONTRIBUTING.md docs: Updated CONTRIBUTING.md (#479) 4 years ago
LICENSE Update LICENSE (#439) 4 years ago
README.md Update README.md 1 week ago
babel.config.js chore(docs/test): fix code style, remove commented code and replace `var` to `const` (#1874) 3 months ago
karma.sauce.conf.js chore(docs/test): fix code style, remove commented code and replace `var` to `const` (#1874) 3 months ago
package-lock.json chore: update moment.js to 2.29.2 (#1856) 4 months ago
package.json chore: update moment.js to 2.29.2 (#1856) 4 months ago
prettier.config.js chore: update prettier setting 4 years ago

README.md

English | 简体中文 | 日本語 | Português Brasileiro | 한국어 | Español (España) | Русский | Türkçe | හල

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.

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 for more details, API, and other docs on day.js.org website.

Installation

npm install dayjs --save

📚Installation Guide

API

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

📚API Reference

I18n

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

📚Internationalization

Plugin

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

📚Plugin List

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.