提升日期处理效率：day.js 实战经验分享

本文简介

点赞 + 关注 + 收藏 = 学会了

1. 本文主要介绍我在工作中使用day.js较多的方法。

2. 本文并不能代替day.js官方文档，日常工作中该查文档的还是要查文档。

3. 本文是写给刚接触day.js的工友，让这部分工友能更顺利上手day.js。

4. 本文不涉及day.js插件（王国之泪通关后再写这部分吧）。

day.js 简介

day.js是一个专门处理日期和时间的工具库，它的体积只有 2KB，非常小。

安装 day.js

npm

安装

npm install dayjs --save

使用

// 引入 dayjsimportdayjsfrom'dayjs'// 输出当前时间console.log(dayjs())

cdn

访问 https://www.jsdelivr.com/package/npm/dayjs 下载最新版本的 Day.js。

<scriptsrc="https://cdn.jsdelivr.net/npm/dayjs@1/dayjs.min.js"></script><script>// 输出当前时间console.log(dayjs())</script>

格式化日期格式

前面我们使用dayjs()获取到当前的时间，但返回的格式不好看。

// 输出当前时间console.log(dayjs())

day.js提供了format()方法可以格式化时间。《文档：Format》

format()会返回一个字符串类型的时间。

基础用法

// 格式化当前时间console.log(dayjs().format())

自定义格式

format()支持自定义日期格式，点击查看支持的格式

常用格式我拷一份放在这里

知道这些格式，我们就可以这样写：

// 年dayjs().format('YY')// 返回 23 （写本文时是2023年）dayjs().format('YYYY')// 返回 2023// 月dayjs().format('M')// 返回当前月份（1-12）dayjs().format('MM')// 返回当前月份（01-12），用MM的话，1-9月前面会补0// 日dayjs().format('D')// 返回当前月份里的天，比如今天是5月1号，就输出1；如果今天是5月20号，就输出20dayjs().format('DD')// 返回当前月份里的天，用DD的话，1-9天前面会补0// 星期dayjs().format('d')// 返回一周中的一天，星期天是 0// 小时dayjs().format('H')// 返回小时 0-23dayjs().format('HH')// 返回小时 00-23，0-9小时前面会补0dayjs().format('h')// 返回小时 1-12dayjs().format('hh')// 返回小时 01-12，1-9小时前面会补0// 分钟dayjs().format('m')// 返回分钟 0-59dayjs().format('mm')// 返回分钟 00-59，0-9分钟前面会补0// 秒dayjs().format('s')// 返回秒 0-59dayjs().format('ss')// 返回秒 00-59，0-9秒前面会补0dayjs().format('sss')// 返回毫秒数 000-999

需要注意：

• 大写M表示月份，小写m表示分钟。
• 大写D表示月份里的一天，小写d表示一周中的一天
• 大写H是24小时制，小写h是12小时制。比如下午2点 大写H是14，小写h就是2。如果是使用小写h，建议配合A或者a一起使用。

可以将上面的格式组合起来使用

/* 目标：输出当前年月日时分秒 规则：年月日用“-”分隔；时分秒用“:“分隔；年月日和时分秒之间用空格分隔 */dayjs().format('YYYY-MM-DD hh:mm:ss')/* 目标：输出当前年月日 规则：年月日用“/”分隔 */dayjs().format('YYYY/MM/DD')/* 目标：输出当前年月日 规则：使用中文的“年”、“月”、“日”单位 */dayjs().format('YYYY年MM月DD日')

dayjs()还接受传入时间参数，然后再使用format()进行格式化

dayjs('2023-05-20').format('YYYY年MM月DD日')// 返回 2023年05月20日

简单吧，好用吧～

format()和其他方法结合起来很好用，后面会举例。

获取/设置日期时间

前面的例子中我们通过dayjs().format('M')等方法可以获取当前时间或者指定时间的月份等信息。

day.js其实也提供了一些方法可以获取或者设置指定日期时间，详情可以看 文档。

我这里举个例子。

// 获取当前月份。注意：月份从0开始，0表示1月，1表示2月...dayjs().month()// 设置月份dayjs().month(10)// 设置完月份后格式化dayjs().month(10).format()

这个例子用到month()方法，如果不传参就会返回当前日期的月份，如果传了参就变成设置月份了。

还有年、日、周、时分秒等其他配置和获取的方法，请参考 文档。

日期时间计算

日期计算是工作中常用的功能，比如计算3天后的日期是多少。day.js提供了很多方便的方法。

增加日期时间

给定一个日期，希望获取该日期的后几天，或者想获取当前时间的半小时后的时间，就可以使用add()方法。

add()方法接收2个参数：

• 第一个参数是要增加的时间，可以是负值。
• 第二个参数是时间单位，比如day、month等。

第二个参数支持的单位如下：

其实第二个参数还支持quarter查询季度，但需要安装QuarterOfYear插件。

比如获取当前日期的后10天。

dayjs().add(10,'day')// 格式化后返回dayjs().add(10,'day').format()

如果加了10天后夸了月，day.js会自动判断的。

比如今天是2023年5月24日，加了10天就是2023年6月3日。

获取当前时间的半小时后的时间。

dayjs().add(30,'minute')// 或者dayjs().add(0.5,'hour')

如果传入的值是负数，那返回的时间就是往前计算的。

比如获取10天前的时间。

dayjs().add(-10,'day')

使用add()方法第一个参数最好还是传入正数，因为想获取之前的时间，可以使用subtract()方法。

减少日期时间

subtract()方法和add()的用法一样。

subtract()的作用是返回减去一定时间的值。

比如想获取10天前的时间值可以这样写。

dayjs().subtract(10,'day')

subtract()的第一个参数同样可以传入负数，但没必要这么做。

subtract()方法很适合用在日历组件的快捷选项，比如获取1周内的时间。

// 当前时间dayjs().format('YYYY-MM-DD hh:mm:ss')// 7天前的时间dayjs().subtract(7,'day').format('YYYY-MM-DD hh:mm:ss')

获取开始日期时间

使用startOf()方法可以获取开始时间日期。

startOf()需要传入一个单位参数，这个参数支持以下值：

其中quarter需要另外安装QuarterOfYear插件，isoWeek需要另外安装IsoWeek插件。

比如，我要获取当月的1号到今天的日期。

// 今天的日期dayjs().format()// 本月的第一天日期dayjs().startOf('month').format()

我在项目中，图表部分有时候会有这种需求。

再比如，有些时候我们可能想获取当前时间的本周第一天，比如今天是2023年5月25号星期4，我想看看这周的周一是几号，就可以这么写：

dayjs().startOf('week').format('DD')// 返回 21。2023年5月21号是星期1

获取结束日期时间

有获取开始日期时间就有获取结束日期时间。

day.js提供了endOf()方法获取结束日期时间。

比如要获取当前日期的23:59:59。

dayjs().endOf('day').format()

endOf()通常会和startOf()结合使用，这样就可以获取一个比较完整的时间段。

比如要获取 2020年2月的开始和结束日期。

// 2020年2月开始日期时间 dayjs('2020-02').startOf('month').format() // 2020年2月结束日期时间 dayjs('2020-02').endOf('month').format()

像2月这种不能一眼看出有多少天的月份，用endOf()方法就非常方便了。

计算2个日期时间差

如果要计算2个日期时间的差异，可以使用diff()方法。

diff()的语法：

时间1.diff(时间2)时间1.diff(时间2,时间单位)

如果不传第二个参数（时间单位），默认返回毫秒数。

举个例子，计算北京奥运会开幕式到现在过了多少天。

// 北京奥运会开幕时间constopeningDate=dayjs('2008-08-08')// 当前时间constnow=dayjs()// 计算北京奥运开幕式到现在过了多少毫秒now.diff(openingDate)// 计算北京奥运开幕式到现在过了多少天now.diff(openingDate,'day')

单位时间除了'day'之外，还支持以下单位：

日期时间查询

查询指定月份有多少天

我还记得小学数学老师教我们数一个月有多少天的方法。

举起一个拳头👊

不好意思，搞错了。。。

从食指往小拇指方向数，凸起来的是31天，凹下去的是30天，2月份除外。

因为有闰年的存在，2月的天数是不定的。

day.js提供了daysInMonth()方法可以快速查询指定月份有多少天。

dayjs('2008-02').daysInMonth()// 返回29dayjs('2023-02').daysInMonth()// 返回28

查询时间是否在另一个时间之前

查询一个时间是否在另一个时间之前，用的是isBefore()方法。

比如查询当前日期是否在北京奥运会开幕式之前

dayjs().isBefore(dayjs('2008-08-08'))

isBefore()接受第二个参数：时间单位。

比如传入month，就通过年和月来对比。

ayjs().isBefore(dayjs('2008-08-08'),'month')

查询时间是否在另一个时间之后

查询一个时间是否在另一个时间之后，用的是isAfter()方法。

比如查询当前日期是否在北京奥运会开幕式之后

dayjs().isAfter(dayjs('2008-08-08'))

isAfter()也支持传入第二个参数：时间单位。

判断两个时间是否相同

判断两个时间是否相同使用的方法是isSame()。

isSame()方法默认使用毫秒来判断。

dayjs().isSame(dayjs('2008-08-08'))

如果想判断年份或者月份是否相同，就需要传入第二个参数：时间单位。

// 年份相同就返回 true，否则返回 falsedayjs().isSame('2008-08-08','year')// 年份和月份相同才返回 true，否则返回 falsedayjs().isSame('2008-08-08','month')// 年月日都相同才返回 true，否则返回 falsedayjs().isSame('2008-08-08','day')

是否在其他两个的日期时间之间

判断一个时间是否在某个时间段内，需要用到 IsBetween 插件。

如果不想下载这个插件，完全可以通过isBefore()和isAfter()组合起来进行判断。

比如判断当前时间是否在2019年 至 2025年之间，可以这么写：

// 当前时间constnow=dayjs()// 判断结果now.isAfter('2019')&&now.isBefore('2025')

day.js 轻量实用，能高效搞定日期格式化、计算与时间查询需求，落地时要考虑组件复用、快速部署的工程效率问题。试试RollCode 低代码平台，轻松实现私有化部署、自定义组件、静态页面发布（SSG + SEO）。

点赞 + 关注 + 收藏 = 学会了