【JavaScript 漫游】【013】Date 对象知识点摘录

文章简介

本文为【JavaScript 漫游】专栏的第 013 篇文章，记录了 JS 语言中 Date 对象的重要知识点。

1. 普通函数的用法
2. 构造函数的用法
3. 日期的运算
4. 静态方法，包括：Date.now()、Date.parse() 和 Date.UTC()
5. 实例方法，包括：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()