DateUtil (hutool 2.15.9 API)

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

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

作者:

xiaoleilu

嵌套类概要

嵌套类
限定符和类型类和说明

static class DateUtil.Timer
计时器
计算某个过程话费的时间，精确到毫秒

嵌套类
限定符和类型	类和说明
`static class`	`DateUtil.Timer` 计时器计算某个过程话费的时间，精确到毫秒

字段概要

字段
限定符和类型	字段和说明
`static long`	`DAY_MS` 每天的毫秒数
`static long`	`HOUR_MS` 每小时的毫秒数
`static String`	`HTTP_DATETIME_PATTERN` HTTP头中日期时间格式
`static long`	`MINUTE_MS` 每分钟的毫秒数
`static long`	`MS` 毫秒
`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` 标准时间格式
`static long`	`SECOND_MS` 每秒钟的毫秒数

构造器概要

构造器
构造器和说明

DateUtil()

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

方法概要

方法
限定符和类型	方法和说明
`static long`	`current(boolean isNano)` 当前时间long
`static DateTime`	`date()`
`static DateTime`	`date(long date)` Long类型时间转为Date
`static long`	`diff(Date subtrahend, Date minuend, long diffField)` 判断两个日期相差的时长返回 minuend - subtrahend 的差
`static String`	`format(Date date, String format)` 根据特定格式格式化日期
`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 DateTime`	`getBeginTimeOfDay(Date date)` 获取某天的开始时间
`static DateTime`	`getEndTimeOfDay(Date date)` 获取某天的结束时间
`static DateTime`	`lastMouth()` 上个月
`static DateTime`	`lastWeek()` 上周
`static int`	`month(Date date)` 获得月份
`static String`	`now()` 当前时间，格式 yyyy-MM-dd HH:mm:ss
`static DateTime`	`offsiteDate(Date date, int calendarField, int offsite)` 获取指定日期偏移指定时间后的时间
`static DateTime`	`offsiteDay(Date date, int offsite)` 偏移天
`static DateTime`	`offsiteMonth(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, SimpleDateFormat simpleDateFormat)` 构建DateTime对象
`static DateTime`	`parse(String dateString, 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 long`	`spendMs(long preTime)` 计时，常用于记录某段代码的执行时间，单位：毫秒
`static long`	`spendNt(long preTime)` 计时，常用于记录某段代码的执行时间，单位：纳秒
`static int`	`thisMonth()`
`static int`	`thisYear()`
`static DateUtil.Timer`	`timer()` 计时器计算某个过程话费的时间，精确到毫秒
`static Calendar`	`toCalendar(Date date)` 转换为Calendar对象
`static String`	`today()` 当前日期，格式 yyyy-MM-dd
`static int`	`toIntSecond(Date date)` 格式化成yyMMddHHmm后转换为int型
`static int`	`weekCount(Date start, Date end)` 计算指定指定时间区间内的周数
`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

- 字段详细资料
  - MS
```
public static final long MS
```
    毫秒
    
    另请参阅:
    常量字段值
  - SECOND_MS
```
public static final long SECOND_MS
```
    每秒钟的毫秒数
    
    另请参阅:
    常量字段值
  - MINUTE_MS
```
public static final long MINUTE_MS
```
    每分钟的毫秒数
    
    另请参阅:
    常量字段值
  - HOUR_MS
```
public static final long HOUR_MS
```
    每小时的毫秒数
    
    另请参阅:
    常量字段值
  - DAY_MS
```
public static final long DAY_MS
```
    每天的毫秒数
    
    另请参阅:
    常量字段值
  - 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()
```
- 方法详细资料
  - 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
    
    返回:
    当前日期的标准形式字符串
  - thisMonth
```
public static int thisMonth()
```
    返回:
    当前月份
  - thisYear
```
public static int thisYear()
```
    返回:
    今年
  - date
```
public static DateTime date()
```
    返回:
    当前时间
  - date
```
public static DateTime date(long date)
```
    Long类型时间转为Date
    
    参数:
    date - Long类型Date（Unix时间戳）
    
    返回:
    时间对象
  - toCalendar
```
public static Calendar toCalendar(Date date)
```
    转换为Calendar对象
    
    参数:
    date - 日期对象
    
    返回:
    Calendar对象
  - month
```
public static int month(Date date)
```
    获得月份
    
    参数:
    date - 日期
    
    返回:
    月份
  - year
```
public static int year(Date date)
```
    获得年
    
    参数:
    date - 日期
    
    返回:
    年
  - season
```
public static int season(Date date)
```
    获得季节
    
    参数:
    date - 日期
    
    返回:
    第几个季节
  - 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 - 格式
    
    返回:
    格式化后的字符串
  - 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,
             SimpleDateFormat simpleDateFormat)
```
    构建DateTime对象
    
    参数:
    dateStr - Date字符串
    simpleDateFormat - 格式化器
    
    返回:
    DateTime对象
  - parse
```
public static DateTime parse(String dateString,
             String format)
```
    将特定格式的日期转换为Date对象
    
    参数:
    dateString - 特定格式的日期
    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 - 日期字符串
    
    返回:
    日期
  - getBeginTimeOfDay
```
public static DateTime getBeginTimeOfDay(Date date)
```
    获取某天的开始时间
    
    参数:
    date - 日期
    
    返回:
    某天的开始时间
  - getEndTimeOfDay
```
public static DateTime getEndTimeOfDay(Date date)
```
    获取某天的结束时间
    
    参数:
    date - 日期
    
    返回:
    某天的结束时间
  - yesterday
```
public static DateTime yesterday()
```
    昨天
    
    返回:
    昨天
  - lastWeek
```
public static DateTime lastWeek()
```
    上周
    
    返回:
    上周
  - lastMouth
```
public static DateTime lastMouth()
```
    上个月
    
    返回:
    上个月
  - 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,
                   int calendarField,
                   int offsite)
```
    获取指定日期偏移指定时间后的时间
    
    参数:
    date - 基准日期
    calendarField - 偏移的粒度大小（小时、天、月等）使用Calendar中的常数
    offsite - 偏移量，正数为向后偏移，负数为向前偏移
    
    返回:
    偏移后的日期
  - diff
```
public static long diff(Date subtrahend,
        Date minuend,
        long diffField)
```
    判断两个日期相差的时长
    返回 minuend - subtrahend 的差
    
    参数:
    subtrahend - 减数日期
    minuend - 被减数日期
    diffField - 相差的选项：相差的天、小时
    
    返回:
    日期差
  - 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 DateUtil.Timer timer()
```
    计时器
    计算某个过程话费的时间，精确到毫秒
    
    返回:
    Timer

类 DateUtil

嵌套类概要

字段概要

构造器概要

方法概要

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

字段详细资料

MS

SECOND_MS

MINUTE_MS

HOUR_MS

DAY_MS

NORM_DATE_PATTERN

NORM_TIME_PATTERN

NORM_DATETIME_MINUTE_PATTERN

NORM_DATETIME_PATTERN

NORM_DATETIME_MS_PATTERN

HTTP_DATETIME_PATTERN

构造器详细资料

DateUtil

方法详细资料

now

current

today

thisMonth

thisYear

date

date

toCalendar

month

year

season

yearAndSeason

yearAndSeasons

format

formatDateTime

formatDate

formatHttpDate

parse

parse

parseDateTime

parseDate

parseTime

parse

getBeginTimeOfDay

getEndTimeOfDay

yesterday

lastWeek

lastMouth

offsiteDay

offsiteWeek

offsiteMonth

offsiteDate

diff

spendNt

spendMs

toIntSecond

weekCount

timer