想在網頁上顯示一個兼具國曆、農曆、每週與節氣的日曆?本文示範如何以 JavaScript 實作,核心是一份描述農曆閏月與大小月的壓縮資料表,再透過位元運算還原出每一天的農曆資訊。
1900 至 2050 年間每年的農曆資訊,被壓縮成一串十六進位數字。每個數字以位元編碼了該年的閏月位置、各月大小等資訊:
var lunarInfo = new Array(
0x04bd8,0x04ae0,0x0a570,0x054d5,0x0d260,0x0d950,0x16554,0x056a0,0x09ad0,0x055d2,
// ...後續年份依此類推
0x0b5a0,0x056d0,0x055b2,0x049b0,0x0a577,0x0a4b0,0x0aa50,0x1b255,0x06d20,0x0ada0
);
var Animals = new Array("鼠","牛","虎","兔","龍","蛇","馬","羊","猴","雞","狗","豬");
var Gan = new Array("甲","乙","丙","丁","戊","己","庚","辛","壬","癸");
var Zhi = new Array("子","丑","寅","卯","辰","巳","午","未","申","酉","戌","亥");
透過位元運算,可以從壓縮資料中還原各種資訊:
// 回傳農曆某年的閏月(1-12,無閏則為 0)
function leapMonth(y) { return (lunarInfo[y - 1900] & 0xf); }
// 回傳農曆某年閏月的天數
function leapDays(y) {
if (leapMonth(y))
return ((lunarInfo[y - 1900] & 0x10000) ? 30 : 29);
else
return 0;
}
// 回傳農曆某年某月的總天數
function monthDays(y, m) {
return ((lunarInfo[y - 1900] & (0x10000 >> m)) ? 30 : 29);
}
// 天干地支紀年
function cyclical(num) {
return (Gan[num % 10] + Zhi[num % 12]);
}
Lunar 函式接收一個 Date 物件,先算出它與 1900 年 1 月 31 日(農曆基準日)相差的天數,再逐年、逐月扣除,就能得到對應的農曆年、月、日,並判斷是否為閏月。
程式碼中還包含了 24 節氣(solarTerm)與農曆/國曆節日(如春節、端午、國慶)的比對邏輯,用一組预先算好的時間偏移量來判斷當天是否為某個節氣或節日。
最後由 setCalendar() 把國曆日期、星期、生肖、干支、農曆日期與節日拼湊成一段 HTML,再用 jQuery 寫入頁面的容器中:
$(document).ready(function () {
var temDate = new Date();
var xxx = getDateList(temDate.getFullYear(), temDate.getMonth(), temDate.getDate());
$("#sss").html(xxx);
});
這套「壓縮資料表 + 位元運算」的經典做法,能在極小的程式碼量下完成完整的農曆計算,是許多線上日曆元件的基礎。