Fast 2kB alternative to Moment.js with the same modern API
## 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).
================================================
FILE: babel.config.js
================================================
module.exports = {
env: {
test: {
presets: [
'@babel/preset-env'
]
},
build: {
presets: [
[
'@babel/preset-env',
{
modules: false,
loose: true
}
]
]
}
}
}
================================================
FILE: build/esm.js
================================================
const fs = require('fs')
const path = require('path')
const util = require('util')
const { ncp } = require('ncp')
const { promisify } = util
const typeFileExt = '.d.ts'
const localeDir = path.join(process.env.PWD, 'esm/locale')
const pluginDir = path.join(process.env.PWD, 'esm/plugin')
const localeTypePath = path.join(process.env.PWD, 'esm/locale', `index${typeFileExt}`);
(async () => {
try {
const readLocaleDir = await promisify(fs.readdir)(localeDir)
readLocaleDir.forEach(async (l) => {
const filePath = path.join(localeDir, l)
const readFile = await promisify(fs.readFile)(filePath, 'utf8')
const result = readFile.replace("'dayjs'", "'../index'")
await promisify(fs.writeFile)(filePath, result, 'utf8')
})
await promisify(ncp)('./types/', './esm')
const readLocaleFile = await promisify(fs.readFile)(localeTypePath, 'utf8')
const localResult = readLocaleFile.replace("'dayjs", "'dayjs/esm")
await promisify(fs.writeFile)(localeTypePath, localResult, 'utf8')
const readPluginDir = await promisify(fs.readdir)(pluginDir)
readPluginDir.forEach(async (p) => {
if (p.includes(typeFileExt)) {
const pluginName = p.replace(typeFileExt, '')
const filePath = path.join(pluginDir, p)
const targetPath = path.join(pluginDir, pluginName, `index${typeFileExt}`)
const readFile = await promisify(fs.readFile)(filePath, 'utf8')
const result = readFile.replace(/'dayjs'/g, "'dayjs/esm'")
await promisify(fs.writeFile)(targetPath, result, 'utf8')
await promisify(fs.unlink)(filePath)
}
})
} catch (e) {
console.error(e) // eslint-disable-line no-console
}
})()
================================================
FILE: build/index.js
================================================
const rollup = require('rollup')
const configFactory = require('./rollup.config')
const fs = require('fs')
const util = require('util')
const path = require('path')
const { ncp } = require('ncp')
const { promisify } = util
const promisifyReadDir = promisify(fs.readdir)
const promisifyReadFile = promisify(fs.readFile)
const promisifyWriteFile = promisify(fs.writeFile)
const localeNameRegex = /\/\/ (.*) \[/
const formatName = n => n.replace(/\.js/, '').replace('-', '_')
const localePath = path.join(__dirname, '../src/locale')
async function build(option) {
const bundle = await rollup.rollup(option.input)
await bundle.write(option.output)
}
async function listLocaleJson(localeArr) {
const localeListArr = []
await Promise.all(localeArr.map(async (l) => {
const localeData = await promisifyReadFile(path.join(localePath, l), 'utf-8')
localeListArr.push({
key: l.slice(0, -3),
name: localeData.match(localeNameRegex)[1]
})
}))
promisifyWriteFile(path.join(__dirname, '../locale.json'), JSON.stringify(localeListArr), 'utf8')
}
(async () => {
try {
/* eslint-disable no-restricted-syntax, no-await-in-loop */
// We use await-in-loop to make rollup run sequentially to save on RAM
const locales = await promisifyReadDir(localePath)
for (const l of locales) {
// run builds sequentially to limit RAM usage
await build(configFactory({
input: `./src/locale/${l}`,
fileName: `./locale/${l}`,
name: `dayjs_locale_${formatName(l)}`
}))
}
const plugins = await promisifyReadDir(path.join(__dirname, '../src/plugin'))
for (const plugin of plugins) {
// run builds sequentially to limit RAM usage
await build(configFactory({
input: `./src/plugin/${plugin}/index`,
fileName: `./plugin/${plugin}.js`,
name: `dayjs_plugin_${formatName(plugin)}`
}))
}
build(configFactory({
input: './src/index.js',
fileName: './dayjs.min.js'
}))
await promisify(ncp)('./types/', './')
// list locales
await listLocaleJson(locales)
} catch (e) {
console.error(e) // eslint-disable-line no-console
}
})()
================================================
FILE: build/rollup.config.js
================================================
const babel = require('rollup-plugin-babel')
const { terser } = require('rollup-plugin-terser')
module.exports = (config) => {
const { input, fileName, name } = config
return {
input: {
input,
external: [
'dayjs'
],
plugins: [
babel({
exclude: 'node_modules/**'
}),
terser()
]
},
output: {
file: fileName,
format: 'umd',
name: name || 'dayjs',
globals: {
dayjs: 'dayjs'
},
compact: true
}
}
}
================================================
FILE: docs/demo/index.js
================================================
import dayjs from 'dayjs'
// basic usage
dayjs().format()
// parse
dayjs('2018-08-08').format()
// format
dayjs().format('YYYY-MM-DD')
// locale
dayjs().locale('zh-cn').format()
// add
dayjs().add(1, 'year').format()
// subtract
dayjs().subtract(1, 'year').format()
// diff
dayjs().diff(dayjs().add(1, 'year'), 'year')
// isBefore
dayjs().isBefore(dayjs().add(1, 'year'))
// isAfter
dayjs().isAfter(dayjs().subtract(1, 'year'))
// isSame
dayjs().isSame(dayjs())
// isLeapYear
dayjs().isLeapYear()
// isBetween
dayjs().isBetween(dayjs().subtract(1, 'year'), dayjs().add(1, 'year'))
// isSameOrAfter
dayjs().isSameOrAfter(dayjs().subtract(1, 'year'))
// isSameOrBefore
dayjs().isSameOrBefore(dayjs().add(1, 'year'))
// startOf
dayjs().startOf('year').format()
// endOf
dayjs().endOf('year').format()
// week
dayjs().week()
// weekday
dayjs().weekday()
================================================
FILE: docs/en/API-reference.md
================================================
### Note
The documents are moved to [https://day.js.org](https://day.js.org).
================================================
FILE: docs/en/I18n.md
================================================
### Note
The documents are moved to [https://day.js.org](https://day.js.org).
================================================
FILE: docs/en/Installation.md
================================================
### Note
The documents are moved to [https://day.js.org](https://day.js.org).
================================================
FILE: docs/en/Plugin.md
================================================
### Note
The documents are moved to [https://day.js.org](https://day.js.org).
================================================
FILE: docs/es-es/API-reference.md
================================================
### Note
The documents are moved to [https://day.js.org](https://day.js.org).
================================================
FILE: docs/es-es/I18n.md
================================================
### Note
The documents are moved to [https://day.js.org](https://day.js.org).
================================================
FILE: docs/es-es/Installation.md
================================================
### Note
The documents are moved to [https://day.js.org](https://day.js.org).
================================================
FILE: docs/es-es/Plugin.md
================================================
### Note
The documents are moved to [https://day.js.org](https://day.js.org).
================================================
FILE: docs/es-es/README-es-es.md
================================================
Español (España) | [English](../../README.md) | [简体中文](../zh-cn/README.zh-CN.md) | [日本語](../ja/README-ja.md) | [Português Brasileiro](../pt-br/README-pt-br.md) | [한국어](../ko/README-ko.md) | [Русский](../ru/README-ru.md) | [עברית](./docs/he/README-he.md)
Alternativa rápida y ligera 2kB a Moment.js, con la misma API moderna
## Licencia
Day.js está licenciado bajo la [Licencia MIT](./LICENSE).
================================================
FILE: docs/fr/README-fr.md
================================================
Français | [English](../../README.md) | [简体中文](./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)
Alternative rapide de 2kB à Moment.js avec la même API moderne
## Sponsors
Soutenez ce projet en devenant sponsor. Votre logo apparaîtra ici avec un lien vers votre site web.
[[Devenir sponsor via Github](https://github.com/sponsors/iamkun/)] [[Devenir sponsor via OpenCollective](https://opencollective.com/dayjs#sponsor)]
## Contributeurs
Ce projet existe grâce à toutes les personnes qui y contribuent.
Donnez-nous une 💖 étoile 💖 pour nous soutenir. Nous vous remercions.
Et merci à tous nos donateurs ! 🙏
## Licence
Day.js est sous licence [MIT License](./LICENSE).
================================================
FILE: docs/he/README-he.md
================================================
אלטרנטיבה מהירה ל-Moment.js ששוקלת רק 2kB עם אותן יכולות מודרניות
## תורמים
פרויקט זה קיים הודות לכל האנשים שתמכו בו.
תנו לנו 💖 כוכב 💖 כדי לתמוך בנו. תודה רבה.
ותודה רבה לכל התומכים שלנו! 🙏
## רישיון
Day.js מורשה לשימוש עם [רישיון MIT](./LICENSE).
Moment.js と同じ API を備えた 2kB の軽量ライブラリ
Moment.js와 호환되는 API를 가진 경량 라이브러리 (2kB)
Alternativa veloz ao Moment.js, com 2kB e a mesma API moderna
## Contribuidores
Este projeto existe graças a todas as pessoas que contribuem.
Por favor, nos dê uma 💖 estrela 💖 para suportar-nos. Obrigado.
E obrigado a todos os nossos apoiadores! 🙏
## Licença
Day.js é licenciado sob a [MIT License](../../LICENSE).
================================================
FILE: docs/ru/LICENSE-ru
================================================
Лицензия MIT
Авторское право (c) с 2018 года по настоящее время, iamkun
Данная лицензия разрешает лицам, получившим копию
данного программного обеспечения и сопутствующей документации (в дальнейшем именуемыми «Программное обеспечение»), безвозмездно
использовать Программное обеспечение без ограничений, включая неограниченное право
на использование, копирование, изменение, слияние, публикацию, распространение, сублицензирование и/или продажу
копий Программного обеспечения, а также лицам, которым предоставляется данное Программное обеспечение,
при соблюдении следующих условий:
Указанное выше уведомление об авторском праве и данные условия должны быть включены во все
копии или значимые части данного Программного обеспечения.
ДАННОЕ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНО ВЫРАЖЕННЫХ ИЛИ
ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ ГАРАНТИИ ТОВАРНОЙ ПРИГОДНОСТИ, СООТВЕТСТВИЯ ПО ЕГО КОНКРЕТНОМУ НАЗНАЧЕНИЮ
И ОТСУТСТВИЯ НАРУШЕНИЙ, НО НЕ ОГРАНИЧИВАЯСЬ ИМИ. НИ В КАКОМ СЛУЧАЕ АВТОРЫ ИЛИ ПРАВООБЛАДАТЕЛИ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ
ПО КАКИМ-ЛИБО ИСКАМ, ЗА УЩЕРБ ИЛИ ПО ИНЫМ ТРЕБОВАНИЯМ, В ТОМ ЧИСЛЕ, ПРИ ДЕЙСТВИИ КОНТРАКТА, ДЕЛИКТЕ ИЛИ ИНОЙ СИТУАЦИИ,
ВОЗНИКШИМ ИЗ-ЗА ИСПОЛЬЗОВАНИЯ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ ИЛИ ИНЫХ ДЕЙСТВИЙ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ.
================================================
FILE: docs/ru/README-ru.md
================================================
Русский | [English](../../README.md) | [简体中文](../zh-cn/README.zh-CN.md) | [日本語](../ja/README-ja.md) | [Português Brasileiro](../pt-br/README-pt-br.md) | [한국어](../ko/README-ko.md) | [Español (España)](../es-es/README-es-es.md)| [עברית](./docs/he/README-he.md)
Быстрая 2kB альтернатива Moment.js с тем же современным API
## Контрибьюторы
Этот проект существует благодаря всем людям, кто вносит свой вклад в его развитие.
Пожалуйста поставьте 💖 звездочку 💖, чтобы поддержать нас. Спасибо.
Также выражаю благодарность всем нашим спонсорам! 🙏
## Лицензия
Day.js распространяется под [лицензией MIT](./LICENSE-ru).
================================================
FILE: docs/si/README-si.md
================================================
සිංහල | [English](../../README.md) | [简体中文](./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/he/README-he.md)
නවීන යෙ.ක්ර.මු. සමඟින් Moment.js සඳහා කි.බ. 2 ක වේගවත් විකල්පයකි
## දායකයින්
මෙම ව්යාපෘතිය පවතිනුයේ දායක වූ සියළුම දෙනාට ස්තූති වන්නටය.
අපට සහාය වීමට 💖 තරුවක් 💖 ලබා දෙන්න. ඔබට තුති.
ඒ වගේම අපගේ මූල්යදායකයින් සැමට ස්තුතියි! 🙏
## බලපත්රය
[MIT බලපත්රයක්](./LICENSE) යටතේ Day.js නිකුත් කර ඇත.
================================================
FILE: docs/sw/README-sw.md
================================================
Swahili | [English](../../README.md) | [Kireno](../pt-br/README-pt-br.md) | [Kichina](../zh-cn/README.zh-CN.md) | [Kijapani](../ja/README-ja.md) | [Kikorea](../ko/README-ko.md) | [Kihispania](../es-es/README-es-es.md) | [Kirusi](../ru/README-ru.md) | [Kituruki](../tr/README-tr.md) | [Sinhala](../si/README-si.md) | [Kiebrania](../he/README-he.md)
Fast 2kB mbadala wa Moment.js ukiwa na API zinazofanana na za kisasa
## Wafadhili
Toa mchango wako kwa huu mradi kwa kuwa mfadhili. Nembo yako itaonekana hapa pamoja na link ya kwenda kwenye tovuti yako.
[[Kuwa mfadhili kupitia GitHub](https://github.com/sponsors/iamkun/)] [[Kuwa mfadhili kupitia OpenCollective](https://opencollective.com/dayjs#sponsor)]
## Wachangiaji
Huu mradi umefika hapa ulipo hapa shukrani ziende kwa watu wote wanao changia.
Tafadhali tupe 💖 nyota/maua 💖 kutuunga mkono sisi.Ahsante.
Na ahsante kwa wafadhili wote! 🙏
## Leseni
Day.js ipo chini ya kibali cha [leseni ya MTI](./LICENSE).
================================================
FILE: docs/tr/README-tr.md
================================================
Türkçe | [English](../../README.md) | [简体中文](../zh-cn/README.zh-CN.md) | [日本語](../ja/README-ja.md) | [Português Brasileiro](../pt-br/README-pt-br.md) | [한국어](../ko/README-ko.md) | [Español (España)](../es-es/README-es-es.md) | [Русский](../ru/README-ru.md)| [עברית](./docs/he/README-he.md)
Aynı modern API ile 2kB hızlı bir Moment.js alternatifi
## Katkıda Bulunanlar
Bu proje, katkıda bulunan tüm insanlar sayesinde mevcut.
Lütfen bize destek olmak için projeye 💖 yıldız 💖 verin. Teşekkürler.
Ve tüm destekçilerimize teşekkür ederiz! 🙏
## Lisans
Day.js, bir [MIT Lisansı](../../LICENSE) altında lisanslanmıştır.
================================================
FILE: docs/zh-cn/API-reference.md
================================================
### 提醒
文档已迁移至 [https://day.js.org](https://day.js.org)。
================================================
FILE: docs/zh-cn/I18n.md
================================================
### 提醒
文档已迁移至 [https://day.js.org](https://day.js.org)。
================================================
FILE: docs/zh-cn/Installation.md
================================================
### 提醒
文档已迁移至 [https://day.js.org](https://day.js.org)。
================================================
FILE: docs/zh-cn/Plugin.md
================================================
### 提醒
文档已迁移至 [https://day.js.org](https://day.js.org)。
================================================
FILE: docs/zh-cn/README.zh-CN.md
================================================
简体中文 | [English](../../README.md) | [日本語](../ja/README-ja.md) | [Português Brasileiro](../pt-br/README-pt-br.md) | [한국어](../ko/README-ko.md) | [Español (España)](../es-es/README-es-es.md) | [Русский](../ru/README-ru.md)
Moment.js 的 2kB 轻量化方案，拥有同样强大的 API