DIV CSS 佈局教程網

JavaScript 原生物件:Date 的建構方式與常用方法全解析
編輯:JavaScript綜合知識     

Date 是 JavaScript 中處理時間的核心物件,但它的行為有幾個容易踩雷的地方,尤其是字串解析與時區。本文把建構語法、靜態方法、取值與設值方法,以及格式化輸出一次整理清楚。

四種建立 Date 物件的方式

// 不帶參數,自動以當前日期時間為初始值
new Date();

// value 為毫秒數,代表自 1970/1/1 00:00:00 UTC 起算的數值
new Date(value);

// dateString 為日期字串,格式必須能被 parse 方法辨識
new Date(dateString);

// year 建議使用四位數以避免 2000 年問題,寫 1998 而非 98
// month 從 0(一月)到 11(十二月)
// day 從 1 起算;hour 採 24 小時制,其餘依序為分、秒、毫秒
new Date(year, month, day [, hour, minute, second, millisecond]);

Date():回傳日期時間字串

console.log(Date());
// "Tue Sep 17 2013 12:22:55 GMT+0800 (中國標準時間)"

parse():字串轉毫秒數

解析日期時間字串,回傳該時刻距 1970/1/1 午夜的毫秒數。注意它是 Date 的靜態方法,應該用 Date.parse() 呼叫,而非透過物件實例。

console.log(Date.parse(Date()));      // 1379392301000
console.log(Date.parse("Aug 9, 1995"));// 807897600000

UTC():以世界時計算毫秒數

Date.UTC(year, month, day, hours, minutes, seconds, ms)

year 與 month 必填(month 介於 0~11),其餘選填:day 為 1~31,hours 為 0~23,minutes 與 seconds 為 0~59,ms 為 0~999。這同樣是靜態方法,所有參數都以 UTC(GMT 時區)解讀,轉出的毫秒值可直接餵給 Date 建構函數或 setTime()。

ECMAScript 的 Date 型別建立在早期 Java 的 java.util.Date 之上,因此它以 UTC 1970 年 1 月 1 日零時起算的毫秒數來保存日期,精度足以覆蓋前後約 285616 年。

parse() 與 UTC() 的關鍵差別:parse() 依本地時區建立,UTC() 依 GMT 建立,兩者的參數形式也不同。

var d = new Date();
console.log(Date.parse(d));
// 1379393562000
console.log(Date.UTC(d.getFullYear(), d.getMonth(), d.getDate(),
  d.getHours(), d.getMinutes(), d.getSeconds(), d.getMilliseconds()));
// 1379422362020

Date.now()

ECMAScript 5 加入的方法,直接回傳呼叫當下的毫秒數,IE9 才開始支援。若想向下相容,可以用一元加號把 Date 物件轉為數值達到相同效果。

var d1 = Date.now();
var d2 = + new Date();
console.log(d1); // 1379393793104
console.log(d2); // 1379393793104

日期字串解析的雷區

JavaScript 的日期轉換出了名地古怪:參數寫法不同,解釋結果就不同,而且各瀏覽器表現還不一致。

var d1 = new Date("2012/03/13");
var d2 = new Date("2012-03-13");
var d3 = new Date("2012-3-13");

console.log(d1); // Tue Mar 13 2012 00:00:00 GMT+0800
console.log(d2); // Tue Mar 13 2012 08:00:00 GMT+0800
console.log(d3); // Tue Mar 13 2012 00:00:00 GMT+0800

注意 d2 的時數多了 8 小時——帶連字號的格式會被當成 UTC 解讀。各瀏覽器的差異可參考 https://dygraphs.com/date-formats.html 。為了避開這些坑,建議:

1. 堅持使用「YYYY/MM/DD」格式的日期字串。
2. 避免使用帶連字號的「YYYY-MM-DD」。
3. 年份務必寫滿四位數。
4. Chrome 能接受的日期字串範圍比其他瀏覽器寬鬆得多,所以在 Chrome 跑起來沒問題,不代表其他瀏覽器也没問題。

get 系列:取值方法

getDate() 取月份中的第幾天(1~31);getDay() 取星期幾(0~6);getMonth() 取月份(0~11);getFullYear() 以四位數取年份,請勿使用 getYear();getHours()(0~23)、getMinutes()(0~59)、getSeconds()(0~59)、getMilliseconds()(0~999);getTime() 回傳 1970/1/1 至今的毫秒數;getTimezoneOffset() 回傳本地時間與 GMT 的分鐘差。

對應的世界時版本為 getUTCDate()、getUTCDay()、getUTCMonth()、getUTCFullYear()、getUTCHours()、getUTCMinutes()、getUTCSeconds()、getUTCMilliseconds()。

set 系列:設值方法

setDate()、setMonth()、setFullYear()(請勿使用 setYear())、setHours()、setMinutes()、setSeconds()、setMilliseconds(),以及以毫秒為單位的 setTime()。世界時版本依序為 setUTCDate()、setUTCMonth()、setUTCFullYear()、setUTCHours()、setUTCMinutes()、setUTCSeconds()、setUTCMilliseconds()。

toString 系列:格式化輸出

var d = new Date();

console.log(d);                    // Tue Sep 17 2013 13:37:04 GMT+0800 (中國標準時間)
console.log(d.toString());         // 同上
console.log(d.toTimeString());     // 13:37:04 GMT+0800 (中國標準時間)
console.log(d.toDateString());     // Tue Sep 17 2013
console.log(d.toUTCString());      // Tue, 17 Sep 2013 05:37:04 GMT
console.log(d.toLocaleString());   // 2013年9月17日 下午1:37:04
console.log(d.toLocaleTimeString());// 下午1:37:04
console.log(d.toLocaleDateString());// 2013年9月17日

其中 toString() 固定輸出美式英語格式的字串;toLocaleString() 系列可接收參數指定輸出習慣(詳見 MDN):

var d = new Date();
console.log(d.toLocaleString("ko-KR")); // 2013년 9월 17일 오후 1:48:24

掌握這些方法之後,處理日期時最關鍵的習慣其實只有一條:盡量避開字串建構,改用 year、month、day 的數值參數,或統一走時間戳,就能省下大量跨瀏覽器除錯的時間。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved