線上表單要填日期,與其讓使用者手打 2026-08-26 還得擔心格式寫錯,不如給他一個日曆點一下就好。這份實作完全由 JavaScript 手寫,不需要任何外部程式庫。
var gMonths = new Array("一月","二月","三月","四月","五月","六月","七月","八月","九月","十月","十一月","十二月");
var WeekDay = new Array("日","一","二","三","四","五","六");
var strToday = "今天";
var strYear = "年";
var strMonth = "月";
var strDay = "日";
var splitChar = "-";
var startYear = 2000;
var endYear = 2050;
var dayTdHeight = 12;
var dayTdTextSize = 12;
把月份名稱、分隔符號、年份範圍、格子高度全部提到頂部,日後要改樣式或改語系不必翻遍整份程式。這是好習慣的起點。
接著是一組配色變數,分別控制非本月日期、週末、平常日、滑鼠移入移出、以及「今天」的各種狀態顏色:gcNotCurMonth、gcRestDay、gcWorkDay、gcMouseOver、gcMouseOut、gcToday 等等。把顏色集中管理,換主題時只改這一段。
function $(id) { return document.getElementById(id); }
function $V(id) { return $(id).value; }
這兩個是自己寫的短別名,省下大量重複打字。當年 jQuery 還不普及,這種 $ 簡寫幾乎每個專案都有一份——也正因如此,它跟其他庫的 $ 撞名是家常便飯。
Array.prototype.Push = function() {
var startLength = this.length;
for (var i = 0; i < arguments.length; i++) { this[startLength + i] = arguments[i]; }
return this.length;
}
這是模仿其他語言的 push 行為,順便示範了 arguments 的用法。今天直接用原生 push 就好,而且不建議擴充 Array.prototype。
function fBuildCal(iYear, iMonth) {
var aMonth = new Array();
for (var i = 1; i < 7; i++) aMonth[i] = new Array(i);
var dCalDate = new Date(iYear, iMonth - 1, 1);
var iDayOfFirst = dCalDate.getDay(); // 該月第一天是星期幾
var iDaysInMonth = new Date(iYear, iMonth, 0).getDate(); // 該月總天數
var iOffsetLast = new Date(iYear, iMonth - 1, 0).getDate() - iDayOfFirst + 1;
var iDate = 1;
var iNext = 1;
for (var d = 0; d < 7; d++) {
aMonth[1][d] = (d < iDayOfFirst) ? (iOffsetLast + d) * (-1) : iDate++;
}
for (var w = 2; w < 7; w++) {
for (var d = 0; d < 7; d++) {
aMonth[w][d] = (iDate <= iDaysInMonth) ? iDate++ : (iNext++) * (-1);
}
}
return aMonth;
}
這個函式是整份程式的核心,值得多看兩眼。它用了一個很聰明的技巧:用負數表示「不屬於這個月的日期」。第一列開頭不屬於本月的補位日期是負的,本月跑完之後用來填滿 6×7 格子的下個月日期也是負的。後續繪製時只要判斷正負,就知道要用哪個顏色、要不要可點擊。
另外注意 new Date(iYear, iMonth, 0).getDate() 這個寫法:日期的第 0 天會被 JavaScript 正規化成「上個月的最後一天」,所以傳入「本月 + 1 的月份、第 0 天」就能拿到本月的總天數。這是處理日曆時非常常用的一招,比自己做月份對照表可靠得多。
function fDrawCal(iYear, iMonth, iCellHeight, iDateTextSize) {
var styleTD = " valign='middle' align='center' style='height:" + iCellHeight + "px;font-weight:bolder;font-size:" + iDateTextSize + "px;";
var dateCal = "<tr>";
for (var i = 0; i < 7; i++) {
dateCal += "<td" + styleTD + "color:#990099'>" + WeekDay[i] + "</td>";
}
dateCal += "</tr>";
for (var w = 1; w < 7; w++) {
dateCal += "<tr>";
for (var d = 0; d < 7; d++) {
var tmpid = w + "" + d;
dateCal += "<td" + styleTD + "cursor:pointer;' onclick='fSetSelected(" + tmpid + ")'>";
dateCal += "<span id='cellText" + tmpid + "'></span>";
dateCal += "</td>";
}
dateCal += "</tr>";
}
return dateCal;
}
每個格子有兩層:外層 td 負責點擊事件,內層 span 帶一個像 cellText11、cellText52 這樣的 id(行號接著列號)。後續更新日期時,就能精準地找到某一格去改內容與顏色。
function fSetDate(iYear, iMonth, iDay) {
var iMonthNew = new String(iMonth);
var iDayNew = new String(iDay);
if (iMonthNew.length < 2) iMonthNew = "0" + iMonthNew;
if (iDayNew.length < 2) iDayNew = "0" + iDayNew;
gdCtrl.value = iYear + splitChar + iMonthNew + splitChar + iDayNew;
fHideCalendar();
}
這裡做了兩件重要的事:月和日不足兩位時補零(避免出現 2026-8-6 這種排序會出錯的格式),以及寫入後立刻關閉日曆。gdCtrl 是一個全域變數,記著「目前要填給哪個輸入框」,所以同一份日曆程式碼可以服務頁面上任何數量的日期欄位。
function fGetXY(aTag) {
var oTmp = aTag;
var pt = new Point(0, 0);
do {
pt.x += oTmp.offsetLeft;
pt.y += oTmp.offsetTop;
oTmp = oTmp.offsetParent;
} while (oTmp.tagName.toUpperCase() != "BODY");
return pt;
}
這是取得元素絕對座標的經典寫法:沿著 offsetParent 鏈一路往上累加 offsetLeft/Top,直到抵達 body。今天可以直接用 getBoundingClientRect() 一行解決,但理解這個迴圈有助於搞懂瀏覽器的定位模型。
function fPopCalendar(evt, popCtrl, dateCtrl) {
evt.cancelBubble = true;
gdCtrl = dateCtrl;
fSetYearMon(giYear, giMonth);
var point = fGetXY(popCtrl);
with ($("calendardiv").style) {
left = point.x + "px";
top = (point.y + popCtrl.offsetHeight + 1) + "px";
visibility = 'visible';
zIndex = '99';
position = 'absolute';
}
$("calendardiv").focus();
}
日曆容器是 position: absolute,座標算好之後設上去,剛好落在輸入框下方一個像素的位置。evt.cancelBubble = true 是為了避免這次點擊冒泡到 document 而被「點擊外部關閉」的邏輯立刻關掉。
<body>
<input type="text" style="border:1px solid #999;" readonly="readonly"
onclick="fPopCalendar(event, this, this)" onfocus="this.select()" />
</body>
加上 readonly 是刻意的:使用者不能手打,只能從日曆選,格式因此永遠正確。這在資料需要被後端嚴格解析時很有價值。
這份程式寫於原生 DOM 操作的全盛期,大約六百行做完了今天一行標籤就能做到的事:
<input type="date" value="2026-08-26" />
原生 date 型別自帶日曆、鍵盤操作、行動裝置的原生選取器與無障礙支援,還能搭配 min、max 限制範圍。若需要更豐富的呈現(例如含時分、語系客製),才會考慮引入成熟套件。
不過手寫一遍仍有意義:你會真正理解「某月第一天是星期幾」、「該月有幾天」、「閏年怎麼判斷」這些問題該怎麼算,而不只是會呼叫 API。這些觀念在處理報表期間、訂閱週期、時區換算時一定會回來找你。