網路上找到的幾個日期選擇程式總有些毛病,於是決定重寫一個,順手加上時間選擇功能。大部分思路仍借鑑前人的經驗,但加了兩項實用改進:可選到時與分,以及在彈出時自動隱藏會遮擋它的 select 與 object 標籤。
一開始想用 window.createPopup() 彈出日曆,這樣就能跨過任何標籤、永遠在最上層。做到中途發現理論上行不通,有兩個原因:
一是 popup 視窗在窗體外單擊任何地方都會關閉。而使用者用下拉框選年份時,很可能會滑到窗體外——雖然可以自己寫 select 來避開,但麻煩。
二是 popup 的寬高只能在彈出時設定,而日曆在不同年月下高度會改變(某些月只占四列、某些占五列),無法動態調整。
於是改回普通的絕對定位 div 方案。

var s_tiannet_turn_base = "height:16px;font-size:9pt;color:white;border:0 solid #CCCCCC;cursor:hand;background-color:#2650A6;";
var s_tiannet_turn = "width:28px;" + s_tiannet_turn_base; // 翻年、翻月按鈕
var s_tiannet_turn2 = "width:22px;" + s_tiannet_turn_base; // 關閉、清空按鈕
var s_tiannet_select = "width:64px;display:none;"; // 年份下拉
var s_tiannet_select2 = "width:46px;display:none;"; // 月、時、分下拉
var s_tiannet_body = "width:150;background-color:#2650A6;display:none;z-index:9998;position:absolute;";
var s_tiannet_day = "width:21px;height:20px;background-color:#D8F0FC;font-size:10pt;";
用變數組出樣式字串,共用基底再加上差異部分。這是在 CSS 預處理器普及之前的常見做法——用 JavaScript 變數拼接來達到「樣式繼承」的效果。今天用 Sass 的 @extend 或 placeholder 會乾淨得多。
var tiannetYearSt = 1950; // 可選擇的起始年
var tiannetYearEnd = 2010; // 可選擇的結束年
var tiannetDateNow = new Date();
var tiannetYear = tiannetDateNow.getFullYear();
var tiannetMonth = tiannetDateNow.getMonth() + 1;
var tiannetDay = tiannetDateNow.getDate();
var tiannetHour = 8;
var tiannetMinute = 0;
var tiannetArrDay = new Array(42); // 寫日期用的陣列
var tiannetDateSplit = "-"; // 日期分隔符
var tiannetDateTimeSplit = " "; // 日期與時間的分隔
var tiannetTimeSplit = ":"; // 時間分隔符
var tiannetOutObject; // 接收結果的物件
var arrTiannetHide = new Array(); // 被強制隱藏的標籤
var m_bolShowHour = false; // 是否顯示小時
var m_bolShowMinute = false; // 是否顯示分鐘
三個分隔符各自獨立,讓輸出格式可以客製成 2026/08/26 14:30 或其他樣式。注意 tiannetHour 預設是 8 而不是現在時間——原作者刻意讓時間欄位有個整齊的預設值,避免開啟時出現奇怪的分秒。
// 只選日期
function setDay(obj) {
tiannetOutObject = obj;
var strValue = tiannetTrim(tiannetOutObject.value);
if (strValue != "") { tiannetInitDate(strValue); }
tiannetPopCalendar();
}
// 選日期和小時
function setDayH(obj) {
tiannetOutObject = obj;
m_bolShowHour = true;
var strValue = tiannetTrim(tiannetOutObject.value);
if (strValue != "") {
tiannetInitDate(strValue.substring(0, 10));
var hour = strValue.substring(11, 13);
if (hour < 10) tiannetHour = hour.substring(1, 2);
}
tiannetPopCalendar();
}
// 選日期、小時和分鐘
function setDayHM(obj) {
tiannetOutObject = obj;
m_bolShowHour = true;
m_bolShowMinute = true;
var strValue = tiannetTrim(tiannetOutObject.value);
if (strValue != "") {
tiannetInitDate(strValue.substring(0, 10));
var arr = strValue.substring(11, 16).split(tiannetTimeSplit);
tiannetHour = arr[0];
tiannetMinute = arr[1];
}
tiannetPopCalendar();
}
三個函式共用同一份 UI,只靠兩個布林旗標決定要不要顯示時、分。這種「一個元件、多種模式」的設計,比寫三份日曆程式好維護太多。而且每個函式開頭都先讀輸入框現有的值來初始化狀態——使用者第二次打開時,游標會停在上次選的位置,而不是跳回今天。
var m_aMonHead = new Array(12);
m_aMonHead[0]=31; m_aMonHead[1]=28; m_aMonHead[2]=31; m_aMonHead[3]=30;
m_aMonHead[4]=31; m_aMonHead[5]=30; m_aMonHead[6]=31; m_aMonHead[7]=31;
m_aMonHead[8]=30; m_aMonHead[9]=31; m_aMonHead[10]=30; m_aMonHead[11]=31;
function isPinYear(year) {
if (0 == year % 4 && ((year % 100 != 0) || (year % 400 == 0))) return true;
return false;
}
function getMonthCount(year, month) {
var c = m_aMonHead[month - 1];
if ((month == 2) && isPinYear(year)) c++;
return c;
}
閏年判斷寫得正確:「能被 4 整除,但不能被 100 整除,除非也能被 400 整除」。這個規則很多人只記得前半段,於是 1900 年會被誤判為閏年。順帶一提,用 new Date(year, month, 0).getDate() 也能拿到天數,是更不容易寫錯的替代方案。
function setRealDayCount() {
if (tiannetDay > getMonthCount(tiannetYear, tiannetMonth)) {
tiannetDay = getMonthCount(tiannetYear, tiannetMonth);
}
}
這是個容易忽略的邊界情況:使用者在 1 月 31 日,按下「下一月」,2 月沒有 31 日。若不處理,日期會變成 2 月 31 日這種不存在的組合。這裡的做法是夾到當月的最後一天。翻年月時都會先呼叫這個函式。
function tiannetHideObject(strTagName) {
x = document.all.divTiannetDate.offsetLeft;
y = document.all.divTiannetDate.offsetTop;
h = document.all.divTiannetDate.offsetHeight;
w = document.all.divTiannetDate.offsetWidth;
for (var i = 0; i < document.all.tags(strTagName).length; i++) {
var obj = document.all.tags(strTagName)[i];
if (!obj || !obj.offsetParent) continue;
// 取得元素相對於 BODY 的座標
var objLeft = obj.offsetLeft, objTop = obj.offsetTop;
var objHeight = obj.offsetHeight, objWidth = obj.offsetWidth;
var objParent = obj.offsetParent;
while (objParent.tagName.toUpperCase() != "BODY") {
objLeft += objParent.offsetLeft;
objTop += objParent.offsetTop;
objParent = objParent.offsetParent;
}
var bolHide = true;
if (obj.style.display == "none" || obj.style.visibility == "hidden"
|| obj.getAttribute("Author") == "tiannet") {
bolHide = false; // 本來就隱藏的、或日曆自己的下拉,不必動
}
if (((objLeft + objWidth) > x && (y + h + 20) > objTop && (objTop + objHeight) > y && objLeft < (x + w)) && bolHide) {
arrTiannetHide[arrTiannetHide.length] = obj;
obj.style.visibility = "hidden";
}
}
}
這個函式是整份程式最有意思的部分。它做的是矩形碰撞偵測:算出日曆的包圍盒(x, y, w, h),再逐一比對每個 select/object 的位置,判斷兩者是否重疊。那四個條件合起來就是標準的 AABB 相交測試——「A 的右邊在 B 的左邊之外,且 A 的下邊在 B 的上邊之外……」全部成立才算重疊。
被判定為重疊的標籤會記錄到 arrTiannetHide 陣列並設為 visibility: hidden;關閉日曆時 tiannetShowObject() 再把它們逐一還原。用「記錄起來再還原」而不是「一律還原」,是為了不干擾本來就被隱藏的元素。
這個問題的存在完全是因為 IE6 的 select 是原生視窗元件、不受 z-index 約束。在現代瀏覽器裡,這一整段都可以刪掉了。
function document.onclick() {
with (window.event.srcElement) {
if (tagName != "INPUT" && getAttribute("Author") != "tiannet")
tiannetHideControl();
}
}
function document.onkeypress() {
if (event.keyCode == 27) { tiannetHideControl(); }
}
這兩個函式實作了兩個基本的互動期待:點其他地方關閉、按 ESC 關閉。用自訂的 Author="tiannet" 屬性來標記「這是我自己的元素,不要當成外部點擊」,是個聰明但需要寫註解說明的技巧——否則後人完全看不懂這個屬性的用途。
<script src="./Calendar.js"></script>
<body>
(1) 只選擇日期 <input type="text" name="date" readOnly onClick="setDay(this);"><br/>
(2) 選擇日期和小時 <input type="text" name="dateh" readOnly onClick="setDayH(this);"><br/>
(3) 選擇日期和小時及分鐘 <input type="text" name="datehm" readOnly onClick="setDayHM(this);">
</body>
全部邏輯都在外部 js 檔,頁面只要三個 input 和三次函式呼叫。加上 readOnly 確保格式統一,這才是元件該有的樣子。
今天你只需要寫 <input type="datetime-local">,瀏覽器會給你完整的日期時間選擇器,還附帶鍵盤操作與行動裝置體驗。
但這份程式仍然值得讀完,因為裡面的問題都是真實且會再出現的:跨月時日期溢出怎麼辦、閏年怎麼判斷、浮層如何避免被其他元件遮蓋、點擊外部關閉如何不誤觸自己、狀態如何保留讓使用者回到上次的位置。這些跟你用什麼框架、寫在哪個年代毫無關係。