JS Date對(duì)象

Date對(duì)象是 JavaScript 原生的時(shí)間庫(kù)。它以國(guó)際標(biāo)準(zhǔn)時(shí)間（UTC）1970年1月1日00:00:00作為時(shí)間的零點(diǎn)，可以表示的時(shí)間范圍是前后各1億天（單位為毫秒）。

普通函數(shù)的用法

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

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

構(gòu)造函數(shù)的用法

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

var today = new Date();

Date實(shí)例有一個(gè)獨(dú)特的地方。其他對(duì)象求值的時(shí)候，都是默認(rèn)調(diào)用.valueOf()方法，但是Date實(shí)例求值的時(shí)候，默認(rèn)調(diào)用的是toString()方法。這導(dǎo)致對(duì)Date實(shí)例求值，返回的是一個(gè)字符串，代表該實(shí)例對(duì)應(yī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ù)，返回一個(gè)該參數(shù)對(duì)應(yīng)的時(shí)間實(shí)例。

// 參數(shù)為時(shí)間零點(diǎn)開始計(jì)算的毫秒數(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ù)為多個(gè)整數(shù)，
// 代表年、月、日、小時(shí)、分鐘、秒、毫秒
new Date(2013, 0, 1, 0, 0, 0, 0)
// Tue Jan 01 2013 00:00:00 GMT+0800 (CST)

關(guān)于Date構(gòu)造函數(shù)的參數(shù)，有幾點(diǎn)說(shuō)明。

第一點(diǎn)，參數(shù)可以是負(fù)整數(shù)，代表1970年元旦之前的時(shí)間。

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

第二點(diǎn)，只要是能被Date.parse()方法解析的字符串，都可以當(dāng)作參數(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)

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

第三，參數(shù)為年、月、日等多個(gè)整數(shù)時(shí)，年和月是不能省略的，其他參數(shù)都可以省略的。也就是說(shuō)，這時(shí)至少需要兩個(gè)參數(shù)，因?yàn)槿绻皇褂谩澳辍边@一個(gè)參數(shù)，Date會(huì)將其解釋為毫秒數(shù)。

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

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

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)

上面代碼中，不管有幾個(gè)參數(shù)，返回的都是2013年1月1日零點(diǎn)。

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

  • 年：使用四位數(shù)年份，比如2000。如果寫成兩位數(shù)或個(gè)位數(shù)，則加上1900，即10代表1910年。如果是負(fù)數(shù)，表示公元前。
  • 月：0表示一月，依次類推，11表示12月。
  • 日：1到31。
  • 小時(shí)：0到23。
  • 分鐘：0到59。
  • 秒：0到59
  • 毫秒：0到999。

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

這些參數(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)

上面代碼的第二個(gè)例子，日期設(shè)為0，就代表上個(gè)月的最后一天。

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

日期的運(yùn)算

類型自動(dòng)轉(zhuǎn)換時(shí)，Date實(shí)例如果轉(zhuǎn)為數(shù)值，則等于對(duì)應(yīng)的毫秒數(shù)；如果轉(zhuǎn)為字符串，則等于對(duì)應(yīng)的日期字符串。所以，兩個(gè)日期實(shí)例對(duì)象進(jìn)行減法運(yùn)算時(shí)，返回的是它們間隔的毫秒數(shù)；進(jìn)行加法運(yùn)算時(shí)，返回的是兩個(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)"

靜態(tài)方法

Date.now()

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

Date.now() // 1364026285194

Date.parse()

Date.parse方法用來(lái)解析日期字符串，返回該時(shí)間距離時(shí)間零點(diǎn)（1970年1月1日 00:00:00）的毫秒數(shù)。

日期字符串應(yīng)該符合 RFC 2822 和 ISO 8061 這兩個(gè)標(biāo)準(zhǔn)，即YYYY-MM-DDTHH:mm:ss.sssZ格式，其中最后的Z表示時(shí)區(qū)。但是，其他格式也可以被解析，請(qǐng)看下面的例子。

Date.parse('Aug 9, 1995')
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()

Date.UTC方法接受年、月、日等變量作為參數(shù)，返回該時(shí)間距離時(shí)間零點(diǎn)（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ì)算。區(qū)別在于Date.UTC方法的參數(shù)，會(huì)被解釋為 UTC 時(shí)間（世界標(biāo)準(zhǔn)時(shí)間），Date構(gòu)造函數(shù)的參數(shù)會(huì)被解釋為當(dāng)前時(shí)區(qū)的時(shí)間。

實(shí)例方法

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

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

Date.prototype.valueOf()

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

var d = new Date();

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

預(yù)期為數(shù)值的場(chǎng)合，Date實(shí)例會(huì)自動(dòng)調(diào)用該方法，所以可以用下面的方法計(jì)算時(shí)間的間隔。

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

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>toString是默認(rèn)的調(diào)用方法，所以如果直接讀取Date實(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"
3.Date.prototype.toISOString()

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

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

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"
5.Date.prototype.toDateString()**

toDateString方法返回日期字符串（不含小時(shí)、分和秒）。

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.本地時(shí)間

以下三種方法，可以將 Date 實(shí)例轉(zhuǎn)為表示本地時(shí)間的字符串。

  • Date.prototype.toLocaleString()：完整的本地時(shí)間。
  • Date.prototype.toLocaleDateString()：本地日期（不含小時(shí)、分和秒）。
  • Date.prototype.toLocaleTimeString()：本地時(shí)間（不含年月日）。

下面是用法實(shí)例。

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"

這三個(gè)方法都有兩個(gè)可選的參數(shù)。

dateObj.toLocaleString([locales[, options]])
dateObj.toLocaleDateString([locales[, options]])
dateObj.toLocaleTimeString([locales[, options]])

這兩個(gè)參數(shù)中，locales是一個(gè)指定所用語(yǔ)言的字符串，options是一個(gè)配置對(duì)象。下面是locales的例子。

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

d.toLocaleString('en-US') // "1/1/2013, 12:00:00 AM"
d.toLocaleString('zh-CN') // "2013/1/1 上午12:00:00"

d.toLocaleDateString('en-US') // "1/1/2013"
d.toLocaleDateString('zh-CN') // "2013/1/1"

d.toLocaleTimeString('en-US') // "12:00:00 AM"
d.toLocaleTimeString('zh-CN') // "上午12:00:00"

下面是options的例子。

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

// 時(shí)間格式
// 下面的設(shè)置是，星期和月份為完整文字，年份和日期為數(shù)字
d.toLocaleDateString('en-US', {
  weekday: 'long',
  year: 'numeric',
  month: 'long',
  day: 'numeric'
})
// "Tuesday, January 1, 2013"

// 指定時(shí)區(qū)
d.toLocaleTimeString('en-US', {
  timeZone: 'UTC',
  timeZoneName: 'short'
})
// "4:00:00 PM UTC"

d.toLocaleTimeString('en-US', {
  timeZone: 'Asia/Shanghai',
  timeZoneName: 'long'
})
// "12:00:00 AM China Standard Time"

// 小時(shí)周期為12還是24
d.toLocaleTimeString('en-US', {
  hour12: false
})
// "00:00:00"

d.toLocaleTimeString('en-US', {
  hour12: true
})
// "12:00:00 AM"

get 類方法

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

  • getTime()：返回實(shí)例距離1970年1月1日00:00:00的毫秒數(shù)，等同于valueOf方法。
  • getDate()：返回實(shí)例對(duì)象對(duì)應(yīng)每個(gè)月的幾號(hào)（從1開始）。
  • getDay()：返回星期幾，星期日為0，星期一為1，以此類推。
  • 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（十二月）
var d = new Date('January 6, 2013');

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

上面代碼中，最后一行返回-480，即 UTC 時(shí)間減去當(dāng)前時(shí)間，單位是分鐘。-480表示 UTC 比當(dāng)前時(shí)間少480分鐘，即當(dāng)前時(shí)區(qū)比 UTC 早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 版本，用來(lái)返回 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ū)來(lái)說(shuō)是1月6日，所以getDate方法返回6，對(duì)于 UTC 時(shí)區(qū)來(lái)說(shuō)是1月5日，所以getUTCDate方法返回5。

set 類方法

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

  • setDate(date)：設(shè)置實(shí)例對(duì)象對(duì)應(yīng)的每個(gè)月的幾號(hào)（1-31），返回改變后毫秒時(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ì)算出來(lái)的，而不是設(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ù)超過(guò)當(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()，都有對(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)。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • 目錄 介紹：闡述 Date 對(duì)象。 構(gòu)造函數(shù)：介紹 Date 對(duì)象的構(gòu)造函數(shù)new Date()幾種方式。 實(shí)例方...
    站著瞌睡閱讀 7,365評(píng)論 0贊 4
  • 概述 Date對(duì)象是JavaScript提供的日期和時(shí)間的操作接口。它可以表示的時(shí)間范圍是，1970年1月1日00...
    許先生__閱讀 581評(píng)論 0贊 1
  • 抄自http://javascript.ruanyifeng.com/stdlib/date.html概述Date...
    zjh111閱讀 5,289評(píng)論 0贊 2
  • 國(guó)家電網(wǎng)公司企業(yè)標(biāo)準(zhǔn)（Q/GDW）- 面向?qū)ο蟮挠秒娦畔?shù)據(jù)交換協(xié)議 - 報(bào)批稿：20170802 前言： 排版 ...
    庭說(shuō)閱讀 12,332評(píng)論 6贊 13
  • 今天一年級(jí)的同學(xué)上我們班里來(lái)尚彩玲，可因?yàn)樗麄兡抢锏碾娨晧牧?，所以上我們這們班上就留了幾個(gè)矮個(gè)的人在那里也有...
    一班楊特閱讀 565評(píng)論 0贊 1

友情鏈接更多精彩內(nèi)容