Maven引用
<dependency>
<groupId>org.hothub</groupId>
<artifactId>calendarist</artifactId>
<version>1.0.10</version>
</dependency>
- 支持1900 - 2100年份的日期转换
- 支持阳历日期转阴历日期
- 支持阴历日期转阳历日期
- 支持阳历日期转干支日期
- 支持阴历日期转干支日期
- 支持获取某日期对应节气 @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();
//用法一：直接创建阳历、阴历日期实体对象
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();
Long timeMillis = CalendaristUtils.getTermTime(2023, TermType.XIAOHAN);