文章简介
本文为【JavaScript 漫游】专栏的第 013 篇文章,记录了 JS 语言中 Date
对象的重要知识点。
- 普通函数的用法
- 构造函数的用法
- 日期的运算
- 静态方法,包括:
Date.now()
、Date.parse()
和Date.UTC()
- 实例方法,包括:
Date.prototype.valueOf()
、to
类方法、get
类方法和set
类方法
普通函数的用法
Date
对象可以作为普通函数直接调用,返回一个代表当前时间的字符串。
Date();
// 'Wed Feb 07 2024 17:03:14 GMT+0800 (中国标准时间)'
注意,即使带有参数,Date
作为普通函数使用时,返回的还是当前时间。
Date(2019, 9, 1);
// 'Wed Feb 07 2024 17:05:18 GMT+0800 (中国标准时间)'
构造函数的用法
Date
还可以当作构造函数使用。对它使用 new
命令,会返回一个 Date
对象的实例。如果不加参数,实例代表的就是当前时间。
var today = new Date();
Date
实例有一个独特的地方。其他对象求值的时候,都是默认调用 .valueOf()
方法,但是Date
实例求值的时候,默认调用的是toString()
方法。这导致对Date
实例求值,返回的是一个字符串,代表该实例对应的时间。
var today = new Date();
today;
// 等同于
today.toString();
// Wed Feb 07 2024 17:09:08 GMT+0800 (中国标准时间)
作为构造函数时,Date
对象可以接受多种格式的参数,返回一个该参数对应的时间实例。
// 参数为时间零点开始计算的毫秒数
new Date(1707297016159);
// Wed Feb 07 2024 17:10:16 GMT+0800 (中国标准时间)// 参数为日期字符串
new Date('Feb, 6, 2024');
// Tue Feb 06 2024 00:00:00 GMT+0800 (中国标准时间)// 参数为多个整数
// 代表年、月、日、小时、分钟、秒、毫秒
new Date(2024, 2, 6, 15, 26, 33);
// Wed Mar 06 2024 15:26:33 GMT+0800 (中国标准时间)
关于 Date
构造函数的参数,有几点说明。
第一点,参数可以是负整数,代表1970年元旦之前的时间。
new Date(-1707297016159);
Thu Nov 25 1915 22:49:43 GMT+0800 (中国标准时间)
第二点,只要是能被Date.parse()
方法解析的字符串,都可以当作参数。
new Date('2024-2-6');
new Date('February, 15, 2024');
new Date('FEB, 6, 2024');
// ...
第三点,参数为年、月、日等多个整数时,年和月是不能省略的,其他参数都可以省略的。也就是说,这时至少需要两个参数,因为如果只使用年这一个参数,Date
会将其解释为毫秒数。
new Date(2024);
// Thu Jan 01 1970 08:00:02 GMT+0800 (中国标准时间)
各个参数的取值范围如下。
- 年:使用四位数年份,比如
2000
。如果写成两位数或个位数,则加上1900
,即10
代表 1910年。如果是负数,表示公元前 - 月:
0
表示一月,依次类推,11
表示12月 - 日:
1
到31
- 小时:
0
到23
- 分钟:
0
到59
- 秒:
0
到59
- 毫秒:
0
到999
注意,月份从 0
开始计算,但是,天数从 1
开始计算。另外,除了日期的默认值为 1
,小时、分钟、秒钟和毫秒的默认值都是 0
。
这些参数如果超出了正常范围,会被自动折算。比如,如果月设为 15
,就折算为下一年的 4 月。
new Date(2024, 15);
// Tue Apr 01 2025 00:00:00 GMT+0800 (中国标准时间)
new Date(2024, 0, 0);
// Sun Dec 31 2023 00:00:00 GMT+0800 (中国标准时间)
参数还可以使用负数,表示扣去的时间。
new Date(2024, -1);
// Fri Dec 01 2023 00:00:00 GMT+0800 (中国标准时间)
new Date(2024, 0, -1);
// Sat Dec 30 2023 00:00:00 GMT+0800 (中国标准时间)
日期的运算
类型自动转换时,Date
实例如果转为数值,则等于对应的毫秒数;如果转为字符串,则等于对应的日期字符串。所以,两个日期实例对象进行减法运算时,返回的是它们间隔的毫秒数;进行加法运算时,返回的是两个字符串连接而成的新字符串。
new Date(2024, 2, 6) - new Date(2024, 2, 5);
// 86400000
new Date(2024, 2, 6) + new Date(2024, 2, 5);
// 'Wed Mar 06 2024 00:00:00 GMT+0800 (中国标准时间)Tue Mar 05 2024 00:00:00 GMT+0800 (中国标准时间)'
静态方法
Date.now()
返回当前时间距离时间零点(1970年1月1日 00:00:00 UTC)的毫秒数。
Date.now(); // 1707298447468
Date.parse()
用来解析日期字符串,返回该时间距离时间零点的毫秒数。
日期字符串应该符合YYYY-MM-DDTHH:mm:ss:sssZ
格式,其中最后的 Z
表示时区。但是,其他格式也可以被解析。
Date.parse('Feb 6, 2024');
Date.parse('2024-2-6');
Date.parse('2024-2-6T17:36:00');
// ...
如果解析失败,返回 NaN
Date.UTC()
Date.UTC()
接受年、月、日等变量作为参数,返回该时间距离时间零点的毫秒数。
Date.UTC(2024, 2, 6, 17, 45, 45, 666);
// 1709747145666
该方法的参数用法与 Date
构造函数完全一致,比如月从 0
开始计算,日期从 1
开始计算。区别在于 Date.UTC
方法的参数,会被解释为 UTC 时间(世界标准时间),Date
构造函数的参数会被解释为当前时区的时间。
实例方法
Date
的实例对象,有几十个自己的方法,除了 valueOf
和 toString
,可以分为以下三类。
to
类:从Date
对象返回一个字符串,表示指定的时间get
类:获取Date
对象的日期和时间set
类:设置Date
对象的日期和时间
Date.prototype.valueOf()
返回实例对象距离时间零点对应的毫秒数,等同于 getTime
方法
new Date().valueOf();
new Date().getTime();
// 1707299455536
to
类方法
Date.prototype.toString()
:返回一个完整的日期字符串Date.prototype.toUTCString()
:返回对应的 UTC 时间的日期字符串Date.prototype.toISOString()
:返回符合 ISO8601 写法的日期字符串Date.prototype.toJSON()
:符合 JSON 格式的 ISO 日期字符串Date.prototype.toDateString()
:返回日期字符串(不含小时、分和秒)Date.prototype.toTimeString()
:返回时间字符串(不含年月日)Date.prototype.toLocaleString()
:完整的本地时间Date.prototype.toLocaleDateString()
:本地日期(不含小时、分和秒)Date.prototype.toLocaleTimeString()
:本地时间(不含年月日)
get
类方法
Date.prototype.getTime()
:返回实例距离时间零点的毫秒数,等同于valueOf()
Date.prototype.getDate()
:返回实例对象对应每月的几号(从 1 开始)Date.prototype.getDay()
:返回星期几,星期日为0,星期一为1,以此类推Date.prototype.getFullYear()
:返回四位的年份Date.prototype.getMonth()
:返回月份(0表示1月,11表示12月)Date.prototype.getHours()
:返回小时(0-23)Date.prototype.getMilliseconds()
:返回毫秒(0-999)Date.prototype.getMinutes()
:返回分钟(0-59)Date.prototype.getSeconds()
:返回秒(0-59)Date.prototype.getTimezoneOffset()
:返回当前时间与 UTC 的时区差异,以分钟表示,返回结果考虑到了夏令时因素。
Date
对象还提供了这些方法对应的 UTC 版本,用来返回 UTC 时间:getUTCDate()
、getUTCFullYear()
、getUTCMonth()
、getUTCDay()
、getUTCHours()
、getUTCMinutes()
、getUTCSeconds()
和 getUTCMilliseconds()
set
类方法
Date.prototype.setDate(date)
:设置实例对象对应的每个月的几号(1-31),返回改变后毫秒时间戳Date.prototype.setFullYear(year [, month, date])
:设置四位年份Date.prototype.setHours(hour [, min, sec, ms])
:设置小时(0-23)Date.prototype.setMilliseconds()
:设置毫秒(0-999)Date.prototype.setMinutes(min [, sec, ms])
:设置分钟(0-59)Date.prototype.setMonth(month [, date])
:设置月份(0-11)Date.prototype.setSeconds(sec [, ms])
:设置秒(0-59)Date.prototype.setTime(milliseconds)
:设置毫秒时间戳
同样的,这些方法也有对应的 UTC 版本:setUTCDate()
、setUTCFullYear
、setUTCHours()
、setUTCMilliseconds()
、setUTCMinutes()
、setUTCMonth()
和 setUTCSeconds()