mingyu-core 0.1.0

package/dist/calendar/lunar.js

@@ -0,0 +1,391 @@
+/**
+ * 农历工具类
+ * 基于tyme4ts库实现农历、干支等传统历法功能
+ */
+import { SolarDay } from 'tyme4ts';
+/**
+ * 农历工具类
+ */
+export class LunarUtil {
+    /**
+     * 获取当前时间的完整信息
+     */
+    static getCurrentTimeInfo() {
+        const now = new Date();
+        return this.getTimeInfo(now);
+    }
+    /**
+     * 计算时辰的公共方法，避免代码重复
+     */
+    static calculateHourIndex(currentHour) {
+        // 时辰划分标准：
+        // 子时: 23:00-01:00 (23:00-24:00为夜子时，00:00-01:00为早子时)
+        // 丑时: 01:00-03:00
+        // 寅时: 03:00-05:00
+        // 卯时: 05:00-07:00
+        // 辰时: 07:00-09:00
+        // 巳时: 09:00-11:00
+        // 午时: 11:00-13:00
+        // 未时: 13:00-15:00
+        // 申时: 15:00-17:00
+        // 酉时: 17:00-19:00
+        // 戌时: 19:00-21:00
+        // 亥时: 21:00-23:00
+        if (currentHour >= 23 || currentHour < 1) {
+            return 0; // 子时
+        }
+        else if (currentHour >= 1 && currentHour < 3) {
+            return 1; // 丑时
+        }
+        else if (currentHour >= 3 && currentHour < 5) {
+            return 2; // 寅时
+        }
+        else if (currentHour >= 5 && currentHour < 7) {
+            return 3; // 卯时
+        }
+        else if (currentHour >= 7 && currentHour < 9) {
+            return 4; // 辰时
+        }
+        else if (currentHour >= 9 && currentHour < 11) {
+            return 5; // 巳时
+        }
+        else if (currentHour >= 11 && currentHour < 13) {
+            return 6; // 午时
+        }
+        else if (currentHour >= 13 && currentHour < 15) {
+            return 7; // 未时
+        }
+        else if (currentHour >= 15 && currentHour < 17) {
+            return 8; // 申时
+        }
+        else if (currentHour >= 17 && currentHour < 19) {
+            return 9; // 酉时
+        }
+        else if (currentHour >= 19 && currentHour < 21) {
+            return 10; // 戌时
+        }
+        else if (currentHour >= 21 && currentHour < 23) {
+            return 11; // 亥时
+        }
+        // 默认返回子时（理论上不会执行到这里）
+        return 0;
+    }
+    static assertValidDate(date) {
+        if (!(date instanceof Date) || Number.isNaN(date.getTime())) {
+            throw new Error('时间不是有效日期。');
+        }
+    }
+    static assertSolarYear(year) {
+        if (!Number.isInteger(year) || year < 1900 || year > 2100) {
+            throw new Error('年份需在 1900-2100 之间。');
+        }
+    }
+    static assertSolarMonth(month) {
+        if (!Number.isInteger(month) || month < 1 || month > 12) {
+            throw new Error('月份需在 1-12 之间。');
+        }
+    }
+    /**
+     * 获取指定时间的完整信息
+     */
+    static getTimeInfo(date) {
+        this.assertValidDate(date);
+        try {
+            const solar = SolarDay.fromYmd(date.getFullYear(), date.getMonth() + 1, date.getDate());
+            const lunar = solar.getLunarDay();
+            const jieQi = solar.getTerm();
+            // 获取当前时辰
+            const currentHour = date.getHours();
+            const hours = lunar.getHours();
+            const hourIndex = this.calculateHourIndex(currentHour);
+            // 从 tyme4ts 返回的时辰数组中获取对应索引的时辰
+            const currentLunarHour = hours[hourIndex] || hours[0];
+            return {
+                solar: {
+                    year: solar.getYear(),
+                    month: solar.getMonth(),
+                    day: solar.getDay(),
+                    hour: date.getHours(),
+                    minute: date.getMinutes(),
+                },
+                lunar: {
+                    year: lunar.getYearSixtyCycle().toString(),
+                    month: lunar.getMonthSixtyCycle().toString(),
+                    day: lunar.getSixtyCycle().toString(),
+                    hour: currentLunarHour.getSixtyCycle().toString(),
+                    yearInChinese: lunar.toString().split('年')[0],
+                    monthInChinese: lunar.toString().split('年')[1].split('月')[0] + '月',
+                    dayInChinese: lunar.toString().split('月')[1],
+                    hourInChinese: currentLunarHour.toString().slice(-2),
+                    // 添加数字格式的月日
+                    monthNumber: lunar.getMonth(),
+                    dayNumber: lunar.getDay(),
+                },
+                ganzhi: {
+                    year: lunar.getYearSixtyCycle().toString(),
+                    month: lunar.getMonthSixtyCycle().toString(),
+                    day: lunar.getSixtyCycle().toString(),
+                    hour: currentLunarHour.getSixtyCycle().toString(),
+                },
+                eightChar: {
+                    year: lunar.getYearSixtyCycle().toString(),
+                    month: lunar.getMonthSixtyCycle().toString(),
+                    day: lunar.getSixtyCycle().toString(),
+                    hour: currentLunarHour.getSixtyCycle().toString(),
+                },
+                jieQi: jieQi.getName(),
+            };
+        }
+        catch (error) {
+            console.error('tyme4ts库调用失败:', error);
+            throw error;
+        }
+    }
+    /**
+     * 获取干支信息
+     */
+    static getGanZhi(date) {
+        const targetDate = date || new Date();
+        this.assertValidDate(targetDate);
+        try {
+            const solar = SolarDay.fromYmd(targetDate.getFullYear(), targetDate.getMonth() + 1, targetDate.getDate());
+            const lunar = solar.getLunarDay();
+            // 获取当前时辰
+            const currentHour = targetDate.getHours();
+            const hours = lunar.getHours();
+            const hourIndex = this.calculateHourIndex(currentHour);
+            // 从 tyme4ts 返回的时辰数组中获取对应索引的时辰
+            const currentLunarHour = hours[hourIndex] || hours[0];
+            return {
+                year: lunar.getYearSixtyCycle().toString(),
+                month: lunar.getMonthSixtyCycle().toString(),
+                day: lunar.getSixtyCycle().toString(),
+                hour: currentLunarHour.getSixtyCycle().toString(),
+            };
+        }
+        catch (error) {
+            console.error('tyme4ts库调用失败:', error);
+            throw error;
+        }
+    }
+    /**
+     * 获取农历信息
+     */
+    static getLunar(date) {
+        const targetDate = date || new Date();
+        this.assertValidDate(targetDate);
+        try {
+            const solar = SolarDay.fromYmd(targetDate.getFullYear(), targetDate.getMonth() + 1, targetDate.getDate());
+            const lunar = solar.getLunarDay();
+            // 获取当前时辰
+            const currentHour = targetDate.getHours();
+            const hours = lunar.getHours();
+            const hourIndex = this.calculateHourIndex(currentHour);
+            // 从 tyme4ts 返回的时辰数组中获取对应索引的时辰
+            const currentLunarHour = hours[hourIndex] || hours[0];
+            return {
+                year: lunar.getYearSixtyCycle().toString(),
+                month: lunar.getMonthSixtyCycle().toString(),
+                day: lunar.getSixtyCycle().toString(),
+                hour: currentLunarHour.getSixtyCycle().toString(),
+                yearInChinese: lunar.toString().split('年')[0],
+                monthInChinese: lunar.toString().split('年')[1].split('月')[0] + '月',
+                dayInChinese: lunar.toString().split('月')[1],
+                hourInChinese: currentLunarHour.toString().slice(-2),
+                // 添加数字格式的月日
+                monthNumber: lunar.getMonth(),
+                dayNumber: lunar.getDay(),
+            };
+        }
+        catch (error) {
+            console.error('tyme4ts库调用失败:', error);
+            throw error;
+        }
+    }
+    /**
+     * 获取空亡地支
+     */
+    static getVoidBranches(dayGanZhi) {
+        const voidMap = {
+            // 甲子旬
+            甲子: ['戌', '亥'],
+            乙丑: ['戌', '亥'],
+            丙寅: ['戌', '亥'],
+            丁卯: ['戌', '亥'],
+            戊辰: ['戌', '亥'],
+            己巳: ['戌', '亥'],
+            庚午: ['戌', '亥'],
+            辛未: ['戌', '亥'],
+            壬申: ['戌', '亥'],
+            癸酉: ['戌', '亥'],
+            // 甲戌旬
+            甲戌: ['申', '酉'],
+            乙亥: ['申', '酉'],
+            丙子: ['申', '酉'],
+            丁丑: ['申', '酉'],
+            戊寅: ['申', '酉'],
+            己卯: ['申', '酉'],
+            庚辰: ['申', '酉'],
+            辛巳: ['申', '酉'],
+            壬午: ['申', '酉'],
+            癸未: ['申', '酉'],
+            // 甲申旬
+            甲申: ['午', '未'],
+            乙酉: ['午', '未'],
+            丙戌: ['午', '未'],
+            丁亥: ['午', '未'],
+            戊子: ['午', '未'],
+            己丑: ['午', '未'],
+            庚寅: ['午', '未'],
+            辛卯: ['午', '未'],
+            壬辰: ['午', '未'],
+            癸巳: ['午', '未'],
+            // 甲午旬
+            甲午: ['辰', '巳'],
+            乙未: ['辰', '巳'],
+            丙申: ['辰', '巳'],
+            丁酉: ['辰', '巳'],
+            戊戌: ['辰', '巳'],
+            己亥: ['辰', '巳'],
+            庚子: ['辰', '巳'],
+            辛丑: ['辰', '巳'],
+            壬寅: ['辰', '巳'],
+            癸卯: ['辰', '巳'],
+            // 甲辰旬
+            甲辰: ['寅', '卯'],
+            乙巳: ['寅', '卯'],
+            丙午: ['寅', '卯'],
+            丁未: ['寅', '卯'],
+            戊申: ['寅', '卯'],
+            己酉: ['寅', '卯'],
+            庚戌: ['寅', '卯'],
+            辛亥: ['寅', '卯'],
+            壬子: ['寅', '卯'],
+            癸丑: ['寅', '卯'],
+            // 甲寅旬
+            甲寅: ['子', '丑'],
+            乙卯: ['子', '丑'],
+            丙辰: ['子', '丑'],
+            丁巳: ['子', '丑'],
+            戊午: ['子', '丑'],
+            己未: ['子', '丑'],
+            庚申: ['子', '丑'],
+            辛酉: ['子', '丑'],
+            壬戌: ['子', '丑'],
+            癸亥: ['子', '丑'],
+        };
+        return voidMap[dayGanZhi] || [];
+    }
+    /**
+     * 根据日干获取六神起始
+     */
+    static getSixAnimalsStart(dayGan) {
+        const startMap = {
+            甲: '青龙',
+            乙: '青龙',
+            丙: '朱雀',
+            丁: '朱雀',
+            戊: '勾陈',
+            己: '螣蛇',
+            庚: '白虎',
+            辛: '白虎',
+            壬: '玄武',
+            癸: '玄武',
+        };
+        return startMap[dayGan] || '青龙';
+    }
+    /**
+     * 获取六神序列
+     * 修正：从第一爻（最下方）开始，按日干确定起始六神
+     */
+    static getSixAnimals(dayGan) {
+        const animals = ['青龙', '朱雀', '勾陈', '螣蛇', '白虎', '玄武'];
+        const startAnimal = this.getSixAnimalsStart(dayGan);
+        const startIndex = animals.indexOf(startAnimal);
+        const result = [];
+        for (let i = 0; i < 6; i++) {
+            // 从第一爻（index 0）开始，按顺序排列六神
+            result.push(animals[(startIndex + i) % 6]);
+        }
+        return result;
+    }
+    /**
+     * 获取指定公历月份每日的干支
+     */
+    static getGanZhiForMonth(year, month) {
+        this.assertSolarYear(year);
+        this.assertSolarMonth(month);
+        const daysInMonth = new Date(year, month, 0).getDate();
+        const result = [];
+        let firstError = null;
+        for (let day = 1; day <= daysInMonth; day++) {
+            try {
+                const solar = SolarDay.fromYmd(year, month, day);
+                const lunar = solar.getLunarDay();
+                const lunarDateString = lunar.toString();
+                const lunarMonth = lunarDateString.split('年')[1].split('月')[0] + '月';
+                const lunarDay = lunarDateString.split('月')[1];
+                result.push({
+                    date: `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`,
+                    ganZhi: lunar.getSixtyCycle().toString(),
+                    lunarDate: `${lunarMonth}${lunarDay}`,
+                });
+            }
+            catch (error) {
+                if (!firstError)
+                    firstError = error;
+                console.error(`Error calculating GanZhi for ${year}-${month}-${day}:`, error);
+            }
+        }
+        if (result.length === 0 && firstError) {
+            throw firstError;
+        }
+        return result;
+    }
+    /**
+     * 获取指定公历年份每月的干支
+     */
+    static getGanZhiForYear(year) {
+        this.assertSolarYear(year);
+        const result = [];
+        let firstError = null;
+        for (let month = 1; month <= 12; month++) {
+            try {
+                // 使用该月15号作为代表日来获取月干支
+                const solar = SolarDay.fromYmd(year, month, 15);
+                const lunar = solar.getLunarDay();
+                result.push({
+                    month: month,
+                    ganZhi: lunar.getMonthSixtyCycle().toString(),
+                });
+            }
+            catch (error) {
+                if (!firstError)
+                    firstError = error;
+                console.error(`Error calculating GanZhi for month ${year}-${month}:`, error);
+            }
+        }
+        if (result.length === 0 && firstError) {
+            throw firstError;
+        }
+        return result;
+    }
+    /**
+     * 格式化时间显示
+     */
+    static formatTimeDisplay(timeInfo) {
+        const { solar, lunar, ganzhi } = timeInfo;
+        const lunarYear = lunar.yearInChinese.endsWith('年')
+            ? lunar.yearInChinese
+            : `${lunar.yearInChinese}年`;
+        return {
+            solar: `公历：${solar.year}年${solar.month}月${solar.day}日 ${solar.hour}时${solar.minute}分`,
+            lunar: `农历：${lunarYear} ${lunar.monthInChinese}${lunar.dayInChinese} ${lunar.hourInChinese}`,
+            ganzhi: `干支：${ganzhi.year}年 ${ganzhi.month}月 ${ganzhi.day}日 ${ganzhi.hour}时`,
+        };
+    }
+}
+// 导出便捷函数
+export const getVoidBranches = (dayGanZhi) => LunarUtil.getVoidBranches(dayGanZhi);
+export const getSixAnimals = (dayGan) => LunarUtil.getSixAnimals(dayGan);
+//# sourceMappingURL=lunar.js.map

package/dist/calendar/lunar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lunar.js","sourceRoot":"","sources":["../../src/calendar/lunar.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAmDnC;;GAEG;AACH,MAAM,OAAO,SAAS;IACpB;;OAEG;IACH,MAAM,CAAC,kBAAkB;QACvB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,kBAAkB,CAAC,WAAmB;QACnD,UAAU;QACV,oDAAoD;QACpD,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAElB,IAAI,WAAW,IAAI,EAAE,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,CAAC,CAAC,KAAK;QACjB,CAAC;aAAM,IAAI,WAAW,IAAI,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,CAAC,CAAC,KAAK;QACjB,CAAC;aAAM,IAAI,WAAW,IAAI,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,CAAC,CAAC,KAAK;QACjB,CAAC;aAAM,IAAI,WAAW,IAAI,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,CAAC,CAAC,KAAK;QACjB,CAAC;aAAM,IAAI,WAAW,IAAI,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,CAAC,CAAC,KAAK;QACjB,CAAC;aAAM,IAAI,WAAW,IAAI,CAAC,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;YAChD,OAAO,CAAC,CAAC,CAAC,KAAK;QACjB,CAAC;aAAM,IAAI,WAAW,IAAI,EAAE,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;YACjD,OAAO,CAAC,CAAC,CAAC,KAAK;QACjB,CAAC;aAAM,IAAI,WAAW,IAAI,EAAE,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;YACjD,OAAO,CAAC,CAAC,CAAC,KAAK;QACjB,CAAC;aAAM,IAAI,WAAW,IAAI,EAAE,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;YACjD,OAAO,CAAC,CAAC,CAAC,KAAK;QACjB,CAAC;aAAM,IAAI,WAAW,IAAI,EAAE,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;YACjD,OAAO,CAAC,CAAC,CAAC,KAAK;QACjB,CAAC;aAAM,IAAI,WAAW,IAAI,EAAE,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;YACjD,OAAO,EAAE,CAAC,CAAC,KAAK;QAClB,CAAC;aAAM,IAAI,WAAW,IAAI,EAAE,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;YACjD,OAAO,EAAE,CAAC,CAAC,KAAK;QAClB,CAAC;QAED,qBAAqB;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,MAAM,CAAC,eAAe,CAAC,IAAU;QACvC,IAAI,CAAC,CAAC,IAAI,YAAY,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,eAAe,CAAC,IAAY;QACzC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAAC,KAAa;QAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,IAAU;QAC3B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACxF,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;YAE9B,SAAS;YACT,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;YAEvD,8BAA8B;YAC9B,MAAM,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YAEtD,OAAO;gBACL,KAAK,EAAE;oBACL,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE;oBACrB,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;oBACvB,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE;oBACnB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;oBACrB,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE;iBAC1B;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE;oBAC1C,KAAK,EAAE,KAAK,CAAC,kBAAkB,EAAE,CAAC,QAAQ,EAAE;oBAC5C,GAAG,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;oBACrC,IAAI,EAAE,gBAAgB,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;oBACjD,aAAa,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBAC7C,cAAc,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG;oBAClE,YAAY,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBAC5C,aAAa,EAAE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACpD,YAAY;oBACZ,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE;oBAC7B,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE;iBAC1B;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE;oBAC1C,KAAK,EAAE,KAAK,CAAC,kBAAkB,EAAE,CAAC,QAAQ,EAAE;oBAC5C,GAAG,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;oBACrC,IAAI,EAAE,gBAAgB,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;iBAClD;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE;oBAC1C,KAAK,EAAE,KAAK,CAAC,kBAAkB,EAAE,CAAC,QAAQ,EAAE;oBAC5C,GAAG,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;oBACrC,IAAI,EAAE,gBAAgB,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;iBAClD;gBACD,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE;aACvB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;YACtC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAW;QAC1B,MAAM,UAAU,GAAG,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAC5B,UAAU,CAAC,WAAW,EAAE,EACxB,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,EACzB,UAAU,CAAC,OAAO,EAAE,CACrB,CAAC;YACF,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAElC,SAAS;YACT,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;YAEvD,8BAA8B;YAC9B,MAAM,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YAEtD,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE;gBAC1C,KAAK,EAAE,KAAK,CAAC,kBAAkB,EAAE,CAAC,QAAQ,EAAE;gBAC5C,GAAG,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;gBACrC,IAAI,EAAE,gBAAgB,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;aAClD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;YACtC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAW;QACzB,MAAM,UAAU,GAAG,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAC5B,UAAU,CAAC,WAAW,EAAE,EACxB,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,EACzB,UAAU,CAAC,OAAO,EAAE,CACrB,CAAC;YACF,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAElC,SAAS;YACT,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;YAEvD,8BAA8B;YAC9B,MAAM,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YAEtD,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE;gBAC1C,KAAK,EAAE,KAAK,CAAC,kBAAkB,EAAE,CAAC,QAAQ,EAAE;gBAC5C,GAAG,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;gBACrC,IAAI,EAAE,gBAAgB,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;gBACjD,aAAa,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC7C,cAAc,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG;gBAClE,YAAY,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC5C,aAAa,EAAE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACpD,YAAY;gBACZ,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE;gBAC7B,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE;aAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;YACtC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,SAAiB;QACtC,MAAM,OAAO,GAA6B;YACxC,MAAM;YACN,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YAEd,MAAM;YACN,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YAEd,MAAM;YACN,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YAEd,MAAM;YACN,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YAEd,MAAM;YACN,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACd,EAAE,EAAE,CAAC,GAAG,EAAE,GA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"}

package/dist/calendar/timeManager.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 统一的占卜时间管理工具
+ * 简化时间相关操作，确保所有占卜基于统一的时间基础
+ */
+import type { TimeInfo, GanZhiInfo } from './lunar';
+/**
+ * 统一的占卜时间数据
+ */
+export interface DivinationTime {
+    /** 完整时间信息 */
+    timeInfo: TimeInfo;
+    /** 干支信息 */
+    ganzhi: GanZhiInfo;
+    /** 时间戳 */
+    timestamp: number;
+}
+/**
+ * 时间管理工具类
+ */
+export declare class TimeManager {
+    /**
+     * 时区偏移覆盖（单位：分钟，正数表示 UTC+）
+     * - null：不覆盖，使用运行环境本地时区
+     * - 例如：北京时间为 480
+     * - 默认固定北京时间，避免服务端时区差异导致占卜盘与提示词不一致
+     */
+    private static timezoneOffsetMinutesOverride;
+    /**
+     * 设置时区偏移覆盖（用于服务端/边缘环境固定时区）
+     */
+    static setTimezoneOffsetMinutesOverride(offsetMinutes: number | null): void;
+    /**
+     * 获取目标时区偏移（分钟）
+     */
+    private static getTimezoneOffsetMinutes;
+    /**
+     * 在指定时区偏移下提取年月日时分（不改变原始时间戳）
+     */
+    private static getDatePartsInOffset;
+    /**
+     * 获取占卜用的统一时间数据
+     * @param customTime 自定义时间（可选）
+     * @returns 统一的时间数据
+     */
+    static getDivinationTime(customTime?: Date): DivinationTime;
+    /**
+     * 基于时间戳生成确定性随机数
+     * @param timestamp 时间戳
+     * @param range 范围
+     * @returns 确定性随机数
+     */
+    static getSeededRandom(timestamp: number, range?: number): number;
+    /**
+     * 基于时间生成爻象
+     * @param timestamp 时间戳
+     * @param count 爻象数量
+     * @returns 爻象数组
+     */
+    static generateYaosByTime(timestamp: number, count?: number): number[];
+    /**
+     * 随机生成爻象
+     * @param count 爻象数量
+     * @returns 爻象数组
+     */
+    static generateYaosByRandom(count?: number): number[];
+    /**
+     * 使用三钱法起一爻：正面记 3，反面记 2，三枚铜钱合计得 6/7/8/9。
+     */
+    private static generateYaoByCoinMethod;
+    /**
+     * 获取指定时间的干支信息
+     */
+    private static getGanZhi;
+    /**
+     * 获取指定时间的完整信息
+     */
+    private static getTimeInfo;
+}
+export declare const getDivinationTime: any;
+export declare const generateYaosByTime: any;
+//# sourceMappingURL=timeManager.d.ts.map

package/dist/calendar/timeManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeManager.d.ts","sourceRoot":"","sources":["../../src/calendar/timeManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU;IACV,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,6BAA6B,CAAsB;IAElE;;OAEG;IACH,MAAM,CAAC,gCAAgC,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAI3E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IASvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAoBnC;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,IAAI,GAAG,cAAc;IAY3D;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM;IAUpE;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE;IAazE;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CAAC,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE;IAQxD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAQtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAsBxB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;CAqD3B;AAGD,eAAO,MAAM,iBAAiB,KAAkD,CAAC;AACjF,eAAO,MAAM,kBAAkB,KAAmD,CAAC"}

package/dist/calendar/timeManager.js

@@ -0,0 +1,177 @@
+import { SolarTime } from 'tyme4ts';
+/**
+ * 时间管理工具类
+ */
+export class TimeManager {
+    /**
+     * 时区偏移覆盖（单位：分钟，正数表示 UTC+）
+     * - null：不覆盖，使用运行环境本地时区
+     * - 例如：北京时间为 480
+     * - 默认固定北京时间，避免服务端时区差异导致占卜盘与提示词不一致
+     */
+    static timezoneOffsetMinutesOverride = 480;
+    /**
+     * 设置时区偏移覆盖（用于服务端/边缘环境固定时区）
+     */
+    static setTimezoneOffsetMinutesOverride(offsetMinutes) {
+        this.timezoneOffsetMinutesOverride = offsetMinutes;
+    }
+    /**
+     * 获取目标时区偏移（分钟）
+     */
+    static getTimezoneOffsetMinutes(date) {
+        const override = this.timezoneOffsetMinutesOverride;
+        if (typeof override === 'number' && Number.isFinite(override)) {
+            return override;
+        }
+        // Date#getTimezoneOffset 返回"本地到UTC需要加多少分钟"，因此本地偏移 = -getTimezoneOffset
+        return -date.getTimezoneOffset();
+    }
+    /**
+     * 在指定时区偏移下提取年月日时分（不改变原始时间戳）
+     */
+    static getDatePartsInOffset(date, offsetMinutes) {
+        const shifted = new Date(date.getTime() + offsetMinutes * 60 * 1000);
+        return {
+            year: shifted.getUTCFullYear(),
+            month: shifted.getUTCMonth() + 1,
+            day: shifted.getUTCDate(),
+            hour: shifted.getUTCHours(),
+            minute: shifted.getUTCMinutes(),
+        };
+    }
+    /**
+     * 获取占卜用的统一时间数据
+     * @param customTime 自定义时间（可选）
+     * @returns 统一的时间数据
+     */
+    static getDivinationTime(customTime) {
+        const targetTime = customTime || new Date();
+        if (!(targetTime instanceof Date) || Number.isNaN(targetTime.getTime())) {
+            throw new Error('自定义时间不是有效日期。');
+        }
+        const timeInfo = this.getTimeInfo(targetTime);
+        const ganzhi = this.getGanZhi(targetTime);
+        const timestamp = targetTime.getTime();
+        return { timeInfo, ganzhi, timestamp };
+    }
+    /**
+     * 基于时间戳生成确定性随机数
+     * @param timestamp 时间戳
+     * @param range 范围
+     * @returns 确定性随机数
+     */
+    static getSeededRandom(timestamp, range = 1) {
+        // 使用简单但确定性的伪随机算法
+        const seed = timestamp % 2147483647;
+        const a = 1664525;
+        const c = 1013904223;
+        const m = 2147483647;
+        const result = (a * seed + c) % m;
+        return ((result % range) + range) % range;
+    }
+    /**
+     * 基于时间生成爻象
+     * @param timestamp 时间戳
+     * @param count 爻象数量
+     * @returns 爻象数组
+     */
+    static generateYaosByTime(timestamp, count = 6) {
+        const yaos = [];
+        for (let i = 0; i < count; i++) {
+            // 按三钱法逐币起爻，保持时间起卦的确定性。
+            yaos.push(this.generateYaoByCoinMethod((coinIndex) => this.getSeededRandom(timestamp + i * 1000 + coinIndex * 97, 2)));
+        }
+        return yaos;
+    }
+    /**
+     * 随机生成爻象
+     * @param count 爻象数量
+     * @returns 爻象数组
+     */
+    static generateYaosByRandom(count = 6) {
+        const yaos = [];
+        for (let i = 0; i < count; i++) {
+            yaos.push(this.generateYaoByCoinMethod(() => (Math.random() < 0.5 ? 0 : 1)));
+        }
+        return yaos;
+    }
+    /**
+     * 使用三钱法起一爻：正面记 3，反面记 2，三枚铜钱合计得 6/7/8/9。
+     */
+    static generateYaoByCoinMethod(getCoinBit) {
+        let total = 0;
+        for (let coinIndex = 0; coinIndex < 3; coinIndex++) {
+            total += getCoinBit(coinIndex) === 0 ? 2 : 3;
+        }
+        return total;
+    }
+    /**
+     * 获取指定时间的干支信息
+     */
+    static getGanZhi(date) {
+        const offsetMinutes = this.getTimezoneOffsetMinutes(date);
+        const parts = this.getDatePartsInOffset(date, offsetMinutes);
+        const solarTime = SolarTime.fromYmdHms(parts.year, parts.month, parts.day, parts.hour, parts.minute, 0);
+        const lunarHour = solarTime.getLunarHour();
+        const lunarDay = lunarHour.getLunarDay();
+        return {
+            year: lunarHour.getYearSixtyCycle().toString(),
+            month: lunarHour.getMonthSixtyCycle().toString(),
+            day: lunarDay.getSixtyCycle().toString(),
+            hour: lunarHour.getSixtyCycle().toString(),
+        };
+    }
+    /**
+     * 获取指定时间的完整信息
+     */
+    static getTimeInfo(date) {
+        const offsetMinutes = this.getTimezoneOffsetMinutes(date);
+        const parts = this.getDatePartsInOffset(date, offsetMinutes);
+        const solarTime = SolarTime.fromYmdHms(parts.year, parts.month, parts.day, parts.hour, parts.minute, 0);
+        const solarDay = solarTime.getSolarDay();
+        const lunarHour = solarTime.getLunarHour();
+        const lunarDay = lunarHour.getLunarDay();
+        const lunarDayText = lunarDay.toString().replace(/^农历/, '');
+        const lunarHourText = lunarHour.toString().replace(/^农历/, '');
+        const jieQi = solarTime.getTerm();
+        return {
+            solar: {
+                year: solarDay.getYear(),
+                month: solarDay.getMonth(),
+                day: solarDay.getDay(),
+                hour: parts.hour,
+                minute: parts.minute,
+            },
+            lunar: {
+                year: lunarHour.getYearSixtyCycle().toString(),
+                month: lunarHour.getMonthSixtyCycle().toString(),
+                day: lunarDay.getSixtyCycle().toString(),
+                hour: lunarHour.getSixtyCycle().toString(),
+                yearInChinese: lunarDayText.split('年')[0] + '年',
+                monthInChinese: lunarDayText.split('年')[1].split('月')[0] + '月',
+                dayInChinese: lunarDayText.split('月')[1],
+                hourInChinese: lunarHourText.slice(-2),
+                monthNumber: lunarDay.getMonth(),
+                dayNumber: lunarDay.getDay(),
+            },
+            ganzhi: {
+                year: lunarHour.getYearSixtyCycle().toString(),
+                month: lunarHour.getMonthSixtyCycle().toString(),
+                day: lunarDay.getSixtyCycle().toString(),
+                hour: lunarHour.getSixtyCycle().toString(),
+            },
+            eightChar: {
+                year: lunarHour.getYearSixtyCycle().toString(),
+                month: lunarHour.getMonthSixtyCycle().toString(),
+                day: lunarDay.getSixtyCycle().toString(),
+                hour: lunarHour.getSixtyCycle().toString(),
+            },
+            jieQi: jieQi.getName(),
+        };
+    }
+}
+// 导出便捷函数
+export const getDivinationTime = TimeManager.getDivinationTime.bind(TimeManager);
+export const generateYaosByTime = TimeManager.generateYaosByTime.bind(TimeManager);
+//# sourceMappingURL=timeManager.js.map