Dayjs处理时间函数的插件

现在很多处理时间格式化的插件，我平时项目中最常用的便是Dayjs这个插件，我觉得这个插件还是很好用的。现在说一下这个插件的基本使用。

Dayjs并没有覆盖Javascript原生的Date.prototype,而是创造了一个全新的包含Javascript Date对象的Dayjs的对象。Dayjs对象是不可变的，所有的API操作都会返回一个新的Dayjs对象。

　　我使用的时候一般会绑在Vue原型上使用。当然，和框架使用没关系

　　在Vue中一般是全局安装，然后挂载到Vue原型上

//安装方式
yarn add dayjs --save 
npm i dayjs --save

//引入方式
import dayjs from 'dayjs'
Vue.prototype.$d = dayjs

下述介绍的是最常用的几种时间处理方式，原文档中还有一些项目中不常用的，

有兴趣的话，可以去git查看 https://github.com/iamkun/dayjs/blob/master/docs/zh-cn/API-reference.md

gitDemo地址：https://github.com/dreamITGirl/VueProgect/tree/master/project-demo/src/components/HandleTime

一、基本使用　　　

//当前时间
dayjs()
//格式化的时间
this.$d().format('YYYY-MM-DD HH:mm:ss')
//Date对象
dayjs(new Date(2019,10,15))//输出结果：Thu, 14 Nov 2019 16:00:00 GMT
dayjs(new Date(2019,10,15)).format('YYYY-MM-DD) //输出结果：2019-11-15
//Unix时间戳（毫秒/秒）
//毫秒和秒的差别就在传入的时间戳是13位还是10位
dayjs.unix(new Date().getTime())//输出结果 Tue, 15 Oct 2019 08:01:01 GMT
//自定义时间格式
dayjs().format('DD-MM-YYYY')//输出结果 15-10-2019
//复制时间
　　Dayjs 对象是不可变的，如果想获得一个对象的拷贝，执行.clone()的方法。像dayjs()中传入一个Dayjs对象也能实现同样的效果
dayjs().clone()
//验证时间（返回值是true或false）

　　　　可用单位

单位	缩写	描述
date		日期
day	d	星期几（星期天0，星期六6）
month	M	月(一月0,十二月11)
year	Y/y	年
hour	h	时
minute	m	分
second	s	秒
millisecond	ms	毫秒

二、获取和设置时间

　　①获取年/月/日/星期/时/分/秒/毫秒

//获取或设置
//年
dayjs().year()
dayjs().year(2019)
//月
dayjs().month() //输出9
dayjs().month(10).format('YYYY-MM-DD') //输出2019-11-15
//日
dayjs().date()
dayjs().date(1)
//星期
dayjs().day()
dayjs.day(1)
//时
dayjs().hour()
dayjs().hour(1)
//秒
dayjs().second()
dayjs().second(1)
//毫秒
dayjs().millisecond()
dayjs().millisecond(1)

②设置时间

　　dayjs().set( unit : String ，value : Int)

dayjs().set('date',30).format('YYYY-MM-DD') //2019-10-30

③获取时间

dayjs().get(unit:String)
dayjs().get('month') //从0开始

三、时间操作（增加，减少）

　　dayjs().startOf('month').add(1,'day').substract(1，‘day’)

　　①增加：增加时间并返回一个新的Dayjs()对象

//格式
dayjs().add(value:Number,unit:String)
eg:
    dayjs().add(1,'year')  //Fri, 16 Oct 2020 01:42:30 GMT

②减少　　

//格式
dayjs().subtract(value:Number,unit:String)
//举例
dayjs().subtract(7,'month)// Sat, 16 Mar 2019 01:46:59 GMT

　　③开头时间：返回当前时间的开头时间的Dayjs() 对象，如月份第一天　

//格式
dayjs().startOf(unit:String)
//举例
dayjs().startOf('month').format('YYYY-MM-DD') //2019-10-01

　　④末尾时间

//格式
dayjs().endOf(unit : String)
//举例
dayjs().endOf('month').format('YYYY-MM-DD') //2019-10-31

四、格式化时间 .format()

格式	输出	描述
YY	19	两位数年份
YYYY	2019	四位数年份
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	+5:00	UTC的偏移量
ZZ	+500	UTC 的偏移量，数字前面加上 0
A	AM PM
a	am pm

五、时间差 return Number

　　①获取两个时间差，默认返回值是毫秒　

const date1 = dayjs('2019-11-20')

const date2 = dayjs('2019-10-15')

date1.diff(date2) //3110400000
date1.diff(date2,'month') //1
date1.diff(date2,'month',true) // 1.1666666666666667
date1.diff(date2,'day') //36

　　②Unix时间戳

//格式
dayjs().valueOf()
//举例
dayjs().valueOf()  //1571195016139

　　③Unix时间戳（秒）　　

dayjs().unix() //1571195388

　　④UTC偏移量

dayjs().utcOffset() //480

　　⑤天数（月）

dayjs().daysInMonth() //31

Dayjs处理时间函数的插件

相关推荐