DIV CSS 佈局教程網

JavaScript Date 物件初始化的五種寫法與參數規則
編輯:JavaScript綜合知識     

Date 的建構子看起來單純,卻因為有五種互不相同的形式,而經常被誤用——特別是「月份從 0 開始」這件事,每年都有人為此少算一個月。

五種形式

var objDate = new Date([arguments]);
  1. new Date("month dd,yyyy hh:mm:ss") — 完整字串
  2. new Date("month dd,yyyy") — 只有日期的字串
  3. new Date(yyyy, mth, dd, hh, mm, ss) — 全部用整數
  4. new Date(yyyy, mth, dd) — 整數,只到日
  5. new Date(ms) — 毫秒數

參數含義

  • month:英文月份名稱,January 到 December(字串寫法)
  • mth:整數月份,0 到 11(0 是一月,11 是十二月)
  • dd:月份中的第幾天,1 到 31
  • yyyy:四位數年份
  • hh:小時,0 到 23
  • mm:分鐘,0 到 59
  • ss:秒,0 到 59
  • ms:毫秒,整數,代表與 GMT 1970 年 1 月 1 日相差的毫秒數

五種寫法的等價示範

new Date("January 12,2006 22:19:35");
new Date("January 12,2006");
new Date(2006, 0, 12, 22, 19, 35);   // 注意月份是 0 不是 1
new Date(2006, 0, 12);
new Date(1137075575000);

以上都指向 2006 年 1 月 12 日。

那個著名的「格式不正確」錯誤

原範例提到:用第三種寫法時總是顯示格式不正確,仔細檢查才發現參數必須是整數,而他傳入的是字串。

new Date("2006", "0", "12");   // 字串 → 不可靠,部分環境回傳 Invalid Date
new Date(2006, 0, 12);          // 整數 → 正確

這是因為多引擎對「全字串參數」的寬容度不同:有的會嘗試逐個轉型,有的直接放棄。養成習慣:用數字寫法時一律傳 number,不要讓字串混進來。

兩個還要更小心的陷阱

月份從 0 起算。new Date(2006, 1, 12) 是 2 月 12 日,不是 1 月。要產生「現在的月份」時,getMonth() 回傳的 0–11 可以直接餵回建構子,這也是它設計成 0 起算的原因(方便與 getMonth 對接),但對手寫程式的人非常不友善。

字串寫法與時區。不含時區資訊的 ISO 格式("2006-01-12")在標準中被定義為 UTC,而 "2006/01/12" 通常被當成當地時間,兩者可能相差數小時。跨時區的應用請一律使用 ISO 8601 並帶上時區偏移,例如 "2006-01-12T22:19:35+08:00"。

現代建議

new Date();                          // 現在
Date.now();                          // 現在的毫秒數(數字,更好運算)
new Date(2006, 0, 12);               //  Construct 時用數字
new Date("2006-01-12T22:19:35+08:00"); // 解析字串時帶時區

若日期運算很多(格式化、加減月份、時區轉換),直接引入 Day.js 或 date-fns 會省下大量自行處理邊界條件的時間;原生 Date 的月份溢出行為(1 月 31 日加一個月)尤其容易釀成 bug。

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