JavaScript Date對(duì)象

概述

Date對(duì)象是JavaScript提供的日期和時(shí)間的操作接口。它有多種用法。

Date()

作為一個(gè)函數(shù)，Date對(duì)象可以直接調(diào)用，返回一個(gè)當(dāng)前日期和時(shí)間的字符串。

Date()
// "Sat Mar 09 2013 08:46:54 GMT+0800 (CST)"

Date(2000, 1, 1)
// "Sat Mar 09 2013 08:46:54 GMT+0800 (CST)"

上面代碼說(shuō)明，無(wú)論有沒有參數(shù)，直接調(diào)用Date總是返回當(dāng)前時(shí)間。

new Date()

Date對(duì)象還是一個(gè)構(gòu)造函數(shù)，對(duì)它使用new命令，會(huì)返回一個(gè)Date對(duì)象的實(shí)例。如果不加參數(shù)，生成的就是代表當(dāng)前時(shí)間的對(duì)象。

var today = new Date();

today 
// "Sat Mar 09 2013 08:46:54 GMT+0800 (CST)"

// 等同于
today.toString() 
// "Sat Mar 09 2013 08:46:54 GMT+0800 (CST)"

new Date(milliseconds)

Date對(duì)象接受從1970年1月1日00:00:00 UTC開始計(jì)算的毫秒數(shù)作為參數(shù)。這意味著如果將Unix時(shí)間戳作為參數(shù)，必須將Unix時(shí)間戳乘以1000。

new Date(1378218728000)
// Tue Sep 03 2013 22:32:08 GMT+0800 (CST)

// 1970年1月2日的零時(shí)
var Jan02_1970 = new Date(3600*24*1000);
// Fri Jan 02 1970 08:00:00 GMT+0800 (CST)

// 1969年12月31日的零時(shí)
var Dec31_1969 = new Date(-3600*24*1000);
// Wed Dec 31 1969 08:00:00 GMT+0800 (CST)

上面代碼說(shuō)明，Date構(gòu)造函數(shù)的參數(shù)可以是一個(gè)負(fù)數(shù)，表示1970年1月1日之前的時(shí)間。Date對(duì)象能夠表示的日期范圍是1970年1月1日前后各一億天。

new Date(datestring)

Date對(duì)象還接受一個(gè)日期字符串作為參數(shù)，返回所對(duì)應(yīng)的時(shí)間。

new Date("January 6, 2013");
// Sun Jan 06 2013 00:00:00 GMT+0800 (CST)

所有可以被Date.parse()方法解析的日期字符串，都可以當(dāng)作Date對(duì)象的參數(shù)。

new Date("2013-02-15")
new Date("2013-FEB-15")
new Date("FEB, 15, 2013")
new Date("FEB 15, 2013")
new Date("Feberuary, 15, 2013")
new Date("Feberuary 15, 2013")
new Date("15, Feberuary, 2013")
// Fri Feb 15 2013 08:00:00 GMT+0800 (CST)

上面多種寫法，返回的都是同一個(gè)時(shí)間。

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

在多個(gè)參數(shù)的情況下，Date對(duì)象將其分別視作對(duì)應(yīng)的年、月、日、小時(shí)、分鐘、秒和毫秒。如果采用這種用法，最少需要指定兩個(gè)參數(shù)（年和月），其他參數(shù)都是可選的，默認(rèn)等于0。如果只使用年一個(gè)參數(shù)，Date對(duì)象會(huì)將其解釋為毫秒數(shù)。

new Date(2013) // Thu Jan 01 1970 08:00:02 GMT+0800 (CST)
new Date(2013,0) // Tue Jan 01 2013 00:00:00 GMT+0800 (CST)
new Date(2013,0,1) // Tue Jan 01 2013 00:00:00 GMT+0800 (CST)
new Date(2013,0,1,0) // Tue Jan 01 2013 00:00:00 GMT+0800 (CST)
new Date(2013,0,1,0,0,0,0) // Tue Jan 01 2013 00:00:00 GMT+0800 (CST)

上面代碼（除了第一行）返回的是2013年1月1日零點(diǎn)的時(shí)間，可以看到月份從0開始計(jì)算，因此1月是0，12月是11。但是，月份里面的天數(shù)從1開始計(jì)算。

這些參數(shù)如果超出了正常范圍，會(huì)被自動(dòng)折算。比如，如果月設(shè)為15，就算折算為下一年的4月。參數(shù)還可以使用負(fù)數(shù)，表示扣去的時(shí)間。

new Date(2013,0) // Tue Jan 01 2013 00:00:00 GMT+0800 (CST)
new Date(2013,-1) // Sat Dec 01 2012 00:00:00 GMT+0800 (CST) 
new Date(2013,0,1) // Tue Jan 01 2013 00:00:00 GMT+0800 (CST)
new Date(2013,0,0) // Mon Dec 31 2012 00:00:00 GMT+0800 (CST)
new Date(2013,0,-1) // Sun Dec 30 2012 00:00:00 GMT+0800 (CST)

上面代碼分別對(duì)月和日使用了負(fù)數(shù)，表示從基準(zhǔn)日扣去相應(yīng)的時(shí)間。

年的情況有所不同，如果為0，表示1900年；如果為負(fù)數(shù)，則表示公元前。

new Date(1,0) // Tue Jan 01 1901 00:00:00 GMT+0800 (CST)
new Date(0,0) // Mon Jan 01 1900 00:00:00 GMT+0800 (CST)
new Date(-1,0) // Fri Jan 01 -1 00:00:00 GMT+0800 (CST)

日期的運(yùn)算

類型轉(zhuǎn)換時(shí)，Date對(duì)象的實(shí)例如果轉(zhuǎn)為數(shù)值，則等于對(duì)應(yīng)的毫秒數(shù)；如果轉(zhuǎn)為字符串，則等于對(duì)應(yīng)的日期字符串。所以，兩個(gè)日期對(duì)象進(jìn)行減法運(yùn)算，返回的就是它們間隔的毫秒數(shù)；進(jìn)行加法運(yùn)算，返回的就是連接后的兩個(gè)字符串。

var then = new Date(2013,2,1);
var now = new Date(2013,3,1);

now - then
// 2678400000

now + then
// "Mon Apr 01 2013 00:00:00 GMT+0800 (CST)Fri Mar 01 2013 00:00:00 GMT+0800 (CST)"

Date對(duì)象的方法

Date.now()

now方法返回當(dāng)前距離1970年1月1日 00:00:00 UTC的毫秒數(shù)（Unix時(shí)間戳乘以1000）。

Date.now()
// 1364026285194

如果需要更精確的時(shí)間，可以使用window.performance.now()。它提供頁(yè)面加載到命令運(yùn)行時(shí)的已經(jīng)過去的時(shí)間，單位是浮點(diǎn)數(shù)形式的毫秒。

window.performance.now()
// 21311140.415

Date.parse()

parse方法用來(lái)解析日期字符串，返回距離1970年1月1日 00:00:00的毫秒數(shù)。日期字符串的格式應(yīng)該完全或者部分符合RFC 2822和ISO 8061，即YYYY-MM-DDTHH:mm:ss.sssZ格式，其中最后的Z表示時(shí)區(qū)，是可選的。

• YYYY
• YYYY-MM
• YYYY-MM-DD
• THH:mm（比如“T12:00”）
• THH:mm:ss
• THH:mm:ss.sss

請(qǐng)看例子。

Date.parse("Aug 9, 1995")
// 返回807897600000，以下省略返回值

Date.parse("January 26, 2011 13:51:50")
Date.parse("Mon, 25 Dec 1995 13:30:00 GMT")
Date.parse("Mon, 25 Dec 1995 13:30:00 +0430")
Date.parse("2011-10-10")
Date.parse("2011-10-10T14:48:00")

如果解析失敗，返回NaN。

Date.parse("xxx")
// NaN

Date.UTC()

默認(rèn)情況下，Date對(duì)象返回的都是當(dāng)前時(shí)區(qū)的時(shí)間。Date.UTC方法可以返回UTC時(shí)間（世界標(biāo)準(zhǔn)時(shí)間）。該方法接受年、月、日等變量作為參數(shù)，返回當(dāng)前距離1970年1月1日 00:00:00 UTC的毫秒數(shù)。

// 使用的格式
Date.UTC(year, month[, date[, hrs[, min[, sec[, ms]]]]]) 

Date.UTC(2011,0,1,2,3,4,567)
// 1293847384567

該方法的參數(shù)用法與Date構(gòu)造函數(shù)完全一致，比如月從0開始計(jì)算。

Date實(shí)例對(duì)象的方法

使用new命令生成的Date對(duì)象的實(shí)例，有很多自己的方法。

Date.prototype.toString()

toString方法返回一個(gè)完整的時(shí)間字符串。

var today = new Date(1362790014000);

today.toString()
// "Sat Mar 09 2013 08:46:54 GMT+0800 (CST)"

today
// "Sat Mar 09 2013 08:46:54 GMT+0800 (CST)"

因?yàn)閠oString是默認(rèn)的調(diào)用方法，所以如果直接讀取Date對(duì)象實(shí)例，就相當(dāng)于調(diào)用這個(gè)方法。

Date.prototype.toUTCString()，Date.prototype.toISOString()

toUTCString方法返回對(duì)應(yīng)的UTC時(shí)間，也就是比北京時(shí)間晚8個(gè)小時(shí)。toISOString方法返回對(duì)應(yīng)時(shí)間的ISO8601寫法。

var today = new Date(1362790014000);

today.toUTCString()
// "Sat, 09 Mar 2013 00:46:54 GMT"

today.toISOString()
// "2013-03-09T00:46:54.000Z"

Date.prototype.toDateString()，Date.prototype.toTimeString()

toDateString方法返回日期的字符串形式，toTimeString方法返回時(shí)間的字符串形式。

var today = new Date(1362790014000);

today.toDateString()
// "Sat Mar 09 2013"

today.toTimeString()
// "08:46:54 GMT+0800 (CST)"

Date.prototype.toLocalDateString()，Date.prototype.toLocalTimeString()

toLocalDateString方法返回一個(gè)字符串，代表日期的當(dāng)?shù)貙懛?；toLocalTimeString方法返回一個(gè)字符串，代表時(shí)間的當(dāng)?shù)貙懛ā?/p>

var today = new Date(1362790014000);

today.toLocaleDateString()
// "2013年3月9日"

today.toLocaleTimeString()
"上午8:46:54"

Date.prototype.valueOf()

valueOf方法返回實(shí)例對(duì)象距離1970年1月1日00:00:00 UTC對(duì)應(yīng)的毫秒數(shù)，該方法等同于getTime方法。

var today = new Date();

today.valueOf()
// 1362790014817

today.getTime()
// 1362790014817

該方法可以用于計(jì)算精確時(shí)間。

var start = new Date();

doSomething();
var end = new Date();
var elapsed = end.getTime() - start.getTime();

Date.prototype.get系列方法

Date對(duì)象提供了一系列g(shù)et方法，用來(lái)獲取實(shí)例對(duì)象某個(gè)方面的值。

• Date.prototype.getTime()：返回實(shí)例對(duì)象距離1970年1月1日00:00:00對(duì)應(yīng)的毫秒數(shù)，等同于valueOf方法。
• Date.prototype.getDate()：返回實(shí)例對(duì)象對(duì)應(yīng)每個(gè)月的幾號(hào)（從1開始）。
• Date.prototype.getDay()：返回星期，星期日為0，星期一為1，以此類推。
• Date.prototype.getFullYear()：返回四位的年份。
• Date.prototype.getMonth()：返回月份（0表示1月，11表示12月）。
• Date.prototype.getHours()：返回小時(shí)（0-23）。
• Date.prototype.getMilliseconds()：返回毫秒（0-999）。
• Date.prototype.getMinutes()：返回分鐘（0-59）。
• Date.prototype.getSeconds()：返回秒（0-59）。
• Date.prototype.getTimezoneOffset()：返回當(dāng)前時(shí)間與UTC的時(shí)區(qū)差異，以分鐘表示，返回結(jié)果考慮到了夏令時(shí)因素。

var d = new Date("January 6, 2013");

d.getDate() // 6
d.getMonth() // 0
d.getFullYear() // 2013
d.getTimezoneOffset() // -480

上面這些方法默認(rèn)返回的都是當(dāng)前時(shí)區(qū)的時(shí)間，Date對(duì)象還提供了這些方法對(duì)應(yīng)的UTC版本，用來(lái)返回UTC時(shí)間，比如getUTCFullYear()、getUTCMonth()、getUTCDay()、getUTCHours()等等。

Date.prototype.set系列方法

Date對(duì)象提供了一系列set方法，用來(lái)設(shè)置實(shí)例對(duì)象的各個(gè)方面。

• Date.prototype.setDate(date)：設(shè)置實(shí)例對(duì)象對(duì)應(yīng)的每個(gè)月的幾號(hào)（1-31），返回改變后毫秒時(shí)間戳。
• Date.prototype.setFullYear(year [, month, date])：設(shè)置四位年份。
• Date.prototype.setHours(hour [, min, sec, ms])：設(shè)置小時(shí)（0-23）。
• Date.prototype.setMilliseconds()：設(shè)置毫秒（0-999）。
• Date.prototype.setMinutes(min [, sec, ms])：設(shè)置分鐘（0-59）。
• Date.prototype.setMonth(month [, date])：設(shè)置月份（0-11）。
• Date.prototype.setSeconds(sec [, ms])：設(shè)置秒（0-59）。
• Date.prototype.setTime(milliseconds)：設(shè)置毫秒時(shí)間戳。

var d = new Date ("January 6, 2013");

d 
// Sun Jan 06 2013 00:00:00 GMT+0800 (CST)

d.setDate(9) 
// 1357660800000

d
// Wed Jan 09 2013 00:00:00 GMT+0800 (CST)

set方法的參數(shù)都會(huì)自動(dòng)折算。以setDate為例，如果參數(shù)超過當(dāng)月的最大天數(shù)，則向下一個(gè)月順延，如果參數(shù)是負(fù)數(shù)，表示從上個(gè)月的最后一天開始減去的天數(shù)。

var d = new Date("January 6, 2013");

d.setDate(32)
// 1359648000000
d 
// Fri Feb 01 2013 00:00:00 GMT+0800 (CST)

var d = new Date ("January 6, 2013");

d.setDate(-1)
// 1356796800000
d
// Sun Dec 30 2012 00:00:00 GMT+0800 (CST)

使用setDate方法，可以算出今天過后1000天是幾月幾日。

var d = new Date();
d.setDate( d.getDate() + 1000 );
d.getDay();

set系列方法除了setTime()，都有對(duì)應(yīng)的UTC版本，比如setUTCHours()。

Date.prototype.toJSON()

toJSON方法返回JSON格式的日期對(duì)象。

var jsonDate = (new Date()).toJSON();

jsonDate
"2013-09-03T14:26:31.880Z"

var backToDate = new Date(jsonDate);

參考鏈接

• Rakhitha Nimesh，Getting Started with the Date Object
• Ilya Kantor, Date/Time functions