DateUtil (hutool 2.16.2 API)

java.lang.Object
- com.xiaoleilu.hutool.date.DateUtil

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

作者:

xiaoleilu

字段概要

字段
限定符和类型	字段和说明
`static String`	`HTTP_DATETIME_PATTERN` HTTP头中日期时间格式
`static String`	`NORM_DATE_PATTERN` 标准日期格式
`static String`	`NORM_DATETIME_MINUTE_PATTERN` 标准日期时间格式，精确到分
`static String`	`NORM_DATETIME_MS_PATTERN` 标准日期时间格式，精确到毫秒
`static String`	`NORM_DATETIME_PATTERN` 标准日期时间格式，精确到秒
`static String`	`NORM_TIME_PATTERN` 标准时间格式

构造器概要

构造器
构造器和说明

DateUtil()

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

方法概要

方法
限定符和类型	方法和说明
`static int`	`age(Date birthDay, Date dateToCompare)` 计算相对于dateToCompare的年龄，长用于计算指定生日在某年的年龄
`static int`	`ageOfNow(Date birthDay)` 生日转为年龄，计算法定年龄
`static int`	`ageOfNow(String birthDay)` 生日转为年龄，计算法定年龄
`static DateTime`	`beginOfDay(Calendar calendar)` 获取某天的开始时间
`static DateTime`	`beginOfDay(Date date)` 获取某天的开始时间
`static long`	`between(Date beginDate, Date endDate, DateUnit unit)` 判断两个日期相差的时长返回 minuend - subtrahend 的差
`static Calendar`	`calendar(Date date)` 转换为Calendar对象
`static Calendar`	`calendar(long millis)` 转换为Calendar对象
`static long`	`current(boolean isNano)` 当前时间long
`static DateTime`	`date()`
`static DateTime`	`date(Calendar calendar)` Calendar类型时间转为Date
`static DateTime`	`date(long date)` Long类型时间转为Date
`static int`	`dayOfMonth(Date date)` 获得指定日期是这个日期所在月份的第几天
`static int`	`dayOfWeek(Date date)` 获得指定日期是星期几
`static Week`	`dayOfWeekEnum(Date date)` 获得指定日期是星期几
`static DateTime`	`endOfDay(Calendar calendar)` 获取某天的结束时间
`static DateTime`	`endOfDay(Date date)` 获取某天的结束时间
`static String`	`format(Date date, String format)` 根据特定格式格式化日期
`static String`	`formatBetween(Date beginDate, Date endDate, BetweenFormater.Level level)` 格式化日期间隔输出
`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 int`	`hour(Date date, boolean is24HourClock)` 获得指定日期的小时数部分
`static boolean`	`isAM(Date date)` 是否为上午
`static boolean`	`isLeapYear(int year)` 是否闰年
`static boolean`	`isPM(Date date)` 是否为下午
`static DateTime`	`lastMouth()` 上个月
`static DateTime`	`lastWeek()` 上周
`static int`	`millsecond(Date date)` 获得指定日期的毫秒数部分
`static int`	`minute(Date date)` 获得指定日期的分钟数部分例如：10:04:15.250 -> 4
`static int`	`month(Date date)` 获得月份，从1开始计数
`static Month`	`monthEnum(Date date)` 获得月份
`static String`	`now()` 当前时间，格式 yyyy-MM-dd HH:mm:ss
`static DateTime`	`offsiteDate(Date date, DateField datePart, int offsite)` 获取指定日期偏移指定时间后的时间
`static DateTime`	`offsiteDay(Date date, int offsite)` 偏移天
`static DateTime`	`offsiteHour(Date date, int offsite)` 偏移小时
`static DateTime`	`offsiteMillisecond(Date date, int offsite)` 偏移毫秒数
`static DateTime`	`offsiteMinute(Date date, int offsite)` 偏移分钟
`static DateTime`	`offsiteMonth(Date date, int offsite)` 偏移月
`static DateTime`	`offsiteSecond(Date date, int offsite)` 偏移秒数
`static DateTime`	`offsiteWeek(Date date, int offsite)` 偏移周
`static DateTime`	`parse(String dateStr)` 格式： 1、yyyy-MM-dd HH:mm:ss 2、yyyy-MM-dd 3、HH:mm:ss 4、yyyy-MM-dd HH:mm 5、yyyy-MM-dd HH:mm:ss.SSS
`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
`static int`	`season(Date date)` 获得指定日期所属季节
`static int`	`second(Date date)` 获得指定日期的秒数部分
`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 String`	`today()` 当前日期，格式 yyyy-MM-dd
`static int`	`toIntSecond(Date date)` 格式化成yyMMddHHmm后转换为int型
`static int`	`weekCount(Date start, Date end)` 计算指定指定时间区间内的周数
`static int`	`weekOfMonth(Date date)` 获得指定日期是所在月份的第几周
`static int`	`weekOfYear(Date date)` 获得指定日期是所在年份的第几周
`static int`	`year(Date date)` 获得年的部分
`static String`	`yearAndSeason(Date date)` 获得指定日期年份和季节格式：[20131]表示2013年第一季度
`static LinkedHashSet<String>`	`yearAndSeasons(Date startDate, Date endDate)` 获得指定日期区间内的年份和季节
`static DateTime`	`yesterday()` 昨天

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

- 字段详细资料
  - NORM_DATE_PATTERN
```
public static final String NORM_DATE_PATTERN
```
    标准日期格式
    
    另请参阅:
    常量字段值
  - NORM_TIME_PATTERN
```
public static final String NORM_TIME_PATTERN
```
    标准时间格式
    
    另请参阅:
    常量字段值
  - NORM_DATETIME_MINUTE_PATTERN
```
public static final String NORM_DATETIME_MINUTE_PATTERN
```
    标准日期时间格式，精确到分
    
    另请参阅:
    常量字段值
  - NORM_DATETIME_PATTERN
```
public static final String NORM_DATETIME_PATTERN
```
    标准日期时间格式，精确到秒
    
    另请参阅:
    常量字段值
  - NORM_DATETIME_MS_PATTERN
```
public static final String NORM_DATETIME_MS_PATTERN
```
    标准日期时间格式，精确到毫秒
    
    另请参阅:
    常量字段值
  - HTTP_DATETIME_PATTERN
```
public static final String HTTP_DATETIME_PATTERN
```
    HTTP头中日期时间格式
    
    另请参阅:
    常量字段值
- 构造器详细资料
  - DateUtil
```
public DateUtil()
```
- 方法详细资料
  - date
```
public static DateTime date()
```
    返回:
    当前时间
  - date
```
public static DateTime date(long date)
```
    Long类型时间转为Date
    
    参数:
    date - Long类型Date（Unix时间戳）
    
    返回:
    时间对象
  - date
```
public static DateTime date(Calendar calendar)
```
    Calendar类型时间转为Date
    
    参数:
    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 - 是否为高精度时间
    
    返回:
    时间
  - today
```
public static String today()
```
    当前日期，格式 yyyy-MM-dd
    
    返回:
    当前日期的标准形式字符串
  - year
```
public static int year(Date date)
```
    获得年的部分
    
    参数:
    date - 日期
    
    返回:
    年的部分
  - season
```
public static int season(Date date)
```
    获得指定日期所属季节
    
    参数:
    date - 日期
    
    返回:
    第几个季节
  - month
```
public static int month(Date date)
```
    获得月份，从1开始计数
    
    参数:
    date - 日期
    
    返回:
    月份
  - 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)
```
    获得指定日期是星期几
    
    参数:
    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
```
public static String yearAndSeason(Date date)
```
    获得指定日期年份和季节
    格式：[20131]表示2013年第一季度
    
    参数:
    date - 日期
    
    返回:
    Season ，类似于 20132
  - yearAndSeasons
```
public static LinkedHashSet<String> yearAndSeasons(Date startDate,
                                   Date endDate)
```
    获得指定日期区间内的年份和季节
    
    参数:
    startDate - 其实日期（包含）
    endDate - 结束日期（包含）
    
    返回:
    Season列表，元素类似于 20132
  - format
```
public static String format(Date date,
            String format)
```
    根据特定格式格式化日期
    
    参数:
    date - 被格式化的日期
    format - 日期格式，常用格式见： DatePattern
    
    返回:
    格式化后的字符串
  - 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 - 被格式化的日期
    
    返回:
    格式化后的字符串
  - 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
    
    参数:
    timeString - 标准形式的日期字符串
    
    返回:
    日期对象
  - parse
```
public static DateTime parse(String dateStr)
```
    格式：
    1、yyyy-MM-dd HH:mm:ss
    2、yyyy-MM-dd
    3、HH:mm:ss
    4、yyyy-MM-dd HH:mm 5、yyyy-MM-dd HH:mm:ss.SSS
    
    参数:
    dateStr - 日期字符串
    
    返回:
    日期
  - beginOfDay
```
public static DateTime beginOfDay(Date date)
```
    获取某天的开始时间
    
    参数:
    date - 日期
    
    返回:
    某天的开始时间
  - endOfDay
```
public static DateTime endOfDay(Date date)
```
    获取某天的结束时间
    
    参数:
    date - 日期
    
    返回:
    某天的结束时间
  - beginOfDay
```
public static DateTime beginOfDay(Calendar calendar)
```
    获取某天的开始时间
    
    参数:
    calendar - 日期 Calendar
    
    返回:
    某天的开始时间
  - endOfDay
```
public static DateTime endOfDay(Calendar calendar)
```
    获取某天的结束时间
    
    参数:
    calendar - 日期 Calendar
    
    返回:
    某天的结束时间
  - yesterday
```
public static DateTime yesterday()
```
    昨天
    
    返回:
    昨天
  - lastWeek
```
public static DateTime lastWeek()
```
    上周
    
    返回:
    上周
  - lastMouth
```
public static DateTime lastMouth()
```
    上个月
    
    返回:
    上个月
  - offsiteMillisecond
```
public static DateTime offsiteMillisecond(Date date,
                          int offsite)
```
    偏移毫秒数
    
    参数:
    date - 日期
    offsite - 偏移毫秒数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsiteSecond
```
public static DateTime offsiteSecond(Date date,
                     int offsite)
```
    偏移秒数
    
    参数:
    date - 日期
    offsite - 偏移秒数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsiteMinute
```
public static DateTime offsiteMinute(Date date,
                     int offsite)
```
    偏移分钟
    
    参数:
    date - 日期
    offsite - 偏移分钟数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsiteHour
```
public static DateTime offsiteHour(Date date,
                   int offsite)
```
    偏移小时
    
    参数:
    date - 日期
    offsite - 偏移小时数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsiteDay
```
public static DateTime offsiteDay(Date date,
                  int offsite)
```
    偏移天
    
    参数:
    date - 日期
    offsite - 偏移天数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsiteWeek
```
public static DateTime offsiteWeek(Date date,
                   int offsite)
```
    偏移周
    
    参数:
    date - 日期
    offsite - 偏移周数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsiteMonth
```
public static DateTime offsiteMonth(Date date,
                    int offsite)
```
    偏移月
    
    参数:
    date - 日期
    offsite - 偏移月数，正数向未来偏移，负数向历史偏移
    
    返回:
    偏移后的日期
  - offsiteDate
```
public static DateTime offsiteDate(Date date,
                   DateField datePart,
                   int offsite)
```
    获取指定日期偏移指定时间后的时间
    
    参数:
    date - 基准日期
    datePart - 偏移的粒度大小（小时、天、月等）DateField
    offsite - 偏移量，正数为向后偏移，负数为向前偏移
    
    返回:
    偏移后的日期
  - between
```
public static long between(Date beginDate,
           Date endDate,
           DateUnit unit)
```
    判断两个日期相差的时长
    返回 minuend - subtrahend 的差
    
    参数:
    beginDate - 起始日期
    endDate - 结束日期
    unit - 相差的单位：相差天DateUnit.DAY、小时DateUnit.HOUR 等
    
    返回:
    日期差
  - 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(long betweenMs,
                   BetweenFormater.Level level)
```
    格式化日期间隔输出
    
    参数:
    betweenMs - 日期间隔
    level - 级别，按照天、小时、分、秒、毫秒分为5个等级
    
    返回:
    XX天XX小时XX分XX秒XX毫秒
  - 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 - 生日，标准日期字符串
    
    返回:
    年龄
    
    抛出:
    
    Exception
  - ageOfNow
```
public static int ageOfNow(Date birthDay)
```
    生日转为年龄，计算法定年龄
    
    参数:
    birthDay - 生日
    
    返回:
    年龄
    
    抛出:
    
    Exception
  - age
```
public static int age(Date birthDay,
      Date dateToCompare)
```
    计算相对于dateToCompare的年龄，长用于计算指定生日在某年的年龄
    
    参数:
    birthDay - 生日
    dateToCompare - 需要对比的日期
    
    返回:
    年龄
    
    抛出:
    
    Exception
  - isLeapYear
```
public static boolean isLeapYear(int year)
```
    是否闰年
    
    参数:
    year - 年
    
    返回:
    是否闰年

类 DateUtil

字段概要

构造器概要

方法概要

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

字段详细资料

NORM_DATE_PATTERN

NORM_TIME_PATTERN

NORM_DATETIME_MINUTE_PATTERN

NORM_DATETIME_PATTERN

NORM_DATETIME_MS_PATTERN

HTTP_DATETIME_PATTERN

构造器详细资料

DateUtil

方法详细资料

date

date

date

calendar

calendar

now

current

today

year

season

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

yearAndSeasons

format

formatDateTime

formatDate

formatHttpDate

parse

parse

parse

parseDateTime

parseDate

parseTime

parse

beginOfDay

endOfDay

beginOfDay

endOfDay

yesterday

lastWeek

lastMouth

offsiteMillisecond

offsiteSecond

offsiteMinute

offsiteHour

offsiteDay

offsiteWeek

offsiteMonth

offsiteDate

between

formatBetween