抄自http://javascript.ruanyifeng.com/stdlib/date.html
概述
Date對象是JavaScript提供的日期和時間的操作接口。它可以表示的時間范圍是鼓拧,1970年1月1日00:00:00前后的各1億天(單位為毫秒)甘邀。
實時時間
function getLangDate(){
var dateObj = new Date(); //表示當前系統(tǒng)時間的Date對象
var year = dateObj.getFullYear(); //當前系統(tǒng)時間的完整年份值
var month = dateObj.getMonth()+1; //當前系統(tǒng)時間的月份值
var date = dateObj.getDate(); //當前系統(tǒng)時間的月份中的日
var day = dateObj.getDay(); //當前系統(tǒng)時間中的星期值
var weeks = ["星期日","星期一","星期二","星期三","星期四","星期五","星期六"];
var week = weeks[day]; //根據(jù)星期值受啥,從數(shù)組中獲取對應的星期字符串
var hour = dateObj.getHours(); //當前系統(tǒng)時間的小時值
var minute = dateObj.getMinutes(); //當前系統(tǒng)時間的分鐘值
var second = dateObj.getSeconds(); //當前系統(tǒng)時間的秒鐘值
//如果月注暗、日季眷、小時冕臭、分腺晾、秒的值小于10,在前面補0
if(month<10){
month = "0"+month;
}
if(date<10){
date = "0"+date;
}
if(hour<10){
hour = "0"+hour;
}
if(minute<10){
minute = "0"+minute;
}
if(second<10){
second = "0"+second;
}
var newDate = year+"年"+month+"月"+date+"日 "+week+" "+hour+":"+minute+":"+second;
setTimeout("getLangDate()",1000);//每隔1秒重新調(diào)用一次該函數(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總是返回當前時間。
new Date()
Date還可以當作構(gòu)造函數(shù)使用窟感。對它使用new命令讨彼,會返回一個Date對象的實例。如果不加參數(shù)柿祈,生成的就是代表當前時間的對象哈误。
var today = new Date();
這個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)"
作為構(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ù)可以是一個負數(shù)戈鲁,表示1970年1月1日之前的時間仇参。
(2)new Date(datestring)
Date對象還接受一個日期字符串作為參數(shù),返回所對應的時間婆殿。
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()方法解析的日期字符串滩届,都可以當作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之中浓体,如果日期采用連詞線(-)格式分隔泡挺,且具有前導0,JavaScript會認為這是一個ISO格式的日期字符串命浴,導致返回的時間是以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)
上面代碼中,日期字符串有沒有前導0生闲,返回的結(jié)果是不一樣的媳溺。如果沒有前導0,JavaScript引擎假設(shè)用戶處于本地時區(qū)碍讯,所以本例返回0點0分悬蔽。如果有前導0(即如果你以ISO格式表示日期),就假設(shè)用戶處于格林尼治國際標準時的時區(qū)捉兴,所以返回8點0分蝎困。但是,ES6改變了這種做法倍啥,規(guī)定凡是沒有指定時區(qū)的日期字符串禾乘,一律認定用戶處于本地時區(qū)。
總之逗栽,對于YYYY-MM-DD形式的字符串,JavaScript引擎可能會將其當作ISO格式來解析失暂,采用格林尼治時區(qū)作為計時標準彼宠;而對于其他格式的日期字符串鳄虱,一律視為非ISO格式,采用本地時區(qū)作為計時標準凭峡。
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格式,第二個不是摧冀,導致生成的時間不一樣倍踪。
(3)new Date(year, month [, day, hours, minutes, seconds, ms])
Date對象還可以接受多個整數(shù)作為參數(shù),
依次表示年索昂、月建车、日、小時椒惨、分鐘缤至、秒和毫秒。
如果采用這種格式康谆,最少需要提供兩個參數(shù)(年和月)领斥。
其他參數(shù)都是可選的,默認等于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開始計算受葛。另外,除了日期默認為1,小時总滩、分鐘纲堵、秒鐘和毫秒默認都是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ù)還可以使用負數(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ù),表示從基準日扣去相應的時間咽筋。
年份如果是0到99溶推,會自動加上1900。比如奸攻,0表示1900年蒜危,1表示1901年;如果為負數(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)
日期的運算
類型轉(zhuǎn)換時,Date對象的實例如果轉(zhuǎn)為數(shù)值硝训,則等于對應的毫秒數(shù)响委;
如果轉(zhuǎn)為字符串,則等于對應的日期字符串窖梁。所以赘风,
兩個日期對象進行減法運算,返回的就是它們間隔的毫秒數(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)"
減法可以用來求時間假哎。
Date對象的靜態(tài)方法
Date.now()
Date.now方法返回當前距離1970年1月1日 00:00:00 UTC的毫秒數(shù)(Unix時間戳乘以1000)瞬捕。
Date.now() // 1364026285194
如果需要比毫秒更精確的時間,可以使用window.performance.now()舵抹。它提供頁面加載到命令運行時的已經(jīng)過去的時間肪虎,可以精確到千分之一毫秒。
window.performance.now() // 21311140.415
Date.parse()
Date.parse方法用來解析日期字符串惧蛹,返回距離1970年1月1日 00:00:00的毫秒數(shù)扇救。
標準的日期字符串的格式刑枝,應該完全或者部分符合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()
默認情況下,Date對象返回的都是當前時區(qū)的時間苫费。Date.UTC方法可以返回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開始計算。
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是默認的調(diào)用方法,所以如果直接讀取Date對象實例底靠,就相當于調(diào)用這個方法害晦。
(2)Date.prototype.toUTCString()
toUTCString方法返回對應的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方法返回對應時間的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方法返回一個字符串,代表日期的當?shù)貙懛ā?/p>
var d = new Date(2013, 0, 1);
d.toLocaleDateString()
// 中文版瀏覽器為"2013年1月1日"
// 英文版瀏覽器為"1/1/2013"
(8)Date.prototype.toLocaleTimeString()
toLocaleTimeString方法返回一個字符串的止,代表時間的當?shù)貙懛ā?
var d = new Date(2013, 0, 1);
d.toLocaleTimeString()
// 中文版瀏覽器為"上午12:00:00"
// 英文版瀏覽器為"12:00:00 AM"
get類方法
Date對象提供了一系列g(shù)et*方法,用來獲取實例對象某個方面的值层坠。
getTime():返回距離1970年1月1日00:00:00的毫秒數(shù)辐宾,等同于valueOf方法。
getDate():返回實例對象對應每個月的幾號(從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():返回當前時間與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
上面這些get*方法返回的都是當前時區(qū)的時間馆衔,Date對象還提供了這些方法對應的UTC版本瘟判,用來返回UTC時間。
getUTCDate()
getUTCFullYear()
getUTCMonth()
getUTCDay()
getUTCHours()
getUTCMinutes()
getUTCSeconds()
getUTCMilliseconds()
var d = new Date('January 6, 2013');
d.getDate() // 6
d.getUTCDate() // 5
上面代碼中角溃,實例對象d表示當前時區(qū)(東八時區(qū))的1月6日0點0分0秒拷获,這個時間對于當前時區(qū)來說是1月6日,所以getDate方法返回6减细,對于UTC時區(qū)來說是1月5日匆瓜,所以getUTCDate方法返回5。
set類方法
Date對象提供了一系列set*方法未蝌,用來設(shè)置實例對象的各個方面驮吱。
setDate(date):設(shè)置實例對象對應的每個月的幾號(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方法一一對應的,但是沒有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ù)超過當月的最大天數(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');
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()瓢湃,都有對應的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對應的毫秒數(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();