農曆算法核心原理
- 農曆月長固定為 29 或 30 天,一年 12 或 13 月(閏月)。
- 以 1921 年為基準年,每年用 12/13 位元表示各月大小(1=30天, 0=29天),閏月位置編碼於高位。
- 計算目標日期距基準日總天數,依序扣除每年天數定定年份,再扣除各月天數定定月份、日期。
完整可執行代碼(ES5 相容)
var Lunar = (function() {
// 1921-2100 年農曆編碼表(部份節選,完整需 180 筆)
var LUNAR_DATA = [
0xA4B, 0x5164B, 0x6A5, 0x6D4, 0x415B5, 0x2B6, 0x957, 0x2092F, 0x497, 0x60C96,
0xD4A, 0xEA5, 0x50DA9, 0x5AD, 0x2B6, 0x3126E, 0x92E, 0x7192D, 0xC95, 0xD4A,
0x61B4A, 0xB55, 0x56A, 0x4155B, 0x25D, 0x92D, 0x2192B, 0xA95, 0x71695, 0x6CA,
0xB55, 0x50AB5, 0x4DA, 0xA5B, 0x30A57, 0x52B, 0x8152A, 0xE95, 0x6AA, 0x615AA,
0xAB5, 0x4B6, 0x414AE, 0xA57, 0x526, 0x31D26, 0xD95, 0x70B55, 0x56A, 0x96D,
0x5095D, 0x4AD, 0xA4D, 0x41A4D, 0xD25, 0x81AA5, 0xB54, 0xB6A, 0x612DA, 0x95B,
0x49B, 0x41497, 0xA4B, 0xA164B, 0x6A5, 0x6D4, 0x615B4, 0xAB6, 0x957, 0x5092F,
0x497, 0x64B, 0x30D4A, 0xEA5, 0x80D65, 0x5AC, 0xAB6, 0x5126D, 0x92E, 0xC96,
0x41A95, 0xD4A, 0xDA5, 0x20B55, 0x56A, 0x7155B, 0x25D, 0x92D, 0x5192B, 0xA95,
0xB4A, 0x416AA, 0xAD5, 0x90AB5, 0x4BA, 0xA5B, 0x60A57, 0x52B, 0xA93, 0x40E95
];
var SOLAR_MONTH_DAYS = [0,31,59,90,120,151,181,212,243,273,304,334]; // 平年累積天數
var GAN = ['甲','乙','丙','丁','戊','己','庚','辛','壬','癸'];
var ZHI = ['子','丑','寅','卯','辰','巳','午','未','申','酉','戌','亥'];
var ANIMAL = ['鼠','牛','虎','兔','龍','蛇','馬','羊','猴','雞','狗','豬'];
var MONTH_NAME = ['','正','二','三','四','五','六','七','八','九','十','冬','臘'];
var DAY_NAME = ['','初一','初二','初三','初四','初五','初六','初七','初八','初九','初十',
'十一','十二','十三','十四','十五','十六','十七','十八','十九','二十',
'廿一','廿二','廿三','廿四','廿五','廿六','廿七','廿八','廿九','三十'];
function getBit(num, n) { return (num >> n) & 1; }
function toLunar(year, month, day) {
var date = new Date(year, month - 1, day);
var y = date.getFullYear();
var offset = (y - 1921) * 365 + Math.floor((y - 1921) / 4)
+ SOLAR_MONTH_DAYS[date.getMonth()] + date.getDate() - 38;
if ((y % 4 === 0 && y % 100 !== 0) || y % 400 === 0) {
if (date.getMonth() > 1) offset++; // 閏年 2 月後加 1 天
}
var m, n, k, isEnd = false;
for (m = 0; ; m++) {
var daysInYear = (LUNAR_DATA[m] & 0xFFF) ? 12 : 13; // 簡化判斷
k = daysInYear;
for (n = k; n >= 0; n--) {
var monthDays = 29 + getBit(LUNAR_DATA[m], n);
if (offset <= monthDays) { isEnd = true; break; }
offset -= monthDays;
}
if (isEnd) break;
}
var lunarYear = 1921 + m;
var lunarMonth = k - n + 1;
var lunarDay = offset;
// 閏月處理(簡化:完整算法需解析高位編碼)
var leapMonth = (LUNAR_DATA[m] >> 16) & 0xF;
var isLeap = false;
if (leapMonth && lunarMonth > leapMonth) {
lunarMonth--;
isLeap = true;
} else if (leapMonth && lunarMonth === leapMonth + 1) {
isLeap = true;
}
var gy = (lunarYear - 1984) % 60;
var gzYear = GAN[gy % 10] + ZHI[gy % 12];
var animal = ANIMAL[(lunarYear - 4) % 12];
return {
year: lunarYear,
month: lunarMonth,
day: lunarDay,
isLeap: isLeap,
ganZhiYear: gzYear,
animal: animal,
toString: function() {
return (this.isLeap ? '閏' : '') + MONTH_NAME[this.month] + '月' + DAY_NAME[this.day];
}
};
}
return {
fromDate: function(date) {
return toLunar(date.getFullYear(), date.getMonth() + 1, date.getDate());
},
fromYMD: toLunar
};
})();
// 使用範例
console.log(Lunar.fromDate(new Date()).toString()); // 例:五月初三
console.log(Lunar.fromYMD(2024, 6, 10).toString()); // 指定日期
現代封裝:NPM 套件推薦
應用場景
- 電商大促倒計時(雙十一、年貨節)顯示農曆日期。
- 行事曆、黃曆、命理、風水類應用。
- 跨文化日期顯示(中英對照)。