閱讀(772) 書簽贊(0) 我要糾錯

JavaScript Date 對象

2023-03-20 15:52 更新

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

普通函數(shù)的用法

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

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

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

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

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

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

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

var today = new Date();

Date實例有一個獨特的地方。其他對象求值的時候，都是默認調(diào)用.valueOf()方法，但是Date實例求值的時候，默認調(diào)用的是toString()方法。這導(dǎo)致對Date實例求值，返回的是一個字符串，代表該實例對應(yīng)的時間。

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方法。

作為構(gòu)造函數(shù)時，Date對象可以接受多種格式的參數(shù)，返回一個該參數(shù)對應(yīng)的時間實例。

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

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

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

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

第二點，只要是能被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)

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

第三，參數(shù)為年、月、日等多個整數(shù)時，年和月是不能省略的，其他參數(shù)都可以省略的。也就是說，這時至少需要兩個參數(shù)，因為如果只使用“年”這一個參數(shù)，Date會將其解釋為毫秒數(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)

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

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

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

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

這些參數(shù)如果超出了正常范圍，會被自動折算。比如，如果月設(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è)為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ù)，表示從基準日扣去相應(yīng)的時間。

日期的運算

類型自動轉(zhuǎn)換時，Date實例如果轉(zhuǎn)為數(shù)值，則等于對應(yīng)的毫秒數(shù)；如果轉(zhuǎn)為字符串，則等于對應(yīng)的日期字符串。所以，兩個日期實例對象進行減法運算時，返回的是它們間隔的毫秒數(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方法返回當(dāng)前時間距離時間零點（1970年1月1日 00:00:00 UTC）的毫秒數(shù)，相當(dāng)于 Unix 時間戳乘以1000。

Date.now() // 1364026285194

Date.parse()

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

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

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ù)，返回該時間距離時間零點（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開始計算，日期從1開始計算。區(qū)別在于Date.UTC方法的參數(shù)，會被解釋為 UTC 時間（世界標準時間），Date構(gòu)造函數(shù)的參數(shù)會被解釋為當(dāng)前時區(qū)的時間。

實例方法

Date的實例對象，有幾十個自己的方法，除了valueOf和toString，可以分為以下三類。

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

Date.prototype.valueOf()

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

var d = new Date();

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

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

to 類方法

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

因為toString是默認的調(diào)用方法，所以如果直接讀取Date實例，就相當(dāng)于調(diào)用這個方法。

（2）Date.prototype.toUTCString()

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

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

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

（3）Date.prototype.toISOString()

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

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

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

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

（4）Date.prototype.toJSON()

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

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

d.toJSON()
// "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方法返回時間字符串（不含年月日）。

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

（7）本地時間

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

Date.prototype.toLocaleString()：完整的本地時間。
Date.prototype.toLocaleDateString()：本地日期（不含小時、分和秒）。
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"

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

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

這兩個參數(shù)中，locales是一個指定所用語言的字符串，options是一個配置對象。下面是locales的例子，分別采用en-US和zh-CN語言設(shè)定。

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配置對象有以下屬性。

dateStyle：可能的值為full、long、medium、short。
timeStyle：可能的值為full、long、medium、short。
month：可能的值為numeric、2-digit、long、short、narrow。
year：可能的值為numeric、2-digit。
weekday：可能的值為long、short、narrow。
day、hour、minute、second：可能的值為numeric、2-digit。
timeZone：可能的值為 IANA 的時區(qū)數(shù)據(jù)庫。
timeZoneName：可能的值為long、short。
hour12：24小時周期還是12小時周期，可能的值為true、false。

下面是用法實例。

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

d.toLocaleDateString('en-US', {
  weekday: 'long',
  year: 'numeric',
  month: 'long',
  day: 'numeric'
})
// "Tuesday, January 1, 2013"

d.toLocaleDateString('en-US', {
  day: "2-digit",
  month: "long",
  year: "2-digit"
});
// "January 01, 13"

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"

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

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

get 類方法

Date對象提供了一系列get*方法，用來獲取實例對象某個方面的值。

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

所有這些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 時間減去當(dāng)前時間，單位是分鐘。-480表示 UTC 比當(dāng)前時間少480分鐘，即當(dāng)前時區(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*方法返回的都是當(dāng)前時區(qū)的時間，Date對象還提供了這些方法對應(yīng)的 UTC 版本，用來返回 UTC 時間。

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

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

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

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

set 類方法

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

setDate(date)：設(shè)置實例對象對應(yīng)的每個月的幾號（1-31），返回改變后毫秒時間戳。
setFullYear(year [, month, date])：設(shè)置四位年份。
setHours(hour [, min, sec, ms])：設(shè)置小時（0-23）。
setMilliseconds(ms)：設(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è)置毫秒時間戳。

這些方法基本是跟get*方法一一對應(yīng)的，但是沒有setDay方法，因為星期幾是計算出來的，而不是設(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ù)都會自動折算。以setDate()為例，如果參數(shù)超過當(dāng)月的最大天數(shù)，則向下一個月順延，如果參數(shù)是負數(shù)，表示從上個月的最后一天開始減去的天數(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');

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

上面代碼中，d1.setDate(32)將日期設(shè)為1月份的32號，因為1月份只有31號，所以自動折算為2月1日。d2.setDate(-1)表示設(shè)為上個月的倒數(shù)第二天，即12月30日。

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

var d = new Date();

// 將日期向后推1000天
d.setDate(d.getDate() + 1000);
// 將時間設(shè)為6小時后
d.setHours(d.getHours() + 6);
// 將年份設(shè)為去年
d.setFullYear(d.getFullYear() - 1);

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

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)

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

參考鏈接

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

以上內(nèi)容是否對您有幫助：

← JavaScript Math 對象

JavaScript RegExp 對象 →

寫筆記

我要補充