theme: smartblue

本文简介

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

本文主要介绍我在工作中使用 day.js 较多的方法。
本文并不能代替 day.js 官方文档，日常工作中该查文档的还是要查文档。
本文是写给刚接触 day.js 的工友，让这部分工友能更顺利上手 day.js。
本文不涉及 day.js 插件(王国之泪通关后再写这部分吧)。

day.js 简介

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

安装 day.js

npm

安装

npm install dayjs --save

使用

```js // 引入 dayjs import dayjs from 'dayjs'

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

cdn

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

```html

```

格式化日期格式

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

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

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

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

基础用法

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

自定义格式

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

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

| 占位符 | 输出 | 详情 | | ------ | ---------------- | --------------- | | YY | 18 | 两位数的年份 | | YYYY | 2018 | 四位数的年份 | | M | 1-12 | 月份，从 1 开始 | | MM | 01-12 | 月份，两位数 | | MMM | Jan-Dec | 缩写的月份名称 | | MMMM | January-December | 完整的月份名称 | | D | 1-31 | 月份里的一天 | | DD | 01-31 | 月份里的一天，两位数 | | d | 0-6 | 一周中的一天，星期天是 0 | | dd | Su-Sa | 最简写的星期几 | | ddd | Sun-Sat | 简写的星期几 | | dddd | Sunday-Saturday | 星期几 | | H | 0-23 | 小时 | | HH | 00-23 | 小时，两位数 | | h | 1-12 | 小时, 12 小时制 | | hh | 01-12 | 小时, 12 小时制, 两位数 | | m | 0-59 | 分钟 | | mm | 00-59 | 分钟，两位数 | | s | 0-59 | 秒 | | ss | 00-59 | 秒两位数 | | SSS | 000-999 | 毫秒三位数 | | Z | +05:00 | UTC 的偏移量，±HH:mm | | ZZ | +0500 | UTC 的偏移量，±HHmm | | A | AM PM | | | a | am pm | |

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

```js // 年 dayjs().format('YY') // 返回 23 (写本文时是2023年) dayjs().format('YY') // 返回 2023

// 月 dayjs().format('M') // 返回当前月份(1-12) dayjs().format('MM') // 返回当前月份(01-12)，用MM的话，1-9月前面会补0

// 日 dayjs().format('D') // 返回当前月份里的天，比如今天是5月1号，就输出1；如果今天是5月20号，就输出20 dayjs().format('DD') // 返回当前月份里的天，用DD的话，1-9天前面会补0

// 星期 dayjs().format('d') // 返回一周中的一天，星期天是 0

// 小时 dayjs().format('H') // 返回小时 0-23 dayjs().format('HH') // 返回小时 00-23，0-9小时前面会补0 dayjs().format('h') // 返回小时 1-12 dayjs().format('hh') // 返回小时 01-12，1-9小时前面会补0

// 分钟 dayjs().format('m') // 返回分钟 0-59 dayjs().format('mm') // 返回分钟 00-59，0-9分钟前面会补0

// 秒 dayjs().format('s') // 返回秒 0-59 dayjs().format('ss') // 返回秒 00-59，0-9秒前面会补0 dayjs().format('sss') // 返回毫秒数 000-999 ```

需要注意：

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

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

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

/* 目标：输出当前年月日规则：年月日用“/”分隔 */ dayjs().format('YYYY/MM/DD')

/* 目标：输出当前年月日规则：使用中文的“年”、“月”、“日”单位 */ dayjs().format('YYYY年MM月DD日') ```

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

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

简单吧，好用吧～

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

获取/设置日期时间

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

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

我这里举个例子。

```js // 获取当前月份。注意：月份从0开始，0表示1月，1表示2月... dayjs().month()

// 设置月份 dayjs().month(10)

// 设置完月份后格式化 dayjs().month(10).format() ```

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

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

日期时间计算

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

增加日期时间

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

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

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

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

| 单位 | 缩写 | 详情 | | ------------- | ---- | -- | | day | d | 日 | | week | w | 周 | | month | M | 月 | | year | y | 年 | | hour | h | 小时 | | minute | m | 分钟 | | second | s | 秒 | | millisecond | ms | 毫秒 |

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

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

```js dayjs().add(10, 'day')

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

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

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

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

```js dayjs().add(30, 'minute')

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

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

比如获取10天前的时间。

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

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

减少日期时间

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

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

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

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

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

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

```js // 当前时间 dayjs().format('YYYY-MM-DD hh:mm:ss')

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

获取开始日期时间

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

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

| 单位 | 缩写 | 详情 | | -------- | --- | ------------------------- | | year | y | 今年一月1日上午 00:00 | | month | M | 本月1日上午 00:00 | | week | w | 本周的第一天上午 00:00 (取决于国际化设置) | | date | D | 当天 00:00 | | day | d | 当天 00:00 | | hour | h | 当前时间，0 分、0 秒、0 毫秒 | | minute | m | 当前时间，0 秒、0 毫秒 | | second | s | 当前时间，0 毫秒 |

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

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

```js // 今天的日期 dayjs().format()

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

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

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

js 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() 的语法：

```js 时间1.diff(时间2)

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

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

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

```js // 北京奥运会开幕时间 const openingDate = dayjs('2008-08-08')

// 当前时间 const now = dayjs()

// 计算北京奥运开幕式到现在过了多少毫秒 now.diff(openingDate)

// 计算北京奥运开幕式到现在过了多少天 now.diff(openingDate, 'day') ```

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

| 单位 | 缩写 | 详情 | | ------------- | ---- | ----------------- | | day | d | 日 | | week | w | Week of Year | | quarter | Q | Quarter | | month | M | 月份 (一月 0，十二月 11) | | year | y | Year | | hour | h | Hour | | minute | m | Minute | | second | s | Second | | millisecond | ms | Millisecond |