Skip to content

Latest commit

 

History

History
109 lines (84 loc) · 3.15 KB

File metadata and controls

109 lines (84 loc) · 3.15 KB

SolarLunar 特性说明

核心功能

1. 公历 ↔ 农历 转换

  • 精确转换: 支持1900-2100年间的任意日期转换
  • 双向转换: 提供 solar2lunarlunar2solar 两种转换方法
  • 高精度: 考虑闰月、节气等复杂因素

2. 天干地支系统

  • 年柱: 精确的年干支计算(考虑立春)
  • 月柱: 基于五虎遁月法的月干支计算
  • 日柱: 日干支计算
  • 完整支持: 天干十(甲乙丙丁戊己庚辛壬癸)、地支十二(子丑寅卯辰巳午未申酉戌亥)

3. 二十四节气

  • 精确定位: 准确计算每年24个节气的具体日期
  • 节气检测: 自动检测某日是否为节气日
  • 节气名称: 提供完整节气名称

4. 生肖系统

  • 基础生肖: 按农历年计算生肖
  • 精确生肖: 考虑立春的精确生肖计算
  • 十二生肖: 鼠牛虎兔龙蛇马羊猴鸡狗猪

技术特点

性能特点

  • 高速转换: <0.01ms / 次转换
  • 高吞吐量: >250,000次/秒
  • 低内存占用: 优化的数据结构

功能完整性

  • 57个测试用例: 100%通过率
  • 边界条件: 全面覆盖边界情况
  • 错误处理: 完善的输入验证和错误处理

兼容性

  • 多模块系统: 支持 ESM、CJS、UMD
  • 多环境支持: 浏览器、Node.js
  • 向后兼容: 保持与原始库的API兼容

精度保证

算法精度

  • 农历算法: 基于权威农历数据
  • 闰月处理: 准确的闰月识别和处理
  • 节气计算: 基于天文数据的节气日期

验证方式

  • 历史验证: 与历史农历数据对比验证
  • 交叉验证: 不同算法结果交叉验证
  • 边界测试: 极端情况下的算法验证

使用场景

传统节日应用

  • 春节、元宵、端午、中秋等传统节日定位
  • 农历生日提醒
  • 传统纪念日

文化应用

  • 天干地支纪年
  • 生肖年份计算
  • 传统节气文化推广

日历应用

  • 农历日历显示
  • 中西历对照
  • 日期转换工具

技术架构

数据结构

  • 常量表: 预计算的农历、节气、天干地支数据表
  • 算法优化: 高效的日期计算算法

代码质量

  • ESLint检查: 代码规范检查
  • Prettier格式化: 代码格式统一
  • Vitest测试: 现代化测试框架

现代化特性

  • ES6+语法: 使用现代JavaScript特性
  • 模块化: 标准ES模块系统
  • Tree-shaking: 支持按需加载

可靠性保证

质量保证

  • 全面测试: 57个测试覆盖所有功能
  • 性能测试: 持续性能基准测试
  • 兼容性测试: 多环境兼容性验证

维护保证

  • 文档完整: 完整的API和使用文档
  • 示例丰富: 多种使用场景示例
  • 错误处理: 完善的异常处理机制

技术优势

  1. 高性脃: 优化的算法和数据结构
  2. 高精度: 基于权威数据的计算
  3. 易使用: 简单直观的API设计
  4. 多环境: 支持多种运行环境
  5. 现代化: 遵活使用现代开发工具链
  6. 文档完整: 完整的文档和示例
  7. 兼容性: 保持向后兼容
  8. 可维护: 清晰的代码结构和注释