ECMAScript 的 Date 型別建構在早期 Java 的 java.util.Date 類別概念之上,內部用「自 UTC(Coordinated Universal Time,國際協調時間)1970 年 1 月 1 日午夜起算的毫秒數」來保存日期。在這種儲存格式下,Date 能精確表達 1970 年前後各約 285616 年的範圍——遠比一般應用需要的跨度大得多。
這個設計有個實務含意:Date 內部一律以 UTC 毫秒數運算,只有在你呼叫 getHours() 這類「本地時間」方法時才做時區換算。理解這點,就能解釋為什麼同一個時間戳在不同時區顯示會不同。
Date.parse(string):接受表示日期的字串,嘗試轉為對應的毫秒數,無法轉換則回傳 NaN。
Date.UTC(year, month[, day, hour, min, second, millisecond]):依參數回傳毫秒數。只有前兩個參數(年、月)是必填,其餘省略時一律視為 0。注意月份從 0 起算。
Date.now():回傳呼叫當下的毫秒數,比 +new Date() 更直觀。
toLocaleString():依瀏覽器地區設定輸出日期與時間,格式因瀏覽器而異。
toString():通常回傳含時區資訊的字串,時間多以 24 小時制表示,格式同樣因瀏覽器而異。
valueOf():回傳毫秒數,這也是 date1 - date2 能直接相減的原因。
toDateString():顯示星期、月、日、年。
toTimeString():顯示時、分、秒與時區。
toLocaleDateString():以地區格式顯示星期、月、日、年。
toLocaleTimeString():以地區格式顯示時、分、秒。
toUTCString():輸出完整的 UTC 日期字串。
另外還有 ES5 之後加入的 toISOString(),輸出標準的 YYYY-MM-DDTHH:mm:ss.sssZ,跨語言交換資料時最可靠。
以下成對出現的 getter/setter 用來存取日期中特定部位的值:
getTime() / setTime(毫秒):讀取或設定毫秒數。setTime 會改動整個日期。
getFullYear() / setFullYear(年):四碼年份(如 2007 而非 07)。傳入必須是四位數。
getUTCFullYear() / setUTCFullYear(年):UTC 版本的四碼年份。
getMonth() / setMonth(月):月份 0 代表一月,11 代表十二月。
getUTCMonth() / setUTCMonth(月):UTC 版本的月份。
getDate() / setDate(日):月份中的第幾天(1–31)。若傳入值超出該月天數,會自動進位到下個月。
getUTCDate() / setUTCDate(日):UTC 版本,同樣會自動進位。
getDay() / getUTCDay():星期幾,0 為週日,6 為週六。注意這組沒有對應的 setter。
getHours() / setHours(時):小時 0–23,超出 23 則進位到天。
getUTCHours() / setUTCHours(時):UTC 版本。
getMinutes() / setMinutes(分):分鐘 0–59,超出則進位到小時。
getUTCMinutes() / setUTCMinutes(分):UTC 版本。
getSeconds() / setSeconds(秒):秒數 0–59,超出則進位到分鐘。
getUTCSeconds() / setUTCSeconds(秒):UTC 版本。
getMilliseconds() / setMilliseconds(毫秒):毫秒部分。
getUTCMilliseconds() / setUTCMilliseconds(毫秒):UTC 版本。
getTimezoneOffset():回傳本地時間與 UTC 相差的分鐘數。台灣屬 UTC+8,因此回傳 -480。
一是月份從 0 開始。new Date(2026, 8, 26) 得到的是九月而非八月。
二是字串解析沒有統一標準。new Date("2026-08-26") 在 ES5 之後被定義為 UTC 午夜,而 new Date("2026/08/26") 則是本地時間午夜——在 UTC+8 的環境下,兩者會相差八小時,甚至落在不同日期。處理使用者輸入時,建議一律手動拆字串再組 Date,或直接使用 Date.parse 搭配明確格式。