Date相关 | Shapeying

处理时间是常见的需求，总结下Date类的相关知识

构建时间对象

构建对象实例有多种方式:

不传入参数，默认以系统当前时间返回一个时间对象.new Date();

    new Date();
    // Wed Mar 13 2019 10:49:28 GMT+0800 (中国标准时间)

返回的是一个对象实例，控制台打印了时间字符串，是默认调用了toString()方法。

传入自1970年1月1日00:00:00 (世界标准时间) 起经过的毫秒数.new Date(value);

    new Date(1323532800000);
    // Sun Dec 11 2011 00:00:00 GMT+0800 (中国标准时间)

    // 可以传入负数，代表1970年1月1日00:00:00之前的时间
    new Date(-10000);
    // Thu Jan 01 1970 07:59:50 GMT+0800 (中国标准时间)

传入表示日期的字符串.new Date(dateString);

    new Date('2011-11-11')
    new Date('2011/11/11')
    new Date('11/11/2011')
    // Fri Nov 11 2011 00:00:00 GMT+0800 (中国标准时间)

    new Date('Sun Dec 11 2011 00:00:00')
    // Sun Dec 11 2011 00:00:00 GMT+0800 (中国标准时间)  注意这里是12月份了，11代表的12月

    new Date('2011-11-11 11:11:11')
    new Date('2011-11-11T11:11:11')
    // Fri Nov 11 2011 11:11:11 GMT+0800 (中国标准时间)

    new Date('aa')
    // Invalid Date

只要能被[Date.parse()](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date/parse)解析的字符串，都可以作为参数传入。

传入年月日等多个整数参数. new Date(year, month[, day[, hour[, minutes[, seconds[, milliseconds]]]]]);

    new Date(2011,11,11,11,11,11,111)
    // Sun Dec 11 2011 11:11:11 GMT+0800 (中国标准时间)
    new Date(2011,11)
    // Thu Dec 01 2011 00:00:00 GMT+0800 (中国标准时间)

    new Date(2011)
    // Thu Jan 01 1970 08:00:02 GMT+0800 (中国标准时间)  只传入一个整数参数，会被当做毫秒数解析

    new Date('2011',11,11)
    //Sun Dec 11 2011 00:00:00 GMT+0800 (中国标准时间)  传入的参数会进行转换
    new Date('2011.11',11,11)
    //Sun Dec 11 2011 00:00:00 GMT+0800 (中国标准时间)

    new Date('a',11,11)
    // Invalid Date  无法转换成数字的参数

这种方式至少需要传入两个整数参数标志年、月，只传入一个参数会当做毫秒数进行构建；传入的参数会自动转换成数字，所以例子中传入数字字符串也是可以创建成功的。

如果把Date()直接当作函数调用，不过有没有传入参数，都会返回当前时间的时间字符串

Date()
// "Wed Mar 13 2019 20:22:42 GMT+0800 (中国标准时间)"
Date(2011,11)
// "Wed Mar 13 2019 20:22:47 GMT+0800 (中国标准时间)"

自动折算

时间的参数都是有范围的：

年使用四位数年份，比如2000。如果写成两位数或个位数，则加上1900，即10代表1910年。如果是负数，表示公元前
月份的范围是0~11 (0是一月份，11是12月份)
天数的范围是1~31
小时的范围是0~23
分钟的范围是0~59
秒数的范围是0~59
毫秒的范围是0~999

如果创建时间对象的时候，传入的参数超出了实际范围会怎样呢？

    new Date(2010,12,11)
    // Tue Jan 11 2011 00:00:00 GMT+0800 (中国标准时间)  月的参数12超出了范围，年份多了一年，然后月份变成了1月份（对应参数0）
    new Date(2010,11,0)
    // Tue Nov 30 2010 00:00:00 GMT+0800 (中国标准时间)  天的参数0不在范围内，所以月份变成了11（对应参数10），然后天变成了30
    new Date(2010,11,11,25)
    // Sun Dec 12 2010 01:00:00 GMT+0800 (中国标准时间)  小时的参数25超出了范围，天数变成了12，然后小时变成了1

当传入的参数超出了实际范围，会自动折算成合理的范围 ，相邻的数值也会进行调整。

利用这个特性可以做很多的事情，比如，你想获取2012年2月有共有多少天，可以这样处理。

    new Date(2012,2,0).getDate()
    // 29  -- 三月(对应2)没有0天，所以折算到二月（对应1）的最后一天，这时取得getDate()即是该月的天数

类型转换

如果+ 或者 == 运算符其中一个操作数是对象时，需要先把对象转化成原始值。其他的对象都会先调用valueOf() 方法，而时间对象类型会先调用toString()

1 + new Date()
// "1Thu Mar 14 2019 13:51:46 GMT+0800 (中国标准时间)"

new Date(2011,11,11).getTime() == new Date(2011,11,11)
// false 后面的Date对象，调用了toString()
new Date(2011,11,11).getTime() == +new Date(2011,11,11)
// true 此时隐式转换期待转换为数字，调用了valueOf()

其他期待转换为数字的场景，也是正常先调用valueOf()的

时间戳

时间对象在传递过程中，一般会转换为时间戳，有多种实现方式

new Date(2011,11,11).valueOf()
// 1323532800000
new Date(2011,11,11).getTime()
// 1323532800000
+new Date(2011,11,11)
// 1323532800000

Date.now()
// 1552543813256  当前时间距离时间零点（1970年1月1日 00:00:00 UTC）的毫秒数

注意以上都是毫秒，如果要转成UNIX时间戳（从1970年1月1日（UTC/GMT的午夜）开始所经过的秒数），可以用以下方法

Math.round(ms/1000)

原生方法

Date对象提供了多种方法来获取/设置时间数据

Date对象提供了一系列get*方法，用来获取实例对象某个方面的值。

getTime()：返回实例距离1970年1月1日00:00:00的毫秒数，等同于valueOf方法。
getDate()：返回实例对象对应每个月的几号（从1开始）。
getDay()：返回星期几，星期日为0，星期一为1，以此类推。
getFullYear()：返回四位的年份。
getMonth()：返回月份（0表示1月，11表示12月）。
getHours()：返回小时（0-23）。
getMilliseconds()：返回毫秒（0-999）。
getMinutes()：返回分钟（0-59）。
getSeconds()：返回秒（0-59）。
getTimezoneOffset()：返回当前时间与 UTC 的时区差异，以分钟表示，返回结果考虑到了夏令时因素。

还提供了这些方法对应的 UTC 版本，用来返回 UTC 时间。

getUTCDate()
getUTCFullYear()
getUTCMonth()
getUTCDay()
getUTCHours()
getUTCMinutes()
getUTCSeconds()
getUTCMilliseconds()

new Date(2011,11,11,11,11,11,111).getHours()
// 11
new Date(2011,11,11,11,11,11,111).getUTCHours()
// 3 可见UTC时间比北京时间晚8个小时，也就是下面的时区差异 -480分钟
new Date(2011,11,11,11,11,11,111).getTimezoneOffset()
// -480

Date对象提供了一系列set*方法，用来设置实例对象的各个方面。

setDate(date)：设置实例对象对应的每个月的几号（1-31），返回改变后毫秒时间戳。
setFullYear(year [, month, date])：设置四位年份。
setHours(hour [, min, sec, ms])：设置小时（0-23）。
setMilliseconds()：设置毫秒（0-999）。
setMinutes(min [, sec, ms])：设置分钟（0-59）。
setMonth(month [, date])：设置月份（0-11）。
setSeconds(sec [, ms])：设置秒（0-59）。
setTime(milliseconds)：设置毫秒时间戳。

这些方法基本是跟get方法一一对应的，但是没有setDay方法，因为星期几是计算出来的，而不是设置的。
set系列方法除了setTime()，都有对应的 UTC 版本，即设置 UTC 时区的时间。

setUTCDate()
setUTCFullYear()
setUTCHours()
setUTCMilliseconds()
setUTCMinutes()
setUTCMonth()
setUTCSeconds()

设置时间的方法，配合自动折算，可以很便捷的得到相对时间

let now = new Date();

// 99天之后的时间
now.setDate(now.getDate() + 99)

// 10小时之前
now.setHours(now.getHours() - 10)

date对象提供一系列to* ，用来将时间对象转换为字符串

toString() 返回一个完整的日期字符串。
toDateString() 返回年月日的字符串
toTimeString() 返回时间字符串，不包含年月日

也有对应的 UTC 版本和 local版本

toUTCString() 返回对应的 UTC 时间，也就是比北京时间晚8个小时。
toLocaleString() 返回完整的本地时间。

let now = new Date()
undefined
now.toString()
// "Thu Mar 14 2019 14:32:18 GMT+0800 (中国标准时间)"
now.toUTCString()
// "Thu, 14 Mar 2019 06:32:18 GMT"    UTC时间比北京时间晚8个小时
now.toLocaleString()
// "2019/3/14 下午2:32:18"