萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 計算農曆日期:演算法原理與完整可用代碼

農曆算法核心原理

  • 農曆月長固定為 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 套件推薦

應用場景

  • 電商大促倒計時(雙十一、年貨節)顯示農曆日期。
  • 行事曆、黃曆、命理、風水類應用。
  • 跨文化日期顯示(中英對照)。
copyright © 萬盛學電腦網 all rights reserved