JavaScript Date對(duì)象

目錄

Date對(duì)象是JavaScript提供的日期和時(shí)間的操作接口。它可以表示的時(shí)間范圍是，1970年1月1日00:00:00前后的各1億天（單位為毫秒）。

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

Date()
// "Tue Dec 01 2015 09:34:43 GMT+0800 (CST)"

注意，即使帶有參數(shù)，Date作為普通函數(shù)使用時(shí)，返回的還是當(dāng)前時(shí)間。

Date(2000, 1, 1)
// "Tue Dec 01 2015 09:34:43 GMT+0800 (CST)"

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

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

var today = new Date();

這個(gè)Date實(shí)例對(duì)應(yīng)的字符串值，就是當(dāng)前時(shí)間。

var today = new Date();

today
// "Tue Dec 01 2015 09:34:43 GMT+0800 (CST)"

// 等同于
today.toString()
// "Tue Dec 01 2015 09:34:43 GMT+0800 (CST)"

作為構(gòu)造函數(shù)時(shí)，Date對(duì)象可以接受多種格式的參數(shù)。

（1）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)

上面最后一個(gè)例子說明，Date構(gòu)造函數(shù)的參數(shù)可以是一個(gè)負(fù)數(shù)，表示1970年1月1日之前的時(shí)間。

（2）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)

日期字符串的完整格式是“month day, year hours:minutes:seconds”，比如“December 25, 1995 13:30:00”。如果省略了小時(shí)、分鐘或秒數(shù)，這些值會(huì)被設(shè)為0。

但是，其他格式的日期字符串，也可以被解析。事實(shí)上，所有可以被Date.parse()方法解析的日期字符串，都可以當(dāng)作Date對(duì)象的參數(shù)。

new Date('2013-2-15')
new Date('2013/2/15')
new Date('02/15/2013')
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 Feb 2013')
new Date('15, Feberuary, 2013')

// Fri Feb 15 2013 00:00:00 GMT+0800 (CST)

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

注意，在ES5之中，如果日期采用連詞線（-）格式分隔，且具有前導(dǎo)0，JavaScript會(huì)認(rèn)為這是一個(gè)ISO格式的日期字符串，導(dǎo)致返回的時(shí)間是以UTC時(shí)區(qū)計(jì)算的。

new Date('2014-01-01')
// Wed Jan 01 2014 08:00:00 GMT+0800 (CST)

new Date('2014-1-1')
// Wed Jan 01 2014 00:00:00 GMT+0800 (CST)

上面代碼中，日期字符串有沒有前導(dǎo)0，返回的結(jié)果是不一樣的。如果沒有前導(dǎo)0，JavaScript引擎假設(shè)用戶處于本地時(shí)區(qū)，所以本例返回0點(diǎn)0分。如果有前導(dǎo)0（即如果你以ISO格式表示日期），就假設(shè)用戶處于格林尼治國(guó)際標(biāo)準(zhǔn)時(shí)的時(shí)區(qū)，所以返回8點(diǎn)0分。但是，ES6改變了這種做法，規(guī)定凡是沒有指定時(shí)區(qū)的日期字符串，一律認(rèn)定用戶處于本地時(shí)區(qū)。

總之，對(duì)于YYYY-MM-DD形式的字符串，JavaScript引擎可能會(huì)將其當(dāng)作ISO格式來解析，采用格林尼治時(shí)區(qū)作為計(jì)時(shí)標(biāo)準(zhǔn)；而對(duì)于其他格式的日期字符串，一律視為非ISO格式，采用本地時(shí)區(qū)作為計(jì)時(shí)標(biāo)準(zhǔn)。

new Date('2014-12-11')
// Thu Dec 11 2014 08:00:00 GMT+0800 (CST)

new Date('2014/12/11')
// Thu Dec 11 2014 00:00:00 GMT+0800 (CST)

上面代碼中，第一個(gè)日期字符串是ISO格式，第二個(gè)不是，導(dǎo)致生成的時(shí)間不一樣。

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

Date對(duì)象還可以接受多個(gè)整數(shù)作為參數(shù)，依次表示年、月、日、小時(shí)、分鐘、秒和毫秒。如果采用這種格式，最少需要提供兩個(gè)參數(shù)（年和月），其他參數(shù)都是可選的，默認(rèn)等于0。因?yàn)槿绻皇褂谩澳辍边@一個(gè)參數(shù)，Date對(duì)象會(huì)將其解釋為毫秒數(shù)。

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

上面代碼中，2013被解釋為毫秒數(shù)，而不是年份。

各個(gè)參數(shù)的取值范圍如下。

• year：四位年份，如果寫成兩位數(shù)，則加上1900
• month：表示月份，0表示一月，11表示12月
• date：表示日期，1到31
• hour：表示小時(shí)，0到23
• minute：表示分鐘，0到59
• second：表示秒鐘，0到59
• ms：表示毫秒，0到999

注意，月份從0開始計(jì)算，但是，天數(shù)從1開始計(jì)算。另外，除了日期默認(rèn)為1，小時(shí)、分鐘、秒鐘和毫秒默認(rèn)都是0。

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í)間。

這些參數(shù)如果超出了正常范圍，會(huì)被自動(dòng)折算。比如，如果月設(shè)為15，就折算為下一年的4月。

new Date(2013, 15)
// Tue Apr 01 2014 00:00:00 GMT+0800 (CST)

new Date(2013, 0, 0)
// Mon Dec 31 2012 00:00:00 GMT+0800 (CST)

參數(shù)還可以使用負(fù)數(shù)，表示扣去的時(shí)間。

new Date(2013, -1)
// Sat Dec 01 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到99，會(huì)自動(dòng)加上1900。比如，0表示1900年，1表示1901年；如果為負(fù)數(shù)，則表示公元前。

new Date(0, 0)
// Mon Jan 01 1900 00:00:00 GMT+0800 (CST)

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

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

類型轉(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 d1 = new Date(2000, 2, 1);
var d2 = new Date(2000, 3, 1);

d2 - d1
// 2678400000

d2 + d1
// "Sat Apr 01 2000 00:00:00 GMT+0800 (CST)Wed Mar 01 2000 00:00:00 GMT+0800 (CST)"

Date.now()

Date.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í)間，可以精確到千分之一毫秒。

window.performance.now() // 21311140.415

Date.parse()

Date.parse方法用來解析日期字符串，返回距離1970年1月1日 00:00:00的毫秒數(shù)。

標(biāo)準(zhǔn)的日期字符串的格式，應(yīng)該完全或者部分符合RFC 2822和ISO 8061，即YYYY-MM-DDTHH:mm:ss.sssZ格式，其中最后的Z表示時(shí)區(qū)。但是，其他格式也可以被解析，請(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ì)算，日期從1開始計(jì)算。

Date的實(shí)例對(duì)象，有幾十個(gè)自己的方法，分為以下三類。

• to類：從Date對(duì)象返回一個(gè)字符串，表示指定的時(shí)間。
• get類：獲取Date對(duì)象的日期和時(shí)間。
• set類：設(shè)置Date對(duì)象的日期和時(shí)間。

to類方法

（1）Date.prototype.toString()

toString方法返回一個(gè)完整的日期字符串。

var d = new Date(2013, 0, 1);

d.toString()
// "Tue Jan 01 2013 00:00:00 GMT+0800 (CST)"

d
// "Tue Jan 01 2013 00:00:00 GMT+0800 (CST)"

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

（2）Date.prototype.toUTCString()

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

var d = new Date(2013, 0, 1);

d.toUTCString()
// "Mon, 31 Dec 2012 16:00:00 GMT"

d.toString()
// "Tue Jan 01 2013 00:00:00 GMT+0800 (CST)"

（3）Date.prototype.toISOString()

toISOString方法返回對(duì)應(yīng)時(shí)間的ISO8601寫法。

var d = new Date(2013, 0, 1);

d.toString()
// "Tue Jan 01 2013 00:00:00 GMT+0800 (CST)"

d.toISOString()
// "2012-12-31T16:00:00.000Z"

注意，toISOString方法返回的總是UTC時(shí)區(qū)的時(shí)間。

（4）Date.prototype.toJSON()

toJSON方法返回一個(gè)符合JSON格式的ISO格式的日期字符串，與toISOString方法的返回結(jié)果完全相同。

var d = new Date(2013, 0, 1);

d.toJSON()
// "2012-12-31T16:00:00.000Z"

d.toISOString()
// "2012-12-31T16:00:00.000Z"

（5）Date.prototype.toDateString()

toDateString方法返回日期字符串。

var d = new Date(2013, 0, 1);
d.toDateString() // "Tue Jan 01 2013"

（6）Date.prototype.toTimeString()

toTimeString方法返回時(shí)間字符串。

var d = new Date(2013, 0, 1);
d.toTimeString() // "00:00:00 GMT+0800 (CST)"

（7）Date.prototype.toLocaleDateString()

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

var d = new Date(2013, 0, 1);

d.toLocaleDateString()
// 中文版瀏覽器為"2013年1月1日"
// 英文版瀏覽器為"1/1/2013"

（8）Date.prototype.toLocaleTimeString()

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

var d = new Date(2013, 0, 1);

d.toLocaleTimeString()
// 中文版瀏覽器為"上午12:00:00"
// 英文版瀏覽器為"12:00:00 AM"

get類方法

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

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

所有這些get*方法返回的都是整數(shù)，不同方法返回值的范圍不一樣。

• 分鐘和秒：0 到 59
• 小時(shí)：0 到 23
• 星期：0（星期天）到 6（星期六）
• 日期：1 到 31
• 月份：0（一月）到 11（十二月）
• 年份：距離1900年的年數(shù)

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

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

上面代碼中，最后一行返回-480，表示UTC比當(dāng)前時(shí)間晚480分鐘，即8個(gè)小時(shí)。

下面是一個(gè)例子，計(jì)算本年度還剩下多少天。

function leftDays() {
  var today = new Date();
  var endYear = new Date(today.getFullYear(), 11, 31, 23, 59, 59, 999);
  var msPerDay = 24 * 60 * 60 * 1000;
  return Math.round((endYear.getTime() - today.getTime()) / msPerDay);
}

上面這些get*方法返回的都是當(dāng)前時(shí)區(qū)的時(shí)間，Date對(duì)象還提供了這些方法對(duì)應(yīng)的UTC版本，用來返回UTC時(shí)間。

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

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

d.getDate() // 6
d.getUTCDate() // 5

上面代碼中，實(shí)例對(duì)象d表示當(dāng)前時(shí)區(qū)（東八時(shí)區(qū)）的1月6日0點(diǎn)0分0秒，這個(gè)時(shí)間對(duì)于當(dāng)前時(shí)區(qū)來說是1月6日，所以getDate方法返回6，對(duì)于UTC時(shí)區(qū)來說是1月5日，所以getUTCDate方法返回5。

set類方法

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

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

這些方法基本是跟get*方法一一對(duì)應(yīng)的，但是沒有setDay方法，因?yàn)樾瞧趲资怯?jì)算出來的，而不是設(shè)置的。另外，需要注意的是，凡是涉及到設(shè)置月份，都是從0開始算的，即0是1月，11是12月。

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 d1 = new Date('January 6, 2013');

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

var d2 = new Date ('January 6, 2013');

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

set類方法和get類方法，可以結(jié)合使用，得到相對(duì)時(shí)間。

var d = new Date();

// 將日期向后推1000天
d.setDate( d.getDate() + 1000 );

// 將時(shí)間設(shè)為6小時(shí)后
d.setHours(d.getHours() + 6);

// 將年份設(shè)為去年
d.setFullYear(d.getFullYear() - 1);

set*系列方法除了setTime()和setYear()，都有對(duì)應(yīng)的UTC版本，即設(shè)置UTC時(shí)區(qū)的時(shí)間。

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

var d = new Date('January 6, 2013');
d.getUTCHours() // 16
d.setUTCHours(22) // 1357423200000
d // Sun Jan 06 2013 06:00:00 GMT+0800 (CST)

上面代碼中，本地時(shí)區(qū)（東八時(shí)區(qū)）的1月6日0點(diǎn)0分，是UTC時(shí)區(qū)的前一天下午16點(diǎn)。設(shè)為UTC時(shí)區(qū)的22點(diǎn)以后，就變?yōu)楸镜貢r(shí)區(qū)的上午6點(diǎn)。

Date.prototype.valueOf()

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

var d = new Date();

d.valueOf() // 1362790014817
d.getTime() // 1362790014817

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

var start = new Date();

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

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