DateUtil (jexx-core 1.0.13-RELEASE API)

java.lang.Object
- jexx.time.DateUtil

public class DateUtil
extends java.lang.Object

时间工具类

构造器概要

构造器
构造器和说明

DateUtil()

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

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static boolean`	`after(java.util.Date time1, java.util.Date time2)` 第一个时间在第二个时间后
`static boolean`	`after(java.util.Date time1, java.util.Date time2, long milliseconds)` 第一个时间在第二个时间的指定毫秒后
`static int`	`age(java.util.Date birthDay, java.util.Date dateToCompare)` 计算相对于dateToCompare的年龄，长用于计算指定生日在某年的年龄
`static int`	`ageOfNow(java.util.Date birthDay)` 生日转为年龄，计算法定年龄
`static int`	`ageOfNow(java.lang.String birthDay)` 生日转为年龄，计算法定年龄
`static boolean`	`before(java.util.Date time1, java.util.Date time2)` 第一个时间超过第二个时间
`static boolean`	`before(java.util.Date time1, java.util.Date time2, long milliseconds)` 第一个时间在第二个时间的指定毫秒前
`static java.util.Calendar`	`beginOfDay(java.util.Calendar calendar)` 以默认系统时区获取某天的开始时间
`static java.util.Calendar`	`beginOfDay(java.util.Calendar calendar, java.util.TimeZone timeZone)` 获取某天的开始时间
`static DateTime`	`beginOfDay(java.util.Date date)` 获取默认时区为准的某天的开始时间
`static DateTime`	`beginOfDay(java.util.Date date, java.util.TimeZone timeZone)` 获取某天的开始时间
`static java.util.Calendar`	`beginOfMonth(java.util.Calendar calendar)` 获取某月的开始时间
`static DateTime`	`beginOfMonth(java.util.Date date)` 获取某月的开始时间
`static java.util.Calendar`	`beginOfQuarter(java.util.Calendar calendar)` 获取某季度的开始时间
`static DateTime`	`beginOfQuarter(java.util.Date date)` 获取某季度的开始时间
`static java.util.Calendar`	`beginOfWeek(java.util.Calendar calendar)` 获取某周的开始时间
`static java.util.Calendar`	`beginOfWeek(java.util.Calendar calendar, boolean isMondayAsFirstDay)` 获取某周的开始时间，周一定为一周的开始时间
`static DateTime`	`beginOfWeek(java.util.Date date)` 获取某周的开始时间
`static java.util.Calendar`	`beginOfYear(java.util.Calendar calendar)` 获取某年的开始时间
`static DateTime`	`beginOfYear(java.util.Date date)` 获取某年的开始时间
`static long`	`between(java.util.Date beginDate, java.util.Date endDate, DateUnit unit)` 判断两个日期相差的时长，只保留绝对值
`static long`	`between(java.util.Date beginDate, java.util.Date endDate, DateUnit unit, boolean isAbs)` 判断两个日期相差的时长
`static long`	`betweenDay(java.util.Date beginDate, java.util.Date endDate)` 判断两个日期相差的天数计算相差天数的时候需要忽略时分秒。
`static long`	`betweenMonth(java.util.Date beginDate, java.util.Date endDate, boolean isReset)` 计算两个日期相差月数在非重置情况下，如果起始日期的天小于结束日期的天，月数要少算1（不足1个月）
`static long`	`betweenMs(java.util.Date beginDate, java.util.Date endDate)` 判断两个日期相差的毫秒数
`static long`	`betweenYear(java.util.Date beginDate, java.util.Date endDate, boolean isReset)` 计算两个日期相差年数在非重置情况下，如果起始日期的月小于结束日期的月，年数要少算1（不足1年）
`static java.util.Calendar`	`calendar(java.util.Date date)` 转换为Calendar对象
`static java.util.Calendar`	`calendar(long millis)` 转换为Calendar对象
`static long`	`current(boolean isNano)` 当前时间long
`static long`	`currentSeconds()` 当前时间秒数
`static DateTime`	`date()` 转换为`DateTime`对象
`static DateTime`	`date(java.util.Calendar calendar)` `Calendar`类型时间转为`DateTime`
`static DateTime`	`date(java.util.Date date)` `Date`类型时间转为`DateTime`
`static DateTime`	`date(long date)` Long类型时间转为`DateTime` 同时支持10位秒级别时间戳和13位毫秒级别时间戳
`static int`	`dayOfMonth(java.util.Date date)` 获得指定日期是这个日期所在月份的第几天
`static int`	`dayOfMonth(java.util.Date date, java.util.TimeZone timeZone)`
`static int`	`dayOfWeek(java.util.Date date)` 获得指定日期是星期几，1表示周日，2表示周一
`static int`	`dayOfWeek(java.util.Date date, java.util.TimeZone timeZone)`
`static Week`	`dayOfWeekEnum(java.util.Date date)` 获得指定日期是星期几
`static Week`	`dayOfWeekEnum(java.util.Date date, java.util.TimeZone timeZone)`
`static java.util.Calendar`	`endOfDay(java.util.Calendar calendar)` 获取某天的结束时间
`static DateTime`	`endOfDay(java.util.Date date)` 获取某天的结束时间
`static java.util.Calendar`	`endOfMonth(java.util.Calendar calendar)` 获取某月的结束时间
`static DateTime`	`endOfMonth(java.util.Date date)` 获取某月的结束时间
`static java.util.Calendar`	`endOfQuarter(java.util.Calendar calendar)` 获取某季度的结束时间
`static DateTime`	`endOfQuarter(java.util.Date date)` 获取某季度的结束时间
`static java.util.Calendar`	`endOfWeek(java.util.Calendar calendar)` 获取某周的结束时间，周日定为一周的结束
`static java.util.Calendar`	`endOfWeek(java.util.Calendar calendar, boolean isSundayAsLastDay)` 获取某周的结束时间
`static DateTime`	`endOfWeek(java.util.Date date)` 获取某周的结束时间
`static java.util.Calendar`	`endOfYear(java.util.Calendar calendar)` 获取某年的结束时间
`static DateTime`	`endOfYear(java.util.Date date)` 获取某年的结束时间
`static java.lang.String`	`format(java.util.Date date, java.text.DateFormat format)` 根据特定格式格式化日期
`static java.lang.String`	`format(java.util.Date date, DatePattern pattern)` 根据特定格式格式化日期
`static java.lang.String`	`format(java.util.Date date, DatePrinter format)` 根据特定格式格式化日期
`static java.lang.String`	`format(java.util.Date date, java.lang.String format)` 根据特定格式格式化日期
`static java.lang.String`	`formatBetween(java.util.Date beginDate, java.util.Date endDate)` 格式化日期间隔输出，精确到毫秒
`static java.lang.String`	`formatBetween(java.util.Date beginDate, java.util.Date endDate, BetweenFormater.Level level)` 格式化日期间隔输出
`static java.lang.String`	`formatBetween(long betweenMs)` 格式化日期间隔输出，精确到毫秒
`static java.lang.String`	`formatBetween(long betweenMs, BetweenFormater.Level level)` 格式化日期间隔输出
`static java.lang.String`	`formatDate(java.util.Date date)` 默认格式 yyyy-MM-dd 格式化日期
`static java.lang.String`	`formatDateTime(java.util.Date date)` 默认格式 yyyy-MM-dd HH:mm:ss 格式化日期
`static java.lang.String`	`formatPureDate(java.util.Date date)` 格式化时间，yyyyMMdd
`static java.lang.String`	`formatPureDateTime(java.util.Date date)` 格式化时间, yyyyMMddHHmmss
`static int`	`hour(java.util.Date date)`
`static int`	`hour(java.util.Date date, boolean is24HourClock)`
`static int`	`hour(java.util.Date date, java.util.TimeZone timeZone)`
`static int`	`hour(java.util.Date date, java.util.TimeZone timeZone, boolean is24HourClock)` 指定日期在指定时区的小时,从0开始
`static boolean`	`isAM(java.util.Date date)`
`static boolean`	`isAM(java.util.Date date, java.util.TimeZone timeZone)` 指定日期指定时区是否为上午
`static boolean`	`isExpired(java.util.Date startDate, DateField dateField, int timeLength, java.util.Date checkedDate)` 判定给定开始时间经过某段时间后是否过期
`static boolean`	`isIn(java.util.Date date, java.util.Date beginDate, java.util.Date endDate)` 当前日期是否在日期指定范围内起始日期和结束日期可以互换
`static boolean`	`isLeapYear(int year)` 是否闰年
`static boolean`	`isPM(java.util.Date date)`
`static boolean`	`isPM(java.util.Date date, java.util.TimeZone timeZone)` 指定日期指定时区是否为下午
`static boolean`	`isSameDay(java.util.Date day1, java.util.Date day2)`
`static boolean`	`isSameDay(java.util.Date day1, java.util.Date day2, java.util.TimeZone timeZone)` 判断两个日期在指定时区是否在一天
`static boolean`	`isSameHour(java.util.Date day1, java.util.Date day2)`
`static boolean`	`isSameHour(java.util.Date day1, java.util.Date day2, java.util.TimeZone timeZone)` 判断两个日期在指定时区是否在一天
`static DateTime`	`lastMonth()` 上个月
`static DateTime`	`lastWeek()` 上周
`static int`	`millsecond(java.util.Date date)`
`static int`	`millsecond(java.util.Date date, java.util.TimeZone timeZone)` 指定日期指定时区的毫秒
`static int`	`minute(java.util.Date date)`
`static int`	`minute(java.util.Date date, java.util.TimeZone timeZone)` 指定日期指定时区的分钟数
`static int`	`month(java.util.Date date)` 获得月份，从0开始计数
`static int`	`month(java.util.Date date, java.util.TimeZone timeZone)` 指定时区的月,从0开始
`static Month`	`monthEnum(java.util.Date date)` 获得月份
`static DateTime`	`nextMonth()` 下个月
`static DateTime`	`nextWeek()` 下周
`static java.lang.String`	`now()` 当前时间，格式 yyyy-MM-dd HH:mm:ss
`static DateTime`	`offset(java.util.Date date, DateField dateField, int offset)` 获取指定日期偏移指定时间后的时间
`static DateTime`	`offsetDay(java.util.Date date, int offset)` 偏移天
`static DateTime`	`offsetHour(java.util.Date date, int offset)` 偏移小时
`static DateTime`	`offsetMillisecond(java.util.Date date, int offset)` 偏移毫秒数
`static DateTime`	`offsetMinute(java.util.Date date, int offset)` 偏移分钟
`static DateTime`	`offsetMonth(java.util.Date date, int offset)` 偏移月
`static DateTime`	`offsetSecond(java.util.Date date, int offset)` 偏移秒数
`static DateTime`	`offsetWeek(java.util.Date date, int offset)` 偏移周
`static DateTime`	`parse(java.lang.String dateStr)` 将日期字符串转换为`DateTime`对象，格式： yyyy-MM-dd HH:mm:ss yyyy/MM/dd HH:mm:ss yyyy年MM月dd日 HH时mm分ss秒 yyyy-MM-dd yyyy/MM/dd HH:mm:ss HH时mm分ss秒 yyyy-MM-dd HH:mm yyyy-MM-dd HH:mm:ss.SSS yyyyMMddHHmmss yyyyMMddHHmmssSSS yyyyMMdd EEE, dd MMM yyyy HH:mm:ss z EEE MMM dd HH:mm:ss zzz yyyy yyyy-MM-dd'T'HH:mm:ss.SSSXXX yyyy-MM-dd'T'HH:mm:ss.SSSZ https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html#text http://www.cnblogs.com/CharlesGrant/p/5088910.html
`static DateTime`	`parse(java.lang.String dateStr, java.text.DateFormat dateFormat)` 构建DateTime对象
`static DateTime`	`parse(java.lang.String dateStr, DateParser parser)` 构建DateTime对象
`static DateTime`	`parse(java.lang.String dateStr, DatePattern pattern)` 将特定格式的日期转换为Date对象
`static DateTime`	`parse(java.lang.String dateStr, java.lang.String format)` 将特定格式的日期转换为Date对象
`static DateTime`	`parseDate(java.lang.String dateStr)` 字符串以格式 yyyy-MM-dd 转化为时间
`static DateTime`	`parseDateTime(java.lang.String dateStr)` 字符串以格式 yyyy-MM-dd HH:mm:ss 转化为时间
`static DateTime`	`parsePureDate(java.lang.String dateStr)` 字符串以格式 yyyyMMdd 转化为时间
`static DateTime`	`parsePureDateTime(java.lang.String dateStr)` 字符串以格式 yyyyMMddHHmmss 转化为时间
`static int`	`quarter(java.util.Date date)` 获得指定日期所属季度，从1开始计数
`static Quarter`	`quarterEnum(java.util.Date date)` 获得指定日期所属季度
`static DateRanger`	`range(java.util.Date start, java.util.Date end, DateField unit)` 创建日期范围生成器
`static java.util.List<java.util.Date>`	`rangeToList(java.util.Date start, java.util.Date end, DateField unit)` 创建日期范围生成器
`static int`	`second(java.util.Date date)`
`static int`	`second(java.util.Date date, java.util.TimeZone timeZone)` 指定日期指定时区的秒
`static java.lang.String`	`secondToTime(int seconds)` 秒数转为时间格式(HH:mm:ss) 参考：https://github.com/iceroot
`static long`	`spendMs(long preTime)` 计时，常用于记录某段代码的执行时间，单位：毫秒
`static long`	`spendNt(long preTime)` 计时，常用于记录某段代码的执行时间，单位：纳秒
`static int`	`thisDayOfMonth()`
`static int`	`thisDayOfWeek()`
`static Week`	`thisDayOfWeekEnum()`
`static int`	`thisHour(boolean is24HourClock)`
`static int`	`thisMillsecond()`
`static int`	`thisMinute()`
`static int`	`thisMonth()`
`static Month`	`thisMonthEnum()`
`static int`	`thisSecond()`
`static int`	`thisWeekOfMonth()`
`static int`	`thisWeekOfYear()`
`static int`	`thisYear()`
`static int`	`timeToSecond(java.lang.String timeStr)` 时间格式字符串转为秒数参考：https://github.com/iceroot
`static java.lang.String`	`today()` 当前日期，格式 yyyy-MM-dd
`static int`	`toIntSecond(java.util.Date date)` 格式化成yyMMddHHmm后转换为int型
`static DateTime`	`tomorrow()` 明天
`static int`	`weekCount(java.util.Date start, java.util.Date end)` 计算指定指定时间区间内的周数
`static int`	`weekOfMonth(java.util.Date date)` 获得指定日期是所在月份的第几周
`static int`	`weekOfYear(java.util.Date date)` 获得指定日期是所在年份的第几周
`static int`	`year(java.util.Date date)` 获得年的部分
`static int`	`year(java.util.Date date, java.util.TimeZone timeZone)`
`static java.lang.String`	`yearAndQuarter(java.util.Date date)` 获得指定日期年份和季节格式：[20131]表示2013年第一季度
`static java.util.LinkedHashSet<java.lang.String>`	`yearAndQuarter(java.util.Date startDate, java.util.Date endDate)` 获得指定日期区间内的年份和季节
`static DateTime`	`yesterday()` 昨天

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

- 构造器详细资料
  - DateUtil
```
public DateUtil()
```
- 方法详细资料
  - date
```
public static DateTime date()
```
    转换为DateTime对象
    
    返回:
    
    当前时间
  - date
```
public static DateTime date(java.util.Date date)
```
    Date类型时间转为DateTime
    
    参数:
    
    date - Long类型Date（Unix时间戳）
    
    返回:
    
    时间对象
    
    从以下版本开始:
    
    3.0.7
  - date
```
public static DateTime date(long date)
```
    Long类型时间转为DateTime
    同时支持10位秒级别时间戳和13位毫秒级别时间戳
    
    参数:
    
    date - Long类型Date（Unix时间戳）
    
    返回:
    
    时间对象
  - date
```
public static DateTime date(java.util.Calendar calendar)
```
    Calendar类型时间转为DateTime
    
    参数:
    
    calendar - Calendar
    
    返回:
    
    时间对象
  - calendar
```
public static java.util.Calendar calendar(java.util.Date date)
```
    转换为Calendar对象
    
    参数:
    
    date - 日期对象
    
    返回:
    
    Calendar对象
  - calendar
```
public static java.util.Calendar calendar(long millis)
```
    转换为Calendar对象
    
    参数:
    
    millis - 时间戳
    
    返回:
    
    Calendar对象
  - now
```
public static java.lang.String now()
```
    当前时间，格式 yyyy-MM-dd HH:mm:ss
    
    返回:
    
    当前时间的标准形式字符串
  - current
```
public static long current(boolean isNano)
```
    当前时间long
    
    参数:
    
    isNano - 是否为高精度时间
    
    返回:
    
    时间
  - currentSeconds
```
public static long currentSeconds()
```
    当前时间秒数
    
    返回:
    
    当前时间秒数
    
    从以下版本开始:
    
    4.0.0
  - today
```
public static java.lang.String today()
```
    当前日期，格式 yyyy-MM-dd
    
    返回:
    
    当前日期的标准形式字符串
  - year
```
public static int year(java.util.Date date)
```
    获得年的部分
    
    参数:
    
    date - 日期
    
    返回:
    
    年的部分
  - year
```
public static int year(java.util.Date date,
                       java.util.TimeZone timeZone)
```
  - quarter
```
public static int quarter(java.util.Date date)
```
    获得指定日期所属季度，从1开始计数
    
    参数:
    
    date - 日期
    
    返回:
    
    第几个季度
    
    从以下版本开始:
    
    4.1.0
  - quarterEnum
```
public static Quarter quarterEnum(java.util.Date date)
```
    获得指定日期所属季度
    
    参数:
    
    date - 日期
    
    返回:
    
    第几个季度枚举
    
    从以下版本开始:
    
    4.1.0
  - month
```
public static int month(java.util.Date date)
```
    获得月份，从0开始计数
    
    参数:
    
    date - 日期
    
    返回:
    
    月份，从0开始计数
  - month
```
public static int month(java.util.Date date,
                        java.util.TimeZone timeZone)
```
    指定时区的月,从0开始
    
    参数:
    
    date - 日期
    
    timeZone - 时区
    
    返回:
    
    从0开始的月份
  - monthEnum
```
public static Month monthEnum(java.util.Date date)
```
    获得月份
    
    参数:
    
    date - 日期
    
    返回:
    
    Month
  - weekOfYear
```
public static int weekOfYear(java.util.Date date)
```
    获得指定日期是所在年份的第几周
    
    参数:
    
    date - 日期
    
    返回:
    
    周
  - weekOfMonth
```
public static int weekOfMonth(java.util.Date date)
```
    获得指定日期是所在月份的第几周
    
    参数:
    
    date - 日期
    
    返回:
    
    周
  - dayOfMonth
```
public static int dayOfMonth(java.util.Date date)
```
    获得指定日期是这个日期所在月份的第几天
    
    参数:
    
    date - 日期
    
    返回:
    
    天
  - dayOfMonth
```
public static int dayOfMonth(java.util.Date date,
                             java.util.TimeZone timeZone)
```
  - dayOfWeek
```
public static int dayOfWeek(java.util.Date date)
```
    获得指定日期是星期几，1表示周日，2表示周一
    
    参数:
    
    date - 日期
    
    返回:
    
    天
  - dayOfWeek
```
public static int dayOfWeek(java.util.Date date,
                            java.util.TimeZone timeZone)
```
  - dayOfWeekEnum
```
public static Week dayOfWeekEnum(java.util.Date date)
```
    获得指定日期是星期几
    
    参数:
    
    date - 日期
    
    返回:
    
    Week
  - dayOfWeekEnum
```
public static Week dayOfWeekEnum(java.util.Date date,
                                 java.util.TimeZone timeZone)
```
  - hour
```
public static int hour(java.util.Date date)
```
  - hour
```
public static int hour(java.util.Date date,
                       java.util.TimeZone timeZone)
```
  - hour
```
public static int hour(java.util.Date date,
                       boolean is24HourClock)
```
  - hour
```
public static int hour(java.util.Date date,
                       java.util.TimeZone timeZone,
                       boolean is24HourClock)
```
    指定日期在指定时区的小时,从0开始
    
    参数:
    
    date - 指定日期
    
    timeZone - 指定时区
    
    is24HourClock - 是否二十四小时制
    
    返回:
    
    小时
  - minute
```
public static int minute(java.util.Date date)
```
  - minute
```
public static int minute(java.util.Date date,
                         java.util.TimeZone timeZone)
```
    指定日期指定时区的分钟数
    
    参数:
    
    date - 指定日期
    
    timeZone - 指定时区
    
    返回:
    
    分钟数
  - second
```
public static int second(java.util.Date date)
```
  - second
```
public static int second(java.util.Date date,
                         java.util.TimeZone timeZone)
```
    指定日期指定时区的秒
    
    参数:
    
    date - 指定日期
    
    timeZone - 指定时区
    
    返回:
    
    秒，从0开始
  - millsecond
```
public static int millsecond(java.util.Date date)
```
  - millsecond
```
public static int millsecond(java.util.Date date,
                             java.util.TimeZone timeZone)
```
    指定日期指定时区的毫秒
    
    参数:
    
    date - 指定日期
    
    timeZone - 指定时区
    
    返回:
    
    毫秒
  - isAM
```
public static boolean isAM(java.util.Date date)
```
  - isAM
```
public static boolean isAM(java.util.Date date,
                           java.util.TimeZone timeZone)
```
    指定日期指定时区是否为上午
    
    参数:
    
    date - 指定日期
    
    timeZone - 指定时区
    
    返回:
    
    是否为上午
  - isPM
```
public static boolean isPM(java.util.Date date)
```
  - isPM
```
public static boolean isPM(java.util.Date date,
                           java.util.TimeZone timeZone)
```
    指定日期指定时区是否为下午
    
    参数:
    
    date - 指定日期
    
    timeZone - 指定时区
    
    返回:
    
    是否为下午
  - thisYear
```
public static int thisYear()
```
    返回:
    
    今年
  - thisMonth
```
public static int thisMonth()
```
    返回:
    
    当前月份
  - thisMonthEnum
```
public static Month thisMonthEnum()
```
    返回:
    
    当前月份 Month
  - thisWeekOfYear
```
public static int thisWeekOfYear()
```
    返回:
    
    当前日期所在年份的第几周
  - thisWeekOfMonth
```
public static int thisWeekOfMonth()
```
    返回:
    
    当前日期所在年份的第几周
  - thisDayOfMonth
```
public static int thisDayOfMonth()
```
    返回:
    
    当前日期是这个日期所在月份的第几天
  - thisDayOfWeek
```
public static int thisDayOfWeek()
```
    返回:
    
    当前日期是星期几
  - thisDayOfWeekEnum
```
public static Week thisDayOfWeekEnum()
```
    返回:
    
    当前日期是星期几 Week
  - thisHour
```
public static int thisHour(boolean is24HourClock)
```
    参数:
    
    is24HourClock - 是否24小时制
    
    返回:
    
    当前日期的小时数部分
  - thisMinute
```
public static int thisMinute()
```
    返回:
    
    当前日期的分钟数部分
  - thisSecond
```
public static int thisSecond()
```
    返回:
    
    当前日期的秒数部分
  - thisMillsecond
```
public static int thisMillsecond()
```
    返回:
    
    当前日期的毫秒数部分
  - yearAndQuarter
```
public static java.lang.String yearAndQuarter(java.util.Date date)
```
    获得指定日期年份和季节
    格式：[20131]表示2013年第一季度
    
    参数:
    
    date - 日期
    
    返回:
    
    Quarter ，类似于 20132
  - yearAndQuarter
```
public static java.util.LinkedHashSet<java.lang.String> yearAndQuarter(java.util.Date startDate,
                                                                       java.util.Date endDate)
```
    获得指定日期区间内的年份和季节
    
    参数:
    
    startDate - 起始日期（包含）
    
    endDate - 结束日期（包含）
    
    返回:
    
    Season列表，元素类似于 20132
  - format
```
public static java.lang.String format(java.util.Date date,
                                      java.lang.String format)
```
    根据特定格式格式化日期
    
    参数:
    
    date - 被格式化的日期
    
    format - 日期格式，常用格式见： DatePattern
    
    返回:
    
    格式化后的字符串
  - format
```
public static java.lang.String format(java.util.Date date,
                                      DatePattern pattern)
```
    根据特定格式格式化日期
    
    参数:
    
    date - 被格式化的日期
    
    pattern - 日期格式枚举类
    
    返回:
    
    格式化后的字符串
  - format
```
public static java.lang.String format(java.util.Date date,
                                      DatePrinter format)
```
    根据特定格式格式化日期
    
    参数:
    
    date - 被格式化的日期
    
    format - DatePrinter 或 FastDateFormat
    
    返回:
    
    格式化后的字符串
  - format
```
public static java.lang.String format(java.util.Date date,
                                      java.text.DateFormat format)
```
    根据特定格式格式化日期
    
    参数:
    
    date - 被格式化的日期
    
    format - SimpleDateFormat
    
    返回:
    
    格式化后的字符串
  - formatDate
```
public static java.lang.String formatDate(java.util.Date date)
```
    默认格式 yyyy-MM-dd 格式化日期
    
    参数:
    
    date - 被格式化的日期
    
    返回:
    
    格式化后的字符串
  - formatDateTime
```
public static java.lang.String formatDateTime(java.util.Date date)
```
    默认格式 yyyy-MM-dd HH:mm:ss 格式化日期
    
    参数:
    
    date - 被格式化的日期
    
    返回:
    
    格式化后的字符串
  - formatPureDate
```
public static java.lang.String formatPureDate(java.util.Date date)
```
    格式化时间，yyyyMMdd
  - formatPureDateTime
```
public static java.lang.String formatPureDateTime(java.util.Date date)
```
    格式化时间, yyyyMMddHHmmss
  - parse
```
public static DateTime parse(java.lang.String dateStr,
                             java.text.DateFormat dateFormat)
```
    构建DateTime对象
    
    参数:
    
    dateStr - Date字符串
    
    dateFormat - 格式化器 SimpleDateFormat
    
    返回:
    
    DateTime对象
  - parse
```
public static DateTime parse(java.lang.String dateStr,
                             DateParser parser)
```
    构建DateTime对象
    
    参数:
    
    dateStr - Date字符串
    
    parser - 格式化器,FastDateFormat
    
    返回:
    
    DateTime对象
  - parse
```
public static DateTime parse(java.lang.String dateStr,
                             java.lang.String format)
```
    将特定格式的日期转换为Date对象
    
    参数:
    
    dateStr - 特定格式的日期
    
    format - 格式，例如yyyy-MM-dd
    
    返回:
    
    日期对象
  - parse
```
public static DateTime parse(java.lang.String dateStr,
                             DatePattern pattern)
```
    将特定格式的日期转换为Date对象
    
    参数:
    
    dateStr - 特定格式的日期
    
    pattern - 日期格式枚举类
  - parse
```
public static DateTime parse(java.lang.String dateStr)
```
    将日期字符串转换为DateTime对象，格式：
    1. yyyy-MM-dd HH:mm:ss
    2. yyyy/MM/dd HH:mm:ss
    3. yyyy年MM月dd日 HH时mm分ss秒
    4. yyyy-MM-dd
    5. yyyy/MM/dd
    6. HH:mm:ss
    7. HH时mm分ss秒
    8. yyyy-MM-dd HH:mm
    9. yyyy-MM-dd HH:mm:ss.SSS
    10. yyyyMMddHHmmss
    11. yyyyMMddHHmmssSSS
    12. yyyyMMdd
    13. EEE, dd MMM yyyy HH:mm:ss z
    14. EEE MMM dd HH:mm:ss zzz yyyy
    15. yyyy-MM-dd'T'HH:mm:ss.SSSXXX
    16. yyyy-MM-dd'T'HH:mm:ss.SSSZ
    https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html#text http://www.cnblogs.com/CharlesGrant/p/5088910.html
    参数:
    
    dateStr - 日期字符串
    
    返回:
    
    日期
  - parseDate
```
public static DateTime parseDate(java.lang.String dateStr)
```
    字符串以格式 yyyy-MM-dd 转化为时间
    
    参数:
    
    dateStr - 时间字符串
    
    返回:
    
    日期
  - parseDateTime
```
public static DateTime parseDateTime(java.lang.String dateStr)
```
    字符串以格式 yyyy-MM-dd HH:mm:ss 转化为时间
    
    参数:
    
    dateStr - 时间字符串
    
    返回:
    
    日期
  - parsePureDate
```
public static DateTime parsePureDate(java.lang.String dateStr)
```
    字符串以格式 yyyyMMdd 转化为时间
  - parsePureDateTime
```
public static DateTime parsePureDateTime(java.lang.String dateStr)
```
    字符串以格式 yyyyMMddHHmmss 转化为时间
  - beginOfDay
```
public static DateTime beginOfDay(java.util.Date date,
                                  java.util.TimeZone timeZone)
```
    获取某天的开始时间
    
    参数:
    
    date - 日期
    
    返回:
    
    DateTime
  - beginOfDay
```
public static DateTime beginOfDay(java.util.Date date)
```
    获取默认时区为准的某天的开始时间
    
    参数:
    
    date - 某天
    
    返回:
    
    DateTime
  - beginOfDay
```
public static java.util.Calendar beginOfDay(java.util.Calendar calendar,
                                            java.util.TimeZone timeZone)
```
    获取某天的开始时间
    
    参数:
    
    calendar - 日期 Calendar
    
    timeZone - 指定时区 TimeZone
    
    返回:
    
    Calendar
  - beginOfDay
```
public static java.util.Calendar beginOfDay(java.util.Calendar calendar)
```
    以默认系统时区获取某天的开始时间
    
    参数:
    
    calendar - 日期 Calendar
    
    返回:
    
    Calendar
  - endOfDay
```
public static DateTime endOfDay(java.util.Date date)
```
    获取某天的结束时间
    
    参数:
    
    date - 日期
    
    返回:
    
    DateTime
  - endOfDay
```
public static java.util.Calendar endOfDay(java.util.Calendar calendar)
```
    获取某天的结束时间
    
    参数:
    
    calendar - 日期 Calendar
    
    返回:
    
    Calendar
  - beginOfWeek
```
public static DateTime beginOfWeek(java.util.Date date)
```
    获取某周的开始时间
    
    参数:
    
    date - 日期
    
    返回:
    
    DateTime
  - endOfWeek
```
public static DateTime endOfWeek(java.util.Date date)
```
    获取某周的结束时间
    
    参数:
    
    date - 日期
    
    返回:
    
    DateTime
  - beginOfWeek
```
public static java.util.Calendar beginOfWeek(java.util.Calendar calendar)
```
    获取某周的开始时间
    
    参数:
    
    calendar - 日期 Calendar
    
    返回:
    
    Calendar
  - beginOfWeek
```
public static java.util.Calendar beginOfWeek(java.util.Calendar calendar,
                                             boolean isMondayAsFirstDay)
```
    获取某周的开始时间，周一定为一周的开始时间
    
    参数:
    
    calendar - 日期 Calendar
    
    isMondayAsFirstDay - 是否周一做为一周的第一天（false表示周日做为第一天）
    
    返回:
    
    Calendar
    
    从以下版本开始:
    
    3.1.2
  - endOfWeek
```
public static java.util.Calendar endOfWeek(java.util.Calendar calendar)
```
    获取某周的结束时间，周日定为一周的结束
    
    参数:
    
    calendar - 日期 Calendar
    
    返回:
    
    Calendar
  - endOfWeek
```
public static java.util.Calendar endOfWeek(java.util.Calendar calendar,
                                           boolean isSundayAsLastDay)
```
    获取某周的结束时间
    
    参数:
    
    calendar - 日期 Calendar
    
    isSundayAsLastDay - 是否周日做为一周的最后一天（false表示周六做为最后一天）
    
    返回:
    
    Calendar
    
    从以下版本开始:
    
    3.1.2
  - beginOfMonth
```
public static DateTime beginOfMonth(java.util.Date date)
```
    获取某月的开始时间
    
    参数:
    
    date - 日期
    
    返回:
    
    DateTime
  - endOfMonth
```
public static DateTime endOfMonth(java.util.Date date)
```
    获取某月的结束时间
    
    参数:
    
    date - 日期
    
    返回:
    
    DateTime
  - beginOfMonth
```
public static java.util.Calendar beginOfMonth(java.util.Calendar calendar)
```
    获取某月的开始时间
    
    参数:
    
    calendar - 日期 Calendar
    
    返回:
    
    Calendar
  - endOfMonth
```
public static java.util.Calendar endOfMonth(java.util.Calendar calendar)
```
    获取某月的结束时间
    
    参数:
    
    calendar - 日期 Calendar
    
    返回:
    
    Calendar
  - beginOfQuarter
```
public static DateTime beginOfQuarter(java.util.Date date)
```
    获取某季度的开始时间
    
    参数:
    
    date - 日期
    
    返回:
    
    DateTime
  - endOfQuarter
```
public static DateTime endOfQuarter(java.util.Date date)
```
    获取某季度的结束时间
    
    参数:
    
    date - 日期
    
    返回:
    
    DateTime
  - beginOfQuarter
```
public static java.util.Calendar beginOfQuarter(java.util.Calendar calendar)
```
    获取某季度的开始时间
    
    参数:
    
    calendar - 日期 Calendar
    
    返回:
    
    Calendar
  - endOfQuarter
```
public static java.util.Calendar endOfQuarter(java.util.Calendar calendar)
```
    获取某季度的结束时间
    
    参数:
    
    calendar - 日期 Calendar
    
    返回:
    
    Calendar
  - beginOfYear
```
public static DateTime beginOfYear(java.util.Date date)
```
    获取某年的开始时间
    
    参数:
    
    date - 日期
    
    返回:
    
    DateTime
  - endOfYear
```
public static DateTime endOfYear(java.util.Date date)
```
    获取某年的结束时间
    
    参数:
    
    date - 日期
    
    返回:
    
    DateTime
  - beginOfYear
```
public static java.util.Calendar beginOfYear(java.util.Calendar calendar)
```
    获取某年的开始时间
    
    参数:
    
    calendar - 日期 Calendar
    
    返回:
    
    Calendar
  - endOfYear
```
public static java.util.Calendar endOfYear(java.util.Calendar calendar)
```
    获取某年的结束时间
    
    参数:
    
    calendar - 日期 Calendar
    
    返回:
    
    Calendar
  - yesterday
```
public static DateTime yesterday()
```
    昨天
    
    返回:
    
    昨天
  - tomorrow
```
public static DateTime tomorrow()
```
    明天
    
    返回:
    
    明天
    
    从以下版本开始:
    
    3.0.1
  - lastWeek
```
public static DateTime lastWeek()
```
    上周
    
    返回:
    
    上周
  - nextWeek
```
public static DateTime nextWeek()
```
    下周
    
    返回:
    
    下周
    
    从以下版本开始:
    
    3.0.1
  - lastMonth
```
public static DateTime lastMonth()
```
    上个月
    
    返回:
    
    上个月
  - nextMonth
```
public static DateTime nextMonth()
```
    下个月
    
    返回:
    
    下个月
    
    从以下版本开始:
    
    3.0.1
  - offsetMillisecond
```
public static DateTime offsetMillisecond(java.util.Date date,
                                         int offset)
```
    偏移毫秒数
    
    参数:
    
    date - 日期
    
    offset - 偏移毫秒数，正数向未来偏移，负数向历史偏移
    
    返回:
    
    偏移后的日期
  - offsetSecond
```
public static DateTime offsetSecond(java.util.Date date,
                                    int offset)
```
    偏移秒数
    
    参数:
    
    date - 日期
    
    offset - 偏移秒数，正数向未来偏移，负数向历史偏移
    
    返回:
    
    偏移后的日期
  - offsetMinute
```
public static DateTime offsetMinute(java.util.Date date,
                                    int offset)
```
    偏移分钟
    
    参数:
    
    date - 日期
    
    offset - 偏移分钟数，正数向未来偏移，负数向历史偏移
    
    返回:
    
    偏移后的日期
  - offsetHour
```
public static DateTime offsetHour(java.util.Date date,
                                  int offset)
```
    偏移小时
    
    参数:
    
    date - 日期
    
    offset - 偏移小时数，正数向未来偏移，负数向历史偏移
    
    返回:
    
    偏移后的日期
  - offsetDay
```
public static DateTime offsetDay(java.util.Date date,
                                 int offset)
```
    偏移天
    
    参数:
    
    date - 日期
    
    offset - 偏移天数，正数向未来偏移，负数向历史偏移
    
    返回:
    
    偏移后的日期
  - offsetWeek
```
public static DateTime offsetWeek(java.util.Date date,
                                  int offset)
```
    偏移周
    
    参数:
    
    date - 日期
    
    offset - 偏移周数，正数向未来偏移，负数向历史偏移
    
    返回:
    
    偏移后的日期
  - offsetMonth
```
public static DateTime offsetMonth(java.util.Date date,
                                   int offset)
```
    偏移月
    
    参数:
    
    date - 日期
    
    offset - 偏移月数，正数向未来偏移，负数向历史偏移
    
    返回:
    
    偏移后的日期
  - offset
```
public static DateTime offset(java.util.Date date,
                              DateField dateField,
                              int offset)
```
    获取指定日期偏移指定时间后的时间
    
    参数:
    
    date - 基准日期
    
    dateField - 偏移的粒度大小（小时、天、月等）DateField
    
    offset - 偏移量，正数为向后偏移，负数为向前偏移
    
    返回:
    
    偏移后的日期
  - between
```
public static long between(java.util.Date beginDate,
                           java.util.Date endDate,
                           DateUnit unit)
```
    判断两个日期相差的时长，只保留绝对值
    
    参数:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    unit - 相差的单位：相差天DateUnit.DAY、小时DateUnit.HOUR 等
    
    返回:
    
    日期差
  - between
```
public static long between(java.util.Date beginDate,
                           java.util.Date endDate,
                           DateUnit unit,
                           boolean isAbs)
```
    判断两个日期相差的时长
    
    参数:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    unit - 相差的单位：相差天DateUnit.DAY、小时DateUnit.HOUR 等
    
    isAbs - 日期间隔是否只保留绝对值正数
    
    返回:
    
    日期差
    
    从以下版本开始:
    
    3.3.1
  - betweenMs
```
public static long betweenMs(java.util.Date beginDate,
                             java.util.Date endDate)
```
    判断两个日期相差的毫秒数
    
    参数:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    返回:
    
    日期差
    
    从以下版本开始:
    
    3.0.1
  - betweenDay
```
public static long betweenDay(java.util.Date beginDate,
                              java.util.Date endDate)
```
    判断两个日期相差的天数
```
 计算相差天数的时候需要忽略时分秒。
 比如：2016-02-01 23:59:59=2016-02-01 00:00:00
 
```
    参数:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    返回:
    
    日期差
    
    从以下版本开始:
    
    3.0.1
  - betweenMonth
```
public static long betweenMonth(java.util.Date beginDate,
                                java.util.Date endDate,
                                boolean isReset)
```
    计算两个日期相差月数
    在非重置情况下，如果起始日期的天小于结束日期的天，月数要少算1（不足1个月）
    
    参数:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    isReset - 是否重置时间为起始时间（重置天时分秒）
    
    返回:
    
    相差月数
    
    从以下版本开始:
    
    3.0.8
  - betweenYear
```
public static long betweenYear(java.util.Date beginDate,
                               java.util.Date endDate,
                               boolean isReset)
```
    计算两个日期相差年数
    在非重置情况下，如果起始日期的月小于结束日期的月，年数要少算1（不足1年）
    
    参数:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    isReset - 是否重置时间为起始时间（重置月天时分秒）
    
    返回:
    
    相差年数
    
    从以下版本开始:
    
    3.0.8
  - formatBetween
```
public static java.lang.String formatBetween(java.util.Date beginDate,
                                             java.util.Date endDate,
                                             BetweenFormater.Level level)
```
    格式化日期间隔输出
    
    参数:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    level - 级别，按照天、小时、分、秒、毫秒分为5个等级
    
    返回:
    
    XX天XX小时XX分XX秒
  - formatBetween
```
public static java.lang.String formatBetween(java.util.Date beginDate,
                                             java.util.Date endDate)
```
    格式化日期间隔输出，精确到毫秒
    
    参数:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    返回:
    
    XX天XX小时XX分XX秒
    
    从以下版本开始:
    
    3.0.1
  - formatBetween
```
public static java.lang.String formatBetween(long betweenMs,
                                             BetweenFormater.Level level)
```
    格式化日期间隔输出
    
    参数:
    
    betweenMs - 日期间隔
    
    level - 级别，按照天、小时、分、秒、毫秒分为5个等级
    
    返回:
    
    XX天XX小时XX分XX秒XX毫秒
  - formatBetween
```
public static java.lang.String formatBetween(long betweenMs)
```
    格式化日期间隔输出，精确到毫秒
    
    参数:
    
    betweenMs - 日期间隔
    
    返回:
    
    XX天XX小时XX分XX秒XX毫秒
    
    从以下版本开始:
    
    3.0.1
  - isIn
```
public static boolean isIn(java.util.Date date,
                           java.util.Date beginDate,
                           java.util.Date endDate)
```
    当前日期是否在日期指定范围内
    起始日期和结束日期可以互换
    
    参数:
    
    date - 被检查的日期
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    返回:
    
    是否在范围内
    
    从以下版本开始:
    
    3.0.8
  - isSameDay
```
public static boolean isSameDay(java.util.Date day1,
                                java.util.Date day2)
```
  - isSameDay
```
public static boolean isSameDay(java.util.Date day1,
                                java.util.Date day2,
                                java.util.TimeZone timeZone)
```
    判断两个日期在指定时区是否在一天
    
    参数:
    
    day1 - 日期1
    
    day2 - 日期2
    
    timeZone - 时区
    
    返回:
    
    是否在同一天
  - isSameHour
```
public static boolean isSameHour(java.util.Date day1,
                                 java.util.Date day2)
```
  - isSameHour
```
public static boolean isSameHour(java.util.Date day1,
                                 java.util.Date day2,
                                 java.util.TimeZone timeZone)
```
    判断两个日期在指定时区是否在一天
    
    参数:
    
    day1 - 日期1
    
    day2 - 日期2
    
    timeZone - 时区
    
    返回:
    
    是否在同一天
  - spendNt
```
public static long spendNt(long preTime)
```
    计时，常用于记录某段代码的执行时间，单位：纳秒
    
    参数:
    
    preTime - 之前记录的时间
    
    返回:
    
    时间差，纳秒
  - spendMs
```
public static long spendMs(long preTime)
```
    计时，常用于记录某段代码的执行时间，单位：毫秒
    
    参数:
    
    preTime - 之前记录的时间
    
    返回:
    
    时间差，毫秒
  - toIntSecond
```
public static int toIntSecond(java.util.Date date)
```
    格式化成yyMMddHHmm后转换为int型
    
    参数:
    
    date - 日期
    
    返回:
    
    int
  - weekCount
```
public static int weekCount(java.util.Date start,
                            java.util.Date end)
```
    计算指定指定时间区间内的周数
    
    参数:
    
    start - 开始时间
    
    end - 结束时间
    
    返回:
    
    周数
  - ageOfNow
```
public static int ageOfNow(java.lang.String birthDay)
```
    生日转为年龄，计算法定年龄
    
    参数:
    
    birthDay - 生日，标准日期字符串
    
    返回:
    
    年龄
  - ageOfNow
```
public static int ageOfNow(java.util.Date birthDay)
```
    生日转为年龄，计算法定年龄
    
    参数:
    
    birthDay - 生日
    
    返回:
    
    年龄
  - age
```
public static int age(java.util.Date birthDay,
                      java.util.Date dateToCompare)
```
    计算相对于dateToCompare的年龄，长用于计算指定生日在某年的年龄
    
    参数:
    
    birthDay - 生日
    
    dateToCompare - 需要对比的日期
    
    返回:
    
    年龄
  - isLeapYear
```
public static boolean isLeapYear(int year)
```
    是否闰年
    
    参数:
    
    year - 年
    
    返回:
    
    是否闰年
  - isExpired
```
public static boolean isExpired(java.util.Date startDate,
                                DateField dateField,
                                int timeLength,
                                java.util.Date checkedDate)
```
    判定给定开始时间经过某段时间后是否过期
    
    参数:
    
    startDate - 开始时间
    
    dateField - 时间单位
    
    timeLength - 时长
    
    checkedDate - 被比较的时间。如果经过时长后的时间晚于被检查的时间，就表示过期
    
    返回:
    
    是否过期
    
    从以下版本开始:
    
    3.1.1
  - timeToSecond
```
public static int timeToSecond(java.lang.String timeStr)
```
    时间格式字符串转为秒数
    参考：https://github.com/iceroot
    
    参数:
    
    timeStr - 字符串时分秒(HH:mm:ss)格式
    
    返回:
    
    时分秒转换后的秒数
    
    从以下版本开始:
    
    3.1.2
  - secondToTime
```
public static java.lang.String secondToTime(int seconds)
```
    秒数转为时间格式(HH:mm:ss)
    参考：https://github.com/iceroot
    
    参数:
    
    seconds - 需要转换的秒数
    
    返回:
    
    转换后的字符串
    
    从以下版本开始:
    
    3.1.2
  - range
```
public static DateRanger range(java.util.Date start,
                               java.util.Date end,
                               DateField unit)
```
    创建日期范围生成器
    
    参数:
    
    start - 起始日期时间
    
    end - 结束日期时间
    
    unit - 步进单位
    
    返回:
    
    DateRanger
  - rangeToList
```
public static java.util.List<java.util.Date> rangeToList(java.util.Date start,
                                                         java.util.Date end,
                                                         DateField unit)
```
    创建日期范围生成器
    
    参数:
    
    start - 起始日期时间
    
    end - 结束日期时间
    
    unit - 步进单位
    
    返回:
    
    DateRanger
  - before
```
public static boolean before(java.util.Date time1,
                             java.util.Date time2,
                             long milliseconds)
```
    第一个时间在第二个时间的指定毫秒前
    
    参数:
    
    time1 - 第一个时间
    
    time2 - 第二个时间
    
    milliseconds - 指定毫秒
  - before
```
public static boolean before(java.util.Date time1,
                             java.util.Date time2)
```
    第一个时间超过第二个时间
    
    参数:
    
    time1 - 第一个时间
    
    time2 - 第二个时间
  - after
```
public static boolean after(java.util.Date time1,
                            java.util.Date time2,
                            long milliseconds)
```
    第一个时间在第二个时间的指定毫秒后
    
    参数:
    
    time1 - 第一个时间
    
    time2 - 第二个时间
    
    milliseconds - 指定毫秒
  - after
```
public static boolean after(java.util.Date time1,
                            java.util.Date time2)
```
    第一个时间在第二个时间后
    
    参数:
    
    time1 - 第一个时间
    
    time2 - 第二个时间

类 DateUtil

构造器概要

方法概要

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

构造器详细资料

DateUtil

方法详细资料

date

date

date

date

calendar

calendar

now

current

currentSeconds

today

year

year

quarter

quarterEnum

month

month

monthEnum

weekOfYear

weekOfMonth

dayOfMonth

dayOfMonth

dayOfWeek

dayOfWeek

dayOfWeekEnum

dayOfWeekEnum

hour

hour

hour

hour

minute

minute

second

second

millsecond

millsecond

isAM

isAM

isPM

isPM

thisYear

thisMonth

thisMonthEnum

thisWeekOfYear

thisWeekOfMonth

thisDayOfMonth

thisDayOfWeek

thisDayOfWeekEnum

thisHour

thisMinute

thisSecond

thisMillsecond

yearAndQuarter

yearAndQuarter

format

format

format

format

formatDate

formatDateTime

formatPureDate

formatPureDateTime

parse

parse

parse

parse

parse

parseDate

parseDateTime

parsePureDate

parsePureDateTime

beginOfDay

beginOfDay

beginOfDay