sxwnl_spa_dart 0.10.2
sxwnl_spa_dart: ^0.10.2 copied to clipboard
Chinese calendar library with lunar, solar terms, gan-zhi and true solar time (sxwnl + SPA).
0.10.2 #
- 新增
yearGanZhi()— 查询某一年的年干支 (1984=甲子)。 - 新增
getYearRange()— 获取年份范围内逐年干支。 - 新增
getYearMonthGanZhi()— 获取某一年的所有月份干支 (12个)。 - 新增
getDayHourGanZhi()— 获取某日的所有时辰干支 (12个)。
0.10.1 #
- 新增
GanZhi类的纳音五行属性:naYin(如'海中金') 和naYinWuXing(如'金')。
0.10.0 #
- 新增
LunarDate农历日期类:支持阳历 ↔ 农历双向转换,兼容历史特殊月名(后九、拾贰、十三等)。 - 新增
TimePack时间封装包:统一管理钟表时间、真太阳时、UTC 时间和排盘基准时间。 - 新增
calcBaZi()方法:返回类型安全的BaZiCalcResult(包含BaZi对象),原版calcGanZhi()字符串版本保留不变。 - 新增
defaultLoc常量(东经 120°,北纬 30°)。 - 新增日历工具 API:
dayGanZhi()— 查询某一天的日干支dayGanZhiAt()— 查询某一时刻的日干支,支持早晚子时 (splitRatHour) 配置weekday()— 查询某一天是星期几 (1=周一, 7=周日)getDayRange()— 获取日期范围内每一天的干支与星期getSolarMonthDays()— 公历月份逐日干支表getLunarMonthDays()— 农历月份逐日干支表getJieQiPeriodDays()— 节气月份逐日干支表hourGanZhi()— 五鼠遁:根据日干推算时辰干支monthGanZhi()— 五虎遁:根据年干推算月干支
0.9.7 #
- 重大修复:修复
getYearJieQi在历史远古年份(如公元前)因儒略历漂移导致的节气名称映射错误。 - 逻辑优化:
getYearJieQi现在返回从“上个冬至”到“当前冬至”的 25 个节气节点,对齐原版 sxwnl 跨度。 - 逻辑优化:所有节气查询 API(
getPrevJieQi等)现在使用更鲁棒的跨年搜索算法,彻底解决历法漂移带来的相邻节气丢失问题。
0.9.6 #
- 新增 jie_qi.dart 模块,提供便捷的节气查询 API。
- 公开底层定气/定朔计算接口:qiAccurate(), SSQ.qiHigh(), SSQ.soHigh(), SSQ.qiLow(), SSQ.soLow()。
- 新增节/气查询与距离计算:getPrevJie(), getNextJie(), getPrevQi(), getNextQi(), getJieDistance(), getQiDistance(), getJieQiInfo()。
- 新增 Julian Day 版本 API:getPrevJieQiJd(), getNextJieQiJd(), getPrevJieJd(), getNextJieJd(), getPrevQiJd(), getNextQiJd(), getYearJieQiJd()。
0.9.5 #
- SSQ.calcY 增加 enableHistoricalRules 参数,控制是否启用特殊历史历法规则(春秋/战国/秦汉月名与月建处理)。
0.9.4 #
- 真太阳时计算:公元 6000 年以上使用 manualJD。
0.9.3 #
- 修复 SPA 默认时区分钟偏移丢失问题。
- 修复 JD 反解在 24:00:00 的边界问题。
- 修复极昼/极夜场景仍返回中天时间。
- 修复 SPAParams.list 默认大气折射值与主构造不一致。
- 修复 manualJD 绕过年份限制的断言逻辑。
0.9.2 #
- README 更新免责声明与署名/商用授权提示。
0.9.1 #
- 移除未授权的 sxwnl 原始源码测试资源。
- README 增加测试资源获取说明。
0.9.0 #
- 对齐 sxwnl 原版闰月判定与测试基准说明。
- 更新发布前示例与导入路径。