我們平常看到的日曆控件,大多只能選到「年、月、日」為止。但實務上有不少情境需要更細的粒度——後台排程、活動報名、工單開通時間、排班系統等等,使用者往往需要一次輸入「2024-08-12 14:30」這樣的完整時間戳。本文要拆解的這支 JavaScript 日曆控件,就是在傳統日期面板下方多接了一片時間面板,讓日期與時間在同一個彈出視窗裡一次搞定。
整份程式以兩個建構函式為骨架,各自負責一段資料,再由一個共用函式把結果拼起來:
CalendarCalendar:負責年、月、日,對外提供 getDate() 回傳格式化字串。CalendarMinute:負責時、分,對外提供 getTime()。getDateTime():把兩者串成 yyyy-MM-dd HH:mm,寫進 gdCtrl 目前指向的欄位。showCal() 與 hideCalendar():控制面板定位與可見性。fGetXY():逐層累加 offsetLeft/offsetTop,算出觸發欄位在頁面中的絕對座標。validateDate1():把 yyyy-MM-dd HH:mm 這類格式字串動態轉成正則表達式,用來檢查欄位裡既有的值是否合法。時間列的做法很巧妙:用兩個共用屬性字串套在每個 input 上,再用 radix 自訂屬性記錄「這一格的上限」,箭頭就能通用同一段邏輯。
function CalendarMinute(name, fName) {
this.name = name;
this.fName = fName || "m_input";
this.timer = null;
this.fObj = null; // 目前聚焦的輸入框
// 每格共用的屬性:最長 2 碼、聚焦時記住自己、失焦補零、禁止貼上與拖曳
var sMinute_Common = 'class="m_input" maxlength="2" name="' + this.fName + '"'
+ ' onfocus="' + this.name + '.setFocusObj(this)"'
+ ' onblur="' + this.name + '.setTime(this)"'
+ ' onkeyup="' + this.name + '.prevent(this)"'
+ ' onpaste="return false" ondragenter="return false"';
// 上下箭頭;5 顯示向上、6 顯示向下(Webdings 字型會畫成三角形)
var sButton_Common = 'class="m_arrow" onfocus="this.blur()"'
+ ' onmouseup="' + this.name + '.controlTime()" disabled';
this.toString = function () {
var d = new Date(), str = '';
str += '<table class="cal_drawtime" cellspacing="0" cellpadding="0"><tr>';
str += '<td>請選擇時間:</td><td><div class="m_frameborder">';
str += '<input radix="24" value="' + this.formatTime(d.getHours()) + '" ' + sMinute_Common + '>:';
str += '<input radix="60" value="' + this.formatTime(d.getMinutes()) + '" ' + sMinute_Common + '>';
str += '</div></td><td>';
str += '<button id="' + this.fName + '_up" ' + sButton_Common + '>5</button>';
str += '<button id="' + this.fName + '_down" ' + sButton_Common + '>6</button>';
str += '</td></tr></table>';
return str;
};
// 補零成兩位數
this.formatTime = function (sTime) {
sTime = "0" + sTime;
return sTime.substr(sTime.length - 2);
};
// 箭頭微調,含到頂/到底的回圈處理
this.controlTime = function () {
event.cancelBubble = true;
if (!this.fObj) return;
clearInterval(this.timer);
var up = (event.srcElement.innerText == "5");
var i = parseInt(this.fObj.value, 10);
var max = parseInt(this.fObj.radix, 10) - 1;
if (i == max && up) i = 0;
else if (i == 0 && !up) i = max;
else up ? i++ : i--;
this.fObj.value = this.formatTime(i);
this.fObj.select();
getDateTime();
};
// 對外輸出 "HH:mm"
this.getTime = function () {
var box = document.getElementsByName(this.fName), arr = [];
for (var i = 0; i < box.length; i++) arr[i] = box[i].value;
return arr.join(":");
};
}
日曆本體的關鍵只有兩行計算:用 new Date(year, month, 1).getDay() 求出該月一號是星期幾(也就是前面要留幾格空白),再用 new Date(year, month + 1, 0).getDate() 取得當月總天數。
this.drawDate = function () {
var first = new Date(this.year, this.month, 1).getDay(); // 一號是星期幾
var total = new Date(this.year, this.month + 1, 0).getDate(); // 當月總天數
var str = '<table class="cal_drawdate" id="' + this.fName + '_dateTable">';
for (var i = 1, j = 1 - first; i < 7; i++) {
str += '<tr>';
for (var k = 0; k < 7; k++, j++) {
var day = (j >= 1 && j <= total) ? j : ''; // 前後非本月的格子留空
str += '<td><span' + (j == this.date ? ' class="selected"' : '')
+ ' onclick="' + this.name + '.redrawDate(this.innerText)">' + day + '</span></td>';
}
str += '</tr>';
}
return str + '</table>';
};
this.getDate = function (delimiter) {
var m = ("0" + (this.month + 1)).slice(-2);
var d = ("0" + this.date).slice(-2);
return [this.year, m, d].join(delimiter || "-");
};
<input type="text" id="bgntime" name="bgntime" onClick="showCal(bgntime);">
<div id="dateTime" onclick="event.cancelBubble=true"
style="position:absolute; visibility:hidden; z-index:100;">
<table class="cal_table" border="0">
<tr><td>
<script>var c = new CalendarCalendar('c'); document.write(c);</script>
</td></tr>
<tr><td align="center">
<script>var m = new CalendarMinute('m'); document.write(m);</script>
</td></tr>
</table>
</div>
<!-- 點擊文件任何處即收起面板 -->
<script event="onclick" for="document">hideCalendar()</script>
這份程式寫於 IE 一手遮天的年代,因此大量使用了 event.srcElement、document.write()、<script event= for=> 這類僅 Internet Explorer 認得的寫法,在今日的 Chrome、Firefox、Safari 中會失效。它的價值在於「用極少的程式碼把日期與時間面板拼在一起」這個思路,以及用 radix 自訂屬性統一處理數值上限的小技巧。
若是新專案,建議改用原生的 <input type="datetime-local">,或挑一套仍在維護的日期時間選擇器套件(多數已支援鍵盤操作、i18n 與手勢),並把「不可選過去日期」「時區」這些規則交給後端再驗證一次,前端校驗永遠只能當作文不對題時的第一道提示。