Date 物件專門用來處理日期與時間,是前端開發中最常被翻文件的物件之一。這篇把它整理成可以直接查的參照表。
var myDate = new Date();
不帶參數時,會自動以「當下的日期與時間」作為初始值。若要指定時間,共有五種參數形式:
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);
最後一種要特別注意:參數是「與 GMT 1970 年 1 月 1 日相差的毫秒數」,也就是所謂的時間戳。
實際範例:
new Date("January 12,2006 22:19:35");
new Date("January 12,2006");
new Date(2006, 0, 12, 22, 19, 35);
new Date(2006, 0, 12);
new Date(1137075575000);
月份從 0 開始計算這點最容易出錯,new Date(2006, 0, 12) 是 1 月 12 日而非 12 月 1 日。另外字串形式的解析結果在各瀏覽器上未必一致,正式專案建議一律用數值參數或 ISO 8601 字串(如 "2006-01-12T22:19:35")。
Date():回傳當日日期與時間字串getDate():當月日期(1–31)getDay():當週第幾天(0–6,0 是星期日)getMonth():月份(0–11)getFullYear():四位數年份(取代已不建議的 getYear())getHours() / getMinutes() / getSeconds() / getMilliseconds():時、分、秒、毫秒getTime():1970-01-01 至今的毫秒數getTimezoneOffset():本地時間與 GMT 的分鐘差getUTCDate() 等 UTC 系列:以世界時為基準回傳日、週、月、年、時、分、秒、毫秒parse():把日期字串解析為 1970-01-01 午夜起的毫秒數setDate()、setMonth()、setFullYear()、setHours()、setMinutes()、setSeconds()、setMilliseconds() 分別設定各個欄位;setTime() 以毫秒直接設定整個時間值。對應的 UTC 版本為 setUTCDate() 到 setUTCMilliseconds()。同樣地,setYear() 已建議改用 setFullYear()。
toSource():回傳物件原始碼(非標準)toString():轉為完整字串toDateString() / toTimeString():只取日期或時間部分toUTCString():以世界時輸出(取代 toGMTString())toLocaleString() / toLocaleDateString() / toLocaleTimeString():依本地格式輸出toISOString():輸出標準 ISO 8601 字串,跨系統交換資料時最可靠UTC():以世界時計算指定日期距 1997-01-01 的毫秒數valueOf():回傳物件的原始數值,也就是時間戳實務上最實用的兩個補充:toISOString() 拿來存進 API 或資料庫,valueOf() 或直接 +date 拿來做時間差運算。日期格式化若不想自己拼字串,toLocaleDateString('zh-TW') 或 Intl.DateTimeFormat 都能省下不少工夫。