这几天在研究字符串与指定类型的转换,阴差阳错地研究起 java 的日期应用了,记录下来,希望你有帮助。

  • 根据指定格式的字符串,转换为 Date(可研究根据指定格式的字符串,转化为其他指定的类型,如 json 转换为 javaBean)
    需要使用到的特殊类:import java.text.ParsePosition;
    /**
     * <p>Parses a string representing a date by trying a variety of different parsers.

     *
     * <p>The parse will try each parse pattern in turn.
     * A parse is only deemed successful if it parses the whole of the input string.
     * If no parse patterns match, a ParseException is thrown.

     *
     * @param str  the date to parse, not null
     * @param parsePatterns  the date format patterns to use, see SimpleDateFormat, not null
     * @param lenient Specify whether or not date/time parsing is to be lenient.
     * @return the parsed date
     * @throws IllegalArgumentException if the date string or pattern array is null
     * @throws ParseException if none of the date patterns were suitable
     * @see java.util.Calender#isLenient()
     */
    private static Date parseDateWithLeniency(
            String str, String[] parsePatterns, boolean lenient) throws ParseException {
        if (str == null || parsePatterns == null) {
            throw new IllegalArgumentException("Date and Patterns must not be null");
        }
         
        SimpleDateFormat parser = new SimpleDateFormat();
        parser.setLenient(lenient);
        ParsePosition pos = new ParsePosition(0);
        for (String parsePattern : parsePatterns) {
 
            String pattern = parsePattern;
 
            // LANG-530 - need to make sure 'ZZ' output doesn't get passed to SimpleDateFormat
            if (parsePattern.endsWith("ZZ")) {
                pattern = pattern.substring(0, pattern.length() - 1);
            }
             
            parser.applyPattern(pattern);
            pos.setIndex(0);
 
            String str2 = str;
            // LANG-530 - need to make sure 'ZZ' output doesn't hit SimpleDateFormat as it will ParseException
            if (parsePattern.endsWith("ZZ")) {
                str2 = str.replaceAll("([-+][0-9][0-9]):([0-9][0-9])$""$1$2");
            }
 
            Date date = parser.parse(str2, pos);
            if (date != null && pos.getIndex() == str2.length()) {
                return date;
            }
        }

        throw new ParseException("Unable to parse the date: " + str, -1);
    }

    在 java 日期格式里,"ZZ" 代表的是 时区。在java 里,格式化需要借助类 Formate,同时,parse 的时候一般需要借助类 parsePosition,ParsePosition 是 Format 及其子类所使用的简单类,用来在解析过程中跟踪当前位置。各种 Format 类中的 parseObject 方法要求将 ParsePosition对象作为一个变量。

    日期解释的宽松性:

    Calendar 有两种解释日历字段的模式,即 lenient 和 non-lenient。当 Calendar 处于 lenient 模式时,它可接受比它所生成的日历字段范围更大范围内的值。当 Calendar 重新计算日历字段值,以便由 get() 返回这些值时,所有日历字段都被标准化。例如,lenient 模式下的GregorianCalendar 将 MONTH == JANUARYDAY_OF_MONTH == 32解释为 February 1。

    当 Calendar 处于 non-lenient 模式时,如果其日历字段中存在任何不一致性,它都会抛出一个异常。例如,GregorianCalendar 总是在 1 与月份的长度之间生成 DAY_OF_MONTH 值。如果已经设置了任何超出范围的字段值,那么在计算时间或日历字段值时,处于 non-lenient 模式下的GregorianCalendar 会抛出一个异常。(在 non-lenient状态下,可以用来检测用户输入的日期是否合法)



  • 日期加减(Calendar 的 add && set && roll)
set(int field,int amount) 方法,并不会立刻就计算出新的日期的值,而是在调用 getXxx() , add(),roll() 方法才会计算出新的日期的值,即多次调用set 方法,也不会产生多余的计算。

add(int filed, int amount) 方法,调用 add 方法,会立刻计算出新的日期的值。

roll(int fielde,int amount) 方法,调用 roll 方法,也会立刻计算出新的日期的值,与 add 不同的是,在进行计算完之后,不更改更高字段的值。

举例如下:假设一个日期(Calendar类型)是date 20140831
1)调用date.set(Calendar.Month,Calendar.September),在调用 set(Calendar.Data,1) ,c.getTime() 返回的时间是 20140901
2)调用date.add(Calendar.Month,1), c.getTime() 返回的日期是,20141001。(如果是设置了 c.setLeniency(true),返回的日期是 20141001,如果是设置了 c.setLeniency(false),返回的是 20140930)
3)调用date.roll(Calendar.Month,13),c.setLeniency(flase), c.getTime() 返回的日期是 20140930,请注意这里返回的不是 20141231

对于设置日期的值,可以这样编写代码:
private static Date set(Date date, int calendarField, int amount) {
        if (date == null) {
            throw new IllegalArgumentException("The date must not be null");
        }
        // getInstance() returns a new object, so this method is thread safe.
        Calendar c = Calendar.getInstance();
        c.setLenient(false);// 这里使用严格模式,要求设置日期的值必须正确
        c.setTime(date);
        c.set(calendarField, amount);
        return c.getTime();
    }  
加减日期,可以这样编写代码:
private static Date add(Date date, int calendarField, int amount) {
        if (date == null) {
            throw new IllegalArgumentException("The date must not be null");
        }
        Calendar c = Calendar.getInstance();
        c.setTime(date);
        c.add(calendarField, amount);
        return c.getTime();
    }

roll 日期,可以这样编写代码:
private static Date roll(Date date, int calendarField, int amount) {
        if (date == null) {
            throw new IllegalArgumentException("The date must not be null");
        }
        Calendar c = Calendar.getInstance();
        c.setTime(date);
        c.roll(calendarField, amount);
        return c.getTime();
    }

对应的设置年、月、日、时、分、秒,可以这样编写代码:(其他的可以仿写)
public static Date setMinutes(Date date, int amount) {
        return set(date, Calendar.MINUTE, amount);
    }

  • 借助Calendar 提供的 api ,我们可以获取一些特殊的日期值。如下面这些日期值:
     如:get(int fiele) 获取给定日历字段的值;getFirstDayOfWeek() 获取一星期的第一天的值(1~7)(在不同的地区,每周的第一天会有所不一样,在中是默认一星期的第一天是周日 1)。通过这两个 函数,我们可以获取任意一天其所在周的第一天的日期值,如 20140902 周二,我们可以获取到周日的日期值为 20140831。具体方法如下:
    构造一个 20140902 的 Calendar,通过 getFirstDayOfWeek() ,获取本周第一天的值(返回1),通过  get(Calendar.day_of_week) 获取当前日期是本周的第几天,进而获取天数差,再将当前日期减去天数差,即可获取本周第一天的日期值。
    函数如下:
public static Date getFirstDateOfWeek(Date date){
        Calendar c = Calendar.getInstance();
        c.setTime(date);
        // 获取本周第一天的值
        int firstDayOfWeek = c.getFirstDayOfWeek();
        // 当前日期是本周的第几天
        int dayOfWeek = c.get(Calendar.DAY_OF_WEEK);
         
        int day_diff = 1;//天数差的绝对值,20140901~20140903 天数差为3
         
        if (firstDayOfWeek < dayOfWeek) {
            day_diff = Math.abs(dayOfWeek-firstDayOfWeek)  + 1;
        }
         
        c.add(Calendar.DATE,1-day_diff);
         
        return c.getTime();
    }

为了本地化,我们可以用 GregorianCalendar 构造 Calendar,
GregorianCalendar calendar = new GregorianCalendar(Local.getDefault());

类似地,我们可以得到本周最后一天的日期:
public static Date getLastDateOfWeek(Date date){
        Calendar c = Calendar.getInstance();
        c.setTime(date);
        // 获取本周第一天的值
        int firstDayOfWeek = c.getFirstDayOfWeek();
        // 当前日期是本周的第几天
        int dayOfWeek = c.get(Calendar.DAY_OF_WEEK);
         
        int day_diff = 1;//天数差的绝对值
         
        if (firstDayOfWeek < dayOfWeek) {
            day_diff =Math.abs(dayOfWeek - firstDayOfWeek) + 1;
        }
         
        c.add(Calendar.DATE, 7-day_diff);
         
        return c.getTime();
    }

    再借助 getActualMaximum(int field) 给定此 Calendar 的时间值,返回指定日历字段可能拥有的最大值。getActualMinimum(int field)  给定此 Calendar 的时间值,返回指定日历字段可能拥有的最小值。借助这两个函数,我们可以获取一天所在月的第一天/最后一天的日期。方法如下:
public static Date getFirstDateOfMonth(Date date){
        if (date == null) {
            throw new IllegalArgumentException("the date must not be null");
        }
         
        Calendar c = Calendar.getInstance();
        c.setTime(date);
        // get the min date in this month
        int min_day = c.getActualMinimum(Calendar.DATE);
        c.set(Calendar.DATE, min_day);
         
        return c.getTime();
    }
     
    public static Date getLastDateOfMonth(Date date){
        if (date == null) {
            throw new IllegalArgumentException("the date must not be null");
        }
         
        Calendar c = Calendar.getInstance();
        c.setTime(date);
        //get the max date in the month
        int max_day = c.getActualMaximum(Calendar.DATE);
        c.set(Calendar.DATE, max_day);
         
        return c.getTime();
    }

    聪明的我们,是否马上就会想到,能否通过 getActualMaximum 和 getActualMininum 来获取一周 day_of_week 的最大/小值呢??是的,通过这两个方法,我们可以减少一定的计算量,如下:
public static Date getFirstDateOfWeek(Date date){
        Calendar c = Calendar.getInstance();
        c.setTime(date);
//      // 获取本周第一天的值
//      int firstDayOfWeek = c.getFirstDayOfWeek();
//      // 当前日期是本周的第几天
//      int dayOfWeek = c.get(Calendar.DAY_OF_WEEK);
//     
//      int day_diff = 1;//天数差的绝对值,20140901~20140903 天数差为3
//     
//      if (firstDayOfWeek < dayOfWeek) {
//          day_diff = Math.abs(dayOfWeek-firstDayOfWeek)  + 1;
//      }
//     
//      c.add(Calendar.DATE,1-day_diff);
         
        int min_day = c.getActualMinimum(Calendar.DAY_OF_WEEK);
        c.set(Calendar.DAY_OF_WEEK,min_day);
         
        return c.getTime();
    }
    借助 getActualMaxinum 和 getActualMininum 可以获得很多最大/小值,如可以获取月、日、时、分、秒的最后/最初一刻,自然就可以获取一年的起始/结束日期,一天的起始/结束时刻等等,发挥想象了,灵活应用 api,就可以很多我们所需要的函数,组织起来就可以是一个 工具类了。

    在这里再谈一下,如果获取季度的起始/结束日期,方法如下:
    对于给定的日期,如果我们可以获取到其所在季度的起始月份和结束月份,自然就可以获取到季度的起始日期和结束日期。函数如下:
    在这里我们初始化静态数组,用来存储每个月所在季度第一个和最后一个月份的值,注意在 java 里,月份的范围是[0,11]
private static final int[] seasonFirstMonth = new int[] { 000333,
        666999 };
 
    private static final int[] seasonLastMonth = new int[] { 222555,
        888111111 };
     
    public static Date getFirstDateOfSeason(Date date){
        if (date == null) {
            throw new IllegalArgumentException("the date must not be null");
        }
         
        Calendar c = Calendar.getInstance();
        c.setTime(date);
         
        c.set(Calendar.MONTH, seasonFirstMonth[c.get(Calendar.MONTH)]);
        c.set(Calendar.DATE, c.getActualMinimum(Calendar.DATE));
        return c.getTime();
    }
     
    public static Date getLastDateOfSeason(Date date){
        if (date == null) {
            throw new IllegalArgumentException("the date must not be null");
        }
         
        Calendar c = Calendar.getInstance();
        c.setTime(date);
         
        c.set(Calendar.MONTH, seasonLastMonth[c.get(Calendar.MONTH)]);
        c.set(Calendar.DATE, c.getActualMaximum(Calendar.DATE));
        return c.getTime();
    }

    最后谈一下,如何去计算两个日期之间的天数差(规定如下,20140901~20140903,天数差为3),函数如下:
public static long getDaysBetweenTwoDate(Date date1,Date date2){
        if (date1 == null || date2 == null) {
            throw new IllegalArgumentException("date1 and date2 must not be null");
        }
         
        Calendar c1 = Calendar.getInstance();
        c1.setTime(date1);
         
        Calendar c2 = Calendar.getInstance();
        c2.setTime(date2);
         
        long mills_one_day = 60 60 24 1000;
         
        return Math.abs(c1.getTimeInMillis() - c2.getTimeInMillis())/mills_one_day + 1;
    }

附:通过阅读 Java API,借助一些基础的推算逻辑,我们可以合成很多很有用工具类,让我们彼此一起努力。在这一次学习当中,本人更感兴趣的,如何通过指定的字符串格式构造指定的对象(如通过字符串构造日期),又如何通过指定格式输出制定对象(如根据 yyyyMMdd 格式输出 日期对象)。