opprime / calendarist

一个可实现阳历、阴历、干支历间相互转换的JAVA工具

历法计算家，可实现阳历、阴历、干支历的相互转换

使用方法

Maven引用

<dependency>
    <groupId>org.hothub</groupId>
    <artifactId>calendarist</artifactId>
    <version>1.0.10</version>
</dependency>

功能介绍

1. 支持1900 - 2100年份的日期转换
2. 支持阳历日期转阴历日期
3. 支持阴历日期转阳历日期
4. 支持阳历日期转干支日期
5. 支持阴历日期转干支日期
6. 支持获取某日期对应节气 @since 1.0.10

参数/字段说明

字段	说明	类型	取值范围	适用
YEAR	年	int	1900 - 2100	阳历&阴历
MONTH	月	int	1 - 12	阳历&阴历
DAY_OF_MONTH	日	int	1 - 31	阳历&阴历
HOUR_OF_DAY	时	int	0 - 23	阳历&阴历
MINUTE	分	int	0 - 59	阳历&阴历
SECOND	秒	int	0 - 59	阳历&阴历
MILLISECOND	毫秒	int	0 - 999	阳历&阴历
LEAP_MONTH_OF_CURRENT	指定月是否是闰月	boolean	true / false	阴历

代码示例：

阳历转阴历、干支历：

//设置要转换的阳历日期
Calendarist calendarist = Calendarist.fromSolar(2020, 1, 1, 12, 15, 55, 58);

//转阴历
LunarDate lunarDate = calendarist.toLunar();
//转阳历
SolarDate solarDate = calendarist.toSolar();
//转干支历
CycleDate cycleDate = calendarist.toCycle();

阴历转阳历、干支历：

//设置要转换的阴历日期，且需设置指定月是否是闰月及指定年的闰月月份
Calendarist calendarist = Calendarist.fromLunar(2020, 1, 1, 12, 15, 55, 580, false);

//转阴历
LunarDate lunarDate = calendarist.toLunar();
//转阳历
SolarDate solarDate = calendarist.toSolar();
//转干支历
CycleDate cycleDate = calendarist.toCycle();

其他用法：

阳历转阴历、干支历：

//设置要转换的阳历日期
Calendarist calendarist = Calendarist.fromSolar(2020, 1, 1);
calendarist.set(Calendarist.HOUR, 12);
calendarist.set(Calendarist.MINUTE, 15);
calendarist.set(Calendarist.SECOND, 55);
calendarist.set(Calendarist.MILLISECOND, 58);

//转阴历
LunarDate lunarDate = calendarist.toLunar();
//转阳历
SolarDate solarDate = calendarist.toSolar();
//转干支历
CycleDate cycleDate = calendarist.toCycle();

阴历转阳历、干支历：

//设置要转换的阴历日期，且需设置指定月是否是闰月及指定年的闰月月份
Calendarist calendarist = Calendarist.fromLunar(2020, 1, 1, 12, 15, 55, 58);
calendarist.set(Calendarist.HOUR, 12);
calendarist.set(Calendarist.MINUTE, 15);
calendarist.set(Calendarist.SECOND, 55);
calendarist.set(Calendarist.MILLISECOND, 58);

//从阴历转换时，要指定当前月是否是闰月时，建议使用第一种方式
方式一，当值为false时表示指定月非闰月，为true时表示指定月是闰月，默认为false：
calendarist.setLeap(true);
方式二，当值为0时表示指定月非闰月，为1时表示指定月是闰月，默认为0：
calendarist.set(Calendarist.LEAP_MONTH_OF_CURRENT, 1);

//转阴历
LunarDate lunarDate = calendarist.toLunar();
//转阳历
SolarDate solarDate = calendarist.toSolar();
//转干支历
CycleDate cycleDate = calendarist.toCycle();

获取节气（@since 1.0.10）

//用法一：直接创建阳历、阴历日期实体对象
SolarDate solarDate = new SolarDate(2023, 1, 5);
TermType term1 = solarDate.getTerm();

//用法二：阳历、阴历日期互相转换后，直接使用
Calendarist calendarist = Calendarist.fromSolar(2023, 1, 5);
LunarDate lunarDate = calendarist.toLunar();
TermType term2 = lunarDate.getTerm();

根据阳历年份和指定节气反查日期（@since 1.0.10）

Long timeMillis = CalendaristUtils.getTermTime(2023, TermType.XIAOHAN);

calendarist's Issues

您写的代码很不错！我基于写了和流注有关的针灸app用于个人使用。

干支历很不错！

节气好像有问题

新历2024年4月1日，节气是null

闰月

阳历的2014年10月24号，农历为闰九月初一
每年生成生日时，能否是闰月时生成闰月对应的阳历，非闰月时生成非闰月对应的阳历
2015年时Calendarist calendarist = Calendarist.fromLunar(2015, 9, 1);
calendarist.set(Calendarist.LEAP_MONTH_OF_CURRENT, 1);
阳历为2015.2.19

索引越界问题

阴历直接获取天干地支，时间为13时或者20时 会出现索引越界，hourGanZhi 方法中 hourIndex的值为13了。

发现了日期与万年历对应不上的问题

首先非常感谢您这边的工具，解决了我们开发过程中很大的难题，我们在使用的过程中发现，根据工具算出来的时间与万年历对应不上，例如1990年5月12日，工具算出来是乙亥日，实际上应该是丁丑日 还有1990年6月11日 工具：丙午日，实际：丁未日，好像都少了一天