类 cn.hutool.core.date.DateTime的使用 (hutool-core 5.8.9 API)

使用DateTime的程序包
程序包	说明
cn.hutool.core.date	日期封装，日期的核心为DateTime类，DateUtil提供日期操作的入口
cn.hutool.core.util	提供各种工具方法，按照归类入口为XXXUtil，如字符串工具StrUtil等

cn.hutool.core.date中DateTime的使用

返回DateTime的cn.hutool.core.date中的方法
限定符和类型	方法和说明
`static DateTime`	DateUtil.`beginOfDay(Date date)` 获取某天的开始时间
`static DateTime`	DateUtil.`beginOfDay(Date date)` 获取某天的开始时间
`static DateTime`	DateUtil.`beginOfHour(Date date)` 获取某小时的开始时间
`static DateTime`	DateUtil.`beginOfHour(Date date)` 获取某小时的开始时间
`static DateTime`	DateUtil.`beginOfMinute(Date date)` 获取某分钟的开始时间
`static DateTime`	DateUtil.`beginOfMinute(Date date)` 获取某分钟的开始时间
`static DateTime`	DateUtil.`beginOfMonth(Date date)` 获取某月的开始时间
`static DateTime`	DateUtil.`beginOfMonth(Date date)` 获取某月的开始时间
`static DateTime`	DateUtil.`beginOfQuarter(Date date)` 获取某季度的开始时间
`static DateTime`	DateUtil.`beginOfQuarter(Date date)` 获取某季度的开始时间
`static DateTime`	DateUtil.`beginOfSecond(Date date)` 获取秒级别的开始时间，即毫秒部分设置为0
`static DateTime`	DateUtil.`beginOfSecond(Date date)` 获取秒级别的开始时间，即毫秒部分设置为0
`static DateTime`	DateUtil.`beginOfWeek(Date date)` 获取某周的开始时间，周一定为一周的开始时间
`static DateTime`	DateUtil.`beginOfWeek(Date date)` 获取某周的开始时间，周一定为一周的开始时间
`static DateTime`	DateUtil.`beginOfWeek(Date date, boolean isMondayAsFirstDay)` 获取某周的开始时间
`static DateTime`	DateUtil.`beginOfWeek(Date date, boolean isMondayAsFirstDay)` 获取某周的开始时间
`static DateTime`	DateUtil.`beginOfYear(Date date)` 获取某年的开始时间
`static DateTime`	DateUtil.`beginOfYear(Date date)` 获取某年的开始时间
`static DateTime`	DateUtil.`ceiling(Date date, DateField dateField)` 修改日期为某个时间字段结束时间
`static DateTime`	DateUtil.`ceiling(Date date, DateField dateField)` 修改日期为某个时间字段结束时间
`static DateTime`	DateUtil.`ceiling(Date date, DateField dateField, boolean truncateMillisecond)` 修改日期为某个时间字段结束时间可选是否归零毫秒。
`static DateTime`	DateUtil.`ceiling(Date date, DateField dateField, boolean truncateMillisecond)` 修改日期为某个时间字段结束时间可选是否归零毫秒。
`static DateTime`	DateUtil.`convertTimeZone(Date date, TimeZone timeZone)` `Date` 转换时区
`static DateTime`	DateUtil.`convertTimeZone(Date date, TimeZone timeZone)` `Date` 转换时区
`static DateTime`	DateUtil.`convertTimeZone(Date date, ZoneId zoneId)` `Date` 转换时区
`static DateTime`	DateUtil.`convertTimeZone(Date date, ZoneId zoneId)` `Date` 转换时区
`static DateTime`	DateUtil.`date()` 当前时间，转换为`DateTime`对象
`static DateTime`	DateUtil.`date()` 当前时间，转换为`DateTime`对象
`static DateTime`	DateUtil.`date(Calendar calendar)` `Calendar`类型时间转为`DateTime` 始终根据已有`Calendar` 产生新的`DateTime`对象
`static DateTime`	DateUtil.`date(Calendar calendar)` `Calendar`类型时间转为`DateTime` 始终根据已有`Calendar` 产生新的`DateTime`对象
`static DateTime`	DateUtil.`date(Date date)` `Date`类型时间转为`DateTime` 如果date本身为DateTime对象，则返回强转后的对象，否则新建一个DateTime对象
`static DateTime`	DateUtil.`date(Date date)` `Date`类型时间转为`DateTime` 如果date本身为DateTime对象，则返回强转后的对象，否则新建一个DateTime对象
`static DateTime`	DateUtil.`date(long date)` Long类型时间转为`DateTime` 只支持毫秒级别时间戳，如果需要秒级别时间戳，请自行×1000
`static DateTime`	DateUtil.`date(long date)` Long类型时间转为`DateTime` 只支持毫秒级别时间戳，如果需要秒级别时间戳，请自行×1000
`static DateTime`	DateUtil.`date(TemporalAccessor temporalAccessor)` `TemporalAccessor`类型时间转为`DateTime` 始终根据已有`TemporalAccessor` 产生新的`DateTime`对象
`static DateTime`	DateUtil.`date(TemporalAccessor temporalAccessor)` `TemporalAccessor`类型时间转为`DateTime` 始终根据已有`TemporalAccessor` 产生新的`DateTime`对象
`static DateTime`	DateUtil.`dateNew(Date date)` 根据已有`Date` 产生新的`DateTime`对象
`static DateTime`	DateUtil.`dateNew(Date date)` 根据已有`Date` 产生新的`DateTime`对象
`static DateTime`	DateUtil.`dateSecond()` 当前时间，转换为`DateTime`对象，忽略毫秒部分
`static DateTime`	DateUtil.`dateSecond()` 当前时间，转换为`DateTime`对象，忽略毫秒部分
`static DateTime`	DateUtil.`endOfDay(Date date)` 获取某天的结束时间
`static DateTime`	DateUtil.`endOfDay(Date date)` 获取某天的结束时间
`static DateTime`	DateUtil.`endOfHour(Date date)` 获取某小时的结束时间
`static DateTime`	DateUtil.`endOfHour(Date date)` 获取某小时的结束时间
`static DateTime`	DateUtil.`endOfMinute(Date date)` 获取某分钟的结束时间
`static DateTime`	DateUtil.`endOfMinute(Date date)` 获取某分钟的结束时间
`static DateTime`	DateUtil.`endOfMonth(Date date)` 获取某月的结束时间
`static DateTime`	DateUtil.`endOfMonth(Date date)` 获取某月的结束时间
`static DateTime`	DateUtil.`endOfQuarter(Date date)` 获取某季度的结束时间
`static DateTime`	DateUtil.`endOfQuarter(Date date)` 获取某季度的结束时间
`static DateTime`	DateUtil.`endOfSecond(Date date)` 获取秒级别的结束时间，即毫秒设置为999
`static DateTime`	DateUtil.`endOfSecond(Date date)` 获取秒级别的结束时间，即毫秒设置为999
`static DateTime`	DateUtil.`endOfWeek(Date date)` 获取某周的结束时间，周日定为一周的结束
`static DateTime`	DateUtil.`endOfWeek(Date date)` 获取某周的结束时间，周日定为一周的结束
`static DateTime`	DateUtil.`endOfWeek(Date date, boolean isSundayAsLastDay)` 获取某周的结束时间
`static DateTime`	DateUtil.`endOfWeek(Date date, boolean isSundayAsLastDay)` 获取某周的结束时间
`static DateTime`	DateUtil.`endOfYear(Date date)` 获取某年的结束时间
`static DateTime`	DateUtil.`endOfYear(Date date)` 获取某年的结束时间
`static DateTime`	DateUtil.`lastMonth()` 上个月
`static DateTime`	DateUtil.`lastMonth()` 上个月
`static DateTime`	DateUtil.`lastWeek()` 上周
`static DateTime`	DateUtil.`lastWeek()` 上周
`static DateTime`	DateUtil.`nextMonth()` 下个月
`static DateTime`	DateUtil.`nextMonth()` 下个月
`static DateTime`	DateUtil.`nextWeek()` 下周
`static DateTime`	DateUtil.`nextWeek()` 下周
`static DateTime`	DateTime.`now()` 现在的时间
`static DateTime`	DateTime.`now()` 现在的时间
`static DateTime`	DateTime.`of(Calendar calendar)` 转换 `Calendar` 为 DateTime
`static DateTime`	DateTime.`of(Calendar calendar)` 转换 `Calendar` 为 DateTime
`static DateTime`	DateTime.`of(Date date)` 转换JDK date为 DateTime
`static DateTime`	DateTime.`of(Date date)` 转换JDK date为 DateTime
`static DateTime`	DateTime.`of(long timeMillis)` 转换时间戳为 DateTime
`static DateTime`	DateTime.`of(long timeMillis)` 转换时间戳为 DateTime
`static DateTime`	DateTime.`of(String dateStr, String format)` 构造
`static DateTime`	DateTime.`of(String dateStr, String format)` 构造
`static DateTime`	DateUtil.`offset(Date date, DateField dateField, int offset)` 获取指定日期偏移指定时间后的时间，生成的偏移日期不影响原日期
`static DateTime`	DateUtil.`offset(Date date, DateField dateField, int offset)` 获取指定日期偏移指定时间后的时间，生成的偏移日期不影响原日期
`DateTime`	DateTime.`offset(DateField datePart, int offset)` 调整日期和时间如果此对象为可变对象，返回自身，否则返回新对象，设置是否可变对象见`setMutable(boolean)`
`DateTime`	DateTime.`offset(DateField datePart, int offset)` 调整日期和时间如果此对象为可变对象，返回自身，否则返回新对象，设置是否可变对象见`setMutable(boolean)`
`static DateTime`	DateUtil.`offsetDay(Date date, int offset)` w 偏移天
`static DateTime`	DateUtil.`offsetDay(Date date, int offset)` w 偏移天
`static DateTime`	DateUtil.`offsetHour(Date date, int offset)` 偏移小时
`static DateTime`	DateUtil.`offsetHour(Date date, int offset)` 偏移小时
`static DateTime`	DateUtil.`offsetMillisecond(Date date, int offset)` 偏移毫秒数
`static DateTime`	DateUtil.`offsetMillisecond(Date date, int offset)` 偏移毫秒数
`static DateTime`	DateUtil.`offsetMinute(Date date, int offset)` 偏移分钟
`static DateTime`	DateUtil.`offsetMinute(Date date, int offset)` 偏移分钟
`static DateTime`	DateUtil.`offsetMonth(Date date, int offset)` 偏移月
`static DateTime`	DateUtil.`offsetMonth(Date date, int offset)` 偏移月
`DateTime`	DateTime.`offsetNew(DateField datePart, int offset)` 调整日期和时间返回调整后的新DateTime，不影响原对象
`DateTime`	DateTime.`offsetNew(DateField datePart, int offset)` 调整日期和时间返回调整后的新DateTime，不影响原对象
`static DateTime`	DateUtil.`offsetSecond(Date date, int offset)` 偏移秒数
`static DateTime`	DateUtil.`offsetSecond(Date date, int offset)` 偏移秒数
`static DateTime`	DateUtil.`offsetWeek(Date date, int offset)` 偏移周
`static DateTime`	DateUtil.`offsetWeek(Date date, int offset)` 偏移周
`static DateTime`	DateUtil.`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`	DateUtil.`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`	DateUtil.`parse(CharSequence dateStr, DateFormat dateFormat)` 构建DateTime对象
`static DateTime`	DateUtil.`parse(CharSequence dateStr, DateFormat dateFormat)` 构建DateTime对象
`static DateTime`	DateUtil.`parse(CharSequence dateStr, DateParser parser)` 构建DateTime对象
`static DateTime`	DateUtil.`parse(CharSequence dateStr, DateParser parser)` 构建DateTime对象
`static DateTime`	DateUtil.`parse(CharSequence dateStr, DateParser parser, boolean lenient)` 构建DateTime对象
`static DateTime`	DateUtil.`parse(CharSequence dateStr, DateParser parser, boolean lenient)` 构建DateTime对象
`static DateTime`	DateUtil.`parse(CharSequence dateStr, DateTimeFormatter formatter)` 构建DateTime对象
`static DateTime`	DateUtil.`parse(CharSequence dateStr, DateTimeFormatter formatter)` 构建DateTime对象
`static DateTime`	DateUtil.`parse(CharSequence dateStr, String format)` 将特定格式的日期转换为Date对象
`static DateTime`	DateUtil.`parse(CharSequence dateStr, String format)` 将特定格式的日期转换为Date对象
`static DateTime`	DateUtil.`parse(CharSequence dateStr, String format, Locale locale)` 将特定格式的日期转换为Date对象
`static DateTime`	DateUtil.`parse(CharSequence dateStr, String format, Locale locale)` 将特定格式的日期转换为Date对象
`static DateTime`	DateUtil.`parse(String str, String... parsePatterns)` 通过给定的日期格式解析日期时间字符串。
`static DateTime`	DateUtil.`parse(String str, String... parsePatterns)` 通过给定的日期格式解析日期时间字符串。
`static DateTime`	DateUtil.`parseCST(CharSequence cstString)` 解析CST时间，格式： EEE MMM dd HH:mm:ss z yyyy（例如：Wed Aug 01 00:00:00 CST 2012）
`static DateTime`	DateUtil.`parseCST(CharSequence cstString)` 解析CST时间，格式： EEE MMM dd HH:mm:ss z yyyy（例如：Wed Aug 01 00:00:00 CST 2012）
`static DateTime`	DateUtil.`parseDate(CharSequence dateString)` 解析日期字符串，忽略时分秒，支持的格式包括： yyyy-MM-dd yyyy/MM/dd yyyy.MM.dd yyyy年MM月dd日
`static DateTime`	DateUtil.`parseDate(CharSequence dateString)` 解析日期字符串，忽略时分秒，支持的格式包括： yyyy-MM-dd yyyy/MM/dd yyyy.MM.dd yyyy年MM月dd日
`static DateTime`	DateUtil.`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`	DateUtil.`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`	DateUtil.`parseTime(CharSequence timeString)` 解析时间，格式HH:mm:ss，日期部分默认为1970-01-01
`static DateTime`	DateUtil.`parseTime(CharSequence timeString)` 解析时间，格式HH:mm:ss，日期部分默认为1970-01-01
`static DateTime`	DateUtil.`parseTimeToday(CharSequence timeString)` 解析时间，格式HH:mm 或 HH:mm:ss，日期默认为今天
`static DateTime`	DateUtil.`parseTimeToday(CharSequence timeString)` 解析时间，格式HH:mm 或 HH:mm:ss，日期默认为今天
`static DateTime`	DateUtil.`parseUTC(String utcString)` 解析UTC时间，格式： 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 DateTime`	DateUtil.`parseUTC(String utcString)` 解析UTC时间，格式： 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 DateTime`	DateUtil.`round(Date date, DateField dateField)` 修改日期为某个时间字段四舍五入时间
`static DateTime`	DateUtil.`round(Date date, DateField dateField)` 修改日期为某个时间字段四舍五入时间
`DateTime`	DateTime.`setField(DateField field, int value)` 设置日期的某个部分如果此对象为可变对象，返回自身，否则返回新对象，设置是否可变对象见`setMutable(boolean)`
`DateTime`	DateTime.`setField(DateField field, int value)` 设置日期的某个部分如果此对象为可变对象，返回自身，否则返回新对象，设置是否可变对象见`setMutable(boolean)`
`DateTime`	DateTime.`setField(int field, int value)` 设置日期的某个部分如果此对象为可变对象，返回自身，否则返回新对象，设置是否可变对象见`setMutable(boolean)`
`DateTime`	DateTime.`setField(int field, int value)` 设置日期的某个部分如果此对象为可变对象，返回自身，否则返回新对象，设置是否可变对象见`setMutable(boolean)`
`DateTime`	DateTime.`setFirstDayOfWeek(Week firstDayOfWeek)` 设置一周的第一天 JDK的Calendar中默认一周的第一天是周日，Hutool中将此默认值设置为周一设置一周的第一天主要影响`weekOfMonth()`和`weekOfYear()` 两个方法
`DateTime`	DateTime.`setFirstDayOfWeek(Week firstDayOfWeek)` 设置一周的第一天 JDK的Calendar中默认一周的第一天是周日，Hutool中将此默认值设置为周一设置一周的第一天主要影响`weekOfMonth()`和`weekOfYear()` 两个方法
`DateTime`	DateTime.`setMinimalDaysInFirstWeek(int minimalDaysInFirstWeek)` 设置第一周最少天数
`DateTime`	DateTime.`setMinimalDaysInFirstWeek(int minimalDaysInFirstWeek)` 设置第一周最少天数
`DateTime`	DateTime.`setMutable(boolean mutable)` 设置对象是否可变如果为不可变对象，以下方法将返回新方法： `offset(DateField, int)` `setField(DateField, int)` `setField(int, int)` 如果为不可变对象，`setTime(long)`将抛出异常
`DateTime`	DateTime.`setMutable(boolean mutable)` 设置对象是否可变如果为不可变对象，以下方法将返回新方法： `offset(DateField, int)` `setField(DateField, int)` `setField(int, int)` 如果为不可变对象，`setTime(long)`将抛出异常
`DateTime`	DateTime.`setTimeZone(TimeZone timeZone)` 设置时区
`DateTime`	DateTime.`setTimeZone(TimeZone timeZone)` 设置时区
`static DateTime`	DateUtil.`tomorrow()` 明天
`static DateTime`	DateUtil.`tomorrow()` 明天
`static DateTime`	DateUtil.`truncate(Date date, DateField dateField)` 修改日期为某个时间字段起始时间
`static DateTime`	DateUtil.`truncate(Date date, DateField dateField)` 修改日期为某个时间字段起始时间
`static DateTime`	DateUtil.`yesterday()` 昨天
`static DateTime`	DateUtil.`yesterday()` 昨天

返回变量类型为DateTime的类型的cn.hutool.core.date中的方法
限定符和类型	方法和说明
`static List<DateTime>`	DateUtil.`rangeContains(DateRange start, DateRange end)` 俩个时间区间取交集
`static List<DateTime>`	DateUtil.`rangeContains(DateRange start, DateRange end)` 俩个时间区间取交集
`static List<DateTime>`	DateUtil.`rangeNotContains(DateRange start, DateRange end)` 俩个时间区间取差集(end - start)
`static List<DateTime>`	DateUtil.`rangeNotContains(DateRange start, DateRange end)` 俩个时间区间取差集(end - start)
`static List<DateTime>`	DateUtil.`rangeToList(Date start, Date end, DateField unit)` 根据步进单位获取起始日期时间和结束日期时间的时间区间集合
`static List<DateTime>`	DateUtil.`rangeToList(Date start, Date end, DateField unit)` 根据步进单位获取起始日期时间和结束日期时间的时间区间集合
`static List<DateTime>`	DateUtil.`rangeToList(Date start, Date end, DateField unit, int step)` 根据步进单位和步进获取起始日期时间和结束日期时间的时间区间集合
`static List<DateTime>`	DateUtil.`rangeToList(Date start, Date end, DateField unit, int step)` 根据步进单位和步进获取起始日期时间和结束日期时间的时间区间集合

cn.hutool.core.util中DateTime的使用

返回DateTime的cn.hutool.core.util中的方法
限定符和类型	方法和说明
`DateTime`	IdcardUtil.Idcard.`getBirthDate()` 获得生日日期
`DateTime`	IdcardUtil.Idcard.`getBirthDate()` 获得生日日期
`static DateTime`	IdcardUtil.`getBirthDate(String idCard)` 从身份证号码中获取生日日期，只支持15或18位身份证号码
`static DateTime`	IdcardUtil.`getBirthDate(String idCard)` 从身份证号码中获取生日日期，只支持15或18位身份证号码
`static DateTime`	RandomUtil.`randomDate(Date baseDate, DateField dateField, int min, int max)` 以给定日期为基准，随机产生一个日期
`static DateTime`	RandomUtil.`randomDate(Date baseDate, DateField dateField, int min, int max)` 以给定日期为基准，随机产生一个日期
`static DateTime`	RandomUtil.`randomDay(int min, int max)` 以当天为基准，随机产生一个日期
`static DateTime`	RandomUtil.`randomDay(int min, int max)` 以当天为基准，随机产生一个日期

类的使用cn.hutool.core.date.DateTime

cn.hutool.core.date中DateTime的使用

cn.hutool.core.util中DateTime的使用

类的使用
cn.hutool.core.date.DateTime