1. 概念

Date对象是JavaScript提供的日期和时间的操作接口。它可以表示的时间范围是,1970年1月1日00:00:00前后的各1亿天(单位为毫秒)。
我们可以通过直接调用Date对象来获取当前时间,获取当前时间的字符串形式

1
2
Date()
// "Mon Jun 05 2017 17:32:47 GMT+0800 (中国标准时间)"

2. new Date()

Date对象还可以当做构造函数来使用,如果前面加new,就返回Date对象的一个实例,如果不接收参数,就返回当前时间。

1
2
new Date()
// Mon Jun 05 2017 17:37:00 GMT+0800 (中国标准时间)

new Date()返回的是当前时间的对象,其typeof 为’’object’’,其字符串形式即是当前时间。

1
2
new Date().toString()
"Mon Jun 05 2017 17:37:00 GMT+0800 (中国标准时间)"

作为构造函数时,Date对象可以接受多种格式的参数。

2.1 new Date(milliseconds)

Date对象接受从1970年1月1日00:00:00 UTC开始计算的毫秒数作为参数。这意味着如果将Unix时间戳(单位为秒)作为参数,必须将Unix时间戳乘以1000。

1
2
new Date(1496620800000)
// Mon Jun 05 2017 08:00:00 GMT+0800 (中国标准时间)

时间戳还可以是一个负数,代表1970年1月1日之前的时间。

1
2
var Dec31_1969 = new Date(-3600 * 24 * 1000);
// Wed Dec 31 1969 08:00:00 GMT+0800 (CST)

2.2 new Date(datestring)

Date对象还可以接受一个日期参数,返回所对应的时间。

1
2
new Date('2017-6-5')
// Mon Jun 05 2017 00:00:00 GMT+0800 (中国标准时间)

日期字符串的完整格式是“month day, year hours:minutes:seconds”,比如“December 25, 1995 13:30:00”。如果省略了小时、分钟或秒数,这些值会被设为0。其他格式的日期字符串,也可以被解析。
事实上,所有可以被Date.parse()方法解析的日期字符串,都可以当作Date对象的参数,ECMA-262没有定义Date.parse()应该支持哪种日期格式,这个方法的行为因地区而异。

1
2
3
4
5
6
7
8
9
10
new Date('2017/6/5')
new Date('2017-6-5')
new Date('05/6/2017')
new Date('Jun 5,2017')
new Date('June 5,2017')
new Date('June,5,2017')
new Date('5 June 2017')
new Date('5,June,2017')
// Mon Jun 05 2017 00:00:00 GMT+0800 (中国标准时间)

以上几种日期格式均返回同一个时间

需要注意的是,在ES5之中,如果日期采用连词线(-)格式分隔,且具有前导0,JavaScript会认为这是一个ISO格式的日期字符串,导致返回的时间是以UTC时区计算的。

1
2
3
4
new Date('2017-6-5')
// Mon Jun 05 2017 00:00:00 GMT+0800 (中国标准时间)
new Date('2017-06-05')
// Mon Jun 05 2017 08:00:00 GMT+0800 (中国标准时间)

上述代码中,日期有无前置0,返回的结果是不同的,如果没有前导0,JavaScript引擎假设用户处于本地时区,所以本例返回0点0分。如果有前导0(即如果你以ISO格式表示日期),就假设用户处于格林尼治国际标准时的时区,所以返回8点0分。但是,ES6改变了这种做法,规定凡是没有指定时区的日期字符串,一律认定用户处于本地时区。

2.3 new Date(year, month [, day, hours, minutes, seconds, ms])

Date对象还可以接受多个整数作为参数,依次表示年、月、日、小时、分钟、秒和毫秒。如果采用这种格式,最少需要提供两个参数(年和月),其他参数都是可选的,默认等于0。因为如果只使用“年”这一个参数,Date对象会将其解释为毫秒数而不是年份。

1
2
new Date(2017)
// Thu Jan 01 1970 08:00:02 GMT+0800 (中国标准时间)

其中,各个参数取值范围如下:

1
2
3
4
5
6
7
year:四位年份,如果写成两位数,则加上1900
month:表示月份,0表示一月,11表示12
date:表示日期,131
hour:表示小时,023
minute:表示分钟,059
second:表示秒钟,059
ms:表示毫秒,0999

注意,月份从0开始计算,但是,天数从1开始计算。另外,除了日期默认为1,小时、分钟、秒钟和毫秒默认都是0。

1
2
3
4
5
6
7
8
new Date(2017,0)
// Sun Jan 01 2017 00:00:00 GMT+0800 (中国标准时间)
new Date(2017,0,1)
// Sun Jan 01 2017 00:00:00 GMT+0800 (中国标准时间)
new Date(2017,0,1,0)
// Sun Jan 01 2017 00:00:00 GMT+0800 (中国标准时间)
new Date(2017,0,1,8,0,0,0)
// Sun Jan 01 2017 08:00:00 GMT+0800 (中国标准时间)

这些参数如果超出了正常范围,会被自动折算。比如,如果月设为15,就折算为下一年的4月。

1
2
3
4
5
new Date(2017,15,1)
// Sun Apr 01 2018 00:00:00 GMT+0800 (中国标准时间)
new Date(2017,6,0)
// Fri Jun 30 2017 00:00:00 GMT+0800 (中国标准时间)

年份如果是0到99,会自动加上1900。比如,0表示1900年,1表示1901年;如果为负数,则表示公元前。

1
2
3
4
5
6
new Date(0,0)
// Mon Jan 01 1900 00:00:00 GMT+0800 (中国标准时间)
new Date(3,0)
// Thu Jan 01 1903 00:00:00 GMT+0800 (中国标准时间)
new Date(-3,0)
// Wed Jan 01 -3 00:00:00 GMT+0800 (中国标准时间)

3. Date对象的静态方法

Date.now()返回当前时间距离1970年1月1日UTC时间的毫秒数(Unix时间戳乘以1000)。

1
2
Date.now()
// 1496660477967

3.1 Date.parse()

Date.parse()方法用了解析日期字符串,返回距离1970年1月1日0:00:00的毫秒数,标准的日期格式应该符合RFC 2822和ISO 8061,即YYYY-MM-DDTHH:mm:ss.sssZ格式,其中最后的Z表示时区。但是有时,其他的日期格式也可以被解析。

1
2
3
4
5
6
Date.parse('Mar 16,1993')
// 732211200000
Date.parse('March 16,1993,14:00:00')
// 732261600000
Date.parse('1993-03-16T14:00:00')
// 732261600000

如果Date.parse无法解析,则返回NaN

3.2 Date.UTC()

默认情况下,Date对象返回当前时区的时间,Date.UTC()则返回UTC时间(世界标准时间),返回当前时间距离1970年1月1日0:00:00UTC时间的毫秒数。

1
2
Date.UTC(2017,6,5)
1499212800000

4. Date实例对象的方法

Date实例对象的方法很多,大致可以分为三类:
to类:从Date对象返回日期字符串
get类:获取Date对象日期
set类:设置Date对象日期

4.1 to类

Date.prototype.toString()

1
2
3
var d=new Date(2017,5,5);
d.toString()
// ''Mon Jun 05 2017 00:00:00 GMT+0800 (中国标准时间)''

4.1.1 Date.prototype.toUTCString()

toUTCString方法返回对应的UTC时间,比北京时间晚8个小时。

1
2
3
var d=new Date(2017,5,5)
d.toUTCString();
// "Sun, 04 Jun 2017 16:00:00 GMT"

4.1.2 Date.prototype.toISOString()

toISOString方法返回对应时间的ISO8601写法。

1
2
3
var d=new Date(2017,5,5)
d.toISOString();
// "2017-06-04T16:00:00.000Z"

4.1.3 Date.prototype.toJSON()

toJSON方法返回一个符合JSON格式的ISO格式的日期字符串,与toISOString方法的返回结果完全相同。

1
2
3
var d=new Date(2017,5,5);
d.toJSON()
// "2017-06-04T16:00:00.000Z"

4.1.4 Date.prototype.toDateString()

toLocaleDateString方法返回一个字符串,代表日期的当地写法。

1
2
3
var d=new Date(2017,5,5);
d.toDateString()
// "Mon Jun 05 2017"

4.1.5 Date.prototype.toLocaleDateString()

1
2
3
var d=new Date(2017,5,5);
d.toLocaleDateString()
// "2017-6-5"

4.1.6 Date.prototype.toLocaleTimeString()

1
2
3
var d=new Date(2017,5,5);
d.toLocaleTimeString()
// "00:00:00"

4.2 get类方法

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

getTime():返回距离1970年1月1日00:00:00的毫秒数,与valueOf()方法返回的值相同。
getDate():返回实例对象日期的天数。(1-31)
getDay():返回星期几(0表示星期日,6表示星期六)
getYear():返回距离1900的年数。
getFullYear():返回四位的年份(如2008而非08)
getMonth():返回月份(0表示1月,11表示12月)。
getHours():返回小时(0-23)。
getMilliseconds():返回毫秒(0-999)。
getMinutes():返回分钟(0-59)。
getSeconds():返回秒(0-59)。
getTimezoneOffset():返回当前时间与UTC的时区差异,以分钟表示,返回结果考虑到了夏令时因素。

1
2
3
4
5
6
var d = new Date(2017,5,5);
d.getDate() // 5
d.getMonth() // 5
d.getYear() // 117
d.getFullYear() // 2017
d.getTimezoneOffset() // -480

上面这些get*方法返回的都是当前时区的时间,Date对象还提供了这些方法对应的UTC版本,用来返回UTC时间。

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

最后一行表明UTC比当前时间晚480分钟,即8个小时。

4.3 set类方法

Date对象提供了一系列set方法,用来设置实例对象的时间。

setDate(date):设置实例对象对应的每个月的几号(1-31),返回改变后毫秒时间戳。
setYear(year): 设置距离1900年的年数。
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方法,因为星期几是计算出来的,而不是设置的。另外,需要注意的是,凡是涉及到设置月份,都是从0开始算的,即0是1月,11是12月。

1
2
3
4
var d=new Date(2017,5,5)
d // Mon Jun 05 2017 00:00:00 GMT+0800 (中国标准时间)
d.setDate(6) // 1496678400000
d // Tue Jun 06 2017 00:00:00 GMT+0800 (中国标准时间)

set*系列方法除了setTime()和setYear(),都有对应的UTC版本,即设置UTC时区的时间。

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

参考
阮一峰JS教程