概述
Date
對象是JavaScript提供的日期和時間的操作接口狈醉。它可以表示的時間范圍是殉了,1970年1月1日00:00:00前后的各1億天(單位為毫秒)。
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)前時間券坞。
new Date()
Date
還可以當(dāng)作構(gòu)造函數(shù)使用鬓催。對它使用new
命令,會返回一個Date
對象的實例恨锚。如果不加參數(shù)宇驾,生成的就是代表當(dāng)前時間的對象。
var today = new Date();
這個Date
實例對應(yīng)的字符串值猴伶,就是當(dā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)"
作為構(gòu)造函數(shù)時,Date
對象可以接受多種格式的參數(shù)他挎。
(1)new Date(milliseconds)
Date
對象接受從1970年1月1日00:00:00 UTC開始計算的毫秒數(shù)作為參數(shù)筝尾。這意味著如果將Unix時間戳(單位為秒)作為參數(shù),必須將Unix時間戳乘以1000办桨。
new Date(1378218728000)
// Tue Sep 03 2013 22:32:08 GMT+0800 (CST)
// 1970年1月2日的零時
var Jan02_1970 = new Date(3600 * 24 * 1000);
// Fri Jan 02 1970 08:00:00 GMT+0800 (CST)
// 1969年12月31日的零時
var Dec31_1969 = new Date(-3600 * 24 * 1000);
// Wed Dec 31 1969 08:00:00 GMT+0800 (CST)
上面最后一個例子說明筹淫,Date構(gòu)造函數(shù)的參數(shù)可以是一個負(fù)數(shù),表示1970年1月1日之前的時間呢撞。
(2)new Date(datestring)
Date對象還接受一個日期字符串作為參數(shù)损姜,返回所對應(yīng)的時間。
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è)為0棒卷。
但是,其他格式的日期字符串瘸右,也可以被解析娇跟。事實上岩齿,所有可以被Date.parse()
方法解析的日期字符串太颤,都可以當(dāng)作Date
對象的參數(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)
上面多種日期字符串的寫法盹沈,返回的都是同一個時間龄章。
注意吃谣,在ES5之中,如果日期采用連詞線(-
)格式分隔做裙,且具有前導(dǎo)0岗憋,JavaScript會認(rèn)為這是一個ISO格式的日期字符串,導(dǎo)致返回的時間是以UTC時區(qū)計算的锚贱。
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è)用戶處于本地時區(qū),所以本例返回0點0分吧碾。如果有前導(dǎo)0(即如果你以ISO格式表示日期)凰盔,就假設(shè)用戶處于格林尼治國際標(biāo)準(zhǔn)時的時區(qū),所以返回8點0分倦春。但是户敬,ES6改變了這種做法,規(guī)定凡是沒有指定時區(qū)的日期字符串睁本,一律認(rèn)定用戶處于本地時區(qū)尿庐。
總之,對于YYYY-MM-DD
形式的字符串呢堰,JavaScript引擎可能會將其當(dāng)作ISO格式來解析屁倔,采用格林尼治時區(qū)作為計時標(biāo)準(zhǔn);而對于其他格式的日期字符串暮胧,一律視為非ISO格式锐借,采用本地時區(qū)作為計時標(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)
上面代碼中往衷,第一個日期字符串是ISO格式钞翔,第二個不是,導(dǎo)致生成的時間不一樣席舍。
(3)new Date(year, month [, day, hours, minutes, seconds, ms])
Date對象還可以接受多個整數(shù)作為參數(shù)布轿,依次表示年、月来颤、日汰扭、小時、分鐘福铅、秒和毫秒萝毛。如果采用這種格式,最少需要提供兩個參數(shù)(年和月)滑黔,其他參數(shù)都是可選的笆包,默認(rèn)等于0环揽。因為如果只使用“年”這一個參數(shù),Date對象會將其解釋為毫秒數(shù)庵佣。
new Date(2013)
// Thu Jan 01 1970 08:00:02 GMT+0800 (CST)
上面代碼中歉胶,2013被解釋為毫秒數(shù),而不是年份巴粪。
各個參數(shù)的取值范圍如下通今。
- year:四位年份,如果寫成兩位數(shù)肛根,則加上1900
- month:表示月份衡创,0表示一月,11表示12月
- date:表示日期晶通,1到31
- hour:表示小時璃氢,0到23
- minute:表示分鐘,0到59
- second:表示秒鐘狮辽,0到59
- ms:表示毫秒一也,0到999
注意,月份從0開始計算喉脖,但是椰苟,天數(shù)從1開始計算。另外树叽,除了日期默認(rèn)為1舆蝴,小時、分鐘题诵、秒鐘和毫秒默認(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日零點的時間。
這些參數(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ù)還可以使用負(fù)數(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)
上面代碼分別對月和日使用了負(fù)數(shù)哩俭,表示從基準(zhǔn)日扣去相應(yīng)的時間。
年份如果是0到99拳恋,會自動加上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)
日期的運(yùn)算
類型轉(zhuǎn)換時鸳谜,Date對象的實例如果轉(zhuǎn)為數(shù)值,則等于對應(yīng)的毫秒數(shù)式廷;如果轉(zhuǎn)為字符串咐扭,則等于對應(yīng)的日期字符串。所以滑废,兩個日期對象進(jìn)行減法運(yùn)算蝗肪,返回的就是它們間隔的毫秒數(shù);進(jìn)行加法運(yùn)算蠕趁,返回的就是連接后的兩個字符串薛闪。
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對象的靜態(tài)方法
Date.now()
Date.now
方法返回當(dāng)前距離1970年1月1日 00:00:00 UTC的毫秒數(shù)(Unix時間戳乘以1000)。
Date.now() // 1364026285194
如果需要比毫秒更精確的時間俺陋,可以使用window.performance.now()
豁延。它提供頁面加載到命令運(yùn)行時的已經(jīng)過去的時間,可以精確到千分之一毫秒腊状。
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
表示時區(qū)映屋。但是苟鸯,其他格式也可以被解析,請看下面的例子棚点。
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對象返回的都是當(dāng)前時區(qū)的時間。Date.UTC
方法可以返回UTC時間(世界標(biāo)準(zhǔn)時間)颁股。該方法接受年么库、月、日等變量作為參數(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開始計算亏掀,日期從1開始計算忱反。
Date實例對象的方法
Date
的實例對象泛释,有幾十個自己的方法,分為以下三類温算。
-
to
類:從Date
對象返回一個字符串怜校,表示指定的時間。 -
get
類:獲取Date
對象的日期和時間注竿。 -
set
類:設(shè)置Date
對象的日期和時間茄茁。
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
是默認(rèn)的調(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"
d.toString()
// "Tue Jan 01 2013 00:00:00 GMT+0800 (CST)"
(3)Date.prototype.toISOString()
toISOString
方法返回對應(yīng)時間的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時區(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"
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
方法返回時間字符串。
var d = new Date(2013, 0, 1);
d.toTimeString() // "00:00:00 GMT+0800 (CST)"
(7)Date.prototype.toLocaleDateString()
toLocaleDateString
方法返回一個字符串酸钦,代表日期的當(dāng)?shù)貙懛ā?/p>
var d = new Date(2013, 0, 1);
d.toLocaleDateString()
// 中文版瀏覽器為"2013年1月1日"
// 英文版瀏覽器為"1/1/2013"
(8)Date.prototype.toLocaleTimeString()
toLocaleTimeString
方法返回一個字符串怪得,代表時間的當(dāng)?shù)貙懛ā?/p>
var d = new Date(2013, 0, 1);
d.toLocaleTimeString()
// 中文版瀏覽器為"上午12:00:00"
// 英文版瀏覽器為"12:00:00 AM"
get類方法
Date對象提供了一系列get*
方法,用來獲取實例對象某個方面的值卑硫。
-
getTime()
:返回距離1970年1月1日00:00:00的毫秒數(shù)徒恋,等同于valueOf
方法。 -
getDate()
:返回實例對象對應(yīng)每個月的幾號(從1開始)入挣。 -
getDay()
:返回星期幾,星期日為0滋恬,星期一為1,以此類推勋磕。 -
getYear()
:返回距離1900的年數(shù)。 -
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(十二月)
- 年份:距離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)前時間筝蚕,單位是分鐘蔗坯。-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)富拗,返回改變后毫秒時間戳。 -
setYear(year)
: 設(shè)置距離1900年的年數(shù)鸣戴。 -
setFullYear(year [, month, date])
:設(shè)置四位年份啃沪。 -
setHours(hour [, min, sec, ms])
:設(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è)置毫秒時間戳追驴。
這些方法基本是跟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ù)是負(fù)數(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');
d.setDate(-1) // 1356796800000
d // Sun Dec 30 2012 00:00:00 GMT+0800 (CST)
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()
和setYear()
,都有對應(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點纽乱。
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
該方法可以用于計算精確時間迫淹。
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