DIV CSS 佈局教程網

JavaScript Date 物件完全指南:建構、取值、設值與格式化
編輯:關於JavaScript     

Date 是 JavaScript 裡最容易踩坑的內建物件之一:月份從 0 起算、字串解析在 IE 上會爆掉、時間戳的零點還有時區問題。這篇把建構方式、取值設值方法與格式化輸出一次整理清楚。

一、基本說明

Date 物件用來操作日期與時間,所有操作都必須透過方法進行,它本身沒有公開屬性。

二、四種建構方式

new Date()

無參數,回傳當前本地日期時間。

var dt = new Date();
console.log(dt); // 表示本地日期時間的 Date 物件

new Date(milliseconds)

傳入毫秒數,以 1970/01/01 00:00:00 為起點做加減。注意這個零點要加上本地時區,北京時間(東八區)的實際起點是 1970/01/01 08:00:00。

var dt = new Date(1000 * 60 * 1);  // 前進 1 分鐘
console.log(dt); // 1970/01/01 08:01:00

dt = new Date(-1000 * 60 * 1);     // 倒退 1 分鐘
console.log(dt); // 1970/01/01 07:59:00

new Date(dateStr)

把字串轉為 Date。字串格式有兩種常見寫法:

  • yyyy/MM/dd HH:mm:ss(建議使用):省略時間時,結果為 00:00:00。
  • yyyy-MM-dd HH:mm:ss:省略時間時結果為 08:00:00(補上本地時區);若帶時間,這寫法在舊版 IE 會轉換失敗。
var dt = new Date('2014/12/25');
console.log(dt); // 2014/12/25 00:00:00

dt = new Date('2014/12/25 12:00:00');
console.log(dt); // 2014/12/25 12:00:00

dt = new Date('2014-12-25');
console.log(dt); // 2014-12-25 08:00:00(加上東八區)

dt = new Date('2014-12-25 12:00:00'); // 舊版 IE 會報錯
console.log(dt);

實務上最穩定的做法是避開字串解析,直接傳數值參數,或把 ISO 8601 格式(2014-12-25T12:00:00)交給各瀏覽器處理。

new Date(year, month, day, hours, minutes, seconds, ms)

  • year:四位年份,如 2014
  • month:月份,從 0 起算,0 是 1 月、11 是 12 月
  • day(可選):日,從 1 起算,1–31
  • hours(可選):0–23
  • minutes、seconds(可選):0–59
  • ms(可選):0–999
var dt = new Date(2014, 11);
console.log(dt); // 2014/12/01 00:00:00

dt = new Date(2014, 11, 25);
console.log(dt); // 2014/12/25 00:00:00

dt = new Date(2014, 11, 25, 15, 30, 40);
console.log(dt); // 2014/12/25 15:30:40

dt = new Date(2014, 12, 25); // 月份 12 會自動進位
console.log(dt); // 2015/01/25

最後一個例子說明了 Date 的自動進位特性:超出範圍的數值會往後(或往前)溢出到下一個單位,這在計算「三個月後」這類需求時反而很方便。

三、取值方法(get)

Date 的方法有本地時間與 UTC 兩套,方法名帶 UTC 的即操作 UTC 時間。以下介紹本地時間這組。

  • getFullYear():四位年份
  • getMonth():月份,0–11,實際月份要 +1
  • getDate():日,1–31
  • getHours() / getMinutes() / getSeconds() / getMilliseconds()
  • getDay():星期,0 是週日、1 是週一,依此類推
  • getTime():與 1970/01/01 00:00:00 之間的毫秒數
dt.getFullYear();     // 2014
dt.getMonth();        // 11,實際是 12 月
dt.getDate();         // 25
dt.getHours();        // 15
dt.getMinutes();      // 30
dt.getSeconds();      // 40
dt.getMilliseconds(); // 333
dt.getDay();          // 4(星期四)
dt.getTime();         // 1419492640333

四、設值方法(set)

  • setFullYear(year, month?, date?)
  • setMonth(month, date?),0 是 1 月
  • setDate(date),1–31
  • setHours(hour, min?, sec?, ms?)
  • setMinutes(min, sec?, ms?)
  • setSeconds(sec, ms?)
  • setMilliseconds(ms)
var dt = new Date();
dt.setFullYear(2014);
dt.setMonth(11);      // 12 月
dt.setDate(25);
dt.setHours(15);
dt.setMinutes(30);
dt.setSeconds(40);
dt.setMilliseconds(333);
console.log(dt); // 2014年12月25日 15:30:40 333

五、轉字串的方法

  • toString():轉為「年月日 時分秒」字串
  • toLocaleString():轉為本地格式的「年月日 時分秒」
  • toDateString():只有年月日
  • toLocaleDateString():本地格式的年月日
  • toTimeString():只有時分秒
  • toLocaleTimeString():本地格式的時分秒
  • valueOf():等同 getTime()
var dt = new Date();
console.log(dt.toString());
// Tue Dec 23 2014 22:56:11 GMT+0800 (中國標準時間)

console.log(dt.toLocaleString());
// 2014年12月23日 下午10:56:11

console.log(dt.toDateString());       // Tue Dec 23 2014
console.log(dt.toLocaleDateString()); // 2014年12月23日
console.log(dt.toTimeString());       // 22:56:11 GMT+0800 (中國標準時間)
console.log(dt.toLocaleTimeString()); // 下午10:56:11
console.log(dt.valueOf());            // 毫秒數

需要自訂格式(例如 YYYY-MM-DD)時,這些方法都不夠用,得自己拼或引入日期庫。

六、靜態方法

Date.now()

回傳當前時間與 1970/01/01 00:00:00 之間的毫秒數。取得時間戳時比 +new Date() 更直觀。

console.log(Date.now()); // 1419431519276

Date.parse(dateStr)

把字串轉為 Date 後回傳毫秒數,字串格式限制與建構子相同——帶時間的 yyyy-MM-dd HH:mm:ss 在舊版 IE 會回傳 NaN。

console.log(Date.parse('2014/12/25 12:00:00')); // 1419480000000
console.log(Date.parse('2014-12-25 12:00:00')); // 舊版 IE 回傳 NaN

兩個延伸案例

〈JavaScript 取得系統當前時間並即時刷新〉與〈電商限時搶購倒數計時實作〉 respectively 示範了取值與時間差運算的實際應用。

以上就是這次的整理,希望對 Date 物件有更完整的認識。

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