「這個訂單下單到現在過了多久?」「活動還剩幾天?」這類需求,本質上都是兩個時間相減再換算單位。寫成一個帶單位參數的函式,各處都能重複用。
GetDateDiff(start, end, "day")
/*
* 取得時間差
* 時間格式:YYYY-MM-DD HH:mm:ss 或 YYYY/MM/DD HH:mm:ss
* diffType 支援:second / minute / hour / day
*/
function GetDateDiff(startTime, endTime, diffType) {
// 將 xxxx-xx-xx 換成 xxxx/xx/xx,因為部分舊瀏覽器不認字串形式的日期
startTime = startTime.replace(/-/g, "/");
endTime = endTime.replace(/-/g, "/");
diffType = diffType.toLowerCase();
var sTime = new Date(startTime);
var eTime = new Date(endTime);
// 決定除數
var divNum = 1;
switch (diffType) {
case "second": divNum = 1000; break;
case "minute": divNum = 1000 * 60; break;
case "hour": divNum = 1000 * 3600; break;
case "day": divNum = 1000 * 3600 * 24; break;
default: divNum = 1;
}
return parseInt((eTime.getTime() - sTime.getTime()) / divNum);
}
Date.getTime() 回傳的是從 1970-01-01 00:00:00 UTC 起算的毫秒數(所謂的 timestamp)。兩個時間各取一次再相減,得到的就是純粹的毫秒差。接著只要除以「該單位的毫秒數」並取整數,就完成換算。
那個 replace(/-/g, "/") 不是多餘的。new Date("2010-10-12 01:00:00") 這種帶橫線又帶空格的格式,在舊版 IE 與 Safari 會回傳 Invalid Date,導致 getTime() 得到 NaN,整個計算就報廢了。換成斜線是為了相容舊環境的實用補救。
用 Math.floor 取代 parseInt。parseInt 的用途是把字串解析成整數,順手拿來無條件捨去小數雖然能work,但語意不對。而且當數字大到超過 1e21 時,parseInt 會回傳 NaN(因為此時數字被轉成含 e+ 的科學記號字串)。Math.floor() 沒有這個問題。
注意「天數」的閏秒與日光時間。用固定 1000 * 3600 * 24 去除,在有日光節約時間的地區,跨日的結果可能偏一小時。若精度要求高,用 UTC 方法(Date.UTC() 搭配 getUTC*)計算會更準確。
負值代表什麼要想清楚。如果 endTime 早於 startTime,結果會是負數。UI 上顯示「-3 天」通常不是好體驗,記得判斷並給出「尚未開始」之類的文案。
現代寫法。如果不是被舊專案綁住,直接減兩個 Date 物件就會自動轉為毫秒差,或用 date-fns、dayjs 這類函式庫的 differenceInDays 更省事:
var diffMs = new Date(end) - new Date(start);
var days = Math.floor(diffMs / 86400000);
另外,若你只需要格式化顯示,Intl.RelativeTimeFormat 與 toLocaleString() 這些內建 API 已經能處理好各語言的「3 天前」這類表述,不必自己拼字串。