Date 的建構子看起來單純,卻因為有五種互不相同的形式,而經常被誤用——特別是「月份從 0 開始」這件事,每年都有人為此少算一個月。
var objDate = new Date([arguments]);
new Date("month dd,yyyy hh:mm:ss") — 完整字串new Date("month dd,yyyy") — 只有日期的字串new Date(yyyy, mth, dd, hh, mm, ss) — 全部用整數new Date(yyyy, mth, dd) — 整數,只到日new Date(ms) — 毫秒數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。