DateUtil (hutool-core 4.1.14 API)

java.lang.Object
- cn.hutool.core.date.DateUtil

```
public class DateUtil
extends Object
```
时间工具类

作者:

xiaoleilu

构造器概要

构造器
构造器和说明

DateUtil()

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

方法概要

方法
限定符和类型	方法和说明
`static int`	`age(Date birthDay, Date dateToCompare)` 计算相对于dateToCompare的年龄，长用于计算指定生日在某年的年龄
`static int`	`ageOfNow(Date birthDay)` 生日转为年龄，计算法定年龄
`static int`	`ageOfNow(String birthDay)` 生日转为年龄，计算法定年龄
`static Calendar`	`beginOfDay(Calendar calendar)` 获取某天的开始时间
`static DateTime`	`beginOfDay(Date date)` 获取某天的开始时间
`static Calendar`	`beginOfMonth(Calendar calendar)` 获取某月的开始时间
`static DateTime`	`beginOfMonth(Date date)` 获取某月的开始时间
`static Calendar`	`beginOfQuarter(Calendar calendar)` 获取某季度的开始时间
`static DateTime`	`beginOfQuarter(Date date)` 获取某季度的开始时间
`static Calendar`	`beginOfWeek(Calendar calendar)` 获取某周的开始时间
`static Calendar`	`beginOfWeek(Calendar calendar, boolean isMondayAsFirstDay)` 获取某周的开始时间，周一定为一周的开始时间
`static DateTime`	`beginOfWeek(Date date)` 获取某周的开始时间
`static Calendar`	`beginOfYear(Calendar calendar)` 获取某年的开始时间
`static DateTime`	`beginOfYear(Date date)` 获取某年的开始时间
`static long`	`between(Date beginDate, Date endDate, DateUnit unit)` 判断两个日期相差的时长，只保留绝对值
`static long`	`between(Date beginDate, Date endDate, DateUnit unit, boolean isAbs)` 判断两个日期相差的时长
`static long`	`betweenDay(Date beginDate, Date endDate, boolean isReset)` 判断两个日期相差的天数有时候我们计算相差天数的时候需要忽略时分秒。
`static long`	`betweenMonth(Date beginDate, Date endDate, boolean isReset)` 计算两个日期相差月数在非重置情况下，如果起始日期的天小于结束日期的天，月数要少算1（不足1个月）
`static long`	`betweenMs(Date beginDate, Date endDate)` 判断两个日期相差的毫秒数
`static long`	`betweenYear(Date beginDate, Date endDate, boolean isReset)` 计算两个日期相差年数在非重置情况下，如果起始日期的月小于结束日期的月，年数要少算1（不足1年）
`static Calendar`	`calendar(Date date)` 转换为Calendar对象
`static Calendar`	`calendar(long millis)` 转换为Calendar对象
`static long`	`current(boolean isNano)` 当前时间long
`static long`	`currentSeconds()` 当前时间秒数
`static DateTime`	`date()` 转换为`DateTime`对象
`static DateTime`	`date(Calendar calendar)` `Calendar`类型时间转为`DateTime`
`static DateTime`	`date(Date date)` `Date`类型时间转为`DateTime`
`static DateTime`	`date(long date)` Long类型时间转为`DateTime` 只支持毫秒级别时间戳，如果需要秒级别时间戳，请自行×1000
`static int`	`dayOfMonth(Date date)` 获得指定日期是这个日期所在月份的第几天
`static int`	`dayOfWeek(Date date)` 获得指定日期是星期几，1表示周日，2表示周一
`static Week`	`dayOfWeekEnum(Date date)` 获得指定日期是星期几
`static Calendar`	`endOfDay(Calendar calendar)` 获取某天的结束时间
`static DateTime`	`endOfDay(Date date)` 获取某天的结束时间
`static Calendar`	`endOfMonth(Calendar calendar)` 获取某月的结束时间
`static DateTime`	`endOfMonth(Date date)` 获取某月的结束时间
`static Calendar`	`endOfQuarter(Calendar calendar)` 获取某季度的结束时间
`static DateTime`	`endOfQuarter(Date date)` 获取某季度的结束时间
`static Calendar`	`endOfWeek(Calendar calendar)` 获取某周的结束时间，周日定为一周的结束
`static Calendar`	`endOfWeek(Calendar calendar, boolean isSundayAsLastDay)` 获取某周的结束时间
`static DateTime`	`endOfWeek(Date date)` 获取某周的结束时间
`static Calendar`	`endOfYear(Calendar calendar)` 获取某年的结束时间
`static DateTime`	`endOfYear(Date date)` 获取某年的结束时间
`static String`	`format(Date date, DateFormat format)` 根据特定格式格式化日期
`static String`	`format(Date date, DatePrinter format)` 根据特定格式格式化日期
`static String`	`format(Date date, String format)` 根据特定格式格式化日期
`static String`	`formatBetween(Date beginDate, Date endDate)` 格式化日期间隔输出，精确到毫秒
`static String`	`formatBetween(Date beginDate, Date endDate, BetweenFormater.Level level)` 格式化日期间隔输出
`static String`	`formatBetween(long betweenMs)` 格式化日期间隔输出，精确到毫秒
`static String`	`formatBetween(long betweenMs, BetweenFormater.Level level)` 格式化日期间隔输出
`static String`	`formatDate(Date date)` 格式化日期部分（不包括时间）格式 yyyy-MM-dd
`static String`	`formatDateTime(Date date)` 格式化日期时间格式 yyyy-MM-dd HH:mm:ss
`static String`	`formatHttpDate(Date date)` 格式化为Http的标准日期格式
`static String`	`formatTime(Date date)` 格式化时间格式 HH:mm:ss
`static int`	`hour(Date date, boolean is24HourClock)` 获得指定日期的小时数部分
`static boolean`	`isAM(Date date)` 是否为上午
`static boolean`	`isExpired(Date startDate, DateField dateField, int timeLength, Date checkedDate)` 判定给定开始时间经过某段时间后是否过期
`static boolean`	`isIn(Date date, Date beginDate, Date endDate)` 当前日期是否在日期指定范围内起始日期和结束日期可以互换
`static boolean`	`isLeapYear(int year)` 是否闰年
`static boolean`	`isPM(Date date)` 是否为下午
`static boolean`	`isSameDay(Calendar cal1, Calendar cal2)` 比较两个日期是否为同一天
`static boolean`	`isSameDay(Date date1, Date date2)` 比较两个日期是否为同一天
`static boolean`	`isSameTime(Date date1, Date date2)` 是否为相同时间
`static DateTime`	`lastMonth()` 上个月
`static DateTime`	`lastWeek()` 上周
`static int`	`millsecond(Date date)` 获得指定日期的毫秒数部分
`static int`	`minute(Date date)` 获得指定日期的分钟数部分例如：10:04:15.250 =》 4
`static int`	`month(Date date)` 获得月份，从0开始计数
`static Month`	`monthEnum(Date date)` 获得月份
`static DateTime`	`nextMonth()` 下个月
`static DateTime`	`nextWeek()` 下周
`static String`	`now()` 当前时间，格式 yyyy-MM-dd HH:mm:ss
`static DateTime`	`offset(Date date, DateField dateField, int offset)` 获取指定日期偏移指定时间后的时间
`static DateTime`	`offsetDate(Date date, DateField dateField, int offset)` 已过时。 please use `offset(Date, DateField, int)`
`static DateTime`	`offsetDay(Date date, int offset)` 偏移天
`static DateTime`	`offsetHour(Date date, int offset)` 偏移小时
`static DateTime`	`offsetMillisecond(Date date, int offset)` 偏移毫秒数
`static DateTime`	`offsetMinute(Date date, int offset)` 偏移分钟
`static DateTime`	`offsetMonth(Date date, int offset)` 偏移月
`static DateTime`	`offsetSecond(Date date, int offset)` 偏移秒数
`static DateTime`	`offsetWeek(Date date, int offset)` 偏移周
`static DateTime`	`parse(String dateStr)` 将日期字符串转换为`DateTime`对象，格式： yyyy-MM-dd HH:mm:ss yyyy/MM/dd HH:mm:ss yyyy.MM.dd HH:mm:ss yyyy年MM月dd日 HH时mm分ss秒 yyyy-MM-dd 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
`static DateTime`	`parse(String dateStr, DateFormat dateFormat)` 构建DateTime对象
`static DateTime`	`parse(String dateStr, DateParser parser)` 构建DateTime对象
`static DateTime`	`parse(String dateStr, String format)` 将特定格式的日期转换为Date对象
`static DateTime`	`parseDate(String dateString)` 格式yyyy-MM-dd
`static DateTime`	`parseDateTime(String dateString)` 格式yyyy-MM-dd HH:mm:ss
`static DateTime`	`parseTime(String timeString)` 解析时间，格式HH:mm:ss，默认为1970-01-01
`static DateTime`	`parseTimeToday(String timeString)` 解析时间，格式HH:mm:ss，日期默认为今天
`static DateTime`	`parseUTC(String utcString)` 解析UTC时间，格式为：yyyy-MM-dd'T'HH:mm:ss'Z
`static int`	`quarter(Date date)` 获得指定日期所属季度，从1开始计数
`static Quarter`	`quarterEnum(Date date)` 获得指定日期所属季度
`static DateRange`	`range(Date start, Date end, DateField unit)` 创建日期范围生成器
`static List<DateTime>`	`rangeToList(Date start, Date end, DateField unit)` 创建日期范围生成器
`static int`	`season(Date date)` 已过时。请使用`quarter(Date)`
`static int`	`second(Date date)` 获得指定日期的秒数部分
`static 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 TimeInterval`	`timer()` 计时器计算某个过程花费的时间，精确到毫秒
`static int`	`timeToSecond(String timeStr)` 时间格式字符串转为秒数参考：https://github.com/iceroot
`static String`	`today()` 当前日期，格式 yyyy-MM-dd
`static int`	`toIntSecond(Date date)` 格式化成yyMMddHHmm后转换为int型
`static DateTime`	`tomorrow()` 明天
`static int`	`weekCount(Date start, Date end)` 计算指定指定时间区间内的周数
`static int`	`weekOfMonth(Date date)` 获得指定日期是所在月份的第几周
`static int`	`weekOfYear(Date date)` 获得指定日期是所在年份的第几周
`static int`	`year(Date date)` 获得年的部分
`static String`	`yearAndQuarter(Date date)` 获得指定日期年份和季节格式：[20131]表示2013年第一季度
`static LinkedHashSet<String>`	`yearAndQuarter(Date startDate, Date endDate)` 获得指定日期区间内的年份和季节
`static String`	`yearAndSeason(Date date)` 已过时。请使用`yearAndQuarter(java.util.Date)` 代替
`static LinkedHashSet<String>`	`yearAndSeasons(Date startDate, Date endDate)` 已过时。请使用`yearAndQuarter(java.util.Date)` 代替
`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(Date date)
```
    Date类型时间转为DateTime
    
    参数:
    date - Long类型Date（Unix时间戳）
    
    返回:
    时间对象
    从以下版本开始:
    
    3.0.7
  - date
```
public static DateTime date(long date)
```
    Long类型时间转为DateTime
    只支持毫秒级别时间戳，如果需要秒级别时间戳，请自行×1000
    
    参数:
    date - Long类型Date（Unix时间戳）
    
    返回:
    时间对象
  - date
```
public static DateTime date(Calendar calendar)
```
    Calendar类型时间转为DateTime
    
    参数:
    calendar - Calendar
    
    返回:
    时间对象
  - calendar
```
public static Calendar calendar(Date date)
```
    转换为Calendar对象
    
    参数:
    date - 日期对象
    
    返回:
    Calendar对象
  - calendar
```
public static Calendar calendar(long millis)
```
    转换为Calendar对象
    
    参数:
    millis - 时间戳
    
    返回:
    Calendar对象
  - now
```
public static 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 String today()
```
    当前日期，格式 yyyy-MM-dd
    
    返回:
    当前日期的标准形式字符串
  - year
```
public static int year(Date date)
```
    获得年的部分
    
    参数:
    date - 日期
    
    返回:
    年的部分
  - season
```
@Deprecated
public static int season(Date date)
```
    已过时。 请使用quarter(Date)
    
    获得指定日期所属季度
    
    参数:
    date - 日期
    
    返回:
    第几个季度
  - quarter
```
public static int quarter(Date date)
```
    获得指定日期所属季度，从1开始计数
    
    参数:
    date - 日期
    
    返回:
    第几个季度
    从以下版本开始:
    
    4.1.0
  - quarterEnum
```
public static Quarter quarterEnum(Date date)
```
    获得指定日期所属季度
    
    参数:
    date - 日期
    
    返回:
    第几个季度枚举
    从以下版本开始:
    
    4.1.0
  - month
```
public static int month(Date date)
```
    获得月份，从0开始计数
    
    参数:
    date - 日期
    
    返回:
    月份，从0开始计数
  - monthEnum
```
public static Month monthEnum(Date date)
```
    获得月份
    
    参数:
    date - 日期
    
    返回:
    Month
  - weekOfYear
```
public static int weekOfYear(Date date)
```
    获得指定日期是所在年份的第几周
    
    参数:
    date - 日期
    
    返回:
    周
  - weekOfMonth
```
public static int weekOfMonth(Date date)
```
    获得指定日期是所在月份的第几周
    
    参数:
    date - 日期
    
    返回:
    周
  - dayOfMonth
```
public static int dayOfMonth(Date date)
```
    获得指定日期是这个日期所在月份的第几天
    
    参数:
    date - 日期
    
    返回:
    天
  - dayOfWeek
```
public static int dayOfWeek(Date date)
```
    获得指定日期是星期几，1表示周日，2表示周一
    
    参数:
    date - 日期
    
    返回:
    天
  - dayOfWeekEnum
```
public static Week dayOfWeekEnum(Date date)
```
    获得指定日期是星期几
    
    参数:
    date - 日期
    
    返回:
    Week
  - hour
```
public static int hour(Date date,
       boolean is24HourClock)
```
    获得指定日期的小时数部分
    
    参数:
    date - 日期
    is24HourClock - 是否24小时制
    
    返回:
    小时数
  - minute
```
public static int minute(Date date)
```
    获得指定日期的分钟数部分
    例如：10:04:15.250 =》 4
    
    参数:
    date - 日期
    
    返回:
    分钟数
  - second
```
public static int second(Date date)
```
    获得指定日期的秒数部分
    
    参数:
    date - 日期
    
    返回:
    秒数
  - millsecond
```
public static int millsecond(Date date)
```
    获得指定日期的毫秒数部分
    
    参数:
    date - 日期
    
    返回:
    毫秒数
  - isAM
```
public static boolean isAM(Date date)
```
    是否为上午
    
    参数:
    date - 日期
    
    返回:
    是否为上午
  - isPM
```
public static boolean isPM(Date date)
```
    是否为下午
    
    参数:
    date - 日期
    
    返回:
    是否为下午
  - 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()
```
    返回:
    当前日期的毫秒数部分
  - yearAndSeason
```
@Deprecated
public static String yearAndSeason(Date date)
```
    已过时。 请使用yearAndQuarter(java.util.Date) 代替
    
    获得指定日期年份和季节
    格式：[20131]表示2013年第一季度
    
    参数:
    date - 日期
    
    返回:
    Season ，类似于 20132
  - yearAndQuarter
```
public static String yearAndQuarter(Date date)
```
    获得指定日期年份和季节
    格式：[20131]表示2013年第一季度
    
    参数:
    date - 日期
    
    返回:
    Quarter ，类似于 20132
  - yearAndSeasons
```
@Deprecated
public static LinkedHashSet<String> yearAndSeasons(Date startDate,
                                              Date endDate)
```
    已过时。 请使用yearAndQuarter(java.util.Date) 代替
    
    获得指定日期区间内的年份和季节
    
    参数:
    startDate - 起始日期（包含）
    endDate - 结束日期（包含）
    
    返回:
    Season列表，元素类似于 20132
  - yearAndQuarter
```
public static LinkedHashSet<String> yearAndQuarter(Date startDate,
                                   Date endDate)
```
    获得指定日期区间内的年份和季节
    
    参数:
    startDate - 起始日期（包含）
    endDate - 结束日期（包含）
    
    返回:
    Season列表，元素类似于 20132
  - format
```
public static String format(Date date,
            String format)
```
    根据特定格式格式化日期
    
    参数:
    date - 被格式化的日期
    format - 日期格式，常用格式见： DatePattern
    
    返回:
    格式化后的字符串
  - format
```
public static String format(Date date,
            DatePrinter format)
```
    根据特定格式格式化日期
    
    参数:
    date - 被格式化的日期
    format - DatePrinter 或 FastDateFormat
    
    返回:
    格式化后的字符串
  - format
```
public static String format(Date date,
            DateFormat format)
```
    根据特定格式格式化日期
    
    参数:
    date - 被格式化的日期
    format - SimpleDateFormat
    
    返回:
    格式化后的字符串
  - formatDateTime
```
public static String formatDateTime(Date date)
```
    格式化日期时间
    格式 yyyy-MM-dd HH:mm:ss
    
    参数:
    date - 被格式化的日期
    
    返回:
    格式化后的日期
  - formatDate
```
public static String formatDate(Date date)
```
    格式化日期部分（不包括时间）
    格式 yyyy-MM-dd
    
    参数:
    date - 被格式化的日期
    
    返回:
    格式化后的字符串
  - formatTime
```
public static String formatTime(Date date)
```
    格式化时间
    格式 HH:mm:ss
    
    参数:
    date - 被格式化的日期
    
    返回:
    格式化后的字符串
    从以下版本开始:
    
    3.0.1
  - formatHttpDate
```
public static String formatHttpDate(Date date)
```
    格式化为Http的标准日期格式
    
    参数:
    date - 被格式化的日期
    
    返回:
    HTTP标准形式日期字符串
  - parse
```
public static DateTime parse(String dateStr,
             DateFormat dateFormat)
```
    构建DateTime对象
    
    参数:
    dateStr - Date字符串
    dateFormat - 格式化器 SimpleDateFormat
    
    返回:
    DateTime对象
  - parse
```
public static DateTime parse(String dateStr,
             DateParser parser)
```
    构建DateTime对象
    
    参数:
    dateStr - Date字符串
    parser - 格式化器,FastDateFormat
    
    返回:
    DateTime对象
  - parse
```
public static DateTime parse(String dateStr,
             String format)
```
    将特定格式的日期转换为Date对象
    
    参数:
    dateStr - 特定格式的日期
    format - 格式，例如yyyy-MM-dd
    
    返回:
    日期对象
  - parseDateTime
```
public static DateTime parseDateTime(String dateString)
```
    格式yyyy-MM-dd HH:mm:ss
    
    参数:
    dateString - 标准形式的时间字符串
    
    返回:
    日期对象
  - parseDate
```
public static DateTime parseDate(String dateString)
```
    格式yyyy-MM-dd
    
    参数:
    dateString - 标准形式的日期字符串
    
    返回:
    日期对象
  - parseTime
```
public static DateTime parseTime(String timeString)
```
    解析时间，格式HH:mm:ss，默认为1970-01-01
    
    参数:
    timeString - 标准形式的日期字符串
    
    返回:
    日期对象
  - parseTimeToday
```
public static DateTime parseTimeToday(String timeString)
```
    解析时间，格式HH:mm:ss，日期默认为今天
    
    参数:
    timeString - 标准形式的日期字符串
    
    返回:
    日期对象
    从以下版本开始:
    
    3.1.1
  - parseUTC
```
public static DateTime parseUTC(String utcString)
```
    解析UTC时间，格式为：yyyy-MM-dd'T'HH:mm:ss'Z
    
    参数:
    utcString - UTC时间
    
    返回:
    日期对象
    从以下版本开始:
    
    4.1.14
  - parse
```
public static DateTime parse(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日 HH时mm分ss秒
    5. yyyy-MM-dd
    6. yyyy/MM/dd
    7. yyyy.MM.dd
    8. HH:mm:ss
    9. HH时mm分ss秒
    10. yyyy-MM-dd HH:mm
    11. yyyy-MM-dd HH:mm:ss.SSS
    12. yyyyMMddHHmmss
    13. yyyyMMddHHmmssSSS
    14. yyyyMMdd
    15. EEE, dd MMM yyyy HH:mm:ss z
    16. EEE MMM dd HH:mm:ss zzz yyyy
    参数:
    dateStr - 日期字符串
    
    返回:
    日期
  - beginOfDay
```
public static DateTime beginOfDay(Date date)
```
    获取某天的开始时间
    
    参数:
    date - 日期
    
    返回:
    DateTime
  - endOfDay
```
public static DateTime endOfDay(Date date)
```
    获取某天的结束时间
    
    参数:
    date - 日期
    
    返回:
    DateTime
  - beginOfDay
```
public static Calendar beginOfDay(Calendar calendar)
```
    获取某天的开始时间
    
    参数:
    calendar - 日期 Calendar
    
    返回:
    Calendar
  - endOfDay
```
public static Calendar endOfDay(Calendar calendar)
```
    获取某天的结束时间
    
    参数:
    calendar - 日期 Calendar
    
    返回:
    Calendar
  - beginOfWeek
```
public static DateTime beginOfWeek(Date date)
```
    获取某周的开始时间
    
    参数:
    date - 日期
    
    返回:
    DateTime
  - endOfWeek
```
public static DateTime endOfWeek(Date date)
```
    获取某周的结束时间
    
    参数:
    date - 日期
    
    返回:
    DateTime
  - beginOfWeek
```
public static Calendar beginOfWeek(Calendar calendar)
```
    获取某周的开始时间
    
    参数:
    calendar - 日期 Calendar
    
    返回:
    Calendar
  - beginOfWeek
```
public static Calendar beginOfWeek(Calendar calendar,
                   boolean isMondayAsFirstDay)
```
    获取某周的开始时间，周一定为一周的开始时间
    
    参数:
    calendar - 日期 Calendar
    isMondayAsFirstDay - 是否周一做为一周的第一天（false表示周日做为第一天）
    
    返回:
    Calendar
    从以下版本开始:
    
    3.1.2
  - endOfWeek
```
public static Calendar endOfWeek(Calendar calendar)
```
    获取某周的结束时间，周日定为一周的结束
    
    参数:
    calendar - 日期 Calendar
    
    返回:
    Calendar
  - endOfWeek
```
public static Calendar endOfWeek(Calendar calendar,
                 boolean isSundayAsLastDay)
```
    获取某周的结束时间
    
    参数:
    calendar - 日期 Calendar
    isSundayAsLastDay - 是否周日做为一周的最后一天（false表示周六做为最后一天）
    
    返回:
    Calendar
    从以下版本开始:
    
    3.1.2
  - beginOfMonth
```
public static DateTime beginOfMonth(Date date)
```
    获取某月的开始时间
    
    参数:
    date - 日期
    
    返回:
    DateTime
  - endOfMonth
```
public static DateTime endOfMonth(Date date)
```
    获取某月的结束时间
    
    参数:
    date - 日期
    
    返回:
    DateTime
  - beginOfMonth
```
public static Calendar beginOfMonth(Calendar calendar)
```
    获取某月的开始时间
    
    参数:
    calendar - 日期 Calendar
    
    返回:
    Calendar
  - endOfMonth
```
public static Calendar endOfMonth(Calendar calendar)
```
    获取某月的结束时间
    
    参数:
    calendar - 日期 Calendar
    
    返回:
    Calendar
  - beginOfQuarter
```
public static DateTime beginOfQuarter(Date date)
```
    获取某季度的开始时间
    
    参数:
    date - 日期
    
    返回:
    DateTime
  - endOfQuarter
```
public static DateTime endOfQuarter(Date date)
```
    获取某季度的结束时间
    
    参数:
    date - 日期
    
    返回:
    DateTime
  - beginOfQuarter
```
public static Calendar beginOfQuarter(Calendar calendar)
```
    获取某季度的开始时间
    
    参数:
    calendar - 日期 Calendar
    
    返回:
    Calendar
    从以下版本开始:
    
    4.1.0
  - endOfQuarter
```
public static Calendar endOfQuarter(Calendar calendar)
```
    获取某季度的结束时间
    
    参数:
    calendar - 日期 Calendar
    
    返回:
    Calendar
    从以下版本开始:
    
    4.1.0
  - beginOfYear
```
public static DateTime beginOfYear(Date date)
```
    获取某年的开始时间
    
    参数:
    date - 日期
    
    返回:
    DateTime
  - endOfYear
```
public static DateTime endOfYear(Date date)
```
    获取某年的结束时间
    
    参数:
    date - 日期
    
    返回:
    DateTime
  - beginOfYear
```
public static Calendar beginOfYear(Calendar calendar)
```
    获取某年的开始时间
    
    参数:
    calendar - 日期 Calendar
    
    返回:
    Calendar
  - endOfYear
```
public static Calendar endOfYear(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(Date date,
                         int offset)
```
    偏移毫秒数
    
    参数:
    date - 日期
    offset - 偏移毫秒数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsetSecond
```
public static DateTime offsetSecond(Date date,
                    int offset)
```
    偏移秒数
    
    参数:
    date - 日期
    offset - 偏移秒数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsetMinute
```
public static DateTime offsetMinute(Date date,
                    int offset)
```
    偏移分钟
    
    参数:
    date - 日期
    offset - 偏移分钟数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsetHour
```
public static DateTime offsetHour(Date date,
                  int offset)
```
    偏移小时
    
    参数:
    date - 日期
    offset - 偏移小时数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsetDay
```
public static DateTime offsetDay(Date date,
                 int offset)
```
    偏移天
    
    参数:
    date - 日期
    offset - 偏移天数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsetWeek
```
public static DateTime offsetWeek(Date date,
                  int offset)
```
    偏移周
    
    参数:
    date - 日期
    offset - 偏移周数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsetMonth
```
public static DateTime offsetMonth(Date date,
                   int offset)
```
    偏移月
    
    参数:
    date - 日期
    offset - 偏移月数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offset
```
public static DateTime offset(Date date,
              DateField dateField,
              int offset)
```
    获取指定日期偏移指定时间后的时间
    
    参数:
    date - 基准日期
    dateField - 偏移的粒度大小（小时、天、月等）DateField
    offset - 偏移量，正数为向后偏移，负数为向前偏移
    
    返回:
    偏移后的日期
  - offsetDate
```
@Deprecated
public static DateTime offsetDate(Date date,
                             DateField dateField,
                             int offset)
```
    已过时。 please use offset(Date, DateField, int)
    
    获取指定日期偏移指定时间后的时间
    
    参数:
    date - 基准日期
    dateField - 偏移的粒度大小（小时、天、月等）DateField
    offset - 偏移量，正数为向后偏移，负数为向前偏移
    
    返回:
    偏移后的日期
  - between
```
public static long between(Date beginDate,
           Date endDate,
           DateUnit unit)
```
    判断两个日期相差的时长，只保留绝对值
    
    参数:
    beginDate - 起始日期
    endDate - 结束日期
    unit - 相差的单位：相差天DateUnit.DAY、小时DateUnit.HOUR 等
    
    返回:
    日期差
  - between
```
public static long between(Date beginDate,
           Date endDate,
           DateUnit unit,
           boolean isAbs)
```
    判断两个日期相差的时长
    
    参数:
    beginDate - 起始日期
    endDate - 结束日期
    unit - 相差的单位：相差天DateUnit.DAY、小时DateUnit.HOUR 等
    isAbs - 日期间隔是否只保留绝对值正数
    
    返回:
    日期差
    从以下版本开始:
    
    3.3.1
  - betweenMs
```
public static long betweenMs(Date beginDate,
             Date endDate)
```
    判断两个日期相差的毫秒数
    
    参数:
    beginDate - 起始日期
    endDate - 结束日期
    
    返回:
    日期差
    从以下版本开始:
    
    3.0.1
  - betweenDay
```
public static long betweenDay(Date beginDate,
              Date endDate,
              boolean isReset)
```
    判断两个日期相差的天数
```
 有时候我们计算相差天数的时候需要忽略时分秒。
 比如：2016-02-01 23:59:59和2016-02-02 00:00:00相差一秒
 如果isReset为false相差天数为0。
 如果isReset为true相差天数将被计算为1
 
```
    参数:
    beginDate - 起始日期
    endDate - 结束日期
    isReset - 是否重置时间为起始时间
    
    返回:
    日期差
    从以下版本开始:
    
    3.0.1
  - betweenMonth
```
public static long betweenMonth(Date beginDate,
                Date endDate,
                boolean isReset)
```
    计算两个日期相差月数
    在非重置情况下，如果起始日期的天小于结束日期的天，月数要少算1（不足1个月）
    
    参数:
    beginDate - 起始日期
    endDate - 结束日期
    isReset - 是否重置时间为起始时间（重置天时分秒）
    
    返回:
    相差月数
    从以下版本开始:
    
    3.0.8
  - betweenYear
```
public static long betweenYear(Date beginDate,
               Date endDate,
               boolean isReset)
```
    计算两个日期相差年数
    在非重置情况下，如果起始日期的月小于结束日期的月，年数要少算1（不足1年）
    
    参数:
    beginDate - 起始日期
    endDate - 结束日期
    isReset - 是否重置时间为起始时间（重置月天时分秒）
    
    返回:
    相差年数
    从以下版本开始:
    
    3.0.8
  - formatBetween
```
public static String formatBetween(Date beginDate,
                   Date endDate,
                   BetweenFormater.Level level)
```
    格式化日期间隔输出
    
    参数:
    beginDate - 起始日期
    endDate - 结束日期
    level - 级别，按照天、小时、分、秒、毫秒分为5个等级
    
    返回:
    XX天XX小时XX分XX秒
  - formatBetween
```
public static String formatBetween(Date beginDate,
                   Date endDate)
```
    格式化日期间隔输出，精确到毫秒
    
    参数:
    beginDate - 起始日期
    endDate - 结束日期
    
    返回:
    XX天XX小时XX分XX秒
    从以下版本开始:
    
    3.0.1
  - formatBetween
```
public static String formatBetween(long betweenMs,
                   BetweenFormater.Level level)
```
    格式化日期间隔输出
    
    参数:
    betweenMs - 日期间隔
    level - 级别，按照天、小时、分、秒、毫秒分为5个等级
    
    返回:
    XX天XX小时XX分XX秒XX毫秒
  - formatBetween
```
public static String formatBetween(long betweenMs)
```
    格式化日期间隔输出，精确到毫秒
    
    参数:
    betweenMs - 日期间隔
    
    返回:
    XX天XX小时XX分XX秒XX毫秒
    从以下版本开始:
    
    3.0.1
  - isIn
```
public static boolean isIn(Date date,
           Date beginDate,
           Date endDate)
```
    当前日期是否在日期指定范围内
    起始日期和结束日期可以互换
    
    参数:
    date - 被检查的日期
    beginDate - 起始日期
    endDate - 结束日期
    
    返回:
    是否在范围内
    从以下版本开始:
    
    3.0.8
  - isSameTime
```
public static boolean isSameTime(Date date1,
                 Date date2)
```
    是否为相同时间
    
    参数:
    date1 - 日期1
    date2 - 日期2
    
    返回:
    是否为相同时间
    从以下版本开始:
    
    4.1.13
  - isSameDay
```
public static boolean isSameDay(Date date1,
                Date date2)
```
    比较两个日期是否为同一天
    
    参数:
    date1 - 日期1
    date2 - 日期2
    
    返回:
    是否为同一天
    从以下版本开始:
    
    4.1.13
  - isSameDay
```
public static boolean isSameDay(Calendar cal1,
                Calendar cal2)
```
    比较两个日期是否为同一天
    
    参数:
    cal1 - 日期1
    cal2 - 日期2
    
    返回:
    是否为同一天
    从以下版本开始:
    
    4.1.13
  - spendNt
```
public static long spendNt(long preTime)
```
    计时，常用于记录某段代码的执行时间，单位：纳秒
    
    参数:
    preTime - 之前记录的时间
    
    返回:
    时间差，纳秒
  - spendMs
```
public static long spendMs(long preTime)
```
    计时，常用于记录某段代码的执行时间，单位：毫秒
    
    参数:
    preTime - 之前记录的时间
    
    返回:
    时间差，毫秒
  - toIntSecond
```
public static int toIntSecond(Date date)
```
    格式化成yyMMddHHmm后转换为int型
    
    参数:
    date - 日期
    
    返回:
    int
  - weekCount
```
public static int weekCount(Date start,
            Date end)
```
    计算指定指定时间区间内的周数
    
    参数:
    start - 开始时间
    end - 结束时间
    
    返回:
    周数
  - timer
```
public static TimeInterval timer()
```
    计时器
    计算某个过程花费的时间，精确到毫秒
    
    返回:
    Timer
  - ageOfNow
```
public static int ageOfNow(String birthDay)
```
    生日转为年龄，计算法定年龄
    
    参数:
    birthDay - 生日，标准日期字符串
    
    返回:
    年龄
  - ageOfNow
```
public static int ageOfNow(Date birthDay)
```
    生日转为年龄，计算法定年龄
    
    参数:
    birthDay - 生日
    
    返回:
    年龄
  - age
```
public static int age(Date birthDay,
      Date dateToCompare)
```
    计算相对于dateToCompare的年龄，长用于计算指定生日在某年的年龄
    
    参数:
    birthDay - 生日
    dateToCompare - 需要对比的日期
    
    返回:
    年龄
  - isLeapYear
```
public static boolean isLeapYear(int year)
```
    是否闰年
    
    参数:
    year - 年
    
    返回:
    是否闰年
  - isExpired
```
public static boolean isExpired(Date startDate,
                DateField dateField,
                int timeLength,
                Date checkedDate)
```
    判定给定开始时间经过某段时间后是否过期
    
    参数:
    startDate - 开始时间
    dateField - 时间单位
    timeLength - 时长
    checkedDate - 被比较的时间。如果经过时长后的时间晚于被检查的时间，就表示过期
    
    返回:
    是否过期
    从以下版本开始:
    
    3.1.1
  - timeToSecond
```
public static int timeToSecond(String timeStr)
```
    时间格式字符串转为秒数
    参考：https://github.com/iceroot
    
    参数:
    timeStr - 字符串时分秒(HH:mm:ss)格式
    
    返回:
    时分秒转换后的秒数
    从以下版本开始:
    
    3.1.2
  - secondToTime
```
public static String secondToTime(int seconds)
```
    秒数转为时间格式(HH:mm:ss)
    参考：https://github.com/iceroot
    
    参数:
    seconds - 需要转换的秒数
    
    返回:
    转换后的字符串
    从以下版本开始:
    
    3.1.2
  - range
```
public static DateRange range(Date start,
              Date end,
              DateField unit)
```
    创建日期范围生成器
    
    参数:
    start - 起始日期时间
    end - 结束日期时间
    unit - 步进单位
    
    返回:
    DateRange
  - rangeToList
```
public static List<DateTime> rangeToList(Date start,
                         Date end,
                         DateField unit)
```
    创建日期范围生成器
    
    参数:
    start - 起始日期时间
    end - 结束日期时间
    unit - 步进单位
    
    返回:
    DateRange

类 DateUtil

构造器概要

方法概要

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

构造器详细资料

DateUtil

方法详细资料

date

date

date

date

calendar

calendar

now

current

currentSeconds

today

year

season

quarter

quarterEnum

month

monthEnum

weekOfYear

weekOfMonth

dayOfMonth

dayOfWeek

dayOfWeekEnum

hour

minute

second

millsecond

isAM

isPM

thisYear

thisMonth

thisMonthEnum

thisWeekOfYear

thisWeekOfMonth

thisDayOfMonth

thisDayOfWeek

thisDayOfWeekEnum

thisHour

thisMinute

thisSecond

thisMillsecond

yearAndSeason

yearAndQuarter

yearAndSeasons

yearAndQuarter

format

format

format

formatDateTime

formatDate

formatTime

formatHttpDate

parse

parse

parse

parseDateTime

parseDate

parseTime

parseTimeToday

parseUTC

parse

beginOfDay

endOfDay

beginOfDay

endOfDay

beginOfWeek

endOfWeek

beginOfWeek

beginOfWeek

endOfWeek

endOfWeek

beginOfMonth

endOfMonth

beginOfMonth

endOfMonth