DateUtil (util v0.1.1 API)

java.lang.Object
- cn.tekin.spring.util.DateUtil

```
public class DateUtil
extends Object
```

字段概要

字段
限定符和类型	字段和说明
`static String`	`DATE_FORMAT_MMDDHHMI` 特殊格式日期格式，月日时分，例如：10-05 12:00
`static String`	`DATE_FORMAT_POINTYYYYMMDD` 日期格式，年月日，例如：2016.10.05
`static String`	`DATE_FORMAT_YY_MM_DD` 日期格式，年月日，用横杠分开，例如：06-12-25，08-08-08
`static String`	`DATE_FORMAT_YYMMDD` 格式到年月日日期格式，年月日，例如：050630，080808
`static String`	`DATE_FORMAT_YYYY` 格式到年日期格式，年份，例如：2004，2008
`static String`	`DATE_FORMAT_YYYY_MM` 日期格式，年份和月份，例如：200707，2008-08
`static String`	`DATE_FORMAT_YYYY_MM_DD` 日期格式，年月日，用横杠分开，例如：2006-12-25，2008-08-08
`static String`	`DATE_FORMAT_YYYYMM` 格式到年月日期格式，年份和月份，例如：200707，200808
`static String`	`DATE_FORMAT_YYYYMMDD` 日期格式，年月日，例如：20050630，20080808
`static String`	`DATE_FORMAT_YYYYMMDDHHmm` 格式到年月日时分日期格式，年月日时分，例如：200506301210，200808081210
`static String`	`DATE_TIME_FORMAT_YYYY_MM_DD_HH_MI` 日期格式，年月日时分，例如：2000-12-30 12:00，2008-08-08 20:08
`static String`	`DATE_TIME_FORMAT_YYYY_MM_DD_HH_MI_SS` 日期格式，年月日时分秒，年月日用横杠分开，时分秒用冒号分开例如：2005-05-10 23：20：00，2008-08-08 20:08:08
`static String`	`DATE_TIME_FORMAT_YYYYMMDD_HH_MI` 日期格式，年月日时分，例如：20001230 12:00，20080808 20:08
`static String`	`DATE_TIME_FORMAT_YYYYMMDDHHMISS` 格式到年月日时分秒日期格式，年月日时分秒，例如：20001230120000，20080808200808
`static String`	`DATE_TIME_FORMAT_YYYYMMDDHHMISSSSS` 格式到年月日时分秒毫秒日期格式，年月日时分秒毫秒，例如：20001230120000123，20080808200808456
`static String`	`DATE_TIME_FORMAT_YYYY年MM月DD日` 日期格式，年月日，例如：2016年10月05日

构造器概要

构造器
构造器和说明

DateUtil()

构造器
构造器和说明
`DateUtil()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static Date`	`addDate(Date date, int year, int month, int day, int hour, int minute, int second, int millisecond)` 获得指定时间加减参数后的日期(不计算则输入0)
`static Boolean`	`compareIsSameMonth(Date date1, Date date2)` 判断二个时间是否为同年同月
`static Date`	`formatHhMmSsOfDate(Date date)` 将指定日期的时分秒格式为零
`static String`	`getCurrentStrDateTime()` 获取当前字符串时间 Y-m-d H:i:s 格式
`static Integer`	`getDay(Date date)` 获取某日期的日数
`static Date`	`getDayBeginTime(Date date)` 获取指定时间的那天 00:00:00.000 的时间
`static Date`	`getDayEndTime(Date date)` 获取指定时间的那天 23:59:59.999 的时间
`static List<String>`	`getDayListOfDate(String beginDateStr, String endDateStr)` 解析两个日期段之间的所有日期
`static String`	`getDayWeekOfDate1(Date date)` 获取某个日期为星期几
`static Integer`	`getDayWeekOfDate2(Date date)` 获得指定日期的星期几数
`static Long`	`getDistanceDays(String str1, String str2)` 两个时间之间相差距离多少天
`static long[]`	`getDistanceTime(Date one, Date two)` 获得两个时间相差距离多少天多少小时多少分多少秒
`static long[]`	`getDistanceTime(String str1, String str2)` 两个时间相差距离多少天多少小时多少分多少秒
`static Long`	`getDistanceTimestamp(Date startDate, Date endDate)` 获得两个日期的时间戳之差
`static Date`	`getFirstDayOfMonth(int year, int month)` 获取某年某月的第一天
`static Date`	`getFirstDayOfWeek(Date date)` 获取指定日期所在周的第一天
`static Date`	`getFirstDayOfWeek(int year, int week)` 获取某年某周的第一天
`static Date`	`getLastDayOfMonth(int year, int month)` 获取某年某月的最后一天
`static Date`	`getLastDayOfWeek(Date date)` 获取指定日期所在周的最后一天
`static Date`	`getLastDayOfWeek(int year, int week)` 获取某年某周的最后一天
`static Integer`	`getMonth(Date date)` 获取某日期的月份
`static List<String>`	`getMonthListOfDate(String beginDateStr, String endDateStr)` 解析两个日期之间的所有月份
`static Integer`	`getWeekCountOfYear(int year)` 获取某一年的总周数
`static Integer`	`getWeekthOfYear(Date date)` 获取当前日期是一年中第几周
`static HashMap<Integer,String>`	`getWeekTimeOfYear(int year)` 获取某一年各星期的始终时间实例：getWeekList(2016)，第52周(从2016-12-26至2017-01-01)
`static Integer`	`getYear(Date date)` 获取某日期的年份
`static List<Integer>`	`getYearListOfYears(int before, int behind)` 获取当下年份指定前后数量的年份集合
`static void`	`main(String[] args)` Main *
`static String`	`parseDateToStr(Date time, String timeFromat)` 格式化Date时间
`static String`	`parseDateToStr(Date time, String timeFromat, Date defaultValue)` 格式化Date时间
`static String`	`parseDateToStr(Date time, String timeFromat, String defaultValue)` 格式化Date时间
`static Date`	`parseStrToDate(String time, String timeFromat)` 格式化String时间
`static Date`	`parseStrToDate(String strTime, String timeFromat, Date defaultValue)` 格式化String时间
`static String`	`parseTimestampToStr(Timestamp timestamp, String timeFromat)` 格式化Timestamp时间
`static Date`	`strToDate(String strTime)` 当strTime为2008-9时返回为2008-9-1 00:00格式日期时间，无法转换返回null.
`static boolean`	`validateIsDate(String strTime)` 验证字符串是否为日期验证格式:YYYYMMDD、YYYY_MM_DD、YYYYMMDDHHMISS、YYYYMMDD_HH_MI、YYYY_MM_DD_HH_MI 、YYYYMMDDHHMISSSSS、YYYY_MM_DD_HH_MI_SS

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - DATE_FORMAT_YYYY
```
public static final String DATE_FORMAT_YYYY
```
    格式到年日期格式，年份，例如：2004，2008
    
    另请参阅:
    
    常量字段值
  - DATE_FORMAT_YYYYMM
```
public static final String DATE_FORMAT_YYYYMM
```
    格式到年月日期格式，年份和月份，例如：200707，200808
    
    另请参阅:
    
    常量字段值
  - DATE_FORMAT_YYYY_MM
```
public static final String DATE_FORMAT_YYYY_MM
```
    日期格式，年份和月份，例如：200707，2008-08
    
    另请参阅:
    
    常量字段值
  - DATE_FORMAT_YYMMDD
```
public static final String DATE_FORMAT_YYMMDD
```
    格式到年月日日期格式，年月日，例如：050630，080808
    
    另请参阅:
    
    常量字段值
  - DATE_FORMAT_YY_MM_DD
```
public static final String DATE_FORMAT_YY_MM_DD
```
    日期格式，年月日，用横杠分开，例如：06-12-25，08-08-08
    
    另请参阅:
    
    常量字段值
  - DATE_FORMAT_YYYYMMDD
```
public static final String DATE_FORMAT_YYYYMMDD
```
    日期格式，年月日，例如：20050630，20080808
    
    另请参阅:
    
    常量字段值
  - DATE_FORMAT_YYYY_MM_DD
```
public static final String DATE_FORMAT_YYYY_MM_DD
```
    日期格式，年月日，用横杠分开，例如：2006-12-25，2008-08-08
    
    另请参阅:
    
    常量字段值
  - DATE_FORMAT_POINTYYYYMMDD
```
public static final String DATE_FORMAT_POINTYYYYMMDD
```
    日期格式，年月日，例如：2016.10.05
    
    另请参阅:
    
    常量字段值
  - DATE_TIME_FORMAT_YYYY年MM月DD日
```
public static final String DATE_TIME_FORMAT_YYYY年MM月DD日
```
    日期格式，年月日，例如：2016年10月05日
    
    另请参阅:
    
    常量字段值
  - DATE_FORMAT_YYYYMMDDHHmm
```
public static final String DATE_FORMAT_YYYYMMDDHHmm
```
    格式到年月日时分日期格式，年月日时分，例如：200506301210，200808081210
    
    另请参阅:
    
    常量字段值
  - DATE_TIME_FORMAT_YYYYMMDD_HH_MI
```
public static final String DATE_TIME_FORMAT_YYYYMMDD_HH_MI
```
    日期格式，年月日时分，例如：20001230 12:00，20080808 20:08
    
    另请参阅:
    
    常量字段值
  - DATE_TIME_FORMAT_YYYY_MM_DD_HH_MI
```
public static final String DATE_TIME_FORMAT_YYYY_MM_DD_HH_MI
```
    日期格式，年月日时分，例如：2000-12-30 12:00，2008-08-08 20:08
    
    另请参阅:
    
    常量字段值
  - DATE_TIME_FORMAT_YYYYMMDDHHMISS
```
public static final String DATE_TIME_FORMAT_YYYYMMDDHHMISS
```
    格式到年月日时分秒日期格式，年月日时分秒，例如：20001230120000，20080808200808
    
    另请参阅:
    
    常量字段值
  - DATE_TIME_FORMAT_YYYY_MM_DD_HH_MI_SS
```
public static final String DATE_TIME_FORMAT_YYYY_MM_DD_HH_MI_SS
```
    日期格式，年月日时分秒，年月日用横杠分开，时分秒用冒号分开例如：2005-05-10 23：20：00，2008-08-08 20:08:08
    
    另请参阅:
    
    常量字段值
  - DATE_TIME_FORMAT_YYYYMMDDHHMISSSSS
```
public static final String DATE_TIME_FORMAT_YYYYMMDDHHMISSSSS
```
    格式到年月日时分秒毫秒日期格式，年月日时分秒毫秒，例如：20001230120000123，20080808200808456
    
    另请参阅:
    
    常量字段值
  - DATE_FORMAT_MMDDHHMI
```
public static final String DATE_FORMAT_MMDDHHMI
```
    特殊格式日期格式，月日时分，例如：10-05 12:00
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - DateUtil
```
public DateUtil()
```
- 方法详细资料
  - getCurrentStrDateTime
```
public static String getCurrentStrDateTime()
```
    获取当前字符串时间 Y-m-d H:i:s 格式
    
    返回:
    
    string string
  - getYear
```
public static Integer getYear(Date date)
```
    获取某日期的年份
    
    参数:
    
    date - date
    
    返回:
    
    year year
  - getMonth
```
public static Integer getMonth(Date date)
```
    获取某日期的月份
    
    参数:
    
    date - date
    
    返回:
    
    month month
  - getDay
```
public static Integer getDay(Date date)
```
    获取某日期的日数
    
    参数:
    
    date - date
    
    返回:
    
    integer integer
  - parseDateToStr
```
public static String parseDateToStr(Date time,
                                    String timeFromat)
```
    格式化Date时间
    
    参数:
    
    time - Date类型时间
    
    timeFromat - String类型格式
    
    返回:
    
    格式化后的字符串 string
  - parseTimestampToStr
```
public static String parseTimestampToStr(Timestamp timestamp,
                                         String timeFromat)
```
    格式化Timestamp时间
    
    参数:
    
    timestamp - Timestamp类型时间
    
    timeFromat - time fromat
    
    返回:
    
    格式化后的字符串 string
  - parseDateToStr
```
public static String parseDateToStr(Date time,
                                    String timeFromat,
                                    Date defaultValue)
```
    格式化Date时间
    
    参数:
    
    time - Date类型时间
    
    timeFromat - String类型格式
    
    defaultValue - 默认值为当前时间Date
    
    返回:
    
    格式化后的字符串 string
  - parseDateToStr
```
public static String parseDateToStr(Date time,
                                    String timeFromat,
                                    String defaultValue)
```
    格式化Date时间
    
    参数:
    
    time - Date类型时间
    
    timeFromat - String类型格式
    
    defaultValue - 默认时间值String类型
    
    返回:
    
    格式化后的字符串 string
  - parseStrToDate
```
public static Date parseStrToDate(String time,
                                  String timeFromat)
```
    格式化String时间
    
    参数:
    
    time - String类型时间
    
    timeFromat - String类型格式
    
    返回:
    
    格式化后的Date日期 date
  - parseStrToDate
```
public static Date parseStrToDate(String strTime,
                                  String timeFromat,
                                  Date defaultValue)
```
    格式化String时间
    
    参数:
    
    strTime - String类型时间
    
    timeFromat - String类型格式
    
    defaultValue - 异常时返回的默认值
    
    返回:
    
    date date
  - strToDate
```
public static Date strToDate(String strTime)
```
    当strTime为2008-9时返回为2008-9-1 00:00格式日期时间，无法转换返回null.
    
    参数:
    
    strTime - str time
    
    返回:
    
    date date
  - getMonthListOfDate
```
public static List<String> getMonthListOfDate(String beginDateStr,
                                              String endDateStr)
```
    解析两个日期之间的所有月份
    
    参数:
    
    beginDateStr - 开始日期，至少精确到yyyy-MM
    
    endDateStr - 结束日期，至少精确到yyyy-MM
    
    返回:
    
    yyyy -MM日期集合
  - getDayListOfDate
```
public static List<String> getDayListOfDate(String beginDateStr,
                                            String endDateStr)
```
    解析两个日期段之间的所有日期
    
    参数:
    
    beginDateStr - 开始日期，至少精确到yyyy-MM-dd
    
    endDateStr - 结束日期，至少精确到yyyy-MM-dd
    
    返回:
    
    yyyy -MM-dd日期集合
  - getYearListOfYears
```
public static List<Integer> getYearListOfYears(int before,
                                               int behind)
```
    获取当下年份指定前后数量的年份集合
    
    参数:
    
    before - 当下年份前年数
    
    behind - 当下年份后年数
    
    返回:
    
    集合 year list of years
  - getWeekthOfYear
```
public static Integer getWeekthOfYear(Date date)
```
    获取当前日期是一年中第几周
    
    参数:
    
    date - date
    
    返回:
    
    weekth of year
  - getWeekTimeOfYear
```
public static HashMap<Integer,String> getWeekTimeOfYear(int year)
```
    获取某一年各星期的始终时间实例：getWeekList(2016)，第52周(从2016-12-26至2017-01-01)
    
    参数:
    
    year - year
    
    返回:
    
    week time of year
  - getWeekCountOfYear
```
public static Integer getWeekCountOfYear(int year)
```
    获取某一年的总周数
    
    参数:
    
    year - year
    
    返回:
    
    integer integer
  - getFirstDayOfWeek
```
public static Date getFirstDayOfWeek(Date date)
```
    获取指定日期所在周的第一天
    
    参数:
    
    date - date
    
    返回:
    
    first day of week
  - getLastDayOfWeek
```
public static Date getLastDayOfWeek(Date date)
```
    获取指定日期所在周的最后一天
    
    参数:
    
    date - date
    
    返回:
    
    last day of week
  - getFirstDayOfWeek
```
public static Date getFirstDayOfWeek(int year,
                                     int week)
```
    获取某年某周的第一天
    
    参数:
    
    year - 目标年份
    
    week - 目标周数
    
    返回:
    
    first day of week
  - getLastDayOfWeek
```
public static Date getLastDayOfWeek(int year,
                                    int week)
```
    获取某年某周的最后一天
    
    参数:
    
    year - 目标年份
    
    week - 目标周数
    
    返回:
    
    last day of week
  - getFirstDayOfMonth
```
public static Date getFirstDayOfMonth(int year,
                                      int month)
```
    获取某年某月的第一天
    
    参数:
    
    year - 目标年份
    
    month - 目标月份
    
    返回:
    
    date date
  - getLastDayOfMonth
```
public static Date getLastDayOfMonth(int year,
                                     int month)
```
    获取某年某月的最后一天
    
    参数:
    
    year - 目标年份
    
    month - 目标月份
    
    返回:
    
    date date
  - getDayWeekOfDate1
```
public static String getDayWeekOfDate1(Date date)
```
    获取某个日期为星期几
    
    参数:
    
    date - date
    
    返回:
    
    String "星期*"
  - getDayWeekOfDate2
```
public static Integer getDayWeekOfDate2(Date date)
```
    获得指定日期的星期几数
    
    参数:
    
    date - date
    
    返回:
    
    int integer
  - validateIsDate
```
public static boolean validateIsDate(String strTime)
```
    验证字符串是否为日期验证格式:YYYYMMDD、YYYY_MM_DD、YYYYMMDDHHMISS、YYYYMMDD_HH_MI、YYYY_MM_DD_HH_MI 、YYYYMMDDHHMISSSSS、YYYY_MM_DD_HH_MI_SS
    
    参数:
    
    strTime - str time
    
    返回:
    
    null时返回false ;true为日期，false不为日期
  - formatHhMmSsOfDate
```
public static Date formatHhMmSsOfDate(Date date)
```
    将指定日期的时分秒格式为零
    
    参数:
    
    date - date
    
    返回:
    
    date date
  - addDate
```
public static Date addDate(Date date,
                           int year,
                           int month,
                           int day,
                           int hour,
                           int minute,
                           int second,
                           int millisecond)
```
    获得指定时间加减参数后的日期(不计算则输入0)
    
    参数:
    
    date - 指定日期
    
    year - 年数，可正可负
    
    month - 月数，可正可负
    
    day - 天数，可正可负
    
    hour - 小时数，可正可负
    
    minute - 分钟数，可正可负
    
    second - 秒数，可正可负
    
    millisecond - 毫秒数，可正可负
    
    返回:
    
    计算后的日期 date
  - getDistanceTimestamp
```
public static Long getDistanceTimestamp(Date startDate,
                                        Date endDate)
```
    获得两个日期的时间戳之差
    
    参数:
    
    startDate - start date
    
    endDate - end date
    
    返回:
    
    long long
  - compareIsSameMonth
```
public static Boolean compareIsSameMonth(Date date1,
                                         Date date2)
```
    判断二个时间是否为同年同月
    
    参数:
    
    date1 - date 1
    
    date2 - date 2
    
    返回:
    
    boolean boolean
  - getDistanceTime
```
public static long[] getDistanceTime(Date one,
                                     Date two)
```
    获得两个时间相差距离多少天多少小时多少分多少秒
    
    参数:
    
    one - one
    
    two - two
    
    返回:
    
    long[] 返回值为：{天, 时, 分, 秒}
  - getDistanceTime
```
public static long[] getDistanceTime(String str1,
                                     String str2)
```
    两个时间相差距离多少天多少小时多少分多少秒
    
    参数:
    
    str1 - 时间参数 1 格式：1990-01-01 12:00:00
    
    str2 - 时间参数 2 格式：2009-01-01 12:00:00
    
    返回:
    
    String 返回值为：{天, 时, 分, 秒}
  - getDistanceDays
```
public static Long getDistanceDays(String str1,
                                   String str2)
                            throws Exception
```
    两个时间之间相差距离多少天
    
    参数:
    
    str1 - str 1
    
    str2 - str 2
    
    返回:
    
    相差天数 distance days
    
    抛出:
    
    Exception - if any.
  - getDayBeginTime
```
public static Date getDayBeginTime(Date date)
```
    获取指定时间的那天 00:00:00.000 的时间
    
    参数:
    
    date - date
    
    返回:
    
    day begin time
  - getDayEndTime
```
public static Date getDayEndTime(Date date)
```
    获取指定时间的那天 23:59:59.999 的时间
    
    参数:
    
    date - date
    
    返回:
    
    day end time
  - main
```
public static void main(String[] args)
```
    Main *
    
    参数:
    
    args - args

类 DateUtil

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

DATE_FORMAT_YYYY

DATE_FORMAT_YYYYMM

DATE_FORMAT_YYYY_MM

DATE_FORMAT_YYMMDD

DATE_FORMAT_YY_MM_DD

DATE_FORMAT_YYYYMMDD

DATE_FORMAT_YYYY_MM_DD

DATE_FORMAT_POINTYYYYMMDD

DATE_TIME_FORMAT_YYYY年MM月DD日

DATE_FORMAT_YYYYMMDDHHmm

DATE_TIME_FORMAT_YYYYMMDD_HH_MI

DATE_TIME_FORMAT_YYYY_MM_DD_HH_MI

DATE_TIME_FORMAT_YYYYMMDDHHMISS

DATE_TIME_FORMAT_YYYY_MM_DD_HH_MI_SS

DATE_TIME_FORMAT_YYYYMMDDHHMISSSSS

DATE_FORMAT_MMDDHHMI

构造器详细资料

DateUtil

方法详细资料

getCurrentStrDateTime

getYear

getMonth

getDay

parseDateToStr

parseTimestampToStr

parseDateToStr

parseDateToStr

parseStrToDate

parseStrToDate

strToDate

getMonthListOfDate

getDayListOfDate

getYearListOfYears

getWeekthOfYear

getWeekTimeOfYear

getWeekCountOfYear

getFirstDayOfWeek

getLastDayOfWeek

getFirstDayOfWeek

getLastDayOfWeek

getFirstDayOfMonth

getLastDayOfMonth

getDayWeekOfDate1

getDayWeekOfDate2

validateIsDate

formatHhMmSsOfDate

addDate

getDistanceTimestamp

compareIsSameMonth

getDistanceTime

getDistanceTime

getDistanceDays

getDayBeginTime

getDayEndTime

main