公历农历转换库Lunar Solar Calendar Converter编程频道|福州电脑网

公历农历转换库Lunar Solar Calendar Converter

项目介绍

Lunar Solar Calendar Converter 是一个多语言支持的公历（阳历）和农历（阴历）转换工具。这个开源项目提供了一种简单而准确的方法来进行日期转换，支持1900年到2100年之间的日期。

主要特点

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

使用方法

安装

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

对于Python用户，可以通过pip安装：

代码语言：javascript代码运行次数：0运行复制

pip install LunarSolarConverter

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

基本用法

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

C#/Java

代码语言：javascript代码运行次数：0运行复制

Solar solarDate = LunarSolarConverter.LunarToSolar(lunarDate);
Lunar lunarDate = LunarSolarConverter.SolarToLunar(solarDate);

Objective-C

代码语言：javascript代码运行次数：0运行复制

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

PHP

代码语言：javascript代码运行次数：0运行复制

$solarDate = LunarSolarConverter::LunarToSolar($lunarDate);
$lunarDate = LunarSolarConverter::SolarToLunar($solarDate);

Python

代码语言：javascript代码运行次数：0运行复制

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

JavaScript

代码语言：javascript代码运行次数：0运行复制

let solarDate = converter.LunarToSolar(lunarDate);
let lunarDate = converter.SolarToLunar(solarDate);

C/C++

代码语言：javascript代码运行次数：0运行复制

Solar solarDate = LunarToSolar(lunarDate);
Lunar lunarDate = SolarToLunar(solarDate);

Ruby

代码语言：javascript代码运行次数：0运行复制

solar_date = lunar_to_solar(lunar_date)
lunar_date = solar_to_lunar(solar_date)

Swift

代码语言：javascript代码运行次数：0运行复制

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

代码语言：javascript代码运行次数：0运行复制

solarDate := LunarToSolar(lunarDate)
lunarDate := SolarToLunar(solarDate)

Dart

代码语言：javascript代码运行次数：0运行复制

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

数据验证

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

在JavaScript目录下运行 node check.js 启动服务器。
使用以下URL进行测试：
- 公历转农历：http://localhost:1337/?src=2015,1,15
- 农历转公历：http://localhost:1337/?src=2014,11,25,0
在C#版本中，Check.cs 文件实现了C#与Node.js的数据比对。

注意事项

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

项目地址

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。原始发表：2024-08-23，如有侵权请联系 cloudcommunity@tencent 删除编程语言服务器工具数据calendar

公历农历转换库Lunar Solar Calendar Converter