前陣子在處理一個查詢頁面的需求:使用者先挑年份與月份,再選「第幾週」,頁面必須自動顯示該週是從幾號到幾號。網路上找得到的範例不少,但沒有一個完全符合,最後還是決定自己寫一版。
核心思路是這樣的:先求出所選年月「一號」是星期幾,再回推該週週一的日期,作為計算基準。
以這一天為原點:第 1 週的結束日是基準日加 6 天;第 2 週的起始日是加 7 天、結束日加 13 天;第 3 週起始日加 14 天,以此類推到第 5 週。只要基準日抓對,後面的推算就只是單純的天數位移。
先準備兩個小工具:一個做日期加減,一個把日期格式化為 YYYY-MM-DD。
// date 為基準日期,days 為要加減的天數(可為負數)
// 例如 addDate('2010-10-01', -3) 得到 2010-09-28
function addDate(date, days) {
var d = new Date(date);
d.setDate(d.getDate() + days);
var m = d.getMonth() + 1;
var tmpDate = d.getFullYear() + "/" + m + "/" + d.getDate();
return new Date(tmpDate);
}
// 轉為 YYYY-MM-DD 字串
function changeDateFormat(DateIn) {
var year = DateIn.getFullYear();
var month = DateIn.getMonth() + 1;
var day = DateIn.getDate();
var currentDate = year + "-";
currentDate += (month > 10) ? month + "-" : "0" + month + "-";
currentDate += (day > 10) ? day : "0" + day;
return currentDate;
}
依「一號是星期幾」決定基準週一的位移量,再依週數決定起訖日。
function weekToDate(weekNumber, strWeekDay, dateIn) {
var outputDate_1 = ""; // 起始日
var outputDate_2 = ""; // 當週週一
var temp_date = "";
// 一號是週日時,該週週一要往前退 6 天
if (strWeekDay == '0') { outputDate_1 = addDate(dateIn, -6); }
if (strWeekDay == '1') { outputDate_1 = addDate(dateIn, 0); }
if (strWeekDay == '2') { outputDate_1 = addDate(dateIn, -1); }
if (strWeekDay == '3') { outputDate_1 = addDate(dateIn, -2); }
if (strWeekDay == '4') { outputDate_1 = addDate(dateIn, -3); }
if (strWeekDay == '5') { outputDate_1 = addDate(dateIn, -4); }
if (strWeekDay == '6') { outputDate_1 = addDate(dateIn, -5); }
// 第 1 週以 outputDate_1 為起點,其後各週依序位移 7 天的倍數
if (weekNumber == '2') { outputDate_2 = addDate(outputDate_1, 7); }
if (weekNumber == '3') { outputDate_2 = addDate(outputDate_1, 14); }
if (weekNumber == '4') { outputDate_2 = addDate(outputDate_1, 21); }
if (weekNumber == '5') { outputDate_2 = addDate(outputDate_1, 28); }
if (weekNumber == '1') {
document.getElementById("spnDate").value = changeDateFormat(outputDate_1);
temp_date = addDate(outputDate_1, 6);
} else {
document.getElementById("spnDate").value = changeDateFormat(outputDate_2);
temp_date = addDate(outputDate_2, 6);
}
document.getElementById("finishTime").value = changeDateFormat(temp_date);
}
接著把年、月、週三個下拉選單的選取值取出,組出 yyyy/mm/01 的日期字串,取得該月一號的星期數後再呼叫上面的函式。這段原本用了大量重複的 if 判斷,實際上可以簡化為一次呼叫:
function getFromToDateOfSelectedWeek() {
var year = document.getElementById("sltYear");
var optionYear = year.getElementsByTagName("option");
var strYear = "";
for (var i = 0; i < optionYear.length; ++i) {
if (optionYear[i].selected) { strYear = optionYear[i].text; }
}
var month = document.getElementById("sltMonth");
var option = month.getElementsByTagName("option");
var strMonth = "";
for (var i = 0; i < option.length; ++i) {
if (option[i].selected) { strMonth = option[i].text; }
}
// 組出 yyyy/mm/01 並轉為日期物件
var sltDate = new Date(strYear + "/" + strMonth + "/" + "1");
var weekDay = sltDate.getDay(); // 該月一號是星期幾
var weekNumber = document.getElementById("weekNumber");
var optionWeek = weekNumber.getElementsByTagName("option");
var strWeek = "";
for (var i = 0; i < optionWeek.length; ++i) {
if (optionWeek[i].selected) { strWeek = optionWeek[i].text; }
}
// 原本 5 段 × 7 條 if 的重複判斷,實際上只需這一行
weekToDate(strWeek, String(weekDay), sltDate);
}
測試時發現一個 bug:當某年 2 月 1 日剛好是星期一,而且該年是平年,此時選擇「2 月第 5 週」,算出來的起始日已經落在 3 月。例如查詢 2010 年 2 月第 5 週,程式會顯示 2010-03-01 至 2010-03-07。
這其實不是計算錯誤,而是「第 5 週」在該月並不存在完整的七天。處理方式有兩種:
兩種做法都能讓顯示結果與使用者的預期一致,可依產品情境挑選。這也提醒我們:日期計算的魔鬼幾乎都藏在月長、閏年與跨年這些邊界裡,實作時記得多跑幾組極端組合。