Day.js 一个轻量级的 JavaScript 时间日期处理库

最新推荐文章于 2025-06-14 13:47:22 发布

原创最新推荐文章于 2025-06-14 13:47:22 发布 · 7.7k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#时间库

开源库专栏收录该内容

1 篇文章

订阅专栏

Day.js是替代Moment.js的轻量级（2kb）时间日期库，提供相同API和用法，支持链式操作，全浏览器兼容。在项目中，若不需要多语言本地化，通过全局替换Moment.js，可以降低包体积，同时保持所有功能不变。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在项目中难免要去处理时间和日期，所以就一定会用到 Moment.js ，Moment.js 是一个大而全的 JS 时间库，使得我们处理时间和日期变得简便，但是 Moment.js 太重了（大约 200k +），而对于我们的项目我们可能只用到了其中的几个 API 而已，这时如果没有其它语言本地化的需求我们就可以使用 Day.js ，之所以使用它，仅仅是因为它有着与 Moment.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 大小，但是功能一点也没有阉割，包含了事件处理的全部常用方法

文档地址

https://github.com/xx45/dayjs

原项目中已有 moment.js

如果项目里没有其它国家语言本地化的需求，那没想缩小打包体积，提升开发体验只需要 replace(/moment/g, 'dayjs')全局替换一下，就能够减小体积并且所有 API 保持不变，无需修改，下面来看一些栗子

创建

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() // 闰年