Java多功能万年历：基于Calendar与农历计算的实现

Noah

发布时间：2026-10-13 | 2人浏览过

原创

在Java开发中，处理复杂的日期逻辑（如农历、节气）通常需要借助内置的java.util.Calendar体系。本文将通过分析基础类的API，展示如何构建一个支持公历/农历互转、显示干支生肖及查询节气的万年历工具类。

核心对象与基础概念

万年历的逻辑基石是 java.util.Calendar 抽象类及其具体子类 java.util.GregorianCalendar（公历）。掌握其字段与方法是实现定制化的前提。

第1步：掌握Calendar关键字段与对象获取

目的：理解时间维度的表示方式。

常用字段：
- YEAR：年份。
- MONTH：月份（**注意：从0开始**，0代表一月）。
- DATE：一个月中的某天。
- DAY_OF_WEEK：一周中的某天（1代表星期日，依此类推）。
- HOUR / HOUR_OF_DAY：上午/下午的小时数或一天的小时数。
创建对象：推荐使用静态工厂方法获取实例，以保证线程安全与环境适配。
```
Calendar ca = Calendar.getInstance();
```

第2步：关键操作方法详解

目的：具备设置和获取时间数据的能力。

设置时间 (set)：

// 精确到秒
void set(int year, int month, int date,
         int hourOfDay, int minute, int second);
// 或使用Date对象直接赋值
void setTime(Date date);

获取值 (get)：

int value = ca.get(Calendar.MONTH); // 获取当前月份(0-11)
Date d = ca.getTime();              // 转换为标准Date对象

时间运算 (add)：根据规则自动进位。

ca.add(Calendar.MONTH, 1); // 下一个月，自动处理跨年和闰月天数变化

第3步：实例化GregorianCalendar

目的：初始化具有特定年月日的公历日历。

GregorianCalendar 默认使用当前的语言环境和时区。可以通过构造函数指定初始时间：

// 1. 默认当前时刻
Calendar ca1 = new GregorianCalendar();

// 2. 指定年月日 (注意Month参数从0开始)
Calendar ca2 = new GregorianCalendar(2023, 9, 5);

// 3. 指定年月日时分秒
Calendar ca3 = new GregorianCalendar(2023, 9, 5, 14, 30, 0);

Java万年历实战代码实现

以下代码提供了一个完整的 ChineseCalendar 类。它扩展了 GregorianCalendar，通过预置的数据表实现了从1901年到2100年的农历转换、节气判定以及节假日查询功能。

功能亮点：

双向转换：支持公历转农历，也支持农历转公历。
丰富属性：提供天干、地支、生肖、节气（节气/中气）、农历中文名称等查询。
辅助函数：包含公历闰年判断、当月天数计算等底层逻辑。

package com.via.mce.monthcalendar.utils;

import java.util.Calendar;
import java.util.Date;
import java.util.GregorianCalendar;
import java.util.HashMap;

/**
 * 农历日历。将农历从1901年到2100年之间各年、月的大小以及历年节气保存，
 * 然后基于这些数据进行计算。
 */
public final class ChineseCalendar extends GregorianCalendar {
 
 // --- 自定义农历相关常量字段 ---
 public static final int CHINESE_YEAR = 801;       // 农历年
 public static final int CHINESE_MONTH = 802;      // 农历月 (1起始，负数表示闰月)
 public static final int CHINESE_DATE = 803;       // 农历日
 public static final int CHINESE_SECTIONAL_TERM = 804; // 当月节气对应的公历日
 public static final int CHINESE_PRINCIPLE_TERM = 805; // 当月中气对应的公历日
 public static final int CHINESE_HEAVENLY_STEM = 806; // 天干
 public static final int CHINESE_EARTHLY_BRANCH = 807; // 地支
 public static final int CHINESE_ZODIAC = 808;     // 属相
 public static final int LUNAR_FESTIVAL = 809;     // 农历节日
 public static final int SOLAR_FESTIVAL = 810;     // 阳历节日
 public static final int CHINESE_TERM = 811;       // 节气
 
 private String getLunarFestival() { /* 农历节日逻辑... */ return null; }
 private String getSolarFestival() { /* 阳历节日逻辑... */ return null; }
 // ... 其他内部方法与静态数据表(省略以节省篇幅，详见完整源码) ...
 
 /** 获得属性的中文描述 */
 public String getChinese(int field) {
   // 实现获取天干地支、星期、月份的中文名称
   return "";
 }
}

注：上述代码展示了结构框架。实际运行需包含完整的静态数组 chineseMonths（农历大小月数据）、sFestival（阳历节日映射）及节气计算算法。该实现遵循 Java 封装原则，开发者可通过调用 get(CHINESE_YEAR) 等方法直接获取所需的农历信息。