/** * 农历转换工具 * 支持 1900-2100 年的公历农历互转 */ // 农历数据表 (1900-2100) // 每个数字的后12位代表12个月,1为大月(30天),0为小月(29天) // 前4位代表闰月月份,0表示无闰月 const lunarInfo = [ 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, 0x0a5b0, 0x14573, 0x052b0, 0x0a9a8, 0x0e950, 0x06aa0, 0x0aea6, 0x0ab50, 0x04b60, 0x0aae4, 0x0a570, 0x05260, 0x0f263, 0x0d950, 0x05b57, 0x056a0, 0x096d0, 0x04dd5, 0x04ad0, 0x0a4d0, 0x0d4d4, 0x0d250, 0x0d558, 0x0b540, 0x0b6a0, 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, 0x04afb, 0x04ad0, 0x0a4d0, 0x1d0b6, 0x0d250, 0x0d520, 0x0dd45, 0x0b5a0, 0x056d0, 0x055b2, 0x049b0, 0x0a577, 0x0a4b0, 0x0aa50, 0x1b255, 0x06d20, 0x0ada0, 0x14b63, 0x09370, 0x049f8, 0x04970, 0x064b0, 0x168a6, 0x0ea50, 0x06b20, 0x1a6c4, 0x0aae0, 0x0a2e0, 0x0d2e3, 0x0c960, 0x0d557, 0x0d4a0, 0x0da50, 0x05d55, 0x056a0, 0x0a6d0, 0x055d4, 0x052d0, 0x0a9b8, 0x0a950, 0x0b4a0, 0x0b6a6, 0x0ad50, 0x055a0, 0x0aba4, 0x0a5b0, 0x052b0, 0x0b273, 0x06930, 0x07337, 0x06aa0, 0x0ad50, 0x14b55, 0x04b60, 0x0a570, 0x054e4, 0x0d160, 0x0e968, 0x0d520, 0x0daa0, 0x16aa6, 0x056d0, 0x04ae0, 0x0a9d4, 0x0a2d0, 0x0d150, 0x0f252, 0x0d520, ] // 天干 const Gan = ['甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'] // 地支 const Zhi = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'] // 生肖 const Animals = ['鼠', '牛', '虎', '兔', '龙', '蛇', '马', '羊', '猴', '鸡', '狗', '猪'] // 农历月份 const lunarMonths = ['正', '二', '三', '四', '五', '六', '七', '八', '九', '十', '冬', '腊'] // 农历日期 const lunarDays = [ '初一', '初二', '初三', '初四', '初五', '初六', '初七', '初八', '初九', '初十', '十一', '十二', '十三', '十四', '十五', '十六', '十七', '十八', '十九', '二十', '廿一', '廿二', '廿三', '廿四', '廿五', '廿六', '廿七', '廿八', '廿九', '三十', ] /** * 获取农历年份的闰月月份 * @param year 农历年份 * @returns 闰月月份,0表示无闰月 */ function leapMonth(year: number): number { return lunarInfo[year - 1900] & 0xf } /** * 获取农历年份的闰月天数 * @param year 农历年份 * @returns 闰月天数 */ function leapDays(year: number): number { if (leapMonth(year)) { return lunarInfo[year - 1900] & 0x10000 ? 30 : 29 } return 0 } /** * 获取农历年份的总天数 * @param year 农历年份 * @returns 总天数 */ function yearDays(year: number): number { let sum = 348 for (let i = 0x8000; i > 0x8; i >>= 1) { sum += lunarInfo[year - 1900] & i ? 1 : 0 } return sum + leapDays(year) } /** * 获取农历年份某月的天数 * @param year 农历年份 * @param month 农历月份 * @returns 该月天数 */ function monthDays(year: number, month: number): number { return lunarInfo[year - 1900] & (0x10000 >> month) ? 30 : 29 } /** * 公历转农历 * @param date 公历日期 * @returns 农历信息,如果日期超出范围则返回null */ export function solar2lunar(date: Date) { const inputYear = date.getFullYear() // 检查年份范围 if (inputYear < 1900 || inputYear > 2100) { return null } const baseDate = new Date(1900, 0, 31) let offset = Math.floor((date.getTime() - baseDate.getTime()) / 86400000) let year = 1900 let daysInYear = 0 // 计算农历年份 while (year < 2101 && offset > 0) { daysInYear = yearDays(year) offset -= daysInYear year++ } if (offset < 0) { offset += daysInYear year-- } // 农历年份 const lunarYear = year const leap = leapMonth(year) let isLeap = false // 计算农历月份 let month = 1 let daysOfMonth = 0 for (month = 1; month <= 12 && offset > 0; month++) { // 闰月 if (leap > 0 && month === leap + 1 && !isLeap) { --month isLeap = true daysOfMonth = leapDays(year) } else { daysOfMonth = monthDays(year, month) } // 解除闰月 if (isLeap && month === leap + 1) { isLeap = false } offset -= daysOfMonth } // 修正月份 if (offset === 0 && leap > 0 && month === leap + 1) { if (isLeap) { isLeap = false } else { isLeap = true --month } } if (offset < 0) { offset += daysOfMonth --month } const lunarMonth = month const lunarDay = offset + 1 // 计算干支年 const ganIndex = (lunarYear - 4) % 10 const zhiIndex = (lunarYear - 4) % 12 const ganZhiYear = Gan[ganIndex] + Zhi[zhiIndex] // 生肖 const animal = Animals[(lunarYear - 4) % 12] // 确保月份和日期在有效范围内 const validMonth = Math.max(1, Math.min(12, lunarMonth)) const validDay = Math.max(1, Math.min(30, lunarDay)) return { lunarYear, lunarMonth: validMonth, lunarDay: validDay, isLeap, ganZhiYear, animal, monthName: (isLeap ? '闰' : '') + (lunarMonths[validMonth - 1] || '未知') + '月', dayName: lunarDays[validDay - 1] || '未知', toString: function () { return `${this.ganZhiYear}年(${this.animal})${this.monthName}${this.dayName}` }, } } /** * 农历转公历 * @param year 农历年份 * @param month 农历月份 * @param day 农历日期 * @param isLeap 是否闰月 * @returns 公历日期 */ export function lunar2solar(year: number, month: number, day: number, isLeap = false): Date | null { if (year < 1900 || year > 2100) { return null } const leap = leapMonth(year) if (isLeap && leap !== month) { return null } // 计算从1900年1月31日到目标日期的天数 let offset = 0 // 累加年份天数 for (let i = 1900; i < year; i++) { offset += yearDays(i) } // 累加月份天数 let leapFlag = false for (let i = 1; i < month; i++) { offset += monthDays(year, i) } // 如果是闰月,需要加上闰月之前的月份 if (leap > 0 && month > leap) { offset += leapDays(year) if (month === leap + 1 && isLeap) { leapFlag = true } } // 加上日期 offset += day - 1 const baseDate = new Date(1900, 0, 31) const resultDate = new Date(baseDate.getTime() + offset * 86400000) return resultDate } /** * 格式化日期为 YYYY-MM-DD */ export function formatDate(date: Date): string { const year = date.getFullYear() const month = String(date.getMonth() + 1).padStart(2, '0') const day = String(date.getDate()).padStart(2, '0') return `${year}-${month}-${day}` } /** * 解析 YYYY-MM-DD 格式的日期字符串 */ export function parseDate(dateStr: string): Date | null { if (!dateStr) return null const parts = dateStr.split('-') if (parts.length !== 3) return null const year = parseInt(parts[0]) const month = parseInt(parts[1]) - 1 const day = parseInt(parts[2]) return new Date(year, month, day) } /** * 检查某个日期是否在当前月份 * @param dateStr 日期字符串 YYYY-MM-DD * @param isLunar 是否按农历计算 * @returns 如果在当前月份返回日期信息,否则返回null */ export function isInCurrentMonth(dateStr: string, isLunar: boolean = false): { day: number; month: number } | null { const date = parseDate(dateStr) if (!date) return null const now = new Date() const currentYear = now.getFullYear() const currentMonth = now.getMonth() + 1 if (isLunar) { // 按农历计算:获取原日期的农历信息 const originalLunar = solar2lunar(date) if (!originalLunar) return null // 计算今年对应的农历日期的公历日期 const thisYearSolar = lunar2solar( currentYear, originalLunar.lunarMonth, originalLunar.lunarDay, originalLunar.isLeap ) if (!thisYearSolar) { // 如果转换失败,尝试用明年的日期 const nextYearSolar = lunar2solar( currentYear + 1, originalLunar.lunarMonth, originalLunar.lunarDay, originalLunar.isLeap ) if (nextYearSolar) { const nextYearMonth = nextYearSolar.getMonth() + 1 const nextYearDay = nextYearSolar.getDate() if (nextYearMonth === currentMonth) { return { day: nextYearDay, month: nextYearMonth } } } return null } const thisYearMonth = thisYearSolar.getMonth() + 1 const thisYearDay = thisYearSolar.getDate() if (thisYearMonth === currentMonth) { return { day: thisYearDay, month: thisYearMonth } } } else { // 按公历计算:直接比较月份 const month = date.getMonth() + 1 const day = date.getDate() if (month === currentMonth) { return { day, month } } } return null }