實務上常需要「給定起訖日期,列出範圍內的每一天」,例如報表展開、日曆產生器或資料補洞。本文示範的做法是先為 Date 擴充一個加天數的方法,再用迴圈逐日推進收集結果。
// 為 Date 增加「加 n 天」的能力,回傳新的 Date 物件
Date.prototype.addDays = function (days) {
var dat = new Date(this.valueOf());
dat.setDate(dat.getDate() + days);
return dat;
};
// 取得 startDate 到 stopDate 之間(含)的所有日期
function getDates(startDate, stopDate) {
var dateArray = [];
var currentDate = startDate;
while (currentDate <= stopDate) {
dateArray.push(self.formatDate(currentDate));
currentDate = currentDate.addDays(1);
}
return dateArray;
}
幾個實作細節值得留意:
addDays 刻意回傳新物件。如果直接改動 this,原日期物件會被污染,迴圈中的 startDate 也會跟著跑掉。用 new Date(this.valueOf()) 複製一份再運算,是較安全的寫法。
formatDate 需自行實作。原範例參考了 self.formatDate,這個函式要自己補上,負責把 Date 物件格式化為字串:
function formatDate(d) {
var m = d.getMonth() + 1, day = d.getDate();
return d.getFullYear() + "-" + (m < 10 ? "0" + m : m) +
"-" + (day < 10 ? "0" + day : day);
}
不建議直接擴充 Date.prototype。為內建物件掛上可列舉屬性,在 for-in 迴圈中可能造成非預期行為,也容易與其他函式庫衝突。改寫成獨立函式 addDays(date, n) 會更安全。
比較物件要用 getTime()。用 <= 比較兩個 Date 物件雖可運作,但更明確的做法是比 currentDate.getTime() <= stopDate.getTime(),同時也要留意起訖日期若含時分秒,可能導致「當天」被排除在範圍外。