安装:
npm install dayjs --save
main.js引入
import dayjs from 'dayjs';
Vue.prototype.$dayjs = dayjs;
API参考:
Dayjs 并没有改变或覆盖 Javascript 原生的 Date.prototype, 而是创造了一个全新的包含 Javascript
Date 对象的 Dayjs 的对象。
Dayjs 对象是不可变的, 所有的 API 操作都将返回一个新的 Dayjs 对象。
- 当前时间
直接运行 dayjs(),得到包含当前时间和日期的 Dayjs 对象。
dayjs()
- 时间字符串
可以解析传入的一个标准的ISO 8601时间字符串。
dayjs(String)
dayjs('1995-12-25')
- Date 对象
可以解析传入的一个 Javascript Date 对象。
dayjs(Date)
dayjs(new Date(2018, 8, 18))
- Unix 时间戳 (毫秒)
可以解析传入的一个 Unix 时间戳 (13 位数字)。
dayjs.unix(Number)
dayjs.unix(1318781876)
- Unix 时间戳 (秒)
可以解析传入的一个 Unix 时间戳 (10 位数字)。
dayjs.unix(Number)
dayjs.unix(1318781876)
- 复制
Dayjs 对象是不可变的,如果您想获得一个对象的拷贝,请执行 .clone()。 向 dayjs() 里传入一个 Dayjs 对象也能实现同样的效果。
dayjs(Dayjs)
dayjs().clone()
- 验证
return Boolean
检测当前 Dayjs 对象是否是一个有效的时间。
dayjs().isValid()
- 获取+设置
获取和改变日期。
年
获取或设置年份。
dayjs().year()
dayjs().year(2000)
月
获取或设置月份。从 0 开始
dayjs().month()
dayjs().month(0)
日
获取或设置日期。从 1 开始
dayjs().date()
dayjs().date(1)
星期
获取或设置星期。从星期天 0 开始
dayjs().day()
dayjs().day(0)
时
获取或设置小时。
dayjs().hour()
dayjs().hour(12)
分
获取或设置分钟。
dayjs().minute()
dayjs().minute(59)
秒
获取或设置秒。
dayjs().second()
dayjs().second(1)
毫秒
获取或设置毫秒。
dayjs().millisecond()
dayjs().millisecond(1)
获取
获取从 Dayjs 对象中取到的信息 传入的单位 (unit) 对大小写不敏感。
dayjs().get(unit : String)
dayjs().get('month') // 从 0 开始
dayjs().get('day')
- 可用单位

- 设置
设置时间
dayjs().set(unit : String, value : Int);
dayjs().set('date', 1);
dayjs().set('month', 3); // 四月
dayjs().set('second', 30);
- 操作
您可以对 Dayjs 对象如下增加减少之类的操作:
dayjs()
.startOf('month')
.add(1, 'day')
.subtract(1, 'year')
- 增加
增加时间并返回一个新的 Dayjs() 对象。
dayjs().add(value : Number, unit : String);
dayjs().add(7, 'day');
- 减少
减少时间并返回一个新的 Dayjs() 对象。
dayjs().subtract(value : Number, unit : String);
dayjs().subtract(7, 'year');
- 开头时间
返回当前时间的开头时间的 Dayjs() 对象,如月份的第一天。
dayjs().startOf(unit : String);
dayjs().startOf('week'); // 取决于 locale 文件里 `weekStart` 的值
- 末尾时间
返回当前时间的末尾时间的 Dayjs() 对象,如月份的最后一天。
dayjs().endOf(unit : String);
dayjs().endOf('month');
- 显示
格式化 Dayjs 对象并展示。 - 格式化
return String
接收一系列的时间日期字符串并替换成相应的值。
dayjs().format(String)
dayjs('2019-01-25').format('[YYYY] YYYY-MM-DDTHH:mm:ssZ[Z]') // 'YYYY 2019-01-25T00:00:00-02:00Z'
dayjs().format('{YYYY} MM-DDTHH:mm:ssZ[Z]') // "{2014} 09-08T08:02:17-05:00Z"
详情如下:

- 时间差
return Number
获取两个 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 时间戳 (毫秒)
return Number
返回 Unix 时间戳 (毫秒)
dayjs().valueOf()
- Unix 时间戳 (秒)
return Number
返回 Unix 时间戳 (秒)。
dayjs().unix()
- UTC 偏移量 (分)
返回 UTC 偏移量 (分)
dayjs().utcOffset()
- 天数 (月)
return Number
返回月份的天数。
dayjs().daysInMonth()
- Date 对象
return Javascript Date object
返回原生的 Date 对象。
dayjs().toDate()
- As JSON
return JSON String
当序列化 Dayjs 对象时,会返回 ISO8601 格式的字符串。
dayjs().toJSON() //"2018-08-08T00:00:00.000Z"
- ISO 8601 字符串
return String
返回 ISO8601 格式的字符串。
dayjs().toISOString()
- 字符串
return String
dayjs().toString()
- 查询
- 是否之前
return Boolean
检查一个 Dayjs 对象是否在另一个 Dayjs 对象时间之前。
dayjs().isBefore(Dayjs, unit? : String);
dayjs().isBefore(dayjs()); // false
dayjs().isBefore(dayjs(), 'year'); // false
- 是否相同
return Boolean
检查一个 Dayjs 对象是否和另一个 Dayjs 对象时间相同。
dayjs().isSame(Dayjs, unit? : String);
dayjs().isSame(dayjs()); // true
dayjs().isSame(dayjs(), 'year'); // true
- 是否之后
return Boolean
检查一个 Dayjs 对象是否在另一个 Dayjs 对象时间之后。
dayjs().isAfter(Dayjs, unit? : String);
dayjs().isAfter(dayjs()); // false
dayjs().isAfter(dayjs(), 'year'); // false
- 是否是 Dayjs .isDayjs(compared: any)
返回一个 boolean 验证传入值是否是一个 Dayjs 对象.
dayjs.isDayjs(dayjs()) // true
dayjs.isDayjs(new Date()) // false
- 也可以使用 instanceof
dayjs() instanceof dayjs // true
官方文档地址:https://day.js.org/docs/zh-CN/parse/parse
github地址:https://github.com/iamkun/dayjs

88

被折叠的 条评论
为什么被折叠?



