報表與查詢介面幾乎都會遇到日期區間的驗證需求:起訖日不可為空、結束日不可早於起始日、查詢跨度不可超出上限,有時候還要限制「不允許跨月」。這些規則看似瑣碎,集中寫成一個函式後就好維護多了。
下面的 checkDate 一次處理了五件事,透過 flag 參數決定是否開放跨月查詢:
function checkDate(startDate, endDate, num, flag) {
// 1. 是否為 null
if (startDate == null || endDate == null) {
popwin.info('提示', '日期不可為空');
return false;
}
// 2. 是否為空字串
if (startDate == '' || endDate == '') {
popwin.info('提示', '請輸入查詢日期');
return false;
}
// 3. 轉成 Date 物件;把 - 換成 / 是為了避免部分瀏覽器對 "YYYY-MM-DD" 解析不一致
var start_date = new Date((startDate + " 00:00").replace(/-/g, "/"));
var end_date = new Date((endDate + " 00:00").replace(/-/g, "/"));
// 4. 起訖日順序
if (start_date > end_date) {
popwin.info('提示', '截止日期不能小於起始日期');
return false;
}
// 5. 不得超過 num 天之後
var currentDate = new Date();
currentDate.setDate(currentDate.getDate() + num);
if (end_date > currentDate) {
popwin.info('提示', '截止日期不能大於 ' + num + ' 天之後的日期');
return false;
}
// 6. 是否禁止跨月
if (flag == false) {
if (start_date.getMonth() != end_date.getMonth()) {
popwin.info('提示', '該查詢不支持跨月查詢');
return false;
}
}
}
日期字串解析有陷阱。把 - 一律替換成 / 是為了避開舊版 IE 與 Safari 對 YYYY-MM-DD 這種 ISO 格式的解析差異,實測這樣寫最穩。更保險的做法則是自行以 split 拆出年月日,再組裝 new Date(y, m - 1, d)。
只比月份會漏掉跨年。getMonth() 回傳 0 到 11,若起始日是 12 月、結束日是隔年 1 月,兩者月份不同,會被判為跨月——這個行為剛好正確;但若起始日與結束日同為 1 月卻跨年,就會被誤判為「未跨月」。若要嚴格處理,應同時比對 getFullYear()。
提示訊息最好抽成參數。把 popwin.info 換成 callback 或事件拋出,函式就能同時服務於不同 UI 框架,也方便寫單元測試。