Date 對象

概述

Date對象是 JavaScript 原生的時間庫捧挺。它以國際標準時間（UTC）1970年1月1日00:00:00作為時間的零點醉锅，可以表示的時間范圍是前后各1億天（單位為毫秒）挤庇。

普通函數(shù)的用法

• Date對象可以作為普通函數(shù)直接調(diào)用，返回一個代表當前時間的字符串百拓。

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

• 即使帶有參數(shù)泥彤，Date作為普通函數(shù)使用時，返回的還是當前時間蝌借。

Date(2000, 1, 1)
// "Tue Dec 01 2015 09:34:43 GMT+0800 (CST)"
//無論有沒有參數(shù)昔瞧，直接調(diào)用Date總是返回當前時間。

構造函數(shù)的用法

• Date還可以當作構造函數(shù)使用菩佑。對它使用new命令自晰，會返回一個Date對象的實例。如果不加參數(shù)稍坯，實例代表的就是當前時間酬荞。

var today = new Date();

• Date實例有一個獨特的地方。其他對象求值的時候瞧哟，都是默認調(diào)用.valueOf()方法混巧，但是Date實例求值的時候，默認調(diào)用的是toString()方法勤揩。這導致對Date實例求值咧党，返回的是一個字符串，代表該實例對應的時間陨亡。

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)"

上面代碼中傍衡，today是Date的實例，直接求值等同于調(diào)用toString方法数苫。

• 作為構造函數(shù)時聪舒，Date對象可以接受多種格式的參數(shù)，返回一個該參數(shù)對應的時間實例

// 參數(shù)為時間零點開始計算的毫秒數(shù)
new Date(1378218728000)
// Tue Sep 03 2013 22:32:08 GMT+0800 (CST)

// 參數(shù)為日期字符串
new Date('January 6, 2013');
// Sun Jan 06 2013 00:00:00 GMT+0800 (CST)

// 參數(shù)為多個整數(shù)虐急，
// 代表年箱残、月、日止吁、小時被辑、分鐘、秒敬惦、毫秒
new Date(2013, 0, 1, 0, 0, 0, 0)
// Tue Jan 01 2013 00:00:00 GMT+0800 (CST)

關于Date構造函數(shù)的參數(shù)盼理，有幾點說明:

• 第一點，參數(shù)可以是負整數(shù)俄删，代表1970年元旦之前的時間宏怔。

new Date(-1378218728000)
// Fri Apr 30 1926 17:27:52 GMT+0800 (CST)

• 第二點奏路，只要是能被Date.parse()方法解析的字符串，都可以當作參數(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('February, 15, 2013')
new Date('February 15, 2013')
new Date('15 Feb 2013')
new Date('15, February, 2013')
// Fri Feb 15 2013 00:00:00 GMT+0800 (CST)

上面多種日期字符串的寫法鸽粉，返回的都是同一個時間。

• 第三抓艳，參數(shù)為年触机、月、日等多個整數(shù)時玷或，年和月是不能省略的儡首，其他參數(shù)都是可以省略的。也就是說偏友，這時至少需要兩個參數(shù)蔬胯，因為如果只使用“年”這一個參數(shù)，Date會將其解釋為毫秒數(shù)约谈。

new Date(2013)
// Thu Jan 01 1970 08:00:02 GMT+0800 (CST)
//2013被解釋為毫秒數(shù)笔宿，而不是年份。

下面代碼中棱诱，不管有幾個參數(shù)，返回的都是2013年1月1日零點：

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)

• 各個參數(shù)的取值范圍如下：
  1涝动、年：使用四位數(shù)年份迈勋，比如2000。如果寫成兩位數(shù)或個位數(shù)醋粟，2靡菇、則加上1900，即10代表1910年米愿。如果是負數(shù)厦凤，表示公元前。
  3育苟、月：0表示一月较鼓，依次類推，11表示12月违柏。
  4博烂、日：1到31。
  5漱竖、小時：0到23禽篱。
  6、分鐘：0到59馍惹。
  7躺率、秒：0到59
  8玛界、毫秒：0到999
• 月份從0開始計算，但是悼吱，天數(shù)從1開始計算
• 除了日期的默認值為1脚仔，小時、分鐘舆绎、秒鐘和毫秒的默認值都是0鲤脏。
• 這些參數(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)
//第二個例子努溃，日期設為0硫嘶，就代表上個月的最后一天。

• 參數(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)
//分別對月和日使用了負數(shù)沦疾，表示從基準日扣去相應的時間。

日期的運算

• 類型自動轉換時第队，Date實例如果轉為數(shù)值哮塞，則等于對應的毫秒數(shù)；如果轉為字符串凳谦，則等于對應的日期字符串忆畅。所以，兩個日期實例對象進行減法運算時尸执，返回的是它們間隔的毫秒數(shù)家凯；進行加法運算時，返回的是兩個字符串連接而成的新字符串如失。

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)"

靜態(tài)方法

Date.now()

• Date.now方法返回當前時間距離時間零點（1970年1月1日 00:00:00 UTC）的毫秒數(shù)绊诲，相當于 Unix 時間戳乘以1000。

Date.now() // 1364026285194

Date.parse()

• Date.parse方法用來解析日期字符串褪贵，返回該時間距離時間零點（1970年1月1日 00:00:00）的毫秒數(shù)掂之。
• 如果解析失敗，返回NaN

Date.UTC()

• Date.UTC方法接受年竭鞍、月板惑、日等變量作為參數(shù)，返回該時間距離時間零點（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構造函數(shù)完全一致冯乘，比如月從0開始計算，日期從1開始計算晒夹。區(qū)別在于Date.UTC方法的參數(shù)裆馒，會被解釋為 UTC 時間（世界標準時間）姊氓，Date構造函數(shù)的參數(shù)會被解釋為當前時區(qū)的時間。

實例方法

• Date的實例對象喷好，有幾十個自己的方法翔横，除了valueOf和toString，可以分為以下三類：
  1梗搅、to類：從Date對象返回一個字符串禾唁，表示指定的時間。
  2无切、get類：獲取Date對象的日期和時間荡短。
  3、set類：設置Date對象的日期和時間哆键。

Date.prototype.valueOf()

• valueOf方法返回實例對象距離時間零點（1970年1月1日00:00:00 UTC）對應的毫秒數(shù)掘托，該方法等同于getTime方法。

var d = new Date();

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

to 類方法

Date.prototype.toString()

• toString方法返回一個完整的日期字符串籍嘹。

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)"

Date.prototype.toUTCString()

• toUTCString方法返回對應的 UTC 時間闪盔，也就是比北京時間晚8個小時。

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

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

Date.prototype.toISOString()

• toISOString方法返回對應時間的 ISO8601 寫法辱士。

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

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

toISOString方法返回的總是 UTC 時區(qū)的時間泪掀。

Date.prototype.toJSON()

• toJSON方法返回一個符合JSON格式的 ISO日期字符串，與toISOString方法的返回結果完全相同识补。

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

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

Date.prototype.toDateString()

• toDateString方法返回日期字符串（不含小時族淮、分和秒）。

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

Date.prototype.toTimeString()

• toTimeString方法返回時間字符串（不含年月日）凭涂。

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

本地時間

• 以下三種方法，可以將 Date 實例轉為表示本地時間的字符串：

1贴妻、Date.prototype.toLocaleString()：完整的本地時間切油。
2、Date.prototype.toLocaleDateString()：本地日期（不含小時名惩、分和秒）澎胡。
3、Date.prototype.toLocaleTimeString()：本地時間（不含年月日）娩鹉。
下面是用法實例：

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

d.toLocaleString()
// 中文版瀏覽器為"2013年1月1日 上午12:00:00"
// 英文版瀏覽器為"1/1/2013 12:00:00 AM"

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

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

get 類方法

Date對象提供了一系列get方法攻谁，用來獲取實例對象某個方面的值：
1、getTime()：返回實例距離1970年1月1日00:00:00的毫秒數(shù)弯予，等同于valueOf方法戚宦。
2、getDate()：返回實例對象對應每個月的幾號（從1開始）锈嫩。
3受楼、getDay()：返回星期幾垦搬，星期日為0，星期一為1艳汽，以此類推猴贰。
4、getFullYear()：返回四位的年份河狐。
5米绕、getMonth()：返回月份（0表示1月，11表示12月）馋艺。
6栅干、getHours()：返回小時（0-23）。
7丈钙、getMilliseconds()：返回毫秒（0-999）非驮。
8、getMinutes()：返回分鐘（0-59）雏赦。
9劫笙、getSeconds()：返回秒（0-59）。
10星岗、getTimezoneOffset()：返回當前時間與 UTC 的時區(qū)差異填大，以分鐘表示，返回結果考慮到了夏令時因素俏橘。

• 所有這些get方法返回的都是整數(shù)允华，不同方法返回值的范圍不一樣。
  分鐘和秒：0 到 59
  小時：0 到 23
  星期：0（星期天）到 6（星期六）
  日期：1 到 31
  月份：0（一月）到 11（十二月）

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

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

上面代碼中寥掐，最后一行返回-480靴寂，即 UTC 時間減去當前時間，單位是分鐘召耘。-480表示 UTC 比當前時間少480分鐘百炬，即當前時區(qū)比 UTC 早8個小時。

例子污它，計算本年度還剩下多少天：

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方法返回的都是當前時區(qū)的時間剖踊，Date對象還提供了這些方法對應的 UTC 版本，用來返回 UTC 時間：
getUTCDate()
getUTCFullYear()
getUTCMonth()
getUTCDay()
getUTCHours()
getUTCMinutes()
getUTCSeconds()
getUTCMilliseconds()

set 類方法

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方法，因為星期幾是計算出來的麻裁，而不是設置的

• 需要注意的是箍镜，凡是涉及到設置月份，都是從0開始算的煎源，即0是1月色迂，11是12月。

• set方法的參數(shù)都會自動折算以setDate為例手销，如果參數(shù)超過當月的最大天數(shù)歇僧，則向下一個月順延，如果參數(shù)是負數(shù)锋拖，表示從上個月的最后一天開始減去的天數(shù)诈悍。

• set類方法和get類方法，可以結合使用兽埃，得到相對時間侥钳。

• set系列方法除了setTime()，都有對應的 UTC 版本柄错，即設置 UTC 時區(qū)的時間舷夺。
  setUTCDate()
setUTCFullYear()
setUTCHours()
setUTCMilliseconds()
setUTCMinutes()
setUTCMonth()
setUTCSeconds()