建立日期物件看似簡單,但一旦要指定時間,就會遇到時區與參數格式的問題。本文釐清 Date 建構子的參數規則,以及 Date.parse() 與 Date.UTC() 的關鍵差異。
var now = new Date();
不傳任何參數時,物件會自動取得目前的日期與時間。
若要建立自訂時間的物件,傳給 Date() 的參數必須是毫秒數——從 UTC 時間 1970 年 1 月 1 日午夜起到目標時間為止的累計毫秒數。
取得這個毫秒數有兩個輔助方法:
接收一個表示日期的字串,例如 "May 25, 2013"、"6/13/2013" 等格式。要注意的是,支援的格式因瀏覽器與地區而異,這也是字串解析經常出問題的原因。較保險的做法是使用 ISO 8601 格式("2013-12-12" 或 "2013-12-12T10:30:00Z")。
依序接收:年份、月份(從 0 開始,0–11)、日(1–31)、小時(0–23)、分鐘、秒、毫秒。其中年份與月份是必填,其餘預設為 0。
用 Date.parse():
var mydate = new Date(Date.parse("12/12/2013"));
也可以直接傳字串:
var mydate = new Date("12/12/2013");
此時建構 Date 的過程中會自動呼叫 Date.parse() 把字串轉為毫秒數。
用 Date.UTC():
var mydate = new Date(Date.UTC(2013, 11, 12)); // 注意:月份索引從 0 開始,所以 11 代表 12 月;日的索引則從 1 開始
同樣地,直接傳數值也會自動呼叫 Date.UTC():
var mydate = new Date(2013, 11, 12);
這兩種寫法看起來只差一層呼叫,結果卻不同:
new Date(Date.UTC(2013, 11, 12)) → 得到的是 GMT(UTC)時間。換算成本地時間顯示時,會依時區偏移而落在不同的日期或時刻。new Date(2013, 11, 12) → 得到的是依系統設定的本地時間。在台灣(UTC+8)執行時,前者印出來的本地時間會是 2013/12/12 早上 08:00,而後者是 2013/12/12 00:00。這個八小時的落差,是跨時區功能出錯的常見根源。
11 月而非 12 月。new Date();PHP 的 10 位秒數需先乘以 1000。Date 的 API 設計在時區處理上出了名地難用,dayjs、date-fns、Luxon 等函式庫能省下不少心力。