该版本是一次较大的升级,农历相比公历复杂太多(真佩服古人的智慧),虽然有规律,但涉及到的取舍、近似的感念太多,况且本身的概念就已经很多了,我在网上也是查阅了很多的资料,虽然找到一些计算的方法,但都有些计算缺陷,后来才终于找到“寿天星文历”:一个十分精准的万年历。虽然它的功能十分强大,但相对的涉及到的计算也很多,逻辑和思路都相当的复杂了,维护成本很大,有时候项目中并不一定要用到这么强大的农历,因此该版本目前仅提供了农历的一些基本功能,在下一版本中,我会引入“寿天星文历”,以适合更多的大众需求。

源码:

DateUtil类

新加入代码:(其他代码请参见java日期工具类DateUtil-续一)

/**
	 * 获取简单农历对象
	 * @param date 日期字符串
	 * @return 简单农历对象
	 */
	public static SimpleLunarCalendar getSimpleLunarCalendar(String date) {
		return new SimpleLunarCalendar(DateUtil.StringToDate(date));
	}
	
	/**
	 * 获取简单农历对象
	 * @param date 日期
	 * @return 简单农历对象
	 */
	public static SimpleLunarCalendar getSimpleLunarCalendar(Date date) {
		return new SimpleLunarCalendar(date);
	}

SimpleLunarCalendar类

package com.util;

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

public class SimpleLunarCalendar {

	/** 最小时间1900-1-31*/
	private final static long minTimeInMillis = -2206425952001L;
	/** 最大时间2099-12-31 */
	private final static long maxTimeInMillis = 4102416000000L;
	/**
	 * 农历年数据表(1900-2099年)<br>
	 * <br>
	 * 每个农历年用16进制来表示,解析时转为2进制<br>
	 * 前12位分别表示12个农历月份的大小月,1是大月,0是小月<br>
	 * 最后4位表示闰月,转为十进制后即为闰月值,例如0110,则为闰6月
	 */
	private final static int[] lunarInfo = { 0x4bd8, 0x4ae0, 0xa570, 0x54d5, 0xd260, 0xd950, 0x5554, 0x56af, 0x9ad0, 0x55d2, 0x4ae0, 0xa5b6, 0xa4d0, 0xd250, 0xd295, 0xb54f, 0xd6a0, 0xada2, 0x95b0,
			0x4977, 0x497f, 0xa4b0, 0xb4b5, 0x6a50, 0x6d40, 0xab54, 0x2b6f, 0x9570, 0x52f2, 0x4970, 0x6566, 0xd4a0, 0xea50, 0x6a95, 0x5adf, 0x2b60, 0x86e3, 0x92ef, 0xc8d7, 0xc95f, 0xd4a0, 0xd8a6,
			0xb55f, 0x56a0, 0xa5b4, 0x25df, 0x92d0, 0xd2b2, 0xa950, 0xb557, 0x6ca0, 0xb550, 0x5355, 0x4daf, 0xa5b0, 0x4573, 0x52bf, 0xa9a8, 0xe950, 0x6aa0, 0xaea6, 0xab50, 0x4b60, 0xaae4, 0xa570,
			0x5260, 0xf263, 0xd950, 0x5b57, 0x56a0, 0x96d0, 0x4dd5, 0x4ad0, 0xa4d0, 0xd4d4, 0xd250, 0xd558, 0xb540, 0xb6a0, 0x95a6, 0x95bf, 0x49b0, 0xa974, 0xa4b0, 0xb27a, 0x6a50, 0x6d40, 0xaf46,
			0xab60, 0x9570, 0x4af5, 0x4970, 0x64b0, 0x74a3, 0xea50, 0x6b58, 0x5ac0, 0xab60, 0x96d5, 0x92e0, 0xc960, 0xd954, 0xd4a0, 0xda50, 0x7552, 0x56a0, 0xabb7, 0x25d0, 0x92d0, 0xcab5, 0xa950,
			0xb4a0, 0xbaa4, 0xad50, 0x55d9, 0x4ba0, 0xa5b0, 0x5176, 0x52bf, 0xa930, 0x7954, 0x6aa0, 0xad50, 0x5b52, 0x4b60, 0xa6e6, 0xa4e0, 0xd260, 0xea65, 0xd530, 0x5aa0, 0x76a3, 0x96d0, 0x4afb,
			0x4ad0, 0xa4d0, 0xd0b6, 0xd25f, 0xd520, 0xdd45, 0xb5a0, 0x56d0, 0x55b2, 0x49b0, 0xa577, 0xa4b0, 0xaa50, 0xb255, 0x6d2f, 0xada0, 0x4b63, 0x937f, 0x49f8, 0x4970, 0x64b0, 0x68a6, 0xea5f,
			0x6b20, 0xa6c4, 0xaaef, 0x92e0, 0xd2e3, 0xc960, 0xd557, 0xd4a0, 0xda50, 0x5d55, 0x56a0, 0xa6d0, 0x55d4, 0x52d0, 0xa9b8, 0xa950, 0xb4a0, 0xb6a6, 0xad50, 0x55a0, 0xaba4, 0xa5b0, 0x52b0,
			0xb273, 0x6930, 0x7337, 0x6aa0, 0xad50, 0x4b55, 0x4b6f, 0xa570, 0x54e4, 0xd260, 0xe968, 0xd520, 0xdaa0, 0x6aa6, 0x56df, 0x4ae0, 0xa9d4, 0xa4d0, 0xd150, 0xf252, 0xd520 };
	/** 十二生肖 */
	private final static String[] Animals = { "鼠", "牛", "虎", "兔", "龙", "蛇", "马", "羊", "猴", "鸡", "狗", "猪" };
	/** 农历中文字符串一 */
	private final static String[] lunarString1 = { "零", "一", "二", "三", "四", "五", "六", "七", "八", "九" };
	/** 农历中文字符串二 */
	private final static String[] lunarString2 = { "初", "十", "廿", "卅", "正", "腊", "冬", "闰" };
	/** 农历年 */
	private int lunarYear;
	/** 农历月 */
	private int lunarMonth;
	/** 农历日 */
	private int lunarDay;
	/** 是否是闰月 */
	private boolean isLeap;
	/** 是否是闰年 */
	private boolean isLeapYear;
	/** 某农历月的最大天数 */
	private int maxDayInMonth = 29;

	/**
	 * 通过 TimeInMillis 构建农历信息
	 * @param TimeInMillis
	 */
	public SimpleLunarCalendar(long TimeInMillis) {
		this.init(TimeInMillis);
	}

	/**
	 * 通过 Date 对象构建农历信息
	 * @param date 指定日期对象
	 */
	public SimpleLunarCalendar(Date date) {
		if (date == null)
			date = new Date();
		this.init(date.getTime());
	}

	/**
	 * 农历初始化
	 * @param timeInMillis 时间毫秒数
	 */
	private void init(long timeInMillis) {
		if (timeInMillis > minTimeInMillis && timeInMillis < maxTimeInMillis) {
			// 以农历为1900年正月一日的1900-1-31作为起始日期
			Calendar baseDate = new GregorianCalendar(1900, 0, 31);
			// 距离起始日期间隔的总天数
			long offset = (timeInMillis - baseDate.getTimeInMillis()) / 86400000;
			// 默认农历年为1900年,且由此开始推算农历年份
			this.lunarYear = 1900;
			int daysInLunarYear = SimpleLunarCalendar.getLunarYearDays(this.lunarYear);
			// 递减每个农历年的总天数,确定农历年份
			while (this.lunarYear < 2100 && offset >= daysInLunarYear) {
				offset -= daysInLunarYear;
				daysInLunarYear = SimpleLunarCalendar.getLunarYearDays(++this.lunarYear);
			}
			// 获取该农历年的闰月月份
			int leapMonth = SimpleLunarCalendar.getLunarLeapMonth(this.lunarYear);
			// 没有闰月则不是闰年
			this.isLeapYear = leapMonth > 0;

			// 默认农历月为正月,且由此开始推荐农历月
			int lunarMonth = 1;
			// 是否递减农历月
			boolean isDecrease = true;
			boolean isLeap = false;
			int daysInLunarMonth = 0;
			// 递减每个农历月的总天数,确定农历月份
			while (lunarMonth < 13 && offset > 0) {
				if (isLeap && !isDecrease) {
					// 该农历年闰月的总天数
					daysInLunarMonth = SimpleLunarCalendar.getLunarLeapDays(this.lunarYear);
					isDecrease = true;
				} else {
					// 该农历年正常农历月份的天数
					daysInLunarMonth = SimpleLunarCalendar.getLunarMonthDays(this.lunarYear, lunarMonth);
				}
				if (offset < daysInLunarMonth) {
					break;
				}
				offset -= daysInLunarMonth;

				// 如果农历月是闰月,则不递增农历月份
				if (leapMonth == lunarMonth && isLeap == false) {
					isDecrease = false;
					isLeap = true;
				} else {
					lunarMonth++;
				}
			}
			// 如果daysInLunarMonth为0则说明默认农历月即为返回的农历月
			this.maxDayInMonth = daysInLunarMonth != 0 ? daysInLunarMonth : SimpleLunarCalendar.getLunarMonthDays(this.lunarYear, lunarMonth);
			this.lunarMonth = lunarMonth;
			this.isLeap = (lunarMonth == leapMonth && isLeap);
			this.lunarDay = (int) offset + 1;
		}
	}

	/**
	 * 获取某农历年的总天数
	 * @param lunarYear 农历年份
	 * @return 该农历年的总天数
	 */
	private static int getLunarYearDays(int lunarYear) {
		// 按小月计算,农历年最少有12 * 29 = 348天
		int daysInLunarYear = 348;

		// 遍历前12位
		for (int i = 0x8000; i > 0x8; i >>= 1) {
			// 每个大月累加一天
			daysInLunarYear += ((SimpleLunarCalendar.lunarInfo[lunarYear - 1900] & i) != 0) ? 1 : 0;
		}
		// 加上闰月天数
		daysInLunarYear += SimpleLunarCalendar.getLunarLeapDays(lunarYear);

		return daysInLunarYear;
	}

	/**
	 * 获取某农历年闰月的总天数
	 * @param lunarYear 农历年份
	 * @return 该农历年闰月的总天数,没有闰月返回0
	 */
	private static int getLunarLeapDays(int lunarYear) {
		// 下一年最后4bit为1111,返回30(大月)
		// 下一年最后4bit不为1111,返回29(小月)
		// 若该年没有闰月,返回0
		return SimpleLunarCalendar.getLunarLeapMonth(lunarYear) > 0 ? ((SimpleLunarCalendar.lunarInfo[lunarYear - 1899] & 0xf) == 0xf ? 30 : 29) : 0;
	}

	/**
	 * 获取某农历年闰月月份
	 * @param lunarYear 农历年份
	 * @return 该农历年闰月的月份,没有闰月返回0
	 */
	private static int getLunarLeapMonth(int lunarYear) {
		// 匹配后4位
		int leapMonth = SimpleLunarCalendar.lunarInfo[lunarYear - 1900] & 0xf;
		// 若最后4位全为1或全为0,表示没闰
		leapMonth = (leapMonth == 0xf ? 0 : leapMonth);
		return leapMonth;
	}

	/**
	 * 获取某农历年某农历月份的总天数
	 * @param lunarYear 农历年份
	 * @param lunarMonth 农历月份
	 * @return 该农历年该农历月的总天数
	 */
	private static int getLunarMonthDays(int lunarYear, int lunarMonth) {
		// 匹配前12位代表的相应农历月份的大小月,大月30天,小月29天
		int daysInLunarMonth = ((SimpleLunarCalendar.lunarInfo[lunarYear - 1900] & (0x10000 >> lunarMonth)) != 0) ? 30 : 29;
		return daysInLunarMonth;
	}

	/**
	 * 返回指定数字的农历年份表示字符串
	 * @param lunarYear 农历年份(数字,0为甲子)
	 * @return 农历年份字符串
	 */
	private static String getLunarYearString(int lunarYear) {
		String lunarYearString = "";
		String year = String.valueOf(lunarYear);
		for (int i = 0; i < year.length(); i++) {
			char yearChar = year.charAt(i);
			int index = Integer.parseInt(String.valueOf(yearChar));
			lunarYearString += lunarString1[index];
		}
		return lunarYearString;
	}

	/**
	 * 返回指定数字的农历月份表示字符串
	 * @param lunarMonth 农历月份(数字)
	 * @return 农历月份字符串 (例:正)
	 */
	private static String getLunarMonthString(int lunarMonth) {
		String lunarMonthString = "";
		if (lunarMonth == 1) {
			lunarMonthString = SimpleLunarCalendar.lunarString2[4];
		} else {
			if (lunarMonth > 9)
				lunarMonthString += SimpleLunarCalendar.lunarString2[1];
			if (lunarMonth % 10 > 0)
				lunarMonthString += SimpleLunarCalendar.lunarString1[lunarMonth % 10];
		}
		return lunarMonthString;
	}

	/**
	 * 返回指定数字的农历日表示字符串
	 * @param lunarDay 农历日(数字)
	 * @return 农历日字符串 (例: 廿一)
	 */
	private static String getLunarDayString(int lunarDay) {
		if (lunarDay < 1 || lunarDay > 30)
			return "";
		int i1 = lunarDay / 10;
		int i2 = lunarDay % 10;
		String c1 = SimpleLunarCalendar.lunarString2[i1];
		String c2 = SimpleLunarCalendar.lunarString1[i2];
		if (lunarDay < 11)
			c1 = SimpleLunarCalendar.lunarString2[0];
		if (i2 == 0)
			c2 = SimpleLunarCalendar.lunarString2[1];
		return c1 + c2;
	}

	/**
	 * 取农历年生肖
	 * @return 农历年生肖(例:龙)
	 */
	public String getAnimalString() {
		if (lunarYear == 0)
			return null;
		return SimpleLunarCalendar.Animals[(this.lunarYear - 4) % 12];
	}

	/**
	 * 返回农历日期字符串
	 * @return 农历日期字符串
	 */
	public String getDayString() {
		if (lunarDay == 0)
			return null;
		return SimpleLunarCalendar.getLunarDayString(this.lunarDay);
	}

	/**
	 * 返回农历日期字符串
	 * @return 农历日期字符串
	 */
	public String getMonthString() {
		if (lunarMonth == 0)
			return null;
		return (this.isLeap() ? "闰" : "") + SimpleLunarCalendar.getLunarMonthString(this.lunarMonth);
	}

	/**
	 * 返回农历日期字符串
	 * @return 农历日期字符串
	 */
	public String getYearString() {
		if (lunarYear == 0)
			return null;
		return SimpleLunarCalendar.getLunarYearString(this.lunarYear);
	}

	/**
	 * 返回农历表示字符串
	 * @return 农历字符串(例:甲子年正月初三)
	 */
	public String getDateString() {
		if (lunarYear == 0)
			return null;
		return this.getYearString() + "年" + this.getMonthString() + "月" + this.getDayString() + "日";
	}

	/**
	 * 农历年是否是闰月
	 * @return 农历年是否是闰月
	 */
	public boolean isLeap() {
		return isLeap;
	}

	/**
	 * 农历年是否是闰年
	 * @return 农历年是否是闰年
	 */
	public boolean isLeapYear() {
		return isLeapYear;
	}

	/**
	 * 当前农历月是否是大月
	 * @return 当前农历月是大月
	 */
	public boolean isBigMonth() {
		return this.getMaxDayInMonth() > 29;
	}

	/**
	 * 当前农历月有多少天
	 * @return 天数
	 */
	public int getMaxDayInMonth() {
		if (lunarYear == 0)
			return 0;
		return this.maxDayInMonth;
	}

	/**
	 * 农历日期
	 * @return 农历日期
	 */
	public int getDay() {
		return lunarDay;
	}

	/**
	 * 农历月份
	 * @return 农历月份
	 */
	public int getMonth() {
		return lunarMonth;
	}

	/**
	 * 农历年份
	 * @return 农历年份
	 */
	public int getYear() {
		return lunarYear;
	}
}

说明:该农历核心算法是从网上寻找而来,但我进行了完善,适用的年份为:1900年——2099年,我去掉了不精准的部分(如天干地支),目前该简单农历只能满足显示阴历信息,适合需要较为简单的用户适用。另外若想支持的年限范围更广,则需要修改lunarInfo(农历年数据表),并做适当的调整(默认农历年)即可。