dayjs是一个轻量的处理时间和日期的 JavaScript 库
官方github github.com/iamkun/dayj…
中文使用文档 github.com/iamkun/dayj…
dayjs好处
- 🕒 和Moment.js有着相同的API和模式
- 💪 不可变、持久性
- 🔥 提供链式调用
- 🌐 国际化标准
- 📦 超小的压缩体积，仅仅有2kb左右
- 👫 极大多数的浏览器兼容
dayjs安装
npm install dayjs --save import dayjs from 'dayjs'
<script src="https://unpkg.com/dayjs"></script>
Day.js 的返回值都是新的 Dayjs 对象
dayjs 解析相关的API
直接运行 dayjs()，得到包含当前时间和日期的 Dayjs 对象
dayjs() //返回当前时间 Tue, 28 May 2019 05:57:34 GMT
可以解析传入的一个标准的ISO 8601时间字符串。
dayjs('1995-12-25') //Sun, 24 Dec 1995 16:00:00 GMT
可以解析传入的一个 Javascript Date 对象。
dayjs(new Date(2018, 8, 18)) //Mon, 17 Sep 2018 16:00:00 GMT
可以解析传入的一个 Unix 时间戳 (13 位数字)。
dayjs(1318781876406) //Sun, 16 Oct 2011 16:17:56 GMT
Dayjs 对象是不可变的，如果您想获得一个对象的拷贝，请执行 .clone()。
向 dayjs() 里传入一个 Dayjs 对象也能实现同样的效果。
dayjs(Dayjs) dayjs().clone()
检测当前 Dayjs 对象是否是一个有效的时间
dayjs().isValid()
dayjs 获取和设置相关的API
获取或设置年份。
dayjs().year() //2019 dayjs().year(2000) //Sun, 28 May 2000 06:14:07 GMT
获取或设置月份。 从 0 开始
dayjs().month() //4 实际上5月 dayjs().month(0) //Mon, 28 Jan 2019 06:15:25 GMT
获取或设置日期。 从 1 开始
dayjs().date() //28 当天是2019年5月28日 dayjs().date(1) //Wed, 01 May 2019 06:17:04 GMT
获取或设置星期。 从星期天 0 开始
dayjs().day() //2 当天是星期二 dayjs().day(0) //Sun, 26 May 2019 06:18:13 GMT 被强行设置为上周日
获取或设置小时
dayjs().hour() //14 当时为下午2点 dayjs().hour(12) //Tue, 28 May 2019 04:21:30 GMT 不清楚
获取或设置分钟。
dayjs().minute() //22 dayjs().minute(59) //Tue, 28 May 2019 06:59:50 GMT
获取或设置秒
dayjs().millisecond() dayjs().millisecond(1)
获取或设置毫秒。
dayjs().millisecond() dayjs().millisecond(1)
获取从 Dayjs 对象中取到的信息
传入的单位 (unit) 对大小写不敏感
dayjs().get('month') //4
| 单位 | 缩写 | 描述 |
| date | 日期 | |
| day | d | 星期几 (星期天 0, 星期六 6) |
| month | M | 月 (一月 0, 十二月 11) |
| year | y | 年 |
| hour | h | 时 |
| minute | m | 分 |
| second | s | 秒 |
| millisecond | ms | 毫秒 |
设置时间
dayjs().set('date', 1); dayjs().set('month', 3); // 四月 dayjs().set('second', 30);
dayjs 操作相关API
您可以对 Dayjs 对象如下增加减少之类的操作
增加时间并返回一个新的 Dayjs() 对象。
dayjs().add(value : Number, unit : String); dayjs().add(7, 'day'); //在当前的基础上加7天
减少时间并返回一个新的 Dayjs() 对象。
dayjs().subtract(value : Number, unit : String); dayjs().subtract(7, 'day'); //在当前基础上减少7天
返回当前时间的开头时间的 Dayjs() 对象，如月份的第一天。
dayjs().startOf(unit : String); dayjs().startOf('month'); //Tue, 30 Apr 2019 16:00:00 GMT
返回当前时间的末尾时间的 Dayjs() 对象，如月份的最后一天。
dayjs().endOf(unit : String); dayjs().endOf('month'); //Fri, 31 May 2019 15:59:59 GMT
显示相关的API
格式化 Dayjs 对象并展示。
接收一系列的时间日期字符串并替换成相应的值。
dayjs().format(String) dayjs('2019-01-25').format('YYYY-MM-DD HH:mm:ss') dayjs().format('YYYY-MM-DD') dayjs().format('YYYY-MM') //2019
获取两个 Dayjs 对象的时间差 默认毫秒。
const date1 = dayjs('2019-01-25') const date2 = dayjs('2018-06-05') date1.diff(date2) // 20214000000 date1.diff(date2, 'month') // 7 date1.diff(date2, 'month', true) // 7.645161290322581 date1.diff(date2, 'day') // 233
返回 Unix 时间戳 (毫秒)
dayjs().valueOf() 复制代码
返回 Unix 时间戳 (秒)。
dayjs().unix()
返回月份的天数
dayjs().daysInMonth()
返回原生的 Date 对象。
dayjs().toDate()
当序列化 Dayjs 对象时，会返回 ISO8601 格式的字符串。
dayjs().toJSON() //"2018-08-08T00:00:00.000Z"
返回 ISO8601 格式的字符串。
dayjs().toISOString()
返回字符串
dayjs().toString()
查询相关的API
检查一个 Dayjs 对象是否在另一个 Dayjs 对象时间之前。
dayjs().isBefore(Dayjs, unit? : String); dayjs().isBefore(dayjs()); // false dayjs().isBefore(dayjs(), 'year'); // false
检查一个 Dayjs 对象是否和另一个 Dayjs 对象时间相同。
dayjs().isSame(Dayjs, unit? : String); dayjs().isSame(dayjs()); // true dayjs().isSame(dayjs(), 'year'); // true
检查一个 Dayjs 对象是否在另一个 Dayjs 对象时间之后。
dayjs().isAfter(Dayjs, unit? : String); dayjs().isAfter(dayjs()); // false dayjs().isAfter(dayjs(), 'year'); // false
