解析 | Day.js中文网

# 实例

代替修改本地Date.prototype，Day.js对Date对象进行了封装，只需要调用Dayjs()即可

Day.js对象是不可变的，也就是说，以某种方式改变Day.js对象的所有API操作都将返回它的一个新实例。

# 当前时间

直接调用 dayjs() 将返回一个包含当前日期和时间的 Day.js 对象。

var now = dayjs()

等同于 dayjs(new Date()) 的调用。

当没有传入参数时，参数默认值是 undefined，所以调用 dayjs(undefined) 就相当于调用 dayjs()。

Day.js 将 dayjs(null) 视为无效的输入。

# 字符串

解析传入的 ISO 8601 (opens new window) 格式的字符串并返回一个 Day.js 对象实例。

dayjs('2018-04-04T16:00:00.000Z')

注意

为了保证结果一致，当解析除了 ISO 8601 格式以外的字符串时，您应该使用 String + Format。

# 字符串+格式

如果知道输入字符串的格式，您可以用它来解析日期。

注意

此功能依赖 CustomParseFormat 插件

dayjs.extend(customParseFormat)
dayjs("12-25-1995", "MM-DD-YYYY")

如果想解析包含本地化语言的日期字符串，可以传入第三个参数。

require('dayjs/locale/zh-cn')
dayjs('2018 三月 15', 'YYYY MMMM DD', 'zh-cn')

最后一个参数可传入布尔值来启用严格解析模式。严格解析要求格式和输入内容完全匹配，包括分隔符。

dayjs('1970-00-00', 'YYYY-MM-DD').isValid() // true
dayjs('1970-00-00', 'YYYY-MM-DD', true).isValid() // false
dayjs('1970-00-00', 'YYYY-MM-DD', 'es', true).isValid() // false

如果您不知道输入字符串的确切格式，但知道它可能是几种中的一种，可以使用数组传入多个格式。

dayjs("12-25-2001", ["YYYY", "YYYY-MM-DD"], 'es', true);

支持的解析占位符列表：

输入	示例	描述
YY	18	两位数的年份
YYYY	2018	四位数的年份
M	1-12	月份，从 1 开始
MM	01-12	月份，两位数
MMM	Jan-Dec	缩写的月份名称
MMMM	January-December	完整的月份名称
D	1-31	月份里的一天
DD	01-31	月份里的一天，两位数
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	秒，两位数
S	0-9	毫秒，一位数
SS	00-99	毫秒，两位数
SSS	000-999	毫秒，三位数
Z	-05:00	UTC 的偏移量
ZZ	-0500	UTC 的偏移量，两位数
A	AM / PM	上午下午大写
a	am / pm	上午下午小写
Do	1st... 31st	带序数词的月份里的一天
X	1410715640.579	Unix 时间戳
x	1410715640579	Unix 时间戳

# Unix 时间戳 (毫秒)

解析传入的一个 Unix 时间戳 (13 位数字，从1970年1月1日 UTC 午夜开始所经过的毫秒数) 创建一个 Day.js 对象。

dayjs(1318781876406)

注意

传递的参数必须是一个数字

# Unix 时间戳 (秒)

解析传入的一个 Unix 时间戳 (10 位数字，从1970年1月1日 Utc 午夜开始所经过的秒数) 创建一个 Day.js 对象。

dayjs.unix(1318781876)

这个方法是用 dayjs( timestamp * 1000) 实现的，所以传入时间戳里的小数点后面的秒也会被解析。

dayjs.unix(1318781876.721)

# Date 对象

使用原生 Javascript Date 对象创建一个 Day.js 对象。

var d = new Date(2018, 8, 18)
var day = dayjs(d)

这将克隆 Date 对象。对传入的 Date 对象做进一步更改不会影响 Day.js 对象，反之亦然。

# 对象

您可以传入包含单位和数值的一个对象来创建 Dayjs 对象。

注意

此功能依赖 ObjectSupport 插件，才能正常运行

dayjs.extend(objectSupport)
dayjs({ hour:15, minute:10 });
dayjs.utc({ y:2010, M:3, d:5, h:15, m:10, s:3, ms: 123});
dayjs({ year :2010, month :3, day :5, hour :15, minute :10, second :3, millisecond :123});
dayjs({ years:2010, months:3, date:5, hours:15, minutes:10, seconds:3, milliseconds:123});

day 和 date 都表示月份里的日期。

dayjs({}) 返回当前时间。

注意

类似 new Date(year, month, date)，月份从 0 开始计算。

# 数组

您可以传入一个数组来创建一个 Dayjs 对象，数组和结构和 new Date() 十分类似。

注意

此功能依赖 ArraySupport 插件，才能正常运行

dayjs.extend(arraySupport)
dayjs([2010, 1, 14, 15, 25, 50, 125]); // February 14th, 3:25:50.125 PM
dayjs.utc([2010, 1, 14, 15, 25, 50, 125]);
dayjs([2010]);        // January 1st
dayjs([2010, 6]);     // July 1st
dayjs([2010, 6, 10]); // July 10th

dayjs({}) 返回当前时间。

注意

类似 new Date(year, month, date), 月份从 0 开始计算。

# UTC

世界调整时间（Universal Time Coordinated）

默认情况下，Day.js 会把时间解析成本地时间。

如果想使用 UTC 时间，您可以调用 dayjs.utc() 而不是 dayjs()。

在 UTC 模式下，所有显示方法将会显示 UTC 时间而非本地时间。

注意

此功能依赖 UTC 插件，才能正常运行

dayjs.extend(utc)

// 默认是当地时间
dayjs().format() //2019-03-06T08:00:00+08:00
// UTC 时间
dayjs.utc().format() // 2019-03-06T00:00:00Z
此外，在 UTC 模式下， 所有 getters 和 setters 将使用 Date#getUTC* 和 Date#setUTC* 方法而不是 Date#get* 和 Date#set* 方法。

dayjs.utc().seconds(30).valueOf()// => new Date().setUTCSeconds(30)
dayjs.utc().seconds()// => new Date().getUTCSeconds()

此外，在 UTC 模式下，所有 getters 和 setters 将使用 Date#getUTC* 和 Date#setUTC* 方法而不是 Date#get* 和 Date#set* 方法。

dayjs.utc().seconds(30).valueOf()// => new Date().setUTCSeconds(30)
dayjs.utc().seconds()// => new Date().getUTCSeconds()

要在本地时间和 UTC 时间之间切换，您可以使用 dayjs#utc 或 dayjs#local。

# Dayjs 复制

所有的 Day.js 对象都是不可变的。但如果有必要，使用 dayjs#clone 可以复制出一个当前对象。

var a = dayjs()
var b = a.clone()
// a 和 b 是两个独立的 Day.js 对象

在 dayjs() 里传入一个 Day.js 对象也会返回一个复制的对象。

var a = dayjs()
var b = dayjs(a)

# 验证

返回布尔值表示 Dayjs 的日期是否通过校验。

dayjs().isValid()

# 不严格的校验

只检查传入的值能否被解析成一个时间日期

dayjs('2022-01-33').isValid();
// true, parsed to 2022-02-02
dayjs('some invalid string').isValid();
// false

# 严格校验

检查传入的值能否被解析，且是否是一个有意义的日期。最后两个参数 format 和 strict 必须提供。

注意

此功能依赖 CustomParseFormat 插件，才能正常运行

dayjs('2022-02-31', 'YYYY-MM-DD', true).isValid();
// false

← 安装取值/赋值 →