Date對象(ES5)

抄自http://javascript.ruanyifeng.com/stdlib/date.html
概述
Date對象是JavaScript提供的日期和時間的操作接口。它可以表示的時間范圍是,1970年1月1日00:00:00前后的各1億天(單位為毫秒)。
實時時間

function getLangDate(){
            var dateObj = new Date();             //表示當前系統時間的Date對象 
            var year = dateObj.getFullYear();           //當前系統時間的完整年份值
            var month = dateObj.getMonth()+1;       //當前系統時間的月份值 
            var date = dateObj.getDate();         //當前系統時間的月份中的日
            var day = dateObj.getDay();    //當前系統時間中的星期值
            var weeks = ["星期日","星期一","星期二","星期三","星期四","星期五","星期六"];
            var week = weeks[day];         //根據星期值,從數組中獲取對應的星期字符串 
            var hour = dateObj.getHours();              //當前系統時間的小時值 
            var minute = dateObj.getMinutes(); //當前系統時間的分鐘值
            var second = dateObj.getSeconds();       //當前系統時間的秒鐘值
            //如果月、日、小時、分、秒的值小于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秒重新調用一次該函數 
}    

Date對象可以作為普通函數直接調用,返回一個代表當前時間的字符串。

Date()
// "Tue Dec 01 2015 09:34:43 GMT+0800 (CST)"
//注意,即使帶有參數,Date作為普通函數使用時,返回的還是當前時間。

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

上面代碼說明,無論有沒有參數,直接調用Date總是返回當前時間。

new Date()

Date還可以當作構造函數使用。對它使用new命令,會返回一個Date對象的實例。如果不加參數,生成的就是代表當前時間的對象。

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

作為構造函數時,Date對象可以接受多種格式的參數。

(1)new Date(milliseconds)

Date對象接受從1970年1月1日00:00:00 UTC開始計算的毫秒數作為參數。這意味著如果將Unix時間戳(單位為秒)作為參數,必須將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構造函數的參數可以是一個負數,表示1970年1月1日之前的時間。

(2)new Date(datestring)

Date對象還接受一個日期字符串作為參數,返回所對應的時間。

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”。如果省略了小時、分鐘或秒數,這些值會被設為0。

但是,其他格式的日期字符串,也可以被解析。事實上,所有可以被Date.parse()方法解析的日期字符串,都可以當作Date對象的參數。

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時區計算的。

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,返回的結果是不一樣的。如果沒有前導0,JavaScript引擎假設用戶處于本地時區,所以本例返回0點0分。如果有前導0(即如果你以ISO格式表示日期),就假設用戶處于格林尼治國際標準時的時區,所以返回8點0分。但是,ES6改變了這種做法,規定凡是沒有指定時區的日期字符串,一律認定用戶處于本地時區。

總之,對于YYYY-MM-DD形式的字符串,JavaScript引擎可能會將其當作ISO格式來解析,采用格林尼治時區作為計時標準;而對于其他格式的日期字符串,一律視為非ISO格式,采用本地時區作為計時標準。

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對象還可以接受多個整數作為參數,
依次表示年、月、日、小時、分鐘、秒和毫秒。
如果采用這種格式,最少需要提供兩個參數(年和月)。

其他參數都是可選的,默認等于0。
因為如果只使用“年”這一個參數,Date對象會將其解釋為毫秒數。

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

上面代碼中,2013被解釋為毫秒數,而不是年份。

各個參數的取值范圍如下。

year:四位年份,如果寫成兩位數,則加上1900
month:表示月份,0表示一月,11表示12月
date:表示日期,1到31

hour:表示小時,0到23
minute:表示分鐘,0到59
second:表示秒鐘,0到59
ms:表示毫秒,0到999
注意,月份從0開始計算,但是,天數從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日零點的時間。

這些參數如果超出了正常范圍,會被自動折算。比如,如果月設為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)
參數還可以使用負數,表示扣去的時間。

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)

上面代碼分別對月和日使用了負數,表示從基準日扣去相應的時間。

年份如果是0到99,會自動加上1900。比如,0表示1900年,1表示1901年;如果為負數,則表示公元前。

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)

日期的運算

類型轉換時,Date對象的實例如果轉為數值,則等于對應的毫秒數;
如果轉為字符串,則等于對應的日期字符串。所以,
兩個日期對象進行減法運算,返回的就是它們間隔的毫秒數;
進行加法運算,返回的就是連接后的兩個字符串。

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對象的靜態方法

Date.now()

Date.now方法返回當前距離1970年1月1日 00:00:00 UTC的毫秒數(Unix時間戳乘以1000)。

Date.now() // 1364026285194

如果需要比毫秒更精確的時間,可以使用window.performance.now()。它提供頁面加載到命令運行時的已經過去的時間,可以精確到千分之一毫秒。

window.performance.now() // 21311140.415

Date.parse()

Date.parse方法用來解析日期字符串,返回距離1970年1月1日 00:00:00的毫秒數。

標準的日期字符串的格式,應該完全或者部分符合RFC 2822和ISO 8061,即YYYY-MM-DDTHH:mm:ss.sssZ格式,其中最后的Z表示時區。但是,其他格式也可以被解析,請看下面的例子。

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對象返回的都是當前時區的時間。Date.UTC方法可以返回UTC時間(世界標準時間)。該方法接受年、月、日等變量作為參數,返回當前距離1970年1月1日 00:00:00 UTC的毫秒數。

// 格式
Date.UTC(year, month[, date[, hrs[, min[, sec[, ms]]]]])

// 用法
Date.UTC(2011, 0, 1, 2, 3, 4, 567)
// 1293847384567

該方法的參數用法與Date構造函數完全一致,比如月從0開始計算,日期從1開始計算。

Date實例對象的方法

Date的實例對象,有幾十個自己的方法,分為以下三類。

to類:從Date對象返回一個字符串,表示指定的時間。
get類:獲取Date對象的日期和時間。
set類:設置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是默認的調用方法,所以如果直接讀取Date對象實例,就相當于調用這個方法。

(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時區的時間。

(4)Date.prototype.toJSON()

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

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方法返回一個字符串,代表日期的當地寫法。

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

d.toLocaleDateString()
// 中文版瀏覽器為"2013年1月1日"
// 英文版瀏覽器為"1/1/2013"

(8)Date.prototype.toLocaleTimeString()

toLocaleTimeString方法返回一個字符串,代表時間的當地寫法。

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的毫秒數,等同于valueOf方法。
getDate():返回實例對象對應每個月的幾號(從1開始)。
getDay():返回星期幾,星期日為0,星期一為1,以此類推。
getYear():返回距離1900的年數。
getFullYear():返回四位的年份。
getMonth():返回月份(0表示1月,11表示12月)。
getHours():返回小時(0-23)。
getMilliseconds():返回毫秒(0-999)。
getMinutes():返回分鐘(0-59)。
getSeconds():返回秒(0-59)。
getTimezoneOffset():返回當前時間與UTC的時區差異,以分鐘表示,返回結果考慮到了夏令時因素。
所有這些get*方法返回的都是整數,不同方法返回值的范圍不一樣。
分鐘和秒:0 到 59
小時:0 到 23
星期:0(星期天)到 6(星期六)
日期:1 到 31
月份:0(一月)到 11(十二月)
年份:距離1900年的年數

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

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

上面這些get*方法返回的都是當前時區的時間,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表示當前時區(東八時區)的1月6日0點0分0秒,這個時間對于當前時區來說是1月6日,所以getDate方法返回6,對于UTC時區來說是1月5日,所以getUTCDate方法返回5。

set類方法

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

setDate(date):設置實例對象對應的每個月的幾號(1-31),返回改變后毫秒時間戳。
setYear(year): 設置距離1900年的年數。
setFullYear(year [, month, date]):設置四位年份。
setHours(hour [, min, sec, ms]):設置小時(0-23)。
setMilliseconds():設置毫秒(0-999)。
setMinutes(min [, sec, ms]):設置分鐘(0-59)。
setMonth(month [, date]):設置月份(0-11)。
setSeconds(sec [, ms]):設置秒(0-59)。
setTime(milliseconds):設置毫秒時間戳。
這些方法基本是跟get方法一一對應的,但是沒有setDay方法,因為星期幾是計算出來的,而不是設置的。另外,需要注意的是,凡是涉及到設置月份,都是從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*方法的參數都會自動折算。以setDate為例,如果參數超過當月的最大天數,則向下一個月順延,如果參數是負數,表示從上個月的最后一天開始減去的天數。

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類方法,可以結合使用,得到相對時間。

var d = new Date();

// 將日期向后推1000天
d.setDate( d.getDate() + 1000 );

// 將時間設為6小時后
d.setHours(d.getHours() + 6);

// 將年份設為去年
d.setFullYear(d.getFullYear() - 1);

set*系列方法除了setTime()和setYear(),都有對應的UTC版本,即設置UTC時區的時間。

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)

上面代碼中,本地時區(東八時區)的1月6日0點0分,是UTC時區的前一天下午16點。設為UTC時區的22點以后,就變為本地時區的上午6點。

Date.prototype.valueOf()

valueOf方法返回實例對象距離1970年1月1日00:00:00 UTC對應的毫秒數,該方法等同于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();
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,363評論 6 532
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,497評論 3 416
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事?!?“怎么了?”我有些...
    開封第一講書人閱讀 176,305評論 0 374
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,962評論 1 311
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,727評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,193評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,257評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,411評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,945評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,777評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,978評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,519評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,216評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,642評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,878評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,657評論 3 391
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,960評論 2 373

推薦閱讀更多精彩內容

  • 國家電網公司企業標準(Q/GDW)- 面向對象的用電信息數據交換協議 - 報批稿:20170802 前言: 排版 ...
    庭說閱讀 11,049評論 6 13
  • 第5章 引用類型(返回首頁) 本章內容 使用對象 創建并操作數組 理解基本的JavaScript類型 使用基本類型...
    大學一百閱讀 3,261評論 0 4
  • 1. 概念 Date對象是JavaScript提供的日期和時間的操作接口。它可以表示的時間范圍是,1970年1月1...
    plainnany閱讀 1,963評論 0 1
  • 兩個基礎知識: JavaScript內的時間戳指的是當前時間到1970年1月1日00:00:00 UTC對應的毫秒...
    Sketch閱讀 730評論 0 0
  • 瑞彩容光燦,心誠美意深。 詩書軒氣宇,飽滿見精神。
    不惑而歌閱讀 388評論 14 20