DateUtil (hutool 5.8.36 API)

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

```
public class DateUtil
extends CalendarUtil
```
日期时间工具类

Author:

xiaoleilu

See Also:

java8日志工具类, 日期常用格式工具类

Constructor Summary

Constructors
Constructor and Description

DateUtil()

Constructors
Constructor and Description
`DateUtil()`

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static int`	`age(Date birthday, Date dateToCompare)` 计算相对于dateToCompare的年龄，常用于计算指定生日在某年的年龄
`static int`	`ageOfNow(Date birthDay)` 生日转为年龄，计算法定年龄
`static int`	`ageOfNow(String birthDay)` 生日转为年龄，计算法定年龄
`static DateTime`	`beginOfDay(Date date)` 获取某天的开始时间
`static DateTime`	`beginOfHour(Date date)` 获取某小时的开始时间
`static DateTime`	`beginOfMinute(Date date)` 获取某分钟的开始时间
`static DateTime`	`beginOfMonth(Date date)` 获取某月的开始时间
`static DateTime`	`beginOfQuarter(Date date)` 获取某季度的开始时间
`static DateTime`	`beginOfSecond(Date date)` 获取秒级别的开始时间，即毫秒部分设置为0
`static DateTime`	`beginOfWeek(Date date)` 获取某周的开始时间，周一定为一周的开始时间
`static DateTime`	`beginOfWeek(Date date, boolean isMondayAsFirstDay)` 获取某周的开始时间
`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`	`betweenWeek(Date beginDate, Date endDate, boolean isReset)` 计算指定时间区间内的周数
`static long`	`betweenYear(Date beginDate, Date endDate, boolean isReset)` 计算两个日期相差年数在非重置情况下，如果起始日期的月大于结束日期的月，年数要少算1（不足1年）
`static DateTime`	`ceiling(Date date, DateField dateField)` 修改日期为某个时间字段结束时间
`static DateTime`	`ceiling(Date date, DateField dateField, boolean truncateMillisecond)` 修改日期为某个时间字段结束时间可选是否归零毫秒。
`static int`	`compare(Date date1, Date date2)` `null`安全的日期比较，`null`对象排在末尾
`static int`	`compare(Date date1, Date date2, String format)` `null`安全的日期比较，并只比较指定格式； `null`对象排在末尾, 并指定日期格式；
`static DateTime`	`convertTimeZone(Date date, TimeZone timeZone)` `Date` 转换时区
`static DateTime`	`convertTimeZone(Date date, ZoneId zoneId)` `Date` 转换时区
`static StopWatch`	`createStopWatch()` 创建秒表`StopWatch`，用于对代码块的执行时间计数使用方法如下： StopWatch stopWatch = DateUtil.createStopWatch(); // 任务1 stopWatch.start("任务一"); Thread.sleep(1000); stopWatch.stop(); // 任务2 stopWatch.start("任务二"); Thread.sleep(2000); stopWatch.stop(); // 打印出耗时 Console.log(stopWatch.prettyPrint());
`static StopWatch`	`createStopWatch(String id)` 创建秒表`StopWatch`，用于对代码块的执行时间计数使用方法如下： StopWatch stopWatch = DateUtil.createStopWatch("任务名称"); // 任务1 stopWatch.start("任务一"); Thread.sleep(1000); stopWatch.stop(); // 任务2 stopWatch.start("任务二"); Thread.sleep(2000); stopWatch.stop(); // 打印出耗时 Console.log(stopWatch.prettyPrint());
`static long`	`current()` 当前时间的时间戳
`static long`	`currentSeconds()` 当前时间的时间戳（秒）
`static DateTime`	`date()` 当前时间，转换为`DateTime`对象
`static DateTime`	`date(Calendar calendar)` `Calendar`类型时间转为`DateTime` 始终根据已有`Calendar` 产生新的`DateTime`对象
`static DateTime`	`date(Date date)` `Date`类型时间转为`DateTime` 如果date本身为DateTime对象，则返回强转后的对象，否则新建一个DateTime对象
`static DateTime`	`date(long date)` Long类型时间转为`DateTime` 只支持毫秒级别时间戳，如果需要秒级别时间戳，请自行×1000
`static DateTime`	`date(TemporalAccessor temporalAccessor)` `TemporalAccessor`类型时间转为`DateTime` 始终根据已有`TemporalAccessor` 产生新的`DateTime`对象
`static DateTime`	`dateNew(Date date)` 根据已有`Date` 产生新的`DateTime`对象
`static DateTime`	`dateSecond()` 当前时间，转换为`DateTime`对象，忽略毫秒部分
`static int`	`dayOfMonth(Date date)` 获得指定日期是这个日期所在月份的第几天
`static int`	`dayOfWeek(Date date)` 获得指定日期是星期几，1表示周日，2表示周一
`static Week`	`dayOfWeekEnum(Date date)` 获得指定日期是星期几
`static int`	`dayOfYear(Date date)` 获得指定日期是这个日期所在年的第几天
`static DateTime`	`endOfDay(Date date)` 获取某天的结束时间
`static DateTime`	`endOfHour(Date date)` 获取某小时的结束时间
`static DateTime`	`endOfMinute(Date date)` 获取某分钟的结束时间
`static DateTime`	`endOfMonth(Date date)` 获取某月的结束时间
`static DateTime`	`endOfQuarter(Date date)` 获取某季度的结束时间
`static DateTime`	`endOfSecond(Date date)` 获取秒级别的结束时间，即毫秒设置为999
`static DateTime`	`endOfWeek(Date date)` 获取某周的结束时间，周日定为一周的结束
`static DateTime`	`endOfWeek(Date date, boolean isSundayAsLastDay)` 获取某周的结束时间
`static DateTime`	`endOfYear(Date date)` 获取某年的结束时间
`static String`	`format(Date date, DateFormat format)` 根据特定格式格式化日期
`static String`	`format(Date date, DatePrinter format)` 根据特定格式格式化日期
`static String`	`format(Date date, DateTimeFormatter format)` 根据特定格式格式化日期
`static String`	`format(Date date, String format)` 根据特定格式格式化日期
`static String`	`format(LocalDateTime localDateTime, String format)` 根据特定格式格式化日期
`static String`	`formatBetween(Date beginDate, Date endDate)` 格式化日期间隔输出，精确到毫秒
`static String`	`formatBetween(Date beginDate, Date endDate, BetweenFormatter.Level level)` 格式化日期间隔输出
`static String`	`formatBetween(long betweenMs)` 格式化日期间隔输出，精确到毫秒
`static String`	`formatBetween(long betweenMs, BetweenFormatter.Level level)` 格式化日期间隔输出
`static String`	`formatChineseDate(Date date, boolean isUppercase, boolean withTime)` 格式化为中文日期格式，如果isUppercase为false，则返回类似：2018年10月24日，否则返回二〇一八年十月二十四日
`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的标准日期格式标准日期格式遵循RFC 1123规范，格式类似于：Fri, 31 Dec 1999 23:59:59 GMT
`static String`	`formatLocalDateTime(LocalDateTime localDateTime)` 格式化日期时间格式 yyyy-MM-dd HH:mm:ss
`static String`	`formatTime(Date date)` 格式化时间格式 HH:mm:ss
`static String`	`getChineseZodiac(int year)` 计算生肖，只计算1900年后出生的人
`static int`	`getLastDayOfMonth(Date date)` 获得本月的最后一天
`static String`	`getShotName(TimeUnit unit)` 获取时长单位简写
`static String`	`getZodiac(int month, int day)` 通过生日计算星座
`static int`	`hour(Date date, boolean is24HourClock)` 获得指定日期的小时数部分
`static boolean`	`isAM(Date date)` 是否为上午
`static boolean`	`isExpired(Date startDate, Date endDate, Date checkDate)` Deprecated. 使用isIn方法
`static boolean`	`isExpired(Date startDate, DateField dateField, int timeLength, Date endDate)` Deprecated. 此方法存在一定的歧义，容易产生误导，废弃。
`static boolean`	`isIn(Date date, Date beginDate, Date endDate)` 当前日期是否在日期指定范围内起始日期和结束日期可以互换
`static boolean`	`isLastDayOfMonth(Date date)` 是否为本月最后一天
`static boolean`	`isLeapYear(int year)` 是否闰年
`static boolean`	`isOverlap(Date realStartTime, Date realEndTime, Date startTime, Date endTime)` 检查两个时间段是否有时间重叠重叠指两个时间段是否有交集，注意此方法时间段重合时如：此方法未纠正开始时间小于结束时间当realStartTime和realEndTime或startTime和endTime相等时,退化为判断区间是否包含点当realStartTime和realEndTime和startTime和endTime相等时,退化为判断点与点是否相等 See 准确的区间关系参考:艾伦区间代数
`static boolean`	`isPM(Date date)` 是否为下午
`static boolean`	`isSameDay(Date date1, Date date2)` 比较两个日期是否为同一天
`static boolean`	`isSameMonth(Date date1, Date date2)` 比较两个日期是否为同一月
`static boolean`	`isSameTime(Date date1, Date date2)` 是否为相同时间此方法比较两个日期的时间戳是否相同
`static boolean`	`isSameWeek(Date date1, Date date2, boolean isMon)` 比较两个日期是否为同一周
`static boolean`	`isWeekend(Date date)` 是否为周末（周六或周日）
`static DateTime`	`lastMonth()` 上个月
`static DateTime`	`lastWeek()` 上周
`static int`	`lengthOfMonth(int month, boolean isLeapYear)` 获得指定月份的总天数
`static int`	`lengthOfYear(int year)` 获得指定年份的总天数
`static int`	`millisecond(Date date)` 获得指定日期的毫秒数部分
`static int`	`minute(Date date)` 获得指定日期的分钟数部分例如：10:04:15.250 =》 4
`static int`	`month(Date date)` 获得月份，从0开始计数
`static Month`	`monthEnum(Date date)` 获得月份
`static long`	`nanosToMillis(long duration)` 纳秒转毫秒
`static double`	`nanosToSeconds(long duration)` 纳秒转秒，保留小数
`static SimpleDateFormat`	`newSimpleFormat(String pattern)` 创建`SimpleDateFormat`，注意此对象非线程安全！
`static SimpleDateFormat`	`newSimpleFormat(String pattern, Locale locale, TimeZone timeZone)` 创建`SimpleDateFormat`，注意此对象非线程安全！
`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`	`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`	`offsetYear(Date date, int offset)` 偏移年
`static DateTime`	`parse(CharSequence dateCharSequence)` 将日期字符串转换为`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 yyyy-MM-dd HH:mm:ss.SSSSSS 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'Z' yyyy-MM-dd'T'HH:mm:ss.SSS'Z' yyyy-MM-dd'T'HH:mm:ssZ yyyy-MM-dd'T'HH:mm:ss.SSSZ
`static DateTime`	`parse(CharSequence dateStr, DateFormat dateFormat)` 构建DateTime对象
`static DateTime`	`parse(CharSequence dateStr, DateParser parser)` 构建DateTime对象
`static DateTime`	`parse(CharSequence dateStr, DateParser parser, boolean lenient)` 构建DateTime对象
`static DateTime`	`parse(CharSequence dateStr, DateTimeFormatter formatter)` 构建DateTime对象
`static DateTime`	`parse(CharSequence dateStr, String format)` 将特定格式的日期转换为Date对象
`static DateTime`	`parse(CharSequence dateStr, String format, Locale locale)` 将特定格式的日期转换为Date对象
`static DateTime`	`parse(String str, String... parsePatterns)` 通过给定的日期格式解析日期时间字符串。
`static DateTime`	`parseCST(CharSequence cstString)` Deprecated. 理解错误，请使用`parseRFC2822(CharSequence)`
`static DateTime`	`parseDate(CharSequence dateString)` 解析日期字符串，忽略时分秒，支持的格式包括： yyyy-MM-dd yyyy/MM/dd yyyy.MM.dd yyyy年MM月dd日
`static DateTime`	`parseDateTime(CharSequence dateString)` 解析日期时间字符串，格式支持： yyyy-MM-dd HH:mm:ss yyyy/MM/dd HH:mm:ss yyyy.MM.dd HH:mm:ss yyyy年MM月dd日 HH:mm:ss
`static DateTime`	`parseISO8601(String iso8601String)` 解析ISO8601时间，格式： yyyy-MM-dd'T'HH:mm:ss'Z' yyyy-MM-dd'T'HH:mm:ss.SSS'Z' yyyy-MM-dd'T'HH:mm:ssZ yyyy-MM-dd'T'HH:mm:ss.SSSZ yyyy-MM-dd'T'HH:mm:ss+0800 yyyy-MM-dd'T'HH:mm:ss+08:00
`static LocalDateTime`	`parseLocalDateTime(CharSequence dateStr)` 构建LocalDateTime对象格式：yyyy-MM-dd HH:mm:ss
`static LocalDateTime`	`parseLocalDateTime(CharSequence dateStr, String format)` 构建LocalDateTime对象
`static DateTime`	`parseRFC2822(CharSequence source)` 解析RFC2822时间，格式： EEE MMM dd HH:mm:ss z yyyy（例如：Wed Aug 01 00:00:00 CST 2012）
`static DateTime`	`parseTime(CharSequence timeString)` 解析时间，格式HH:mm:ss，日期部分默认为1970-01-01
`static DateTime`	`parseTimeToday(CharSequence timeString)` 解析时间，格式HH:mm 或 HH:mm:ss，日期默认为今天
`static DateTime`	`parseUTC(String utcString)` Deprecated. 方法歧义，带T的日期并不一定是UTC时间，请使用 `parseISO8601(String)`
`static int`	`quarter(Date date)` 获得指定日期所属季度，从1开始计数
`static Quarter`	`quarterEnum(Date date)` 获得指定日期所属季度
`static DateRange`	`range(Date start, Date end, DateField unit)` 创建日期范围生成器
`static void`	`rangeConsume(Date start, Date end, DateField unit, Consumer<Date> consumer)` 按日期范围遍历，执行 consumer
`static List<DateTime>`	`rangeContains(DateRange start, DateRange end)` 俩个时间区间取交集
`static <T> List<T>`	`rangeFunc(Date start, Date end, DateField unit, Function<Date,T> func)` 按日期范围遍历，执行 function
`static List<DateTime>`	`rangeNotContains(DateRange start, DateRange end)` 俩个时间区间取差集(end - start)
`static List<DateTime>`	`rangeToList(Date start, Date end, DateField unit)` 根据步进单位获取起始日期时间和结束日期时间的时间区间集合
`static List<DateTime>`	`rangeToList(Date start, Date end, DateField unit, int step)` 根据步进单位和步进获取起始日期时间和结束日期时间的时间区间集合
`static DateTime`	`round(Date date, DateField dateField)` 修改日期为某个时间字段四舍五入时间
`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`	`thisMillisecond()`
`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 TimeInterval`	`timer(boolean isNano)` 计时器计算某个过程花费的时间，精确到毫秒
`static int`	`timeToSecond(String timeStr)` HH:mm:ss 时间格式字符串转为秒数参考：https://github.com/iceroot
`static String`	`today()` 当前日期，格式 yyyy-MM-dd
`static Instant`	`toInstant(Date date)` Date对象转换为`Instant`对象
`static Instant`	`toInstant(TemporalAccessor temporalAccessor)` Date对象转换为`Instant`对象
`static int`	`toIntSecond(Date date)` Deprecated. 2022年后结果溢出，此方法废弃
`static LocalDateTime`	`toLocalDateTime(Date date)` `Date` 转换为 `LocalDateTime`，使用系统默认时区
`static LocalDateTime`	`toLocalDateTime(Instant instant)` `Instant` 转换为 `LocalDateTime`，使用系统默认时区
`static DateTime`	`tomorrow()` 明天
`static DateTime`	`truncate(Date date, DateField dateField)` 修改日期为某个时间字段起始时间
`static int`	`weekOfMonth(Date date)` 获得指定日期是所在月份的第几周
`static int`	`weekOfYear(Date date)` 获得指定日期是所在年份的第几周此方法返回值与一周的第一天有关，比如： 2016年1月3日为周日，如果一周的第一天为周日，那这天是第二周（返回2）如果一周的第一天为周一，那这天是第一周（返回1）跨年的那个星期得到的结果总是1
`static int`	`year(Date date)` 获得年的部分
`static String`	`yearAndQuarter(Date date)` 获得指定日期年份和季节格式：[20131]表示2013年第一季度
`static LinkedHashSet<String>`	`yearAndQuarter(Date startDate, Date endDate)` 获得指定日期区间内的年份和季节
`static DateTime`	`yesterday()` 昨天

Methods inherited from class cn.hutool.core.date.CalendarUtil
age, age, beginOfDay, beginOfHour, beginOfMinute, beginOfMonth, beginOfQuarter, beginOfSecond, beginOfWeek, beginOfWeek, beginOfYear, calendar, calendar, calendar, calendar, ceiling, ceiling, compare, endOfDay, endOfHour, endOfMinute, endOfMonth, endOfQuarter, endOfSecond, endOfWeek, endOfWeek, endOfYear, formatChineseDate, getBeginValue, getBeginValue, getEndValue, getEndValue, isAM, isLastDayOfMonth, isPM, isSameDay, isSameInstant, isSameMonth, isSameWeek, parse, parseByPatterns, parseByPatterns, parseByPatterns, round, toInstant, toLocalDateTime, truncate, yearAndQuarter, yearAndQuarter

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - DateUtil
```
public DateUtil()
```
- Method Detail
  - date
```
public static DateTime date()
```
    当前时间，转换为DateTime对象
    
    Returns:
    
    当前时间
  - dateSecond
```
public static DateTime dateSecond()
```
    当前时间，转换为DateTime对象，忽略毫秒部分
    
    Returns:
    
    当前时间
    
    Since:
    
    4.6.2
  - date
```
public static DateTime date(Date date)
```
    Date类型时间转为DateTime
    如果date本身为DateTime对象，则返回强转后的对象，否则新建一个DateTime对象
    
    Parameters:
    
    date - Long类型Date（Unix时间戳），如果传入null，返回null
    
    Returns:
    
    时间对象
    
    Since:
    
    3.0.7
  - dateNew
```
public static DateTime dateNew(Date date)
```
    根据已有Date 产生新的DateTime对象
    
    Parameters:
    
    date - Date对象，如果传入null，返回null
    
    Returns:
    
    DateTime对象
    
    Since:
    
    4.3.1
  - date
```
public static DateTime date(long date)
```
    Long类型时间转为DateTime
    只支持毫秒级别时间戳，如果需要秒级别时间戳，请自行×1000
    
    Parameters:
    
    date - Long类型Date（Unix时间戳）
    
    Returns:
    
    时间对象
  - date
```
public static DateTime date(Calendar calendar)
```
    Calendar类型时间转为DateTime
    始终根据已有Calendar 产生新的DateTime对象
    
    Parameters:
    
    calendar - Calendar，如果传入null，返回null
    
    Returns:
    
    时间对象
  - date
```
public static DateTime date(TemporalAccessor temporalAccessor)
```
    TemporalAccessor类型时间转为DateTime
    始终根据已有TemporalAccessor 产生新的DateTime对象
    
    Parameters:
    
    temporalAccessor - TemporalAccessor,常用子类： LocalDateTime、 LocalDate，如果传入null，返回null
    
    Returns:
    
    时间对象
    
    Since:
    
    5.0.0
  - current
```
public static long current()
```
    当前时间的时间戳
    
    Returns:
    
    时间
  - currentSeconds
```
public static long currentSeconds()
```
    当前时间的时间戳（秒）
    
    Returns:
    
    当前时间秒数
    
    Since:
    
    4.0.0
  - now
```
public static String now()
```
    当前时间，格式 yyyy-MM-dd HH:mm:ss
    
    Returns:
    
    当前时间的标准形式字符串
  - today
```
public static String today()
```
    当前日期，格式 yyyy-MM-dd
    
    Returns:
    
    当前日期的标准形式字符串
  - year
```
public static int year(Date date)
```
    获得年的部分
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    年的部分
  - quarter
```
public static int quarter(Date date)
```
    获得指定日期所属季度，从1开始计数
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    第几个季度
    
    Since:
    
    4.1.0
  - quarterEnum
```
public static Quarter quarterEnum(Date date)
```
    获得指定日期所属季度
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    第几个季度枚举
    
    Since:
    
    4.1.0
  - month
```
public static int month(Date date)
```
    获得月份，从0开始计数
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    月份，从0开始计数
  - monthEnum
```
public static Month monthEnum(Date date)
```
    获得月份
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    Month
  - weekOfYear
```
public static int weekOfYear(Date date)
```
    获得指定日期是所在年份的第几周
    此方法返回值与一周的第一天有关，比如：
    2016年1月3日为周日，如果一周的第一天为周日，那这天是第二周（返回2）
    如果一周的第一天为周一，那这天是第一周（返回1）
    跨年的那个星期得到的结果总是1
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    周
    
    See Also:
    
    DateTime.setFirstDayOfWeek(Week)
  - weekOfMonth
```
public static int weekOfMonth(Date date)
```
    获得指定日期是所在月份的第几周
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    周
  - dayOfMonth
```
public static int dayOfMonth(Date date)
```
    获得指定日期是这个日期所在月份的第几天
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    天
  - dayOfYear
```
public static int dayOfYear(Date date)
```
    获得指定日期是这个日期所在年的第几天
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    天
    
    Since:
    
    5.3.6
  - dayOfWeek
```
public static int dayOfWeek(Date date)
```
    获得指定日期是星期几，1表示周日，2表示周一
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    天
  - dayOfWeekEnum
```
public static Week dayOfWeekEnum(Date date)
```
    获得指定日期是星期几
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    Week
  - isWeekend
```
public static boolean isWeekend(Date date)
```
    是否为周末（周六或周日）
    
    Parameters:
    
    date - 判定的日期Date
    
    Returns:
    
    是否为周末（周六或周日）
    
    Since:
    
    5.7.6
  - hour
```
public static int hour(Date date,
                       boolean is24HourClock)
```
    获得指定日期的小时数部分
    
    Parameters:
    
    date - 日期
    
    is24HourClock - 是否24小时制
    
    Returns:
    
    小时数
  - minute
```
public static int minute(Date date)
```
    获得指定日期的分钟数部分
    例如：10:04:15.250 =》 4
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    分钟数
  - second
```
public static int second(Date date)
```
    获得指定日期的秒数部分
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    秒数
  - millisecond
```
public static int millisecond(Date date)
```
    获得指定日期的毫秒数部分
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    毫秒数
  - isAM
```
public static boolean isAM(Date date)
```
    是否为上午
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    是否为上午
  - isPM
```
public static boolean isPM(Date date)
```
    是否为下午
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    是否为下午
  - thisYear
```
public static int thisYear()
```
    Returns:
    
    今年
  - thisMonth
```
public static int thisMonth()
```
    Returns:
    
    当前月份，从0开始计数
  - thisMonthEnum
```
public static Month thisMonthEnum()
```
    Returns:
    
    当前月份 Month
  - thisWeekOfYear
```
public static int thisWeekOfYear()
```
    Returns:
    
    当前日期所在年份的第几周
  - thisWeekOfMonth
```
public static int thisWeekOfMonth()
```
    Returns:
    
    当前日期所在月份的第几周
  - thisDayOfMonth
```
public static int thisDayOfMonth()
```
    Returns:
    
    当前日期是这个日期所在月份的第几天
  - thisDayOfWeek
```
public static int thisDayOfWeek()
```
    Returns:
    
    当前日期是星期几
  - thisDayOfWeekEnum
```
public static Week thisDayOfWeekEnum()
```
    Returns:
    
    当前日期是星期几 Week
  - thisHour
```
public static int thisHour(boolean is24HourClock)
```
    Parameters:
    
    is24HourClock - 是否24小时制
    
    Returns:
    
    当前日期的小时数部分
  - thisMinute
```
public static int thisMinute()
```
    Returns:
    
    当前日期的分钟数部分
  - thisSecond
```
public static int thisSecond()
```
    Returns:
    
    当前日期的秒数部分
  - thisMillisecond
```
public static int thisMillisecond()
```
    Returns:
    
    当前日期的毫秒数部分
  - yearAndQuarter
```
public static String yearAndQuarter(Date date)
```
    获得指定日期年份和季节
    格式：[20131]表示2013年第一季度
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    Quarter ，类似于 20132
  - yearAndQuarter
```
public static LinkedHashSet<String> yearAndQuarter(Date startDate,
                                                   Date endDate)
```
    获得指定日期区间内的年份和季节
    
    Parameters:
    
    startDate - 起始日期（包含）
    
    endDate - 结束日期（包含）
    
    Returns:
    
    季度列表，元素类似于 20132
  - formatLocalDateTime
```
public static String formatLocalDateTime(LocalDateTime localDateTime)
```
    格式化日期时间
    格式 yyyy-MM-dd HH:mm:ss
    
    Parameters:
    
    localDateTime - 被格式化的日期
    
    Returns:
    
    格式化后的字符串
  - format
```
public static String format(LocalDateTime localDateTime,
                            String format)
```
    根据特定格式格式化日期
    
    Parameters:
    
    localDateTime - 被格式化的日期
    
    format - 日期格式，常用格式见： DatePattern
    
    Returns:
    
    格式化后的字符串
  - format
```
public static String format(Date date,
                            String format)
```
    根据特定格式格式化日期
    
    Parameters:
    
    date - 被格式化的日期
    
    format - 日期格式，常用格式见： DatePattern DatePattern.NORM_DATETIME_PATTERN
    
    Returns:
    
    格式化后的字符串
  - format
```
public static String format(Date date,
                            DatePrinter format)
```
    根据特定格式格式化日期
    
    Parameters:
    
    date - 被格式化的日期
    
    format - DatePrinter 或 FastDateFormat DatePattern.NORM_DATETIME_FORMAT
    
    Returns:
    
    格式化后的字符串
  - format
```
public static String format(Date date,
                            DateFormat format)
```
    根据特定格式格式化日期
    
    Parameters:
    
    date - 被格式化的日期
    
    format - SimpleDateFormat
    
    Returns:
    
    格式化后的字符串
  - format
```
public static String format(Date date,
                            DateTimeFormatter format)
```
    根据特定格式格式化日期
    
    Parameters:
    
    date - 被格式化的日期
    
    format - SimpleDateFormat DatePattern.NORM_DATETIME_FORMATTER
    
    Returns:
    
    格式化后的字符串
    
    Since:
    
    5.0.0
  - formatDateTime
```
public static String formatDateTime(Date date)
```
    格式化日期时间
    格式 yyyy-MM-dd HH:mm:ss
    
    Parameters:
    
    date - 被格式化的日期
    
    Returns:
    
    格式化后的日期
  - formatDate
```
public static String formatDate(Date date)
```
    格式化日期部分（不包括时间）
    格式 yyyy-MM-dd
    
    Parameters:
    
    date - 被格式化的日期
    
    Returns:
    
    格式化后的字符串
  - formatTime
```
public static String formatTime(Date date)
```
    格式化时间
    格式 HH:mm:ss
    
    Parameters:
    
    date - 被格式化的日期
    
    Returns:
    
    格式化后的字符串
    
    Since:
    
    3.0.1
  - formatHttpDate
```
public static String formatHttpDate(Date date)
```
    格式化为Http的标准日期格式
    标准日期格式遵循RFC 1123规范，格式类似于：Fri, 31 Dec 1999 23:59:59 GMT
    
    Parameters:
    
    date - 被格式化的日期
    
    Returns:
    
    HTTP标准形式日期字符串
  - formatChineseDate
```
public static String formatChineseDate(Date date,
                                       boolean isUppercase,
                                       boolean withTime)
```
    格式化为中文日期格式，如果isUppercase为false，则返回类似：2018年10月24日，否则返回二〇一八年十月二十四日
    
    Parameters:
    
    date - 被格式化的日期
    
    isUppercase - 是否采用大写形式
    
    withTime - 是否包含时间部分
    
    Returns:
    
    中文日期字符串
    
    Since:
    
    5.3.9
  - parseLocalDateTime
```
public static LocalDateTime parseLocalDateTime(CharSequence dateStr)
```
    构建LocalDateTime对象
    格式：yyyy-MM-dd HH:mm:ss
    
    Parameters:
    
    dateStr - 时间字符串（带格式）
    
    Returns:
    
    LocalDateTime对象
  - parseLocalDateTime
```
public static LocalDateTime parseLocalDateTime(CharSequence dateStr,
                                               String format)
```
    构建LocalDateTime对象
    
    Parameters:
    
    dateStr - 时间字符串（带格式）
    
    format - 使用DatePattern定义的格式
    
    Returns:
    
    LocalDateTime对象
  - parse
```
public static DateTime parse(CharSequence dateStr,
                             DateFormat dateFormat)
```
    构建DateTime对象
    
    Parameters:
    
    dateStr - Date字符串
    
    dateFormat - 格式化器 SimpleDateFormat
    
    Returns:
    
    DateTime对象
  - parse
```
public static DateTime parse(CharSequence dateStr,
                             DateParser parser)
```
    构建DateTime对象
    
    Parameters:
    
    dateStr - Date字符串
    
    parser - 格式化器,FastDateFormat
    
    Returns:
    
    DateTime对象
  - parse
```
public static DateTime parse(CharSequence dateStr,
                             DateParser parser,
                             boolean lenient)
```
    构建DateTime对象
    
    Parameters:
    
    dateStr - Date字符串
    
    parser - 格式化器,FastDateFormat
    
    lenient - 是否宽容模式
    
    Returns:
    
    DateTime对象
    
    Since:
    
    5.7.14
  - parse
```
public static DateTime parse(CharSequence dateStr,
                             DateTimeFormatter formatter)
```
    构建DateTime对象
    
    Parameters:
    
    dateStr - Date字符串
    
    formatter - 格式化器,DateTimeFormatter
    
    Returns:
    
    DateTime对象
    
    Since:
    
    5.0.0
  - parse
```
public static DateTime parse(CharSequence dateStr,
                             String format)
```
    将特定格式的日期转换为Date对象
    
    Parameters:
    
    dateStr - 特定格式的日期
    
    format - 格式，例如yyyy-MM-dd
    
    Returns:
    
    日期对象
  - parse
```
public static DateTime parse(CharSequence dateStr,
                             String format,
                             Locale locale)
```
    将特定格式的日期转换为Date对象
    
    Parameters:
    
    dateStr - 特定格式的日期
    
    format - 格式，例如yyyy-MM-dd
    
    locale - 区域信息
    
    Returns:
    
    日期对象
    
    Since:
    
    4.5.18
  - parse
```
public static DateTime parse(String str,
                             String... parsePatterns)
                      throws DateException
```
    通过给定的日期格式解析日期时间字符串。
    传入的日期格式会逐个尝试，直到解析成功，返回DateTime对象，否则抛出DateException异常。
    
    Parameters:
    
    str - 日期时间字符串，非空
    
    parsePatterns - 需要尝试的日期时间格式数组，非空, 见SimpleDateFormat
    
    Returns:
    
    解析后的Date
    
    Throws:
    
    IllegalArgumentException - if the date string or pattern array is null
    
    DateException - if none of the date patterns were suitable
    
    Since:
    
    5.3.11
  - parseDateTime
```
public static DateTime parseDateTime(CharSequence dateString)
```
    解析日期时间字符串，格式支持：
```
 yyyy-MM-dd HH:mm:ss
 yyyy/MM/dd HH:mm:ss
 yyyy.MM.dd HH:mm:ss
 yyyy年MM月dd日 HH:mm:ss
 
```
    Parameters:
    
    dateString - 标准形式的时间字符串
    
    Returns:
    
    日期对象
  - parseDate
```
public static DateTime parseDate(CharSequence dateString)
```
    解析日期字符串，忽略时分秒，支持的格式包括：
```
 yyyy-MM-dd
 yyyy/MM/dd
 yyyy.MM.dd
 yyyy年MM月dd日
 
```
    Parameters:
    
    dateString - 标准形式的日期字符串
    
    Returns:
    
    日期对象
  - parseTime
```
public static DateTime parseTime(CharSequence timeString)
```
    解析时间，格式HH:mm:ss，日期部分默认为1970-01-01
    
    Parameters:
    
    timeString - 标准形式的日期字符串
    
    Returns:
    
    日期对象
  - parseTimeToday
```
public static DateTime parseTimeToday(CharSequence timeString)
```
    解析时间，格式HH:mm 或 HH:mm:ss，日期默认为今天
    
    Parameters:
    
    timeString - 标准形式的日期字符串
    
    Returns:
    
    日期对象
    
    Since:
    
    3.1.1
  - parseUTC
```
@Deprecated
public static DateTime parseUTC(String utcString)
```
    Deprecated. 方法歧义，带T的日期并不一定是UTC时间，请使用 parseISO8601(String)
    解析UTC时间，格式：
    1. yyyy-MM-dd'T'HH:mm:ss'Z'
    2. yyyy-MM-dd'T'HH:mm:ss.SSS'Z'
    3. yyyy-MM-dd'T'HH:mm:ssZ
    4. yyyy-MM-dd'T'HH:mm:ss.SSSZ
    5. yyyy-MM-dd'T'HH:mm:ss+0800
    6. yyyy-MM-dd'T'HH:mm:ss+08:00
    Parameters:
    
    utcString - UTC时间
    
    Returns:
    
    日期对象
    
    Since:
    
    4.1.14
  - parseISO8601
```
public static DateTime parseISO8601(String iso8601String)
```
    解析ISO8601时间，格式：
    1. yyyy-MM-dd'T'HH:mm:ss'Z'
    2. yyyy-MM-dd'T'HH:mm:ss.SSS'Z'
    3. yyyy-MM-dd'T'HH:mm:ssZ
    4. yyyy-MM-dd'T'HH:mm:ss.SSSZ
    5. yyyy-MM-dd'T'HH:mm:ss+0800
    6. yyyy-MM-dd'T'HH:mm:ss+08:00
    Parameters:
    
    iso8601String - ISO8601时间
    
    Returns:
    
    日期对象
    
    Since:
    
    5.8.34
  - parseCST
```
@Deprecated
public static DateTime parseCST(CharSequence cstString)
```
    Deprecated. 理解错误，请使用parseRFC2822(CharSequence)
    解析CST时间，格式：
    1. EEE MMM dd HH:mm:ss z yyyy（例如：Wed Aug 01 00:00:00 CST 2012）
    Parameters:
    
    cstString - UTC时间
    
    Returns:
    
    日期对象
    
    Since:
    
    4.6.9
  - parseRFC2822
```
public static DateTime parseRFC2822(CharSequence source)
```
    解析RFC2822时间，格式：
    1. EEE MMM dd HH:mm:ss z yyyy（例如：Wed Aug 01 00:00:00 CST 2012）
    Parameters:
    
    source - RFC2822时间
    
    Returns:
    
    日期对象
    
    Since:
    
    4.6.9
  - parse
```
public static DateTime parse(CharSequence dateCharSequence)
```
    将日期字符串转换为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. yyyy-MM-dd HH:mm:ss.SSSSSS
    13. yyyyMMddHHmmss
    14. yyyyMMddHHmmssSSS
    15. yyyyMMdd
    16. EEE, dd MMM yyyy HH:mm:ss z
    17. EEE MMM dd HH:mm:ss zzz yyyy
    18. yyyy-MM-dd'T'HH:mm:ss'Z'
    19. yyyy-MM-dd'T'HH:mm:ss.SSS'Z'
    20. yyyy-MM-dd'T'HH:mm:ssZ
    21. yyyy-MM-dd'T'HH:mm:ss.SSSZ
    Parameters:
    
    dateCharSequence - 日期字符串
    
    Returns:
    
    日期
  - truncate
```
public static DateTime truncate(Date date,
                                DateField dateField)
```
    修改日期为某个时间字段起始时间
    
    Parameters:
    
    date - Date
    
    dateField - 保留到的时间字段，如定义为 DateField.SECOND，表示这个字段不变，这个字段以下字段全部归0
    
    Returns:
    
    DateTime
    
    Since:
    
    4.5.7
  - round
```
public static DateTime round(Date date,
                             DateField dateField)
```
    修改日期为某个时间字段四舍五入时间
    
    Parameters:
    
    date - Date
    
    dateField - 时间字段
    
    Returns:
    
    DateTime
    
    Since:
    
    4.5.7
  - ceiling
```
public static DateTime ceiling(Date date,
                               DateField dateField)
```
    修改日期为某个时间字段结束时间
    
    Parameters:
    
    date - Date
    
    dateField - 保留到的时间字段，如定义为 DateField.SECOND，表示这个字段不变，这个字段以下字段全部取最大值
    
    Returns:
    
    DateTime
    
    Since:
    
    4.5.7
  - ceiling
```
public static DateTime ceiling(Date date,
                               DateField dateField,
                               boolean truncateMillisecond)
```
    修改日期为某个时间字段结束时间
    可选是否归零毫秒。
    有时候由于毫秒部分必须为0（如MySQL数据库中），因此在此加上选项。
    
    Parameters:
    
    date - Date
    
    dateField - 时间字段
    
    truncateMillisecond - 是否毫秒归零
    
    Returns:
    
    DateTime
    
    Since:
    
    4.5.7
  - beginOfSecond
```
public static DateTime beginOfSecond(Date date)
```
    获取秒级别的开始时间，即毫秒部分设置为0
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
    
    Since:
    
    4.6.2
  - endOfSecond
```
public static DateTime endOfSecond(Date date)
```
    获取秒级别的结束时间，即毫秒设置为999
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
    
    Since:
    
    4.6.2
  - beginOfHour
```
public static DateTime beginOfHour(Date date)
```
    获取某小时的开始时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - endOfHour
```
public static DateTime endOfHour(Date date)
```
    获取某小时的结束时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - beginOfMinute
```
public static DateTime beginOfMinute(Date date)
```
    获取某分钟的开始时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - endOfMinute
```
public static DateTime endOfMinute(Date date)
```
    获取某分钟的结束时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - beginOfDay
```
public static DateTime beginOfDay(Date date)
```
    获取某天的开始时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - endOfDay
```
public static DateTime endOfDay(Date date)
```
    获取某天的结束时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - beginOfWeek
```
public static DateTime beginOfWeek(Date date)
```
    获取某周的开始时间，周一定为一周的开始时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - beginOfWeek
```
public static DateTime beginOfWeek(Date date,
                                   boolean isMondayAsFirstDay)
```
    获取某周的开始时间
    
    Parameters:
    
    date - 日期
    
    isMondayAsFirstDay - 是否周一做为一周的第一天（false表示周日做为第一天）
    
    Returns:
    
    DateTime
    
    Since:
    
    5.4.0
  - endOfWeek
```
public static DateTime endOfWeek(Date date)
```
    获取某周的结束时间，周日定为一周的结束
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - endOfWeek
```
public static DateTime endOfWeek(Date date,
                                 boolean isSundayAsLastDay)
```
    获取某周的结束时间
    
    Parameters:
    
    date - 日期
    
    isSundayAsLastDay - 是否周日做为一周的最后一天（false表示周六做为最后一天）
    
    Returns:
    
    DateTime
    
    Since:
    
    5.4.0
  - beginOfMonth
```
public static DateTime beginOfMonth(Date date)
```
    获取某月的开始时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - endOfMonth
```
public static DateTime endOfMonth(Date date)
```
    获取某月的结束时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - beginOfQuarter
```
public static DateTime beginOfQuarter(Date date)
```
    获取某季度的开始时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - endOfQuarter
```
public static DateTime endOfQuarter(Date date)
```
    获取某季度的结束时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - beginOfYear
```
public static DateTime beginOfYear(Date date)
```
    获取某年的开始时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - endOfYear
```
public static DateTime endOfYear(Date date)
```
    获取某年的结束时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    DateTime
  - yesterday
```
public static DateTime yesterday()
```
    昨天
    
    Returns:
    
    昨天
  - tomorrow
```
public static DateTime tomorrow()
```
    明天
    
    Returns:
    
    明天
    
    Since:
    
    3.0.1
  - lastWeek
```
public static DateTime lastWeek()
```
    上周
    
    Returns:
    
    上周
  - nextWeek
```
public static DateTime nextWeek()
```
    下周
    
    Returns:
    
    下周
    
    Since:
    
    3.0.1
  - lastMonth
```
public static DateTime lastMonth()
```
    上个月
    
    Returns:
    
    上个月
  - nextMonth
```
public static DateTime nextMonth()
```
    下个月
    
    Returns:
    
    下个月
    
    Since:
    
    3.0.1
  - offsetMillisecond
```
public static DateTime offsetMillisecond(Date date,
                                         int offset)
```
    偏移毫秒数
    
    Parameters:
    
    date - 日期
    
    offset - 偏移毫秒数，正数向未来偏移，负数向历史偏移
    
    Returns:
    
    偏移后的日期
  - offsetSecond
```
public static DateTime offsetSecond(Date date,
                                    int offset)
```
    偏移秒数
    
    Parameters:
    
    date - 日期
    
    offset - 偏移秒数，正数向未来偏移，负数向历史偏移
    
    Returns:
    
    偏移后的日期
  - offsetMinute
```
public static DateTime offsetMinute(Date date,
                                    int offset)
```
    偏移分钟
    
    Parameters:
    
    date - 日期
    
    offset - 偏移分钟数，正数向未来偏移，负数向历史偏移
    
    Returns:
    
    偏移后的日期
  - offsetHour
```
public static DateTime offsetHour(Date date,
                                  int offset)
```
    偏移小时
    
    Parameters:
    
    date - 日期
    
    offset - 偏移小时数，正数向未来偏移，负数向历史偏移
    
    Returns:
    
    偏移后的日期
  - offsetDay
```
public static DateTime offsetDay(Date date,
                                 int offset)
```
    偏移天
    
    Parameters:
    
    date - 日期
    
    offset - 偏移天数，正数向未来偏移，负数向历史偏移
    
    Returns:
    
    偏移后的日期
  - offsetWeek
```
public static DateTime offsetWeek(Date date,
                                  int offset)
```
    偏移周
    
    Parameters:
    
    date - 日期
    
    offset - 偏移周数，正数向未来偏移，负数向历史偏移
    
    Returns:
    
    偏移后的日期
  - offsetMonth
```
public static DateTime offsetMonth(Date date,
                                   int offset)
```
    偏移月
    
    Parameters:
    
    date - 日期
    
    offset - 偏移月数，正数向未来偏移，负数向历史偏移
    
    Returns:
    
    偏移后的日期
  - offsetYear
```
public static DateTime offsetYear(Date date,
                                  int offset)
```
    偏移年
    
    Parameters:
    
    date - 日期
    
    offset - 偏移年数，正数向未来偏移，负数向历史偏移
    
    Returns:
    
    偏移后的日期
    
    Since:
    
    5.8.29
  - offset
```
public static DateTime offset(Date date,
                              DateField dateField,
                              int offset)
```
    获取指定日期偏移指定时间后的时间，生成的偏移日期不影响原日期
    
    Parameters:
    
    date - 基准日期
    
    dateField - 偏移的粒度大小（小时、天、月等）DateField
    
    offset - 偏移量，正数为向后偏移，负数为向前偏移
    
    Returns:
    
    偏移后的日期
  - between
```
public static long between(Date beginDate,
                           Date endDate,
                           DateUnit unit)
```
    判断两个日期相差的时长，只保留绝对值
    
    Parameters:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    unit - 相差的单位：相差天DateUnit.DAY、小时DateUnit.HOUR 等
    
    Returns:
    
    日期差
  - between
```
public static long between(Date beginDate,
                           Date endDate,
                           DateUnit unit,
                           boolean isAbs)
```
    判断两个日期相差的时长
    
    Parameters:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    unit - 相差的单位：相差天DateUnit.DAY、小时DateUnit.HOUR 等
    
    isAbs - 日期间隔是否只保留绝对值正数
    
    Returns:
    
    日期差
    
    Since:
    
    3.3.1
  - betweenMs
```
public static long betweenMs(Date beginDate,
                             Date endDate)
```
    判断两个日期相差的毫秒数
    
    Parameters:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    Returns:
    
    日期差
    
    Since:
    
    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
 
```
    Parameters:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    isReset - 是否重置时间为起始时间
    
    Returns:
    
    日期差
    
    Since:
    
    3.0.1
  - betweenWeek
```
public static long betweenWeek(Date beginDate,
                               Date endDate,
                               boolean isReset)
```
    计算指定时间区间内的周数
    
    Parameters:
    
    beginDate - 开始时间
    
    endDate - 结束时间
    
    isReset - 是否重置时间为起始时间
    
    Returns:
    
    周数
  - betweenMonth
```
public static long betweenMonth(Date beginDate,
                                Date endDate,
                                boolean isReset)
```
    计算两个日期相差月数
    在非重置情况下，如果起始日期的天大于结束日期的天，月数要少算1（不足1个月）
    
    Parameters:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    isReset - 是否重置时间为起始时间（重置天时分秒）
    
    Returns:
    
    相差月数
    
    Since:
    
    3.0.8
  - betweenYear
```
public static long betweenYear(Date beginDate,
                               Date endDate,
                               boolean isReset)
```
    计算两个日期相差年数
    在非重置情况下，如果起始日期的月大于结束日期的月，年数要少算1（不足1年）
    
    Parameters:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    isReset - 是否重置时间为起始时间（重置月天时分秒）
    
    Returns:
    
    相差年数
    
    Since:
    
    3.0.8
  - formatBetween
```
public static String formatBetween(Date beginDate,
                                   Date endDate,
                                   BetweenFormatter.Level level)
```
    格式化日期间隔输出
    
    Parameters:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    level - 级别，按照天、小时、分、秒、毫秒分为5个等级
    
    Returns:
    
    XX天XX小时XX分XX秒
  - formatBetween
```
public static String formatBetween(Date beginDate,
                                   Date endDate)
```
    格式化日期间隔输出，精确到毫秒
    
    Parameters:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    Returns:
    
    XX天XX小时XX分XX秒
    
    Since:
    
    3.0.1
  - formatBetween
```
public static String formatBetween(long betweenMs,
                                   BetweenFormatter.Level level)
```
    格式化日期间隔输出
    
    Parameters:
    
    betweenMs - 日期间隔
    
    level - 级别，按照天、小时、分、秒、毫秒分为5个等级
    
    Returns:
    
    XX天XX小时XX分XX秒XX毫秒
  - formatBetween
```
public static String formatBetween(long betweenMs)
```
    格式化日期间隔输出，精确到毫秒
    
    Parameters:
    
    betweenMs - 日期间隔
    
    Returns:
    
    XX天XX小时XX分XX秒XX毫秒
    
    Since:
    
    3.0.1
  - isIn
```
public static boolean isIn(Date date,
                           Date beginDate,
                           Date endDate)
```
    当前日期是否在日期指定范围内
    起始日期和结束日期可以互换
    
    Parameters:
    
    date - 被检查的日期
    
    beginDate - 起始日期（包含）
    
    endDate - 结束日期（包含）
    
    Returns:
    
    是否在范围内
    
    Since:
    
    3.0.8
  - isSameTime
```
public static boolean isSameTime(Date date1,
                                 Date date2)
```
    是否为相同时间
    此方法比较两个日期的时间戳是否相同
    
    Parameters:
    
    date1 - 日期1
    
    date2 - 日期2
    
    Returns:
    
    是否为相同时间
    
    Since:
    
    4.1.13
  - isSameDay
```
public static boolean isSameDay(Date date1,
                                Date date2)
```
    比较两个日期是否为同一天
    
    Parameters:
    
    date1 - 日期1
    
    date2 - 日期2
    
    Returns:
    
    是否为同一天
    
    Since:
    
    4.1.13
  - isSameWeek
```
public static boolean isSameWeek(Date date1,
                                 Date date2,
                                 boolean isMon)
```
    比较两个日期是否为同一周
    
    Parameters:
    
    date1 - 日期1
    
    date2 - 日期2
    
    isMon - 是否为周一。国内第一天为星期一，国外第一天为星期日
    
    Returns:
    
    是否为同一周
  - isSameMonth
```
public static boolean isSameMonth(Date date1,
                                  Date date2)
```
    比较两个日期是否为同一月
    
    Parameters:
    
    date1 - 日期1
    
    date2 - 日期2
    
    Returns:
    
    是否为同一月
    
    Since:
    
    5.4.1
  - spendNt
```
public static long spendNt(long preTime)
```
    计时，常用于记录某段代码的执行时间，单位：纳秒
    
    Parameters:
    
    preTime - 之前记录的时间
    
    Returns:
    
    时间差，纳秒
  - spendMs
```
public static long spendMs(long preTime)
```
    计时，常用于记录某段代码的执行时间，单位：毫秒
    
    Parameters:
    
    preTime - 之前记录的时间
    
    Returns:
    
    时间差，毫秒
  - toIntSecond
```
@Deprecated
public static int toIntSecond(Date date)
```
    Deprecated. 2022年后结果溢出，此方法废弃
    
    格式化成yyMMddHHmm后转换为int型
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    int
  - timer
```
public static TimeInterval timer()
```
    计时器
    计算某个过程花费的时间，精确到毫秒
    
    Returns:
    
    Timer
  - timer
```
public static TimeInterval timer(boolean isNano)
```
    计时器
    计算某个过程花费的时间，精确到毫秒
    
    Parameters:
    
    isNano - 是否使用纳秒计数，false则使用毫秒
    
    Returns:
    
    Timer
    
    Since:
    
    5.2.3
  - createStopWatch
```
public static StopWatch createStopWatch()
```
    创建秒表StopWatch，用于对代码块的执行时间计数
    使用方法如下：
```
 StopWatch stopWatch = DateUtil.createStopWatch();

 // 任务1
 stopWatch.start("任务一");
 Thread.sleep(1000);
 stopWatch.stop();

 // 任务2
 stopWatch.start("任务二");
 Thread.sleep(2000);
 stopWatch.stop();

 // 打印出耗时
 Console.log(stopWatch.prettyPrint());

 
```
    Returns:
    
    StopWatch
    
    Since:
    
    5.2.3
  - createStopWatch
```
public static StopWatch createStopWatch(String id)
```
    创建秒表StopWatch，用于对代码块的执行时间计数
    使用方法如下：
```
 StopWatch stopWatch = DateUtil.createStopWatch("任务名称");

 // 任务1
 stopWatch.start("任务一");
 Thread.sleep(1000);
 stopWatch.stop();

 // 任务2
 stopWatch.start("任务二");
 Thread.sleep(2000);
 stopWatch.stop();

 // 打印出耗时
 Console.log(stopWatch.prettyPrint());

 
```
    Parameters:
    
    id - 用于标识秒表的唯一ID
    
    Returns:
    
    StopWatch
    
    Since:
    
    5.2.3
  - ageOfNow
```
public static int ageOfNow(String birthDay)
```
    生日转为年龄，计算法定年龄
    
    Parameters:
    
    birthDay - 生日，标准日期字符串
    
    Returns:
    
    年龄
  - ageOfNow
```
public static int ageOfNow(Date birthDay)
```
    生日转为年龄，计算法定年龄
    
    Parameters:
    
    birthDay - 生日
    
    Returns:
    
    年龄
  - isLeapYear
```
public static boolean isLeapYear(int year)
```
    是否闰年
    
    Parameters:
    
    year - 年
    
    Returns:
    
    是否闰年
  - age
```
public static int age(Date birthday,
                      Date dateToCompare)
```
    计算相对于dateToCompare的年龄，常用于计算指定生日在某年的年龄
    
    Parameters:
    
    birthday - 生日
    
    dateToCompare - 需要对比的日期
    
    Returns:
    
    年龄
  - isExpired
```
@Deprecated
public static boolean isExpired(Date startDate,
                                             DateField dateField,
                                             int timeLength,
                                             Date endDate)
```
    Deprecated. 此方法存在一定的歧义，容易产生误导，废弃。
    
    判定给定开始时间经过某段时间后是否过期
    
    Parameters:
    
    startDate - 开始时间
    
    dateField - 时间单位
    
    timeLength - 实际经过时长
    
    endDate - 被比较的时间，即有效期的截止时间。如果经过时长后的时间晚于截止时间，就表示过期
    
    Returns:
    
    是否过期
    
    Since:
    
    3.1.1
  - isExpired
```
@Deprecated
public static boolean isExpired(Date startDate,
                                             Date endDate,
                                             Date checkDate)
```
    Deprecated. 使用isIn方法
    
    判定在指定检查时间是否过期。
    以商品为例，startDate即生产日期，endDate即保质期的截止日期，checkDate表示在何时检查是否过期（一般为当前时间）
    endDate和startDate的差值即为保质期（按照毫秒计），checkDate和startDate的差值即为实际经过的时长，实际时长大于保质期表示超时。
    
    Parameters:
    
    startDate - 开始时间
    
    endDate - 被比较的时间，即有效期的截止时间。如果经过时长后的时间晚于被检查的时间，就表示过期
    
    checkDate - 检查时间，可以是当前时间，既
    
    Returns:
    
    是否过期
    
    Since:
    
    5.1.1
  - timeToSecond
```
public static int timeToSecond(String timeStr)
```
    HH:mm:ss 时间格式字符串转为秒数
    参考：https://github.com/iceroot
    
    Parameters:
    
    timeStr - 字符串时分秒(HH:mm:ss)格式
    
    Returns:
    
    时分秒转换后的秒数
    
    Since:
    
    3.1.2
  - secondToTime
```
public static String secondToTime(int seconds)
```
    秒数转为时间格式(HH:mm:ss)
    参考：https://github.com/iceroot
    
    Parameters:
    
    seconds - 需要转换的秒数
    
    Returns:
    
    转换后的字符串
    
    Since:
    
    3.1.2
  - range
```
public static DateRange range(Date start,
                              Date end,
                              DateField unit)
```
    创建日期范围生成器
    
    Parameters:
    
    start - 起始日期时间（包括）
    
    end - 结束日期时间
    
    unit - 步进单位
    
    Returns:
    
    DateRange
  - rangeContains
```
public static List<DateTime> rangeContains(DateRange start,
                                           DateRange end)
```
    俩个时间区间取交集
    
    Parameters:
    
    start - 开始区间
    
    end - 结束区间
    
    Returns:
    
    true 包含
    
    Since:
    
    5.7.21
  - rangeNotContains
```
public static List<DateTime> rangeNotContains(DateRange start,
                                              DateRange end)
```
    俩个时间区间取差集(end - start)
    
    Parameters:
    
    start - 开始区间
    
    end - 结束区间
    
    Returns:
    
    true 包含
    
    Since:
    
    5.7.21
  - rangeFunc
```
public static <T> List<T> rangeFunc(Date start,
                                    Date end,
                                    DateField unit,
                                    Function<Date,T> func)
```
    按日期范围遍历，执行 function
    
    Type Parameters:
    
    T - Date经过函数处理结果类型
    
    Parameters:
    
    start - 起始日期时间（包括）
    
    end - 结束日期时间
    
    unit - 步进单位
    
    func - 每次遍历要执行的 function
    
    Returns:
    
    结果列表
    
    Since:
    
    5.7.21
  - rangeConsume
```
public static void rangeConsume(Date start,
                                Date end,
                                DateField unit,
                                Consumer<Date> consumer)
```
    按日期范围遍历，执行 consumer
    
    Parameters:
    
    start - 起始日期时间（包括）
    
    end - 结束日期时间
    
    unit - 步进单位
    
    consumer - 每次遍历要执行的 consumer
    
    Since:
    
    5.7.21
  - rangeToList
```
public static List<DateTime> rangeToList(Date start,
                                         Date end,
                                         DateField unit)
```
    根据步进单位获取起始日期时间和结束日期时间的时间区间集合
    
    Parameters:
    
    start - 起始日期时间
    
    end - 结束日期时间
    
    unit - 步进单位
    
    Returns:
    
    DateRange
  - rangeToList
```
public static List<DateTime> rangeToList(Date start,
                                         Date end,
                                         DateField unit,
                                         int step)
```
    根据步进单位和步进获取起始日期时间和结束日期时间的时间区间集合
    
    Parameters:
    
    start - 起始日期时间
    
    end - 结束日期时间
    
    unit - 步进单位
    
    step - 步进
    
    Returns:
    
    DateRange
    
    Since:
    
    5.7.16
  - getZodiac
```
public static String getZodiac(int month,
                               int day)
```
    通过生日计算星座
    
    Parameters:
    
    month - 月，从0开始计数
    
    day - 天
    
    Returns:
    
    星座名
    
    Since:
    
    4.4.3
  - getChineseZodiac
```
public static String getChineseZodiac(int year)
```
    计算生肖，只计算1900年后出生的人
    
    Parameters:
    
    year - 农历年
    
    Returns:
    
    生肖名
    
    Since:
    
    4.4.3
  - compare
```
public static int compare(Date date1,
                          Date date2)
```
    null安全的日期比较，null对象排在末尾
    
    Parameters:
    
    date1 - 日期1
    
    date2 - 日期2
    
    Returns:
    
    比较结果，如果date1 < date2，返回数小于0，date1==date2返回0，date1 > date2 大于0
    
    Since:
    
    4.6.2
  - compare
```
public static int compare(Date date1,
                          Date date2,
                          String format)
```
    null安全的日期比较，并只比较指定格式； null对象排在末尾, 并指定日期格式；
    
    Parameters:
    
    date1 - 日期1
    
    date2 - 日期2
    
    format - 日期格式，常用格式见： DatePattern; 允许为空； date1 date2; eg: yyyy-MM-dd
    
    Returns:
    
    比较结果，如果date1 < date2，返回数小于0，date1==date2返回0，date1 > date2 大于0
    
    Since:
    
    5.6.4
  - nanosToMillis
```
public static long nanosToMillis(long duration)
```
    纳秒转毫秒
    
    Parameters:
    
    duration - 时长
    
    Returns:
    
    时长毫秒
    
    Since:
    
    4.6.6
  - nanosToSeconds
```
public static double nanosToSeconds(long duration)
```
    纳秒转秒，保留小数
    
    Parameters:
    
    duration - 时长
    
    Returns:
    
    秒
    
    Since:
    
    4.6.6
  - toInstant
```
public static Instant toInstant(Date date)
```
    Date对象转换为Instant对象
    
    Parameters:
    
    date - Date对象
    
    Returns:
    
    Instant对象
    
    Since:
    
    5.0.2
  - toInstant
```
public static Instant toInstant(TemporalAccessor temporalAccessor)
```
    Date对象转换为Instant对象
    
    Parameters:
    
    temporalAccessor - Date对象
    
    Returns:
    
    Instant对象
    
    Since:
    
    5.0.2
  - toLocalDateTime
```
public static LocalDateTime toLocalDateTime(Instant instant)
```
    Instant 转换为 LocalDateTime，使用系统默认时区
    
    Parameters:
    
    instant - Instant
    
    Returns:
    
    LocalDateTime
    
    Since:
    
    5.0.5
    
    See Also:
    
    LocalDateTimeUtil.of(Instant)
  - toLocalDateTime
```
public static LocalDateTime toLocalDateTime(Date date)
```
    Date 转换为 LocalDateTime，使用系统默认时区
    
    Parameters:
    
    date - Date
    
    Returns:
    
    LocalDateTime
    
    Since:
    
    5.0.5
    
    See Also:
    
    LocalDateTimeUtil.of(Date)
  - convertTimeZone
```
public static DateTime convertTimeZone(Date date,
                                       ZoneId zoneId)
```
    Date 转换时区
    
    Parameters:
    
    date - Date
    
    zoneId - ZoneId
    
    Returns:
    
    DateTime
    
    Since:
    
    5.8.3
  - convertTimeZone
```
public static DateTime convertTimeZone(Date date,
                                       TimeZone timeZone)
```
    Date 转换时区
    
    Parameters:
    
    date - Date
    
    timeZone - TimeZone
    
    Returns:
    
    DateTime
    
    Since:
    
    5.8.3
  - lengthOfYear
```
public static int lengthOfYear(int year)
```
    获得指定年份的总天数
    
    Parameters:
    
    year - 年份
    
    Returns:
    
    天
    
    Since:
    
    5.3.6
  - lengthOfMonth
```
public static int lengthOfMonth(int month,
                                boolean isLeapYear)
```
    获得指定月份的总天数
    
    Parameters:
    
    month - 月份
    
    isLeapYear - 是否闰年
    
    Returns:
    
    天
    
    Since:
    
    5.4.2
  - newSimpleFormat
```
public static SimpleDateFormat newSimpleFormat(String pattern)
```
    创建SimpleDateFormat，注意此对象非线程安全！
    此对象默认为严格格式模式，即parse时如果格式不正确会报错。
    
    Parameters:
    
    pattern - 表达式
    
    Returns:
    
    SimpleDateFormat
    
    Since:
    
    5.5.5
  - newSimpleFormat
```
public static SimpleDateFormat newSimpleFormat(String pattern,
                                               Locale locale,
                                               TimeZone timeZone)
```
    创建SimpleDateFormat，注意此对象非线程安全！
    此对象默认为严格格式模式，即parse时如果格式不正确会报错。
    
    Parameters:
    
    pattern - 表达式
    
    locale - Locale，null表示默认
    
    timeZone - TimeZone，null表示默认
    
    Returns:
    
    SimpleDateFormat
    
    Since:
    
    5.5.5
  - getShotName
```
public static String getShotName(TimeUnit unit)
```
    获取时长单位简写
    
    Parameters:
    
    unit - 单位
    
    Returns:
    
    单位简写名称
    
    Since:
    
    5.7.16
  - isOverlap
```
public static boolean isOverlap(Date realStartTime,
                                Date realEndTime,
                                Date startTime,
                                Date endTime)
```
    检查两个时间段是否有时间重叠
    重叠指两个时间段是否有交集，注意此方法时间段重合时如：
    - 此方法未纠正开始时间小于结束时间
    - 当realStartTime和realEndTime或startTime和endTime相等时,退化为判断区间是否包含点
    - 当realStartTime和realEndTime和startTime和endTime相等时,退化为判断点与点是否相等
    See 准确的区间关系参考:艾伦区间代数
    Parameters:
    
    realStartTime - 第一个时间段的开始时间
    
    realEndTime - 第一个时间段的结束时间
    
    startTime - 第二个时间段的开始时间
    
    endTime - 第二个时间段的结束时间
    
    Returns:
    
    true 表示时间有重合或包含或相等
    
    Since:
    
    5.7.22
  - isLastDayOfMonth
```
public static boolean isLastDayOfMonth(Date date)
```
    是否为本月最后一天
    
    Parameters:
    
    date - Date
    
    Returns:
    
    是否为本月最后一天
    
    Since:
    
    5.8.9
  - getLastDayOfMonth
```
public static int getLastDayOfMonth(Date date)
```
    获得本月的最后一天
    
    Parameters:
    
    date - Date
    
    Returns:
    
    天
    
    Since:
    
    5.8.9

Class DateUtil

Constructor Summary

Method Summary

Methods inherited from class cn.hutool.core.date.CalendarUtil

Methods inherited from class java.lang.Object

Constructor Detail

DateUtil

Method Detail

date

dateSecond

date

dateNew

date

date

date

current

currentSeconds

now

today

year

quarter

quarterEnum

month

monthEnum

weekOfYear

weekOfMonth

dayOfMonth

dayOfYear

dayOfWeek

dayOfWeekEnum

isWeekend

hour

minute

second

millisecond

isAM

isPM

thisYear

thisMonth

thisMonthEnum

thisWeekOfYear

thisWeekOfMonth

thisDayOfMonth

thisDayOfWeek

thisDayOfWeekEnum

thisHour

thisMinute

thisSecond

thisMillisecond

yearAndQuarter

yearAndQuarter

formatLocalDateTime

format

format

format

format

format

formatDateTime

formatDate

formatTime

formatHttpDate

formatChineseDate

parseLocalDateTime

parseLocalDateTime

parse

parse

parse

parse

parse

parse

parse

parseDateTime

parseDate

parseTime

parseTimeToday

parseUTC

parseISO8601

parseCST

parseRFC2822

parse