日期處理是前端最容易出錯的環節之一:月份從 0 開始、時間戳的基準點、時區換算……本文把最常用的 Date 取值方法整理成一份速查表,並說明倒計時的實作思路。
var dateTo = new Date("8:00 1/4/2014");
帶參數建立指定時間的日期物件;不帶參數則預設為當前時間(new Date())。字串格式的解析結果依瀏覽器而異,實務上建議改用 new Date(2014, 0, 4, 8, 0, 0) 這種數值建構方式,或遵循 ISO 8601 格式 "2014-01-04T08:00:00"。
var date = dateTo.getTime()
getTime() 回傳的是從 1970 年 1 月 1 日 00:00:00 UTC 到目前時刻的毫秒數。這個數字是「時間絕對值」的最佳表示法,因為它是一個單一整數,做差、比較、排序都極方便,完全不受時區與格式影響。後端傳時間、資料庫存時間,多半也是這個形式。
var y = date.getFullYear(); // 獲取年份,四位數,如 2014 var mm = date.getMonth() + 1; // 獲取月份,注意必須 +1 var d = date.getDate(); // 獲取日期(當月第幾天,1-31) var h = date.getHours(); // 獲取小時(0-23) var m = date.getMinutes(); // 獲取分鐘數(0-59) var s = date.getSeconds(); // 獲取秒數(0-59)
務必記住 getMonth() 要 +1。 它回傳 0–11,0 代表一月。這是 JavaScript 日期 API 最著名的不一致設計——getDate() 從 1 開始,getMonth() 卻從 0 開始,很多人因此在正式環境寫出「日期少一個月」的 bug。
其他幾個也常用但這份清單未列出的:
date.getDay(); // 星期幾,0 = 週日 date.getMilliseconds(); // 毫秒(0-999) date.getUTCFullYear(); // UTC 時區版本,另有 getUTCMonth/getUTCDate 等 Date.now(); // 直接取當前時間戳,比 new Date().getTime() 簡潔
倒計時的核心只有兩句話:
1. 計算兩個時間的差值。 目標時間減當前時間,得到的毫秒數再換算成天、時、分、秒。
2. 用 setInterval() 每秒執行一次更新函式。
var target = new Date("2014-01-04T08:00:00").getTime();
function tick() {
var diff = target - Date.now();
if (diff <= 0) {
clearInterval(timer);
document.getElementById("countdown").innerText = "時間到!";
return;
}
var days = Math.floor(diff / 86400000);
var hours = Math.floor(diff % 86400000 / 3600000);
var mins = Math.floor(diff % 3600000 / 60000);
var secs = Math.floor(diff % 60000 / 1000);
document.getElementById("countdown").innerText =
days + "天" + hours + "小時" + mins + "分鐘" + secs + "秒";
}
var timer = setInterval(tick, 1000);
過程中會用到的輔助函式:
parseInt(strNum); // 該函數將字符串類型的數字轉換成數字類型
如果後端回傳的是字串形式的數字(例如 "12"),做算術運算前要先 parseInt() 或 Number() 轉型。字串相減雖會自動轉型,但字串相加會變成串接("12" + 1 得到 "121"),這是常見的靜默錯誤來源。
不要用「每次減 1 秒」的方式做倒計時。 那種寫法一旦遇到背景分頁被瀏覽器節流、或系統時間被調整,計時就會漂移。永遠用「目標時間 − 現在時間」重算,誤差才不會累積。
倒計時結束一定要 clearInterval()。 否則計時器會永久執行下去,浪費資源。範例中在 diff <= 0 時立刻清除,是正確做法。