Day.js :一个轻量的处理时间和日期的 JavaScript 库

安装:

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

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值