Repository files navigation

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

Fast2kB 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.

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

You can find more details, API, and other docs onday.js.org website.

npm install dayjs --save

📚Installation Guide

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

dayjs('2018-08-08')// parsedayjs().format('{YYYY} MM-DDTHH:mm:ss SSS [Z] A')// displaydayjs().set('month',3).month()// get & setdayjs().add(1,'year')// manipulatedayjs().isBefore(dayjs())// query

📚API 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 demanddayjs.locale('es')// use Spanish locale globallydayjs('2018-05-05').locale('zh-cn').format()// use Chinese Simplified locale in a specific instance

📚Internationalization

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

importadvancedFormatfrom'dayjs/plugin/advancedFormat'// load on demanddayjs.extend(advancedFormat)// use plugindayjs().format('Q Do k kk X x')// more available formats

📚Plugin List

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]

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

Day.js is licensed under aMIT License.