Date
對(duì)象是 JavaScript 原生的時(shí)間庫愧哟。它以國際標(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)"
上面代碼說明序攘,無論有沒有參數(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)說明舶斧。
第一點(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ù)都可以省略的友瘤。也就是說翠肘,這時(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
方法用來解析日期字符串,返回該時(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ù)值的場合跋涣,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è)指定所用語言的字符串,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*
方法,用來獲取實(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 版本,用來返回 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í)間戳汰瘫。 -
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()
溺职,都有對(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)痛倚。