java日期工具类DateUtil-续二

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

源码：

DateUtil类

新加入代码：（其他代码请参见java日期工具类DateUtil-续一）

[java] view plaincopy

/** 

 * 获取简单农历对象 

 * @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类

[java] view plaincopy

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（农历年数据表），并做适当的调整（默认农历年）即可。