DIV CSS 佈局教程網

JavaScript 農曆與節氣完整演算法:資料表、轉換邏輯與月曆渲染
編輯:關於JavaScript     

要在純前端顯示農曆、干支、二十四節氣與傳統節日,靠的是一份壓縮過的資料表加上一套進位推算。以下把整個流程拆成資料、轉換、格式化、渲染四層來看。

一、農曆資料表與基本常數

每一年的農曆資訊被壓縮進一個十六進位整數:低 4 位記錄閏月是第幾月(0 表示無閏),0x10000 位表示閏月是大月還是29 天,其餘各位依序代表 12 個正月的長短。

var lunarInfo = new Array(
0x04bd8,0x04ae0,0x0a570,0x054d5,0x0d260,0x0d950,0x16554,0x056a0,0x09ad0,0x055d2,
0x04ae0,0x0a5b6,0x0a4d0,0x0d250,0x1d255,0x0b540,0x0d6a0,0x0ada2,0x095b0,0x14977,
0x04970,0x0a4b0,0x0b4b5,0x06a50,0x06d40,0x1ab54,0x02b60,0x09570,0x052f2,0x04970,
0x06566,0x0d4a0,0x0ea50,0x06e95,0x05ad0,0x02b60,0x186e3,0x092e0,0x1c8d7,0x0c950,
0x0d4a0,0x1d8a6,0x0b550,0x056a0,0x1a5b4,0x025d0,0x092d0,0x0d2b2,0x0a950,0x0b557,
0x06ca0,0x0b550,0x15355,0x04da0,0x0a5d0,0x14573,0x052d0,0x0a9a8,0x0e950,0x06aa0,
0x0aea6,0x0ab50,0x04b60,0x0aae4,0x0a570,0x05260,0x0f263,0x0d950,0x05b57,0x056a0,
0x096d0,0x04dd5,0x04ad0,0x0a4d0,0x0d4d4,0x0d250,0x0d558,0x0b540,0x0b5a0,0x195a6,
0x095b0,0x049b0,0x0a974,0x0a4b0,0x0b27a,0x06a50,0x06d40,0x0af46,0x0ab60,0x09570,
0x04af5,0x04970,0x064b0,0x074a3,0x0ea50,0x06b58,0x055c0,0x0ab60,0x096d5,0x092e0,
0x0c960,0x0d954,0x0d4a0,0x0da50,0x07552,0x056a0,0x0abb7,0x025d0,0x092d0,0x0cab5,
0x0a950,0x0b4a0,0x0baa4,0x0ad50,0x055d9,0x04ba0,0x0a5b0,0x15176,0x052b0,0x0a930,
0x07954,0x06aa0,0x0ad50,0x05b52,0x04b60,0x0a6e6,0x0a4e0,0x0d260,0x0ea65,0x0d530,
0x05aa0,0x076a3,0x096d0,0x04bd7,0x04ad0,0x0a4d0,0x1d0b6,0x0d250,0x0d520,0x0dd45,
0x0b5a0,0x056d0,0x055b2,0x049b0,0x0a577,0x0a4b0,0x0aa50,0x1b255,0x06d20,0x0ada0);

var Animals = new Array("鼠","牛","虎","兔","龍","蛇","馬","羊","猴","雞","狗","豬");
var Gan = new Array("甲","乙","丙","丁","戊","己","庚","辛","壬","癸");
var Zhi = new Array("子","丑","寅","卯","辰","巳","午","未","申","酉","戌","亥");

var now = new Date();
var SY = now.getFullYear();
var SM = now.getMonth();
var SD = now.getDate();

資料表的索引以 1900 年起算,因此這套演算法的適用範圍是 1900 到 2049 年。

二、位元運算取出各項資訊

// 傳入 offset,回傳干支,0 = 甲子
function cyclical(num) { return (Gan[num % 10] + Zhi[num % 12]); }

// 該農曆年的總天數
function lYearDays(y) {
  var i, sum = 348;
  for (i = 0x8000; i > 0x8; i >>= 1) sum += (lunarInfo[y - 1900] & i) ? 1 : 0;
  return (sum + leapDays(y));
}

// 閏月的天數
function leapDays(y) {
  if (leapMonth(y)) return ((lunarInfo[y - 1900] & 0x10000) ? 30 : 29);
  else return 0;
}

// 閏哪一個月,1-12,沒有閏月回傳 0
function leapMonth(y) { return (lunarInfo[y - 1900] & 0xf); }

// 農曆 y 年 m 月的總天數
function monthDays(y, m) { return ((lunarInfo[y - 1900] & (0x10000 >> m)) ? 30 : 29); }

lYearDays 的起點 348 是「12 個月每月 29 天」,接著每遇到一個大月就補一天,最後再加上閏月。整段邏輯就是移位搭配 AND 判斷某一位是 0 還是 1。

三、西元轉農曆的核心

// 傳入 Date 物件,回傳帶有 year/month/day/isLeap/yearCyl/dayCyl/monCyl 屬性的物件
function Lunar(objDate) {
  var i, leap = 0, temp = 0;
  var baseDate = new Date(1900, 0, 31);          // 1900-01-31 為農曆 1900 年正月初一
  var offset = (objDate - baseDate) / 86400000;  // 相差的天數

  this.dayCyl = offset + 40;
  this.monCyl = 14;

  // 先扣掉整年,找出年份
  for (i = 1900; i < 2050 && offset > 0; i++) {
    temp = lYearDays(i);
    offset -= temp;
    this.monCyl += 12;
  }
  if (offset < 0) { offset += temp; i--; this.monCyl -= 12; }

  this.year = i;
  this.yearCyl = i - 1864;

  leap = leapMonth(i);
  this.isLeap = false;

  // 再扣掉整月,找出月份
  for (i = 1; i < 13 && offset > 0; i++) {
    if (leap > 0 && i == (leap + 1) && this.isLeap == false) {
      --i; this.isLeap = true; temp = leapDays(this.year);
    } else {
      temp = monthDays(this.year, i);
    }
    if (this.isLeap == true && i == (leap + 1)) this.isLeap = false;

    offset -= temp;
    if (this.isLeap == false) this.monCyl++;
  }

  if (offset == 0 && leap > 0 && i == leap + 1) {
    if (this.isLeap) { this.isLeap = false; }
    else { this.isLeap = true; --i; --this.monCyl; }
  }
  if (offset < 0) { offset += temp; --i; --this.monCyl; }

  this.month = i;
  this.day = offset + 1;
}

整個轉換就是「總天數差 → 逐年扣 → 逐月扣 → 剩下的就是日子」。閏月處理之所以看起來繞,是因為閏月並不佔用月份編號,必須在迴圈裡把 i 往回退一格,才能讓同一個數字代表兩個月。

四、格式化輸出

// 中文月日
function cDay(m, d) {
  var nStr1 = new Array('日','一','二','三','四','五','六','七','八','九','十');
  var nStr2 = new Array('初','十','廿','卅',' ');
  var s;
  if (m > 10) { s = '十' + nStr1[m - 10]; } else { s = nStr1[m]; }
  s += '月';
  switch (d) {
    case 10: s += '初十'; break;
    case 20: s += '二十'; break;
    case 30: s += '三十'; break;
    default: s += nStr2[Math.floor(d / 10)]; s += nStr1[d % 10];
  }
  return s;
}

// 農曆表示
function solarDay2() {
  var lDObj = new Lunar(new Date(SY, SM, SD));
  var cl = '<font color="#000066" STYLE="font-size:9pt;">';
  return (cl + '農歷' + cDay(lDObj.month, lDObj.day) + '</font>');
}

五、節氣與節日比對

function solarDay3() {
  var sTermInfo = new Array(0,21208,42467,63836,85337,107014,128867,150921,173149,
    195551,218072,240693,263343,285989,308563,331033,353350,375494,397447,419210,
    440795,462224,483532,504758);
  var solarTerm = new Array("小寒","大寒","立春","雨水","驚蟄","春分","清明","谷雨",
    "立夏","小滿","芒種","夏至","小暑","大暑","立秋","處暑","白露","秋分","寒露",
    "霜降","立冬","小雪","大雪","冬至");
  var lFtv = new Array("0101*春節","0115 元宵節","0505 端午節","0707 七夕情人節",
    "0715 中元節","0815 中秋節","0909 重陽節","1208 臘八節","1224 小年","0100*除夕");
  var sFtv = new Array("0101*元旦","0214 情人節","0308 婦女節","0312 植樹節",
    "0315 消費者權益日","0401 愚人節","0501 勞動節","0504 青年節","0512 護士節",
    "0601 兒童節","0701 建黨節 香港回歸紀念","0801 建軍節","0808 父親節",
    "0909 南晟網周年紀念日","0910 教師節","0928 孔子誕辰","1001*國慶節",
    "1006 老人節","1024 聯合國日","1112 孫中山誕辰","1220 澳門回歸紀念",
    "1225 聖誕節","1226 毛主席誕辰");

  var lDObj = new Lunar(new Date(SY, SM, SD));
  var festival = '', solarTerms = '', solarFestival = '', lunarFestival = '', tmp1, tmp2;

  // 農曆節日
  for (var i in lFtv)
    if (lFtv[i].match(/^(\d{2})(.{2})([\s\*])(.+)$/)) {
      tmp1 = Number(RegExp.$1) - lDObj.month;
      tmp2 = Number(RegExp.$2) - lDObj.day;
      if (tmp1 == 0 && tmp2 == 0) lunarFestival = RegExp.$4;
    }

  // 國曆節日
  for (var i in sFtv)
    if (sFtv[i].match(/^(\d{2})(\d{2})([\s\*])(.+)$/)) {
      tmp1 = Number(RegExp.$1) - (SM + 1);
      tmp2 = Number(RegExp.$2) - SD;
      if (tmp1 == 0 && tmp2 == 0) solarFestival = RegExp.$4;
    }

  // 節氣
  tmp1 = new Date((31556925974.7 * (SY - 1900) + sTermInfo[SM * 2 + 1] * 60000) + Date.UTC(1900, 0, 6, 2, 5));
  if (tmp1.getUTCDate() == SD) solarTerms = solarTerm[SM * 2 + 1];
  tmp1 = new Date((31556925974.7 * (SY - 1900) + sTermInfo[SM * 2] * 60000) + Date.UTC(1900, 0, 6, 2, 5));
  if (tmp1.getUTCDate() == SD) solarTerms = solarTerm[SM * 2];

  if (solarTerms == '' && solarFestival == '' && lunarFestival == '') festival = '';
  else festival = '<FONT COLOR="#ff0000" STYLE="font-size:9pt;">' +
                 solarTerms + ' ' + solarFestival + ' ' + lunarFestival + '</FONT>';

  return ('<font color="#000066" STYLE="font-size:9pt;">' + festival + '</font>');
}

節氣的算法是另一套:以 1900 年小寒為基準,用回歸年長度 31556925974.7 毫秒累加,再加上每個節氣的偏移分鐘數,最後取 UTC 日期比對。精度足以應付日常顯示,但嚴格的天文節氣需另循 VSOP87 等更精確的模型。

六、月曆渲染

// 該月陽曆天數
function getNowMonthDays(year, month) {
  var isy = (year % 400 == 0 || (year % 4 == 0 && year % 100 != 0));
  switch (month) {
    case 1: case 3: case 5: case 7: case 8: case 10: case 12: return 31;
    case 4: case 6: case 9: case 11: return 30;
    case 2: return isy ? 29 : 28;
  }
}

// 某日曆日
function getSolarDay(year, month, day) {
  var lDObj = new Lunar(new Date(year, month, day));
  return cDay(lDObj.month, lDObj.day);
}

// 月視圖
function showMonth() {
  var days = getNowMonthDays(SY, SM + 1);
  var startweek = getStartWeek();
  var html = "<tr><td>星期一</td><td>星期二</td><td>星期三</td>" +
             "<td>星期四</td><td>星期五</td><td>星期六</td>" +
             "<td>星期日</td></tr><tr>";
  var index = 0;

  for (var i = 1; i < startweek; i++) { html += "<td> </td>"; index++; }

  for (var i = 1; i <= days; i++) {
    if (index % 7 == 0) html += "</tr><tr>";
    html += "<td>" + i + "<br>" + getSolarDay(SY, SM, i) + "</td>";
    index++;
  }
  while (index % 7 != 0) { html += "<td> </td>"; index++; }
  html += "</tr>";

  $("#table_calendar").html(html);
}

七、使用這套程式時該注意的事

效能。月曆渲染會對每一天呼叫一次 Lunar,而 Lunar 內部是兩層迴圈。單純顯示一個月還好,若要一次算整年,請把結果快取起來,不要反覆重算。

for...in 的陷阱。原範例用 for (var i in lFtv) 走訪陣列,這會把 Array.prototype 上被擴充的屬性也一併 enumerate,請改用一般 for 迴圈或 forEach。

innerHTML 拼接的字串。範例大量用字串組 html,若資料來源不是自己寫死的,就有 XSS 風險。改用 DOM API 建立節點,或至少對插入的文字做 escape。

Intl API 是更好的選擇。如果目標只是顯示農曆日期,現代瀏覽器已內建支援:new Intl.DateTimeFormat('zh-TW-u-ca-chinese', { dateStyle: 'full' }).format(new Date()) 就能直接產出農曆格式,不必背資料表。需要節氣、干支或自訂節日對照時,才值得沿用上面這套完整實作。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved