Js中Date对象#

JavaScript的Date对象是用于处理日期和时间的全局对象，Date对象基于Unix Time Stamp，即自1970年1月1日UTC起经过的毫秒数。

描述#

Date()构造函数能够接受四种形式的参数，分别为没有参数、Unix时间戳、时间戳字符串、分别提供日期与时间的每一个成员。此外创建一个新Date对象的唯一方法是通过new操作符，若将它作为常规函数调用，即不加new操作符，将返回一个字符串，而非Date对象。

• 没有参数: 如果没有提供参数，那么新创建的Date对象表示实例化时刻的日期和时间。
• Unix时间戳: 一个Unix时间戳Unix Time Stamp，它是一个整数值，表示自1970年1月1日00:00:00 UTC-the Unix epoch以来的毫秒数，忽略了闰秒，请注意大多数Unix时间戳功能仅精确到最接近的秒。
• 时间戳字符串: 表示日期的字符串值，该字符串应该能被Date.parse()正确方法识别，即符合IETF-compliant RFC 2822 timestamps或version of ISO8601。
• 分别提供日期与时间的每一个成员: 当至少提供了年份与月份时，这一形式的Date()返回的 Date对象中的每一个成员都来自提供的参数，没有提供的成员将使用最小可能值，对日期为1，其他为0。

new Date();
new Date(value);
new Date(dateString);
new Date(year, monthIndex [, day [, hours [, minutes [, seconds [, milliseconds]]]]]);

console.log(new Date()); // Sun Oct 18 2020 10:46:54 GMT+0800 (中国标准时间)
console.log(new Date(1602989155183)); // Sun Oct 18 2020 10:45:55 GMT+0800 (中国标准时间)
console.log(new Date("2020-10-18 10:15:30")); // Sun Oct 18 2020 10:15:30 GMT+0800 (中国标准时间)
console.log(new Date(2020, 9, 18, 10, 15, 30)); // Sun Oct 18 2020 10:15:30 GMT+0800 (中国标准时间)
console.log(typeof(Date())); // string
console.log(typeof(new Date())); // object

方法#

Date.UTC()#

Date.UTC(year,month[,date[,hrs[,min[,sec[,ms]]]]])
Date.UTC()方法接受的参数同日期构造函数接受最多参数时一样，返回从1970-1-1 00:00:00 UTC到指定日期的的毫秒数。

• year: 1900年后的某一年份。
• month: 0到11之间的一个整数，表示月份。
• date: 1到31之间的一个整数，表示某月当中的第几天。
• hrs: 0到23之间的一个整数，表示小时。
• min: 0到59之间的一个整数，表示分钟。
• sec: 0到59之间的一个整数，表示秒。
• ms: 0到999之间的一个整数，表示毫秒。

console.log(Date.UTC(2020, 9, 18, 10, 15, 30)); // 1603016130000

Date.now()#

Date.now()
Date.now()方法返回自1970年1月1日00:00:00 (UTC)到当前时间的毫秒数。

console.log(Date.now()); // 1602991355257

Date.parse()#

Date.parse(dateString)
Date.parse()方法解析一个表示某个日期的字符串，该字符串dateString需要符合RFC2822或ISO 8601日期格式的字符串(其他格式也许也支持，但结果可能与预期不符)，并返回从1970-1-1 00:00:00 UTC到该日期对象即该日期对象的UTC时间的毫秒数，如果该字符串无法识别，或者一些情况下，包含了不合法的日期数值例如2015-02-31，则返回值为NaN。不推荐在ES5之前使用Date.parse方法，因为字符串的解析完全取决于实现。直到至今，不同浏览器在如何解析日期字符串上仍存在许多差异，因此最好还是手动解析日期字符串，在需要适应不同格式时库能起到很大帮助。

console.log(Date.parse("2020-10-18 10:15:30")); // 1602987330000 
console.log(Date.parse("2020-10-18 02:15:30 GMT")); // 1602987330000 
console.log(Date.parse("2020-10-18 02:15:30 UTC")); // 1602987330000 
console.log(Date.parse("2020-10-18 10:15:30 GMT")); // 1603016130000
console.log(Date.parse("2020-10-18 10:15:30 UTC")); // 1603016130000
console.log((1602987330000 - 1603016130000) / 1000 / 3600); // -8
// 如果你在格林威治，你的起始时间是1970年01月01日00时00分00秒。
// 如果你在中国北京，你的起始时间是1970年01月01日08时00分00秒。
// 以相同日期时间来算，北京地区的时间戳在量上是少的。
// 在不同的时区同时运行Date.now()，返回的时间戳是相同的，时间戳是不带有时区信息的。
// 如果我在北京获取到一个时间戳 t，在格林威治使用new Date(t)的话，他取得的时间就比我慢 8 小时。
// 换个角度，如果以相同的时间戳来计算时间的话，北京时间超出格林威治标准时间 8 小时。

Date.prototype.getDate()#

dateObj.getDate()
根据本地时间，返回一个指定的日期对象为一个月中的哪一日，范围为从1-31。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getDate()); // 18

Date.prototype.getDay()#

dateObj.getDay()
getDay()方法根据本地时间，返回一个具体日期中一周的第几天，0表示星期天。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getDay()); // 0

Date.prototype.getFullYear()#

dateObj.getFullYear()
getFullYear()方法根据本地时间返回指定日期的年份。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getFullYear()); // 2020

Date.prototype.getHours()#

dateObj.getHours()
getHours()方法根据本地时间，返回一个指定的日期对象的小时。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getHours()); // 10

Date.prototype.getMilliseconds()#

dateObj.getMilliseconds()
getMilliseconds()方法，根据本地时间，返回一个指定的日期对象的毫秒数。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getMilliseconds()); // 0

Date.prototype.getMinutes()#

dateObj.getMinutes()
getMinutes()方法根据本地时间，返回一个指定的日期对象的分钟数。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getMinutes()); // 15

Date.prototype.getMonth()#

dateObj.getMonth()
根据本地时间，返回一个指定的日期对象的月份，为基于0的值，0表示一年中的第一月。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getMonth()); // 9

Date.prototype.getSeconds()#

dateObj.getSeconds()
getSeconds()方法根据本地时间，返回一个指定的日期对象的秒数。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getSeconds()); // 30

Date.prototype.getTime()#

dateObj.getTime()
getTime方法的返回值一个数值，表示从1970年1月1日0时0分0秒，距离该日期对象所代表时间的毫秒数。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getTime()); // 1602987330000

Date.prototype.getTimezoneOffset()#

dateObj.getTimezoneOffset()
getTimezoneOffset()方法返回协调世界时UTC相对于当前时区的时间差值，单位为分钟。

var date = new Date();
console.log(date.getTimezoneOffset() / 60); // -8

Date.prototype.getUTCDate()#

dateObj.getUTCDate()
getUTCDate()方法以世界时为标准，返回一个指定的日期对象为一个月中的第几天。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getUTCDate()); // 18

Date.prototype.getUTCDay()#

dateObj.getUTCDay()
getUTCDay()方法以世界时为标准，返回一个指定的日期对象为一星期中的第几天，其中0代表星期天。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getUTCDay()); // 0

Date.prototype.getUTCFullYear()#

dateObj.getUTCFullYear()
getUTCFullYear()以世界时为标准，返回一个指定的日期对象的年份。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getUTCFullYear()); // 2020

Date.prototype.getUTCHours()#

dateObj.getUTCHours()
getUTCHours()方法以世界时为标准，返回一个指定的日期对象的小时数。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getUTCHours()); // 2

Date.prototype.getUTCMilliseconds()#

dateObj.getUTCMilliseconds()
getUTCMilliseconds()方法以世界时为标准，返回一个指定的日期对象的毫秒数。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getUTCMilliseconds()); // 0

Date.prototype.getUTCMinutes()#

dateObj.getUTCMinutes()
getUTCMinutes()方法以世界时为标准，返回一个指定的日期对象的分钟数。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getUTCMinutes()); // 15

Date.prototype.getUTCMonth()#

dateObj.getUTCMonth()
getUTCMonth()方法以世界时为标准，返回一个指定的日期对象的月份，它是从0开始计数的，0代表一年的第一个月。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getUTCMonth()); // 9

Date.prototype.getUTCSeconds()#

dateObj.getUTCSeconds()
getUTCSeconds()方法以世界时为标准，返回一个指定的日期对象的秒数。

var date = new Date("2020-10-18 10:15:30");
console.log(date.getUTCSeconds()); // 30

Date.prototype.setDate()#

dateObj.setDate(dayValue)
setDate()方法根据本地时间来指定一个日期对象的天数。

• dayValue: 表示一个整数，表示该月的第几天。

var date = new Date("2020-10-18 10:15:30");
date.setDate(1);
console.log(date); // Thu Oct 01 2020 10:15:30 GMT+0800 (中国标准时间）

Date.prototype.setFullYear()#

dateObj.setFullYear(yearValue[, monthValue[, dayValue]])
setFullYear()方法根据本地时间为一个日期对象设置年份。

• yearValue: 指定年份的整数值，例如1995。
• monthValue: 一个0到11之间的整数值，表示从一月到十二月。
• dayValue: 一个1到31之间的整数值，表示月份中的第几天，如果指定了dayValue参数，就必须同时指定monthValue。

var date = new Date("2020-10-18 10:15:30");
date.setFullYear(2019, 0, 1);
console.log(date); // Tue Jan 01 2019 10:15:30 GMT+0800 (中国标准时间）

Date.prototype.setHours()#

dateObj.setHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])
setHours()方法根据本地时间为一个日期对象设置小时数，返回从1970-01-01 00:00:00 UTC到更新后的日期对象实例所表示时间的毫秒数，在JavaScript 1.3版本之前只接受一个参数。

• hoursValue: 一个0到23的整数，表示小时。
• minutesValue: 一个0到59的整数，表示分钟。
• secondsValue: 一个0到59的整数，表示秒数，如果指定了secondsValue参数，则必须同时指定minutesValue参数。
• msValue: 一个0到999的数字，表示微秒数，如果指定了msValue参数，则必须同时指定minutesValue和secondsValue参数。

var date = new Date("2020-10-18 10:15:30");
console.log(date.setHours(8)); // 1602980130000
console.log(date); // Sun Oct 18 2020 08:15:30 GMT+0800 (中国标准时间)

Date.prototype.setMilliseconds()#

dateObj.setMilliseconds(millisecondsValue)
setMilliseconds()方法会根据本地时间设置一个日期对象的毫秒数。

• millisecondsValue: 一个0到999的数字，表示毫秒数。

var date = new Date("2020-10-18 10:15:30");
date.setMilliseconds(1);
console.log(date.getMilliseconds()); // 1

Date.prototype.setMinutes()#

dateObj.setMinutes(minutesValue[, secondsValue[, msValue]])
setMinutes()方法根据本地时间为一个日期对象设置分钟数，在JavaScript 1.3版本之前只接受第一个参数。

• minutesValue: 一个0到59的整数，表示分钟数。
• secondsValue: 一个0到59的整数，表示秒数。如果指定了secondsValue参数，则必须同时指定minutesValue参数。
• msValue: 一个0到999的数字，表示微秒数，如果指定了msValue参数，则必须同时指定minutesValue和secondsValue参数。

var date = new Date("2020-10-18 10:15:30");
date.setMinutes(1);
console.log(date); // Sun Oct 18 2020 10:01:30 GMT+0800 (中国标准时间)

Date.prototype.setMonth()#

dateObj.setMonth(monthValue[, dayValue])
setMonth()方法根据本地时间为一个设置年份的日期对象设置月份，返回从1970-01-01 00:00:00 UTC到更新后的日期对象实例所表示时间的毫秒数，在JavaScript 1.3版本之前只接受第一个参数。

• monthValue: 介于0到11之间的整数，表示一月到十二月。
• dayValue: 从1到31之间的整数，表示月份中的第几天，0为上个月最后一天。

var date = new Date("2020-10-18 10:15:30");
date.setMonth(1);
console.log(date); // Tue Feb 18 2020 10:15:30 GMT+0800 (中国标准时间)

Date.prototype.setSeconds()#

dateObj.setSeconds(secondsValue[, msValue])
setSeconds()方法根据本地时间设置一个日期对象的秒数，在JavaScript 1.3版本之前只接受第一个参数。

• secondsValue: 一个0到59的整数。
• msValue: 一个0到999的数字，表示微秒数。

var date = new Date("2020-10-18 10:15:30");
date.setSeconds(1);
console.log(date); // Sun Oct 18 2020 10:15:01 GMT+0800 (中国标准时间)

Date.prototype.setTime()#

dateObj.setTime(timeValue)
setTime()方法以一个表示从1970-1-1 00:00:00 UTC计时的毫秒数为来为Date对象设置时间。

• timeValue: 一个整数，表示从1970-1-1 00:00:00 UTC开始计时的毫秒数。

var date = new Date("2020-10-18 10:15:30");
date.setTime(1603011933306);
console.log(date); // Sun Oct 18 2020 17:05:33 GMT+0800 (中国标准时间)

Date.prototype.setUTCDate()#

dateObj.setUTCDate(dayValue)
setUTCDate()方法就是根据全球时间设置特定date对象的日期。

• dayValue: 一个1-31的整形数字，用来指定日期。

var date = new Date("2020-10-18 10:15:30 GMT");
date.setUTCDate(1);
console.log(date.toUTCString()); // Thu, 01 Oct 2020 10:15:30 GMT

Date.prototype.setUTCFullYear()#

dateObj.setUTCFullYear(yearValue[, monthValue[, dayValue]])
setUTCFullYear()方法根据世界标准时间为一个具体日期设置年份，在JavaScript 1.3版本之前只接受第一个参数。

• yearValue: 指定年份整数值，例如1995。
• monthValue: 指定一个0-11之间的整数值，代表从一月到十二月。
• dayValue: 指定一个1-31之间的整数值，代表月份中的第几天，如果指定了dayValue参数，那么必须指定monthValue参数。

var date = new Date("2020-10-18 10:15:30 GMT");
date.setUTCFullYear(2019);
console.log(date.toUTCString()); // Fri, 18 Oct 2019 10:15:30 GMT

Date.prototype.setUTCHours()#

dateObj.setUTCHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])
setUTCHours()方法根据通用时间设置指定日期的小时，并返回从1970年1月1日00:00:00 UTC到更新后的date实例所表示的时间的毫秒数。

• hoursValue: 表示小时的整数，取值0到23之间。
• minutesValue: 表示分钟的整数，取值0到59之间。
• secondsValue: 表示秒数的整数，取值0到59之间，如果指定了该参数，就要同时指定minutesValue参数。
• msValue: 表示毫秒的整数，取值0到999之间，如果指定了该参数，就要指定minutesValue和secondsValue这两个参数。

var date = new Date("2020-10-18 10:15:30 GMT");
date.setUTCHours(1);
console.log(date.toUTCString()); // Sun, 18 Oct 2020 01:15:30 GMT

Date.prototype.setUTCMilliseconds()#

dateObj.setUTCMilliseconds(millisecondsValue)
setUTCMilliseconds()方法会根据世界时来设置指定时间的毫秒数。

• millisecondsValue: 0 - 999之间的数值，代表毫秒数。

var date = new Date("2020-10-18 10:15:30 GMT");
date.setUTCMilliseconds(111);
console.log(date.getUTCMilliseconds()); // 111

Date.prototype.setUTCMinutes()#

dateObj.setUTCMinutes(minutesValue[, secondsValue[, msValue]])
setUTCMinutes()方法会根据世界协调时UTC来设置指定日期的分钟数，返回从UTC时间1970年1月1日0时0分0秒至设置后的时间的毫秒数。

• minutesValue: 表示要设置的分钟数，是一个介于0和59之间的整数。
• secondsValue: 表示要设置的秒数，同样也是一个介于0和59之间的整数，如果传入了这个参数，那么必须要传入上一个参数minutesValue。
• msValue: 表示要设置的毫秒数，这是一个介于0和999之间的数字，如果传入了这个参数，那么就必须要传入前面两个参数minutesValue和secondsValue。

var date = new Date("2020-10-18 10:15:30 GMT");
date.setUTCMinutes(1);
console.log(date.toUTCString()); // Sun, 18 Oct 2020 10:01:30 GMT

Date.prototype.setUTCMonth()#

dateObj.setUTCMonth(monthValue[, dayValue])
setUTCMonth()方法根据通用的时间来设置一个准确的月份，返回从UTC时间1970年1月1日0时0分0秒至设置后的时间的毫秒数。

• monthValue: 一个0-11的整数，代表1月到12月。
• dayValue: 一个1-31的整数，代表一个月的天数。

var date = new Date("2020-10-18 10:15:30 GMT");
date.setUTCMonth(1);
console.log(date.toUTCString()); // Tue, 18 Feb 2020 10:15:30 GMT

Date.prototype.setUTCSeconds()#

dateObj.setUTCSeconds(secondsValue[, msValue])
setUTCSeconds()方法为一个依据国际通用时间的特定日期设置秒数，返回从UTC时间1970年1月1日0时0分0秒至设置后的时间的毫秒数。

• secondsValue: 一个在0到59之间的整数，表示秒数。

• msValue: 一个0到999之间的数字，代表毫秒数。

var date = new Date("2020-10-18 10:15:30 GMT");
date.setUTCSeconds(1);
console.log(date.toUTCString()); // Sun, 18 Oct 2020 10:15:01 GMT

Date.prototype.toDateString()#

dateObj.toDateString()
toDateString()方法返回一个日期对象日期部分的字符串。

var date = new Date("2020-10-18 10:15:30");
console.log(date.toDateString()); // Sun Oct 18 2020

Date.prototype.toISOString()#

dateObj.toISOString()
toISOString()方法返回一个ISO即ISO 8601 Extended Format格式的字符串YYYY-MM-DDTHH:mm:ss.sssZ，时区总是UTC协调世界时，加一个后缀Z标识。

var date = new Date("2020-10-18 10:15:30");
console.log(date.toISOString()); // 2020-10-18T02:15:30.000Z

Date.prototype.toJSON()#

dateObj.toJSON()
toJSON()方法返回Date对象的字符串形式，调用toJSON()返回一个JSON格式字符串，使用toISOString()，表示该日期对象的值，默认情况下，这个方法常用于JSON序列化Date对象。

var date = new Date("2020-10-18 10:15:30");
console.log(date.toJSON()); // 2020-10-18T02:15:30.000Z

Date.prototype.toLocaleDateString()#

dateObj.toLocaleDateString([locales [, options]])
toLocaleDateString()方法返回该日期对象日期部分的字符串，该字符串格式因不同语言而不同。新增的参数locales和options使程序能够指定使用哪种语言格式化规则，允许定制该方法的表现behavior，在旧版本浏览器中，locales和options参数被忽略，使用的语言环境和返回的字符串格式是各自独立实现的。

var date = new Date("2020-10-18 10:15:30");
console.log(date.toLocaleDateString()); // 2020/10/18

Date.prototype.toLocaleString()#

dateObj.toLocaleString([locales [, options]])
toLocaleString()方法返回该日期对象的字符串，该字符串格式因不同语言而不同。新增的参数locales和options使程序能够指定使用哪种语言格式化规则，允许定制该方法的表现behavior。在旧版本浏览器中，locales和options参数被忽略，使用的语言环境和返回的字符串格式是各自独立实现的。

var date = new Date("2020-10-18 10:15:30");
console.log(date.toLocaleString()); // 2020/10/18 上午10:15:30

Date.prototype.toLocaleTimeString()#

dateObj.toLocaleTimeString([locales [, options]])
toLocaleTimeString()方法返回该日期对象时间部分的字符串，该字符串格式因不同语言而不同。新增的参数locales和options使程序能够指定使用哪种语言格式化规则，允许定制该方法的表现behavior。在旧版本浏览器中，locales和options参数被忽略，使用的语言环境和返回的字符串格式是各自独立实现的。

var date = new Date("2020-10-18 10:15:30");
console.log(date.toLocaleTimeString()); // 上午10:15:30

Date.prototype.toString()#

dateObj.toString()
toString()方法返回一个字符串，表示该Date对象。

var date = new Date("2020-10-18 10:15:30");
console.log(date.toString()); // Sun Oct 18 2020 10:15:30 GMT+0800 (中国标准时间)

Date.prototype.toTimeString()#

dateObj.toTimeString()
toTimeString()方法返回一个日期对象时间部分的字符串。

var date = new Date("2020-10-18 10:15:30");
console.log(date.toTimeString()); // 10:15:30 GMT+0800 (中国标准时间)

Date.prototype.toUTCString()#

dateObj.toUTCString()
toUTCString()方法把一个日期转换为一个字符串，使用UTC时区。

var date = new Date("2020-10-18 10:15:30 GMT");
console.log(date.toUTCString()); // Sun, 18 Oct 2020 10:15:30 GMT

Date.prototype.valueOf()#

dateObj.valueOf()
valueOf()方法返回一个Date对象的原始值。

var date = new Date("2020-10-18 10:15:30");
console.log(date.valueOf()); // 1602987330000

Date.prototype[@@toPrimitive]#

Date()[Symbol.toPrimitive]()
[@@toPrimitive]()方法可以转换一个Date对象到一个原始值。如果hint是string或default，[@@toPrimitive]()将会调用toString，如果toString属性不存在，则调用 valueOf，如果valueOf也不存在，则抛出一个TypeError。如果hint是number，[@@toPrimitive]()会首先尝试valueOf，若失败再尝试toString。当期望一个原始值却收到一个对象时，JavaScript可以自动的调用[@@toPrimitive]()方法来将一个对象转化成原始值，所以你很少会需要自己调用这个方法。

var date = new Date("2020-10-18 10:15:30");
console.log(date[Symbol.toPrimitive]("string")); // Sun Oct 18 2020 10:15:30 GMT+0800 (中国标准时间)

每日一题#

参考#