日期與時間的處理幾乎每個專案都會遇到,而 JavaScript 的 Date 物件有不少反直覺的細節(例如月份從 0 開始)。以下把建立方式、繼承方法、格式化方法與各項 get/set 方法整理成一份可直接查閱的清單。
使用 new 搭配 Date 建構函式:
var date = new Date();
不傳參數時,新物件會自動取得「當下的日期與時間」。若要指定時間,需傳入毫秒數(自 1970-01-01 UTC 起算)。
Date.parse() 接收代表日期的字串,回傳對應的毫秒數。要注意的是,可接受的日期格式會因瀏覽器實作與地區設定而異,這也是字串解析常出問題的根源。
Date.UTC() 同樣回傳毫秒數,但參數是數值:年份、月份(0 起算,0 是一月)、日、小時(0–23)、分鐘、秒、毫秒,其中年份與月份為必填。
// 2016 年 5 月 1 日 00:00:00(依 parse 的解析結果而定)
var date1 = new Date(Date.parse("May 1, 2016"));
// UTC 2016 年 1 月 1 日 00:00
var date2 = new Date(Date.UTC(2016, 0));
// 改用「年月日時分秒」數字參數時,走的是本地時區
var date3 = new Date(2016, 4, 10, 21, 46, 30); // 2016 年 5 月 10 日 21:46:30
· toLocaleString():依瀏覽器所在地區輸出日期與時間,通常含 AM/PM,但不含時區資訊
· toString():輸出含時區資訊的字串,時間多為 24 小時制(0–23)
· valueOf():不回傳字串,而是回傳毫秒數,因此可以直接用比較運算子比大小
var date1 = new Date(2016, 1, 9); var date2 = new Date(2016, 4, 10); alert(date1 < date2); // true
Date 另外提供了一組「只輸出日期」或「只輸出時間」的方法:
· toDateString():以實作相關格式顯示星期、月、日、年
· toTimeString():以實作相關格式顯示時、分、秒與時區
· toLocaleDateString():以地區格式顯示星期、月、日、年
· toLocaleTimeString():以地區格式顯示時、分、秒
· toUTCString():以 UTC 顯示完整的日期與時間
這些方法只負責「輸出」,格式受限於環境,若需要固定格式(例如 2026-08-19 14:30),仍需自行組字串。
· getTime() / setTime():取得或設定毫秒數
· getFullYear() / setFullYear():取得或設定四位數年份
· getMonth() / setMonth():月份,0 代表一月
· getDate() / setDate():月份中的第幾天
· getDay():星期幾,0 是週日、6 是週六
· getHours() / setHours():小時(0–23)
· getMinutes() / setMinutes():分鐘(0–59)
· getSeconds() / setSeconds():秒(0–59)
· getMilliseconds():毫秒(0–999)
對應的 UTC 版本(getUTCFullYear()、getUTCMonth() 等)會以 UTC 時區取值,跨時區的應用(例如後端回傳的時間戳)經常需要用到。
第一,new Date("2016-05-01") 這類「只有日期」的 ISO 字串會被當成 UTC 解析,而 new Date("2016/05/01") 則多被當成當地時間,兩者可能相差數小時,跨時區產品要特別小心。
第二,Date 物件是可變的,set 系列方法會直接改動原物件。若需要「不可變」的日期操作,可考虑以時間戳建立新物件,或直接使用 Temporal、date-fns、Day.js 這類函式庫。