⏰Day.js 2KB 轻量时间库 和 Moment.js 一样的 API

[iamkun]

Moment.js 是一个大而全的 JS 时间库，很大地方便了我们处理日期和时间。但是 Moment.js 太重了(200k+ with locals)，可能一般项目也只使用到了她几个常用的 API。虽然社区也有几个轻量的时间库，要想迁移过去又会增加新的学习和迁移成本。

如果能有一个和 Moment.js 一样语法，一样功能，又轻量的库该多好！

Day.js 是一个轻量的 JavaScript 时间日期处理库，和 Moment.js 的 API 设计保持完全一样. 如果你曾经用过 Moment.js, 那么你已经知道如何使用 Day.js

Day.js 基本用法如下，相同的 API，相同的链式操作。

dayjs().startOf('month').add(1, 'day').set('year', 2018).format('YYYY-MM-DD HH:mm:ss');

• 🕒 和 Moment.js 相同的 API 和用法
• 💪 不可变数据 (Immutable)
• 🔥 支持链式操作 (Chainable)
• 📦 仅 2kb 大小的微型库
• 👫 全浏览器兼容

Day.js 虽然仅有 2kb 大小，但功能上也包含了时间处理的全部常用方法。

文档地址 (中文)💖

喜欢可以给个💖star💖鼓励一下吗 https://github.com/xx45/dayjs

---

如果您的项目里没有其他国家语言本地化的需求，那想缩小打包体积，提升开发体验只需要 replace(/moment/g, 'dayjs') 全局替换一下。就能从 Moment.js + locals 200kb 减小成 dayjs 2kb 的体积。所有的 API 调用都保持不变，无需修改。

来感受一下 Dayjs 的语法吧，是不是很看起来亲切呢 😋 (没错 这就是 moment 的语法嘛)

创建

dayjs() // 当前时间
dayjs('1995-12-25') // 1995-12-25
dayjs(Date.now() - 24 * 60 * 60 * 1000) // 昨天

格式化

dayjs().format('YYYY 年 MM 月 DD 日 HH:mm:ss') // 2018 年 08 月 08 日 00:00:00
dayjs().format('[YYYY]') // "[2018]"。[] 里的会原样输出。

操作

dayjs().add(7, 'days') // 之后的第 7 天
dayjs().subtract(1, 'months') // 上个月
dayjs().startOf('months') // 获取一月初 
dayjs().endOf('year') // 获取一年年末

查询

dayjs('2010-10-20').isBefore('2010-10-21') // 早于
dayjs('2010-10-20').isAfter('2010-10-19') // 晚于
dayjs().isLeapYear() // 闰年

issue and pr's welcome

欢迎来 issue 和 pr 哦 https://github.com/xx45/dayjs

[zazzaz]

我在今天 github trending 排行榜看到大佬的项目了 4000star 很厉害呀 喜欢这种小而美的库

[iamkun]

小而美 我喜欢这个说法 😄

[sunjourney]

你是 immutable 的，moment 是 mutable 的，replace(/moment/g, 'dayjs') ，怕是要出篓子哦。

[sunjourney]

其实如果不能通过 moment 的 test cases，`replace(/moment/g, 'dayjs') ` 就最好不要这样介绍，免得有人出 bug 了怪库

[iamkun]

恩 @sunjourney 你说的对 ，下次会更严谨一点。用 moment 时为了避免 bug 一般会 clone 出来一个再操作(假装 mutable)，所以我也对应实现了一个 clone 的 API

[wxsm]

支持一下

[airyland]

赞，但是越多人使用就越可能提出更多的需求和问题，希望能尽量保持体积。

[sunjourney]

@iamkun #5 主要鬼知道有没有人在利用 mutable 编程。。。

[kohos]

支持，momentjs 确实太大了点，以后开发换 dayjs 了

[zazzaz]

@sunjourney 写 moment 必须要每一步都调用 clone 呀 不然很有可能出现各种莫名其妙的 bug

[iamkun]

@airyland 请问大佬在做 vux 时候有类似的经验吗 保持体积和满足需求真的是很矛盾的

[airyland]

@iamkun #11 因为是组件库，都是按需加载，新需求一般也不会让单个组件体积膨胀，所以其实没有这个问题。。工具库像 lodash 是可以按需加载单个函数的，或许你可以保持核心小，其他扩展作为附加文件额外加载，因为大多数时候用户只是需要核心库。

[iamkun]

@airyland #12 受教了
@kohos 欢迎尝试

[zazzaz]

@airyland 又一个大佬 vux 也很好用的 敢问两位大佬 这好几千的 star 是什么体验呀

[FEDT]

赞

[yuanfnadi]

@iamkun iOS 遇到了兼容问题
同样的时间字符串 iOS 显示非法

[iamkun]

@yuanfnadi 谢谢反馈 ，github 看到你的 issue 了，预计明天发的版本会解决。如果比较急可以传入之前先`replace(/-/g, '/')` 即可

[airyland]

@zazzaz #14 一开始上 Github Trending 还挺兴奋的，但是过了 5k 后就没感觉了，再过了 10k 后就会感觉增长缓慢所以不会再去关注 star 数了，实际上维护也挺花精力的。

[SourceMan]

已经用 date-fns 了。。

[phoenixlzx]

哇楼主厉害了

[iamkun]

@phoenixlzx 哇 TJ 大神吗？ 赶快去看看

[zazzaz]

@phoenixlzx 火前留名 tj star 的项目 过一万星星估计已经不远了

[zj9495]

不能处理 unix 时间么
https://s1.ax1x.com/2018/05/09/CdOtpT.png

[iamkun]

@zj9495 我们正在做一套插件系统 应该这几天就上线 unix 和 utc 会已一个插件的形式支持的

[iamkun]

@zj9495 目前可以先这么用 dayjs(unix * 1000) 传入毫秒是可以支持的

[WildCat]

楼主在 Brighton ？

[asahui]

能介绍一下如何做到比 moment 小这么多吗，精简了哪些地方