var now = new Date(); // 目前的系統日期與時間
var d1 = new Date(Date.parse("May 25, 2012"));
var d2 = new Date("May 25, 2012"); // 與上一行等價
var d3 = new Date(Date.UTC(2010, 0)); // GMT 2010 年 1 月 1 日 00:00
var d4 = new Date(2010, 0); // 同上,但使用本地時區
var d5 = new Date(Date.UTC(2010, 4, 5, 17, 55, 55));
var d6 = new Date(2010, 4, 5, 17, 55, 55);
Date.parse() 與 Date.UTC() 都會回傳該日期的毫秒數。參數順序為:年、月、日、時、分、秒、毫秒,至少需要年與月兩個參數。
最重要的細節:月份從 0 開始計算,0 代表一月、11 代表十二月。這是最常出錯的地方之一。另外 Date.UTC() 使用 GMT,而 new Date(年, 月, ...) 使用本地時區,兩者結果會因時區而異。
Date 物件可以直接用 > 與 < 比較,背後會轉成時間戳:
var date1 = new Date(2007, 0, 1); var date2 = new Date(2007, 1, 1); alert(date1 > date2); // false alert(date1 < date2); // true
若要判斷是否相等,建議改用 getTime() 比對毫秒數,避免物件參考的陷阱。
toDateString() // 只有日期部分 toTimeString() // 只有時間部分 toLocaleDateString() // 例如「2007年1月1日」 toLocaleTimeString() // 例如「13:55:55」 toUTCString() // GMT 格式的完整字串
時間戳:
getTime() / setTime()
年月日:
getFullYear() / setFullYear() getMonth() / setMonth() // 月份 0 代表一月 getDate() / setDate() // 月份中的第幾天;超過 31 會自動進位到下個月 getDay() // 星期幾,0 是週日,6 是週六
時分秒毫秒:
getHours() / setHours() // 0 ~ 23 getMinutes() / setMinutes() // 0 ~ 59 getSeconds() / setSeconds() // 0 ~ 59 getMilliseconds()/ setMilliseconds() // 毫秒
上面這些 get 方法取得的是本地時區的值,若要避開時區問題,請用對應的 UTC 版本(getUTCFullYear()、getUTCMonth() 等)。
另一個常見誤解是 getDay() 與 getDate() 的差別:前者是「星期幾」,後者是「號碼」。混用會產生很難察覺的錯誤。
在現代專案中,日期運算建議直接使用 Intl.DateTimeFormat 做格式化,或用 Temporal 這類專門的日期 API;直接手動字串拼接時區與語言格式,很容易踩到邊界情況。