Date 是 JavaScript 裡最容易踩坑的內建物件之一:月份從 0 起算、字串解析在 IE 上會爆掉、時間戳的零點還有時區問題。這篇把建構方式、取值設值方法與格式化輸出一次整理清楚。
Date 物件用來操作日期與時間,所有操作都必須透過方法進行,它本身沒有公開屬性。
無參數,回傳當前本地日期時間。
var dt = new Date(); console.log(dt); // 表示本地日期時間的 Date 物件
傳入毫秒數,以 1970/01/01 00:00:00 為起點做加減。注意這個零點要加上本地時區,北京時間(東八區)的實際起點是 1970/01/01 08:00:00。
var dt = new Date(1000 * 60 * 1); // 前進 1 分鐘 console.log(dt); // 1970/01/01 08:01:00 dt = new Date(-1000 * 60 * 1); // 倒退 1 分鐘 console.log(dt); // 1970/01/01 07:59:00
把字串轉為 Date。字串格式有兩種常見寫法:
yyyy/MM/dd HH:mm:ss(建議使用):省略時間時,結果為 00:00:00。yyyy-MM-dd HH:mm:ss:省略時間時結果為 08:00:00(補上本地時區);若帶時間,這寫法在舊版 IE 會轉換失敗。var dt = new Date('2014/12/25');
console.log(dt); // 2014/12/25 00:00:00
dt = new Date('2014/12/25 12:00:00');
console.log(dt); // 2014/12/25 12:00:00
dt = new Date('2014-12-25');
console.log(dt); // 2014-12-25 08:00:00(加上東八區)
dt = new Date('2014-12-25 12:00:00'); // 舊版 IE 會報錯
console.log(dt);
實務上最穩定的做法是避開字串解析,直接傳數值參數,或把 ISO 8601 格式(2014-12-25T12:00:00)交給各瀏覽器處理。
year:四位年份,如 2014month:月份,從 0 起算,0 是 1 月、11 是 12 月day(可選):日,從 1 起算,1–31hours(可選):0–23minutes、seconds(可選):0–59ms(可選):0–999var dt = new Date(2014, 11); console.log(dt); // 2014/12/01 00:00:00 dt = new Date(2014, 11, 25); console.log(dt); // 2014/12/25 00:00:00 dt = new Date(2014, 11, 25, 15, 30, 40); console.log(dt); // 2014/12/25 15:30:40 dt = new Date(2014, 12, 25); // 月份 12 會自動進位 console.log(dt); // 2015/01/25
最後一個例子說明了 Date 的自動進位特性:超出範圍的數值會往後(或往前)溢出到下一個單位,這在計算「三個月後」這類需求時反而很方便。
Date 的方法有本地時間與 UTC 兩套,方法名帶 UTC 的即操作 UTC 時間。以下介紹本地時間這組。
getFullYear():四位年份getMonth():月份,0–11,實際月份要 +1getDate():日,1–31getHours() / getMinutes() / getSeconds() / getMilliseconds()getDay():星期,0 是週日、1 是週一,依此類推getTime():與 1970/01/01 00:00:00 之間的毫秒數dt.getFullYear(); // 2014 dt.getMonth(); // 11,實際是 12 月 dt.getDate(); // 25 dt.getHours(); // 15 dt.getMinutes(); // 30 dt.getSeconds(); // 40 dt.getMilliseconds(); // 333 dt.getDay(); // 4(星期四) dt.getTime(); // 1419492640333
setFullYear(year, month?, date?)setMonth(month, date?),0 是 1 月setDate(date),1–31setHours(hour, min?, sec?, ms?)setMinutes(min, sec?, ms?)setSeconds(sec, ms?)setMilliseconds(ms)var dt = new Date(); dt.setFullYear(2014); dt.setMonth(11); // 12 月 dt.setDate(25); dt.setHours(15); dt.setMinutes(30); dt.setSeconds(40); dt.setMilliseconds(333); console.log(dt); // 2014年12月25日 15:30:40 333
toString():轉為「年月日 時分秒」字串toLocaleString():轉為本地格式的「年月日 時分秒」toDateString():只有年月日toLocaleDateString():本地格式的年月日toTimeString():只有時分秒toLocaleTimeString():本地格式的時分秒valueOf():等同 getTime()var dt = new Date(); console.log(dt.toString()); // Tue Dec 23 2014 22:56:11 GMT+0800 (中國標準時間) console.log(dt.toLocaleString()); // 2014年12月23日 下午10:56:11 console.log(dt.toDateString()); // Tue Dec 23 2014 console.log(dt.toLocaleDateString()); // 2014年12月23日 console.log(dt.toTimeString()); // 22:56:11 GMT+0800 (中國標準時間) console.log(dt.toLocaleTimeString()); // 下午10:56:11 console.log(dt.valueOf()); // 毫秒數
需要自訂格式(例如 YYYY-MM-DD)時,這些方法都不夠用,得自己拼或引入日期庫。
回傳當前時間與 1970/01/01 00:00:00 之間的毫秒數。取得時間戳時比 +new Date() 更直觀。
console.log(Date.now()); // 1419431519276
把字串轉為 Date 後回傳毫秒數,字串格式限制與建構子相同——帶時間的 yyyy-MM-dd HH:mm:ss 在舊版 IE 會回傳 NaN。
console.log(Date.parse('2014/12/25 12:00:00')); // 1419480000000
console.log(Date.parse('2014-12-25 12:00:00')); // 舊版 IE 回傳 NaN
〈JavaScript 取得系統當前時間並即時刷新〉與〈電商限時搶購倒數計時實作〉 respectively 示範了取值與時間差運算的實際應用。
以上就是這次的整理,希望對 Date 物件有更完整的認識。