图说IT,结构化技术知识,助力年薪百万
侧边栏壁纸
  • 累计撰写 31 篇文章
  • 累计创建 0 个标签
  • 累计收到 0 条评论

目 录CONTENT

文章目录

公历农历转换库Lunar Solar Calendar Converter.md

图说it
2024-08-29 / 0 评论 / 0 点赞 / 172 阅读 / 651 字

项目介绍

Lunar Solar Calendar Converter 是一个多语言支持的公历(阳历)和农历(阴历)转换工具。这个开源项目提供了一种简单而准确的方法来进行日期转换,支持1900年到2100年之间的日期。
在这里插入图片描述

主要特点

  1. 支持公历到农历的转换,以及农历到公历的转换。
  2. 支持多种编程语言,包括C#, Java, Objective-C, PHP, Python, JavaScript (Node.js), C/C++, Ruby, Swift, Go等。
  3. 跨平台支持,包括Mac, Windows, Android, 和Windows Phone。
  4. 提供了数据验证工具,确保不同语言实现的一致性。
  5. 基于查表原理,使用两个数据表进行日期偏移计算。
  6. 原始数据通过微软ChineseLunisolarCalendar类进行了比对验证。

使用方法

安装

根据您使用的编程语言,您可以通过以下方式获取并使用这个转换工具:

  • 对于Python用户,可以通过pip安装:

    pip install LunarSolarConverter
    
  • 对于其他语言,您可以直接从GitHub仓库下载相应的源代码文件。

基本用法

以下是在不同编程语言中使用这个转换工具的基本API:

  1. C#/Java

    Solar solarDate = LunarSolarConverter.LunarToSolar(lunarDate);
    Lunar lunarDate = LunarSolarConverter.SolarToLunar(solarDate);
    
  2. Objective-C

    Solar *solarDate = [LunarSolarConverter lunarToSolar:lunarDate];
    Lunar *lunarDate = [LunarSolarConverter solarToLunar:solarDate];
    
  3. PHP

    $solarDate = LunarSolarConverter::LunarToSolar($lunarDate);
    $lunarDate = LunarSolarConverter::SolarToLunar($solarDate);
    
  4. Python

    solar_date = converter.LunarToSolar(lunar_date)
    lunar_date = converter.SolarToLunar(solar_date)
    
  5. JavaScript

    let solarDate = converter.LunarToSolar(lunarDate);
    let lunarDate = converter.SolarToLunar(solarDate);
    
  6. C/C++

    Solar solarDate = LunarToSolar(lunarDate);
    Lunar lunarDate = SolarToLunar(solarDate);
    
  7. Ruby

    solar_date = lunar_to_solar(lunar_date)
    lunar_date = solar_to_lunar(solar_date)
    
  8. Swift

    let solarDate = LunarSolarConverter.LunarToSolar(lunar: lunarDate)
    let lunarDate = LunarSolarConverter.SolarToLunar(solar: solarDate)
    
  9. Go

    solarDate := LunarToSolar(lunarDate)
    lunarDate := SolarToLunar(solarDate)
    
  10. Dart

    var solarDate = LunarSolarConverter.lunarToSolar(lunarDate);
    var lunarDate = LunarSolarConverter.solarToLunar(solarDate);
    

数据验证

项目提供了一个基于Node.js的HTTP服务器,用于验证不同语言实现的数据一致性:

  1. 在JavaScript目录下运行 node check.js 启动服务器。

  2. 使用以下URL进行测试:

    • 公历转农历:http://localhost:1337/?src=2015,1,15
    • 农历转公历:http://localhost:1337/?src=2014,11,25,0
  3. 在C#版本中,Check.cs 文件实现了C#与Node.js的数据比对。

注意事项

  1. 如果需要支持更长的时间段,可以使用 generate.htm 生成所需的数据。
  2. 目前不支持干支和星座的计算,这些功能在未来版本中可能会添加。
  3. 原始数据与微软的ChineseLunisolarCalendar类进行了比对,但与苹果官方的NSCalendarIdentifierChinese可能存在部分不一致。

项目地址

https://github.com/isee15/Lunar-Solar-Calendar-Converter

0
博主关闭了所有页面的评论