Java日期工具类DateUtils实例详解

package com.example.util; 
 
import java.text.ParseException; 
import java.text.SimpleDateFormat; 
import java.util.ArrayList; 
import java.util.Calendar; 
import java.util.Date; 
import java.util.List; 
 
/** 
 * 日期常用方法 
 * 
 * @author 
 * 
 */ 
public class DateUtils { 
 
  /** 
   * 常用变量 
   */ 
  public static final String DATE_FORMAT_FULL = "yyyy-MM-dd HH:mm:ss"; 
  public static final String DATE_FORMAT_YMD = "yyyy-MM-dd"; 
  public static final String DATE_FORMAT_HMS = "HH:mm:ss"; 
  public static final String DATE_FORMAT_HM = "HH:mm"; 
  public static final String DATE_FORMAT_YMDHM = "yyyy-MM-dd HH:mm"; 
  public static final String DATE_FORMAT_YMDHMS = "yyyyMMddHHmmss"; 
  public static final long ONE_DAY_MILLS = 3600000 * 24; 
  public static final int WEEK_DAYS = 7; 
  private static final int dateLength = DATE_FORMAT_YMDHM.length(); 
   
   
  /** 
   * 日期转换为制定格式字符串 
   * 
   * @param time 
   * @param format 
   * @return 
   */ 
  public static String formatDateToString(Date time, String format) { 
    SimpleDateFormat sdf = new SimpleDateFormat(format); 
    return sdf.format(time); 
  } 
 
  /** 
   * 字符串转换为制定格式日期 
   * (注意：当你输入的日期是2014-12-21 12:12，format对应的应为yyyy-MM-dd HH:mm 
   * 否则异常抛出) 
   * @param date 
   * @param format 
   * @return 
   * @throws ParseException 
   *       @ 
   */ 
  public static Date formatStringToDate(String date, String format) { 
    SimpleDateFormat sdf = new SimpleDateFormat(format); 
    try { 
      return sdf.parse(date); 
    } catch (ParseException ex) { 
      ex.printStackTrace(); 
      throw new RuntimeException(ex.toString()); 
    } 
  } 
 
  /** 
   * 判断一个日期是否属于两个时段内 
   * @param time 
   * @param timeRange 
   * @return 
   */ 
  public static boolean isTimeInRange(Date time, Date[] timeRange) { 
    return (!time.before(timeRange[0]) && !time.after(timeRange[1])); 
  } 
 
  /** 
   * 从完整的时间截取精确到分的时间 
   * 
   * @param fullDateStr 
   * @return 
   */ 
  public static String getDateToMinute(String fullDateStr) { 
    return fullDateStr == null ? null 
        : (fullDateStr.length() >= dateLength ? fullDateStr.substring( 
            0, dateLength) : fullDateStr); 
  } 
 
  /** 
   * 返回指定年度的所有周。List中包含的是String[2]对象 string[0]本周的开始日期,string[1]是本周的结束日期。 
   * 日期的格式为YYYY-MM-DD 每年的第一个周，必须包含星期一且是完整的七天。 
   * 例如：2009年的第一个周开始日期为2009-01-05，结束日期为2009-01-11。 星期一在哪一年，那么包含这个星期的周就是哪一年的周。 
   * 例如：2008-12-29是星期一，2009-01-04是星期日，哪么这个周就是2008年度的最后一个周。 
   * 
   * @param year 
   *      格式 YYYY ，必须大于1900年度 小于9999年 
   * @return @ 
   */ 
  public static List getWeeksByYear(final int year) { 
    int weeks = getWeekNumOfYear(year); 
    List result = new ArrayList(weeks); 
    int start = 1; 
    int end = 7; 
    for (int i = 1; i <= weeks; i++) { 
      String[] tempWeek = new String[2]; 
      tempWeek[0] = getDateForDayOfWeek(year, i, start); 
      tempWeek[1] = getDateForDayOfWeek(year, i, end); 
      result.add(tempWeek); 
    } 
    return result; 
  } 
 
  /** 
   * 计算指定年、周的上一年、周 
   * 
   * @param year 
   * @param week 
   * @return @ 
   */ 
  public static int[] getLastYearWeek(int year, int week) { 
    if (week <= 0) { 
      throw new IllegalArgumentException("周序号不能小于1！！"); 
    } 
    int[] result = { week, year }; 
    if (week == 1) { 
      // 上一年 
      result[1] -= 1; 
      // 最后一周 
      result[0] = getWeekNumOfYear(result[1]); 
    } else { 
      result[0] -= 1; 
    } 
    return result; 
  } 
 
  /** 
   * 下一个[周，年] 
   * 
   * @param year 
   * @param week 
   * @return @ 
   */ 
  public static int[] getNextYearWeek(int year, int week) { 
    if (week <= 0) { 
      throw new IllegalArgumentException("周序号不能小于1！！"); 
    } 
    int[] result = { week, year }; 
    int weeks = getWeekNumOfYear(year); 
    if (week == weeks) { 
      // 下一年 
      result[1] += 1; 
      // 第一周 
      result[0] = 1; 
    } else { 
      result[0] += 1; 
    } 
    return result; 
  } 
 
  /** 
   * 计算指定年度共有多少个周。(从周一开始) 
   * 
   * @param year 
   * @return @ 
   */ 
  public static int getWeekNumOfYear(final int year) { 
    return getWeekNumOfYear(year, Calendar.MONDAY); 
  } 
 
  /** 
   * 计算指定年度共有多少个周。 
   * 
   * @param year 
   *      yyyy 
   * @return @ 
   */ 
  public static int getWeekNumOfYear(final int year, int firstDayOfWeek) { 
    // 每年至少有52个周 ，最多有53个周。 
    int minWeeks = 52; 
    int maxWeeks = 53; 
    int result = minWeeks; 
    int sIndex = 4; 
    String date = getDateForDayOfWeek(year, maxWeeks, firstDayOfWeek); 
    // 判断年度是否相符，如果相符说明有53个周。 
    if (date.substring(0, sIndex).equals(year)) { 
      result = maxWeeks; 
    } 
    return result; 
  } 
 
  public static int getWeeksOfWeekYear(final int year) { 
    Calendar cal = Calendar.getInstance(); 
    cal.setFirstDayOfWeek(Calendar.MONDAY); 
    cal.setMinimalDaysInFirstWeek(WEEK_DAYS); 
    cal.set(Calendar.YEAR, year); 
    return cal.getWeeksInWeekYear(); 
  } 
 
  /** 
   * 获取指定年份的第几周的第几天对应的日期yyyy-MM-dd(从周一开始) 
   * 
   * @param year 
   * @param weekOfYear 
   * @param dayOfWeek 
   * @return yyyy-MM-dd 格式的日期 @ 
   */ 
  public static String getDateForDayOfWeek(int year, int weekOfYear, 
      int dayOfWeek) { 
    return getDateForDayOfWeek(year, weekOfYear, dayOfWeek, Calendar.MONDAY); 
  } 
 
  /** 
   * 获取指定年份的第几周的第几天对应的日期yyyy-MM-dd，指定周几算一周的第一天（firstDayOfWeek） 
   * 
   * @param year 
   * @param weekOfYear 
   * @param dayOfWeek 
   * @param firstDayOfWeek 
   *      指定周几算一周的第一天 
   * @return yyyy-MM-dd 格式的日期 
   */ 
  public static String getDateForDayOfWeek(int year, int weekOfYear, 
      int dayOfWeek, int firstDayOfWeek) { 
    Calendar cal = Calendar.getInstance(); 
    cal.setFirstDayOfWeek(firstDayOfWeek); 
    cal.set(Calendar.DAY_OF_WEEK, dayOfWeek); 
    cal.setMinimalDaysInFirstWeek(WEEK_DAYS); 
    cal.set(Calendar.YEAR, year); 
    cal.set(Calendar.WEEK_OF_YEAR, weekOfYear); 
    return formatDateToString(cal.getTime(), DATE_FORMAT_YMD); 
  } 
 
  /** 
   * 获取指定日期星期几 
   * 
   * @param datetime 
   * @throws ParseException 
   *       @ 
   */ 
  public static int getWeekOfDate(String datetime) throws ParseException { 
    Calendar cal = Calendar.getInstance(); 
    cal.setFirstDayOfWeek(Calendar.MONDAY); 
    cal.setMinimalDaysInFirstWeek(WEEK_DAYS); 
    Date date = formatStringToDate(datetime, DATE_FORMAT_YMD); 
    cal.setTime(date); 
    return cal.get(Calendar.DAY_OF_WEEK); 
 
  } 
 
  /** 
   * 计算某年某周内的所有日期(从周一开始 为每周的第一天) 
   * 
   * @param yearNum 
   * @param weekNum 
   * @return @ 
   */ 
  public static List getWeekDays(int yearNum, int weekNum) { 
    return getWeekDays(yearNum, weekNum, Calendar.MONDAY); 
  } 
 
  /** 
   * 计算某年某周内的所有日期(七天) 
   * 
   * @param yearNum 
   * @param weekNum 
   * @return yyyy-MM-dd 格式的日期列表 
   */ 
  public static List getWeekDays(int year, int weekOfYear, 
      int firstDayOfWeek) { 
    List dates = new ArrayList(); 
    int dayOfWeek = firstDayOfWeek; 
    for (int i = 0; i < WEEK_DAYS; i++) { 
      dates.add(getDateForDayOfWeek(year, weekOfYear, dayOfWeek++, 
          firstDayOfWeek)); 
    } 
    return dates; 
  } 
 
  /** 
   * 获取目标日期的上周、或本周、或下周的年、周信息 
   * 
   * @param queryDate 
   *      传入的时间 
   * @param weekOffset 
   *      -1:上周 0:本周 1:下周 
   * @param firstDayOfWeek 
   *      每周以第几天为首日 
   * @return 
   * @throws ParseException 
   */ 
  public static int[] getWeekAndYear(String queryDate, int weekOffset, 
      int firstDayOfWeek) throws ParseException { 
 
    Date date = formatStringToDate(queryDate, DATE_FORMAT_YMD); 
    Calendar calendar = Calendar.getInstance(); 
    calendar.setTime(date); 
    calendar.setFirstDayOfWeek(firstDayOfWeek); 
    calendar.setMinimalDaysInFirstWeek(WEEK_DAYS); 
    int year = calendar.getWeekYear(); 
    int week = calendar.get(Calendar.WEEK_OF_YEAR); 
    int[] result = { week, year }; 
    switch (weekOffset) { 
    case 1: 
      result = getNextYearWeek(year, week); 
      break; 
    case -1: 
      result = getLastYearWeek(year, week); 
      break; 
    default: 
      break; 
    } 
    return result; 
  } 
 
  /** 
   * 计算个两日期的天数 
   * 
   * @param startDate 
   *      开始日期字串 
   * @param endDate 
   *      结束日期字串 
   * @return 
   * @throws ParseException 
   */ 
  public static int getDaysBetween(String startDate, String endDate) 
      throws ParseException { 
    int dayGap = 0; 
    if (startDate != null && startDate.length() > 0 && endDate != null 
        && endDate.length() > 0) { 
      Date end = formatStringToDate(endDate, DATE_FORMAT_YMD); 
      Date start = formatStringToDate(startDate, DATE_FORMAT_YMD); 
      dayGap = getDaysBetween(start, end); 
    } 
    return dayGap; 
  } 
 
  private static int getDaysBetween(Date startDate, Date endDate) { 
    return (int) ((endDate.getTime() - startDate.getTime()) / ONE_DAY_MILLS); 
  } 
 
  /** 
   * 计算两个日期之间的天数差 
   * @param startDate 
   * @param endDate 
   * @return 
   */ 
  public static int getDaysGapOfDates(Date startDate, Date endDate) { 
    int date = 0; 
    if (startDate != null && endDate != null) { 
      date = getDaysBetween(startDate, endDate); 
    } 
    return date; 
  } 
 
  /** 
   * 计算两个日期之间的年份差距 
   * 
   * @param firstDate 
   * @param secondDate 
   * @return 
   */ 
 
  public static int getYearGapOfDates(Date firstDate, Date secondDate) { 
    if (firstDate == null || secondDate == null) { 
      return 0; 
    } 
    Calendar helpCalendar = Calendar.getInstance(); 
    helpCalendar.setTime(firstDate); 
    int firstYear = helpCalendar.get(Calendar.YEAR); 
    helpCalendar.setTime(secondDate); 
    int secondYear = helpCalendar.get(Calendar.YEAR); 
    return secondYear - firstYear; 
  } 
 
  /** 
   * 计算两个日期之间的月份差距 
   * 
   * @param firstDate 
   * @param secondDate 
   * @return 
   */ 
  public static int getMonthGapOfDates(Date firstDate, Date secondDate) { 
    if (firstDate == null || secondDate == null) { 
      return 0; 
    } 
 
    return (int) ((secondDate.getTime() - firstDate.getTime()) 
        / ONE_DAY_MILLS / 30); 
 
  } 
 
  /** 
   * 计算是否包含当前日期 
   * 
   * @param datys 
   * @return 
   */ 
  public static boolean isContainCurrent(List dates) { 
    boolean flag = false; 
    SimpleDateFormat fmt = new SimpleDateFormat(DATE_FORMAT_YMD); 
    Date date = new Date(); 
    String dateStr = fmt.format(date); 
    for (int i = 0; i < dates.size(); i++) { 
      if (dateStr.equals(dates.get(i))) { 
        flag = true; 
      } 
    } 
    return flag; 
  } 
 
  /** 
   * 从date开始计算time天后的日期 
   * 
   * @param date 
   * @param time 
   * @return 
   * @throws ParseException 
   */ 
  public static String getCalculateDateToString(String startDate, int time) 
      throws ParseException { 
    String resultDate = null; 
    if (startDate != null && startDate.length() > 0) { 
      Date date = formatStringToDate(startDate, DATE_FORMAT_YMD); 
      Calendar c = Calendar.getInstance(); 
      c.setTime(date); 
      c.set(Calendar.DAY_OF_YEAR, time); 
      date = c.getTime(); 
      resultDate = formatDateToString(date, DATE_FORMAT_YMD); 
    } 
    return resultDate; 
  } 
 
  /** 
   * 获取从某日期开始计算，指定的日期所在该年的第几周 
   * 
   * @param date 
   * @param admitDate 
   * @return 
   * @throws ParseException 
   *       @ 
   */ 
  public static int[] getYearAndWeeks(String date, String admitDate) 
      throws ParseException { 
    Calendar c = Calendar.getInstance(); 
    c.setTime(formatStringToDate(admitDate, DATE_FORMAT_YMD)); 
    int time = c.get(Calendar.DAY_OF_WEEK); 
    return getWeekAndYear(date, 0, time); 
  } 
 
  /** 
   * 获取指定日期refDate，前或后一周的所有日期 
   * 
   * @param refDate 
   *      参考日期 
   * @param weekOffset 
   *      -1:上周 0:本周 1:下周 
   * @param startDate 
   *      哪天算一周的第一天 
   * @return yyyy-MM-dd 格式的日期 
   * @throws ParseException 
   *       @ 
   */ 
  public static List getWeekDaysAroundDate(String refDate, 
      int weekOffset, String startDate) throws ParseException { 
    // 以startDate为一周的第一天 
    Calendar c = Calendar.getInstance(); 
    c.setTime(formatStringToDate(startDate, DATE_FORMAT_YMD)); 
    int firstDayOfWeek = c.get(Calendar.DAY_OF_WEEK); 
    // 获取相应周 
    int[] weekAndYear = getWeekAndYear(refDate, weekOffset, firstDayOfWeek); 
    // 获取相应周的所有日期 
    return getWeekDays(weekAndYear[1], weekAndYear[0], firstDayOfWeek); 
  } 
 
  /** 
   * 根据时间点获取时间区间 
   * 
   * @param hours 
   * @return 
   */ 
  public static List getTimePointsByHour(int[] hours) { 
    List hourPoints = new ArrayList(); 
    String sbStart = ":00:00"; 
    String sbEnd = ":59:59"; 
    for (int i = 0; i < hours.length; i++) { 
      String[] times = new String[2]; 
      times[0] = hours[i] + sbStart; 
      times[1] = (hours[(i + 1 + hours.length) % hours.length] - 1) 
          + sbEnd; 
      hourPoints.add(times); 
    } 
    return hourPoints; 
  } 
 
  /** 
   * 
   * 根据指定的日期，增加或者减少天数 
   * 
   * @param date 
   * @param amount 
   * @return 
   */ 
  public static Date addDays(Date date, int amount) { 
    return add(date, Calendar.DAY_OF_MONTH, amount); 
  } 
 
  /** 
   * 根据指定的日期，类型，增加或减少数量 
   * 
   * @param date 
   * @param calendarField 
   * @param amount 
   * @return 
   */ 
  public 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(); 
  } 
 
  /** 
   * 获取当前日期的最大日期 时间2014-12-21 23:59:59 
   * @return 
   */ 
  public static Date getCurDateWithMaxTime() { 
    Calendar c = Calendar.getInstance(); 
    c.set(Calendar.HOUR_OF_DAY, 23); 
    c.set(Calendar.MINUTE, 59); 
    c.set(Calendar.SECOND, 59); 
    return c.getTime(); 
  } 
 
  /** 
   * 获取当前日期的最小日期时间 2014-12-21 00:00:00 
   * @return 
   */ 
  public static Date getCurDateWithMinTime() { 
    Calendar c = Calendar.getInstance(); 
    c.set(Calendar.HOUR_OF_DAY, 0); 
    c.set(Calendar.MINUTE, 0); 
    c.set(Calendar.SECOND, 0); 
    c.set(Calendar.MILLISECOND, 0); 
    return c.getTime(); 
  } 
 
}