Module
⏰ Day.js 2kB immutable date-time library alternative to Moment.js with the same modern API
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415import * as C from './constant'import en from './locale/en'import U from './utils'
let L = 'en' // global localeconst Ls = {} // global loaded localeLs[L] = en
const isDayjs = d => d instanceof Dayjs // eslint-disable-line no-use-before-define
const parseLocale = (preset, object, isLocal) => { let l if (!preset) return L if (typeof preset === 'string') { const presetLower = preset.toLowerCase() if (Ls[presetLower]) { l = presetLower } if (object) { Ls[presetLower] = object l = presetLower } const presetSplit = preset.split('-') if (!l && presetSplit.length > 1) { return parseLocale(presetSplit[0]) } } else { const { name } = preset Ls[name] = preset l = name } if (!isLocal && l) L = l return l || (!isLocal && L)}
const dayjs = function (date, c) { if (isDayjs(date)) { return date.clone() } // eslint-disable-next-line no-nested-ternary const cfg = typeof c === 'object' ? c : {} cfg.date = date cfg.args = arguments// eslint-disable-line prefer-rest-params return new Dayjs(cfg) // eslint-disable-line no-use-before-define}
const wrapper = (date, instance) => dayjs(date, { locale: instance.$L, utc: instance.$u, x: instance.$x, $offset: instance.$offset // todo: refactor; do not use this.$offset in you code })
const Utils = U // for plugin useUtils.l = parseLocaleUtils.i = isDayjsUtils.w = wrapper
const parseDate = (cfg) => { const { date, utc } = cfg if (date === null) return new Date(NaN) // null is invalid if (Utils.u(date)) return new Date() // today if (date instanceof Date) return new Date(date) if (typeof date === 'string' && !/Z$/i.test(date)) { const d = date.match(C.REGEX_PARSE) if (d) { const m = d[2] - 1 || 0 const ms = (d[7] || '0').substring(0, 3) if (utc) { return new Date(Date.UTC(d[1], m, d[3] || 1, d[4] || 0, d[5] || 0, d[6] || 0, ms)) } return new Date(d[1], m, d[3] || 1, d[4] || 0, d[5] || 0, d[6] || 0, ms) } }
return new Date(date) // everything else}
class Dayjs { constructor(cfg) { this.$L = parseLocale(cfg.locale, null, true) this.parse(cfg) // for plugin }
parse(cfg) { this.$d = parseDate(cfg) this.$x = cfg.x || {} this.init() }
init() { const { $d } = this this.$y = $d.getFullYear() this.$M = $d.getMonth() this.$D = $d.getDate() this.$W = $d.getDay() this.$H = $d.getHours() this.$m = $d.getMinutes() this.$s = $d.getSeconds() this.$ms = $d.getMilliseconds() }
// eslint-disable-next-line class-methods-use-this $utils() { return Utils }
isValid() { return !(this.$d.toString() === C.INVALID_DATE_STRING) }
isSame(that, units) { const other = dayjs(that) return this.startOf(units) <= other && other <= this.endOf(units) }
isAfter(that, units) { return dayjs(that) < this.startOf(units) }
isBefore(that, units) { return this.endOf(units) < dayjs(that) }
$g(input, get, set) { if (Utils.u(input)) return this[get] return this.set(set, input) }
unix() { return Math.floor(this.valueOf() / 1000) }
valueOf() { // timezone(hour) * 60 * 60 * 1000 => ms return this.$d.getTime() }
startOf(units, startOf) { // startOf -> endOf const isStartOf = !Utils.u(startOf) ? startOf : true const unit = Utils.p(units) const instanceFactory = (d, m) => { const ins = Utils.w(this.$u ? Date.UTC(this.$y, m, d) : new Date(this.$y, m, d), this) return isStartOf ? ins : ins.endOf(C.D) } const instanceFactorySet = (method, slice) => { const argumentStart = [0, 0, 0, 0] const argumentEnd = [23, 59, 59, 999] return Utils.w(this.toDate()[method].apply( // eslint-disable-line prefer-spread this.toDate('s'), (isStartOf ? argumentStart : argumentEnd).slice(slice) ), this) } const { $W, $M, $D } = this const utcPad = `set${this.$u ? 'UTC' : ''}` switch (unit) { case C.Y: return isStartOf ? instanceFactory(1, 0) : instanceFactory(31, 11) case C.M: return isStartOf ? instanceFactory(1, $M) : instanceFactory(0, $M + 1) case C.W: { const weekStart = this.$locale().weekStart || 0 const gap = ($W < weekStart ? $W + 7 : $W) - weekStart return instanceFactory(isStartOf ? $D - gap : $D + (6 - gap), $M) } case C.D: case C.DATE: return instanceFactorySet(`${utcPad}Hours`, 0) case C.H: return instanceFactorySet(`${utcPad}Minutes`, 1) case C.MIN: return instanceFactorySet(`${utcPad}Seconds`, 2) case C.S: return instanceFactorySet(`${utcPad}Milliseconds`, 3) default: return this.clone() } }
endOf(arg) { return this.startOf(arg, false) }
$set(units, int) { // private set const unit = Utils.p(units) const utcPad = `set${this.$u ? 'UTC' : ''}` const name = { [C.D]: `${utcPad}Date`, [C.DATE]: `${utcPad}Date`, [C.M]: `${utcPad}Month`, [C.Y]: `${utcPad}FullYear`, [C.H]: `${utcPad}Hours`, [C.MIN]: `${utcPad}Minutes`, [C.S]: `${utcPad}Seconds`, [C.MS]: `${utcPad}Milliseconds` }[unit] const arg = unit === C.D ? this.$D + (int - this.$W) : int
if (unit === C.M || unit === C.Y) { // clone is for badMutable plugin const date = this.clone().set(C.DATE, 1) date.$d[name](arg) date.init() this.$d = date.set(C.DATE, Math.min(this.$D, date.daysInMonth())).$d } else if (name) this.$d[name](arg)
this.init() return this }
set(string, int) { return this.clone().$set(string, int) }
get(unit) { return this[Utils.p(unit)]() }
add(number, units) { number = Number(number) // eslint-disable-line no-param-reassign const unit = Utils.p(units) const instanceFactorySet = (n) => { const d = dayjs(this) return Utils.w(d.date(d.date() + Math.round(n * number)), this) } if (unit === C.M) { return this.set(C.M, this.$M + number) } if (unit === C.Y) { return this.set(C.Y, this.$y + number) } if (unit === C.D) { return instanceFactorySet(1) } if (unit === C.W) { return instanceFactorySet(7) } const step = { [C.MIN]: C.MILLISECONDS_A_MINUTE, [C.H]: C.MILLISECONDS_A_HOUR, [C.S]: C.MILLISECONDS_A_SECOND }[unit] || 1 // ms
const nextTimeStamp = this.$d.getTime() + (number * step) return Utils.w(nextTimeStamp, this) }
subtract(number, string) { return this.add(number * -1, string) }
format(formatStr) { const locale = this.$locale()
if (!this.isValid()) return locale.invalidDate || C.INVALID_DATE_STRING
const str = formatStr || C.FORMAT_DEFAULT const zoneStr = Utils.z(this) const { $H, $m, $M } = this const { weekdays, months, meridiem } = locale const getShort = (arr, index, full, length) => ( (arr && (arr[index] || arr(this, str))) || full[index].slice(0, length) ) const get$H = num => ( Utils.s($H % 12 || 12, num, '0') )
const meridiemFunc = meridiem || ((hour, minute, isLowercase) => { const m = (hour < 12 ? 'AM' : 'PM') return isLowercase ? m.toLowerCase() : m })
const matches = { YY: String(this.$y).slice(-2), YYYY: this.$y, M: $M + 1, MM: Utils.s($M + 1, 2, '0'), MMM: getShort(locale.monthsShort, $M, months, 3), MMMM: getShort(months, $M), D: this.$D, DD: Utils.s(this.$D, 2, '0'), d: String(this.$W), dd: getShort(locale.weekdaysMin, this.$W, weekdays, 2), ddd: getShort(locale.weekdaysShort, this.$W, weekdays, 3), dddd: weekdays[this.$W], H: String($H), HH: Utils.s($H, 2, '0'), h: get$H(1), hh: get$H(2), a: meridiemFunc($H, $m, true), A: meridiemFunc($H, $m, false), m: String($m), mm: Utils.s($m, 2, '0'), s: String(this.$s), ss: Utils.s(this.$s, 2, '0'), SSS: Utils.s(this.$ms, 3, '0'), Z: zoneStr // 'ZZ' logic below }
return str.replace(C.REGEX_FORMAT, (match, $1) => $1 || matches[match] || zoneStr.replace(':', '')) // 'ZZ' }
utcOffset() { // Because a bug at FF24, we're rounding the timezone offset around 15 minutes // https://github.com/moment/moment/pull/1871 return -Math.round(this.$d.getTimezoneOffset() / 15) * 15 }
diff(input, units, float) { const unit = Utils.p(units) const that = dayjs(input) const zoneDelta = (that.utcOffset() - this.utcOffset()) * C.MILLISECONDS_A_MINUTE const diff = this - that let result = Utils.m(this, that)
result = { [C.Y]: result / 12, [C.M]: result, [C.Q]: result / 3, [C.W]: (diff - zoneDelta) / C.MILLISECONDS_A_WEEK, [C.D]: (diff - zoneDelta) / C.MILLISECONDS_A_DAY, [C.H]: diff / C.MILLISECONDS_A_HOUR, [C.MIN]: diff / C.MILLISECONDS_A_MINUTE, [C.S]: diff / C.MILLISECONDS_A_SECOND }[unit] || diff // milliseconds
return float ? result : Utils.a(result) }
daysInMonth() { return this.endOf(C.M).$D }
$locale() { // get locale object return Ls[this.$L] }
locale(preset, object) { if (!preset) return this.$L const that = this.clone() const nextLocaleName = parseLocale(preset, object, true) if (nextLocaleName) that.$L = nextLocaleName return that }
clone() { return Utils.w(this.$d, this) }
toDate() { return new Date(this.valueOf()) }
toJSON() { return this.isValid() ? this.toISOString() : null }
toISOString() { // ie 8 return // new Dayjs(this.valueOf() + this.$d.getTimezoneOffset() * 60000) // .format('YYYY-MM-DDTHH:mm:ss.SSS[Z]') return this.$d.toISOString() }
toString() { return this.$d.toUTCString() }}
const proto = Dayjs.prototypedayjs.prototype = proto;[ ['$ms', C.MS], ['$s', C.S], ['$m', C.MIN], ['$H', C.H], ['$W', C.D], ['$M', C.M], ['$y', C.Y], ['$D', C.DATE]].forEach((g) => { proto[g[1]] = function (input) { return this.$g(input, g[0], g[1]) }})
dayjs.extend = (plugin, option) => { if (!plugin.$i) { // install plugin only once plugin(option, Dayjs, dayjs) plugin.$i = true } return dayjs}
dayjs.locale = parseLocale
dayjs.isDayjs = isDayjs
dayjs.unix = timestamp => ( dayjs(timestamp * 1e3))
dayjs.en = Ls[L]dayjs.Ls = Lsdayjs.p = {}export default dayjs