LocalDateTimeUtil (hutool-core 5.4.4 API)

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

```
public class LocalDateTimeUtil
extends Object
```
JDK8+中的LocalDateTime 工具类封装

从以下版本开始:

5.3.9

作者:

looly

构造器概要

构造器
构造器和说明

LocalDateTimeUtil()

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

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static LocalDateTime`	`beginOfDay(LocalDateTime time)` 修改为一天的开始时间，例如：2020-02-02 00:00:00,000
`static Duration`	`between(LocalDateTime startTime, LocalDateTime endTime)` 获取两个日期的差，如果结束时间早于开始时间，获取结果为负。
`static LocalDateTime`	`endOfDay(LocalDateTime time)` 修改为一天的结束时间，例如：2020-02-02 23:59:59,999
`static String`	`format(LocalDate date, DateTimeFormatter formatter)` 格式化日期时间为指定格式
`static String`	`format(LocalDate date, String format)` 格式化日期时间为指定格式
`static String`	`format(LocalDateTime time, DateTimeFormatter formatter)` 格式化日期时间为指定格式
`static String`	`format(LocalDateTime time, String format)` 格式化日期时间为指定格式
`static String`	`formatNormal(LocalDate date)` 格式化日期时间为yyyy-MM-dd格式
`static String`	`formatNormal(LocalDateTime time)` 格式化日期时间为yyyy-MM-dd HH:mm:ss格式
`static LocalDateTime`	`now()` 当前时间，默认时区
`static LocalDateTime`	`of(Date date)` `Date`转`LocalDateTime`，使用默认时区
`static LocalDateTime`	`of(Instant instant)` `Instant`转`LocalDateTime`，使用默认时区
`static LocalDateTime`	`of(Instant instant, TimeZone timeZone)` `Instant`转`LocalDateTime`
`static LocalDateTime`	`of(Instant instant, ZoneId zoneId)` `Instant`转`LocalDateTime`
`static LocalDateTime`	`of(long epochMilli)` 毫秒转`LocalDateTime`，使用默认时区注意：此方法使用默认时区，如果非UTC，会产生时间偏移
`static LocalDateTime`	`of(long epochMilli, TimeZone timeZone)` 毫秒转`LocalDateTime`，结果会产生时间偏移
`static LocalDateTime`	`of(long epochMilli, ZoneId zoneId)` 毫秒转`LocalDateTime`，根据时区不同，结果会产生时间偏移
`static LocalDateTime`	`of(TemporalAccessor temporalAccessor)` `TemporalAccessor`转`LocalDateTime`，使用默认时区
`static LocalDateTime`	`of(ZonedDateTime zonedDateTime)` `ZonedDateTime`转`LocalDateTime`
`static LocalDate`	`ofDate(TemporalAccessor temporalAccessor)` `TemporalAccessor`转`LocalDate`，使用默认时区
`static LocalDateTime`	`offset(LocalDateTime time, long number, TemporalUnit field)` 日期偏移,根据field不同加不同值（偏移会修改传入的对象）
`static LocalDateTime`	`ofUTC(Instant instant)` `Instant`转`LocalDateTime`，使用UTC时区
`static LocalDateTime`	`ofUTC(long epochMilli)` 毫秒转`LocalDateTime`，使用UTC时区
`static LocalDateTime`	`parse(CharSequence text)` 解析日期时间字符串为`LocalDateTime`，仅支持yyyy-MM-dd'T'HH:mm:ss格式，例如：2007-12-03T10:15:30
`static LocalDateTime`	`parse(CharSequence text, DateTimeFormatter formatter)` 解析日期时间字符串为`LocalDateTime`，格式支持日期时间、日期、时间
`static LocalDateTime`	`parse(CharSequence text, String format)` 解析日期时间字符串为`LocalDateTime`
`static LocalDate`	`parseDate(CharSequence text)` 解析日期时间字符串为`LocalDate`，仅支持yyyy-MM-dd'T'HH:mm:ss格式，例如：2007-12-03T10:15:30
`static LocalDate`	`parseDate(CharSequence text, DateTimeFormatter formatter)` 解析日期时间字符串为`LocalDate`，格式支持日期
`static LocalDate`	`parseDate(CharSequence text, String format)` 解析日期字符串为`LocalDate`
`static long`	`toEpochMilli(TemporalAccessor temporalAccessor)` `TemporalAccessor`转换为时间戳（从1970-01-01T00:00:00Z开始的毫秒数）

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

- 构造器详细资料
  - LocalDateTimeUtil
```
public LocalDateTimeUtil()
```
- 方法详细资料
  - now
```
public static LocalDateTime now()
```
    当前时间，默认时区
    
    返回:
    
    LocalDateTime
  - of
```
public static LocalDateTime of(Instant instant)
```
    Instant转LocalDateTime，使用默认时区
    
    参数:
    
    instant - Instant
    
    返回:
    
    LocalDateTime
  - ofUTC
```
public static LocalDateTime ofUTC(Instant instant)
```
    Instant转LocalDateTime，使用UTC时区
    
    参数:
    
    instant - Instant
    
    返回:
    
    LocalDateTime
  - of
```
public static LocalDateTime of(ZonedDateTime zonedDateTime)
```
    ZonedDateTime转LocalDateTime
    
    参数:
    
    zonedDateTime - ZonedDateTime
    
    返回:
    
    LocalDateTime
  - of
```
public static LocalDateTime of(Instant instant,
                               ZoneId zoneId)
```
    Instant转LocalDateTime
    
    参数:
    
    instant - Instant
    
    zoneId - 时区
    
    返回:
    
    LocalDateTime
  - of
```
public static LocalDateTime of(Instant instant,
                               TimeZone timeZone)
```
    Instant转LocalDateTime
    
    参数:
    
    instant - Instant
    
    timeZone - 时区
    
    返回:
    
    LocalDateTime
  - of
```
public static LocalDateTime of(long epochMilli)
```
    毫秒转LocalDateTime，使用默认时区
    注意：此方法使用默认时区，如果非UTC，会产生时间偏移
    
    参数:
    
    epochMilli - 从1970-01-01T00:00:00Z开始计数的毫秒数
    
    返回:
    
    LocalDateTime
  - ofUTC
```
public static LocalDateTime ofUTC(long epochMilli)
```
    毫秒转LocalDateTime，使用UTC时区
    
    参数:
    
    epochMilli - 从1970-01-01T00:00:00Z开始计数的毫秒数
    
    返回:
    
    LocalDateTime
  - of
```
public static LocalDateTime of(long epochMilli,
                               ZoneId zoneId)
```
    毫秒转LocalDateTime，根据时区不同，结果会产生时间偏移
    
    参数:
    
    epochMilli - 从1970-01-01T00:00:00Z开始计数的毫秒数
    
    zoneId - 时区
    
    返回:
    
    LocalDateTime
  - of
```
public static LocalDateTime of(long epochMilli,
                               TimeZone timeZone)
```
    毫秒转LocalDateTime，结果会产生时间偏移
    
    参数:
    
    epochMilli - 从1970-01-01T00:00:00Z开始计数的毫秒数
    
    timeZone - 时区
    
    返回:
    
    LocalDateTime
  - of
```
public static LocalDateTime of(Date date)
```
    Date转LocalDateTime，使用默认时区
    
    参数:
    
    date - Date对象
    
    返回:
    
    LocalDateTime
  - of
```
public static LocalDateTime of(TemporalAccessor temporalAccessor)
```
    TemporalAccessor转LocalDateTime，使用默认时区
    
    参数:
    
    temporalAccessor - TemporalAccessor
    
    返回:
    
    LocalDateTime
  - ofDate
```
public static LocalDate ofDate(TemporalAccessor temporalAccessor)
```
    TemporalAccessor转LocalDate，使用默认时区
    
    参数:
    
    temporalAccessor - TemporalAccessor
    
    返回:
    
    LocalDate
    
    从以下版本开始:
    
    5.3.10
  - parse
```
public static LocalDateTime parse(CharSequence text)
```
    解析日期时间字符串为LocalDateTime，仅支持yyyy-MM-dd'T'HH:mm:ss格式，例如：2007-12-03T10:15:30
    
    参数:
    
    text - 日期时间字符串
    
    返回:
    
    LocalDateTime
  - parse
```
public static LocalDateTime parse(CharSequence text,
                                  DateTimeFormatter formatter)
```
    解析日期时间字符串为LocalDateTime，格式支持日期时间、日期、时间
    
    参数:
    
    text - 日期时间字符串
    
    formatter - 日期格式化器，预定义的格式见：DateTimeFormatter
    
    返回:
    
    LocalDateTime
  - parse
```
public static LocalDateTime parse(CharSequence text,
                                  String format)
```
    解析日期时间字符串为LocalDateTime
    
    参数:
    
    text - 日期时间字符串
    
    format - 日期格式，类似于yyyy-MM-dd HH:mm:ss,SSS
    
    返回:
    
    LocalDateTime
  - parseDate
```
public static LocalDate parseDate(CharSequence text)
```
    解析日期时间字符串为LocalDate，仅支持yyyy-MM-dd'T'HH:mm:ss格式，例如：2007-12-03T10:15:30
    
    参数:
    
    text - 日期时间字符串
    
    返回:
    
    LocalDate
    
    从以下版本开始:
    
    5.3.10
  - parseDate
```
public static LocalDate parseDate(CharSequence text,
                                  DateTimeFormatter formatter)
```
    解析日期时间字符串为LocalDate，格式支持日期
    
    参数:
    
    text - 日期时间字符串
    
    formatter - 日期格式化器，预定义的格式见：DateTimeFormatter
    
    返回:
    
    LocalDate
    
    从以下版本开始:
    
    5.3.10
  - parseDate
```
public static LocalDate parseDate(CharSequence text,
                                  String format)
```
    解析日期字符串为LocalDate
    
    参数:
    
    text - 日期字符串
    
    format - 日期格式，类似于yyyy-MM-dd
    
    返回:
    
    LocalDateTime
  - formatNormal
```
public static String formatNormal(LocalDateTime time)
```
    格式化日期时间为yyyy-MM-dd HH:mm:ss格式
    
    参数:
    
    time - LocalDateTime
    
    返回:
    
    格式化后的字符串
    
    从以下版本开始:
    
    5.3.11
  - format
```
public static String format(LocalDateTime time,
                            DateTimeFormatter formatter)
```
    格式化日期时间为指定格式
    
    参数:
    
    time - LocalDateTime
    
    formatter - 日期格式化器，预定义的格式见：DateTimeFormatter
    
    返回:
    
    格式化后的字符串
  - format
```
public static String format(LocalDateTime time,
                            String format)
```
    格式化日期时间为指定格式
    
    参数:
    
    time - LocalDateTime
    
    format - 日期格式，类似于yyyy-MM-dd HH:mm:ss,SSS
    
    返回:
    
    格式化后的字符串
  - formatNormal
```
public static String formatNormal(LocalDate date)
```
    格式化日期时间为yyyy-MM-dd格式
    
    参数:
    
    date - LocalDate
    
    返回:
    
    格式化后的字符串
    
    从以下版本开始:
    
    5.3.11
  - format
```
public static String format(LocalDate date,
                            DateTimeFormatter formatter)
```
    格式化日期时间为指定格式
    
    参数:
    
    date - LocalDate
    
    formatter - 日期格式化器，预定义的格式见：DateTimeFormatter
    
    返回:
    
    格式化后的字符串
    
    从以下版本开始:
    
    5.3.10
  - format
```
public static String format(LocalDate date,
                            String format)
```
    格式化日期时间为指定格式
    
    参数:
    
    date - LocalDate
    
    format - 日期格式，类似于yyyy-MM-dd
    
    返回:
    
    格式化后的字符串
    
    从以下版本开始:
    
    5.3.10
  - offset
```
public static LocalDateTime offset(LocalDateTime time,
                                   long number,
                                   TemporalUnit field)
```
    日期偏移,根据field不同加不同值（偏移会修改传入的对象）
    
    参数:
    
    time - LocalDateTime
    
    number - 偏移量，正数为向后偏移，负数为向前偏移
    
    field - 偏移单位，见ChronoField，不能为null
    
    返回:
    
    偏移后的日期时间
  - between
```
public static Duration between(LocalDateTime startTime,
                               LocalDateTime endTime)
```
    获取两个日期的差，如果结束时间早于开始时间，获取结果为负。
    返回结果为Duration对象，通过调用toXXX方法返回相差单位
    
    参数:
    
    startTime - 开始时间
    
    endTime - 结束时间
    
    返回:
    
    时间差 Duration对象
  - beginOfDay
```
public static LocalDateTime beginOfDay(LocalDateTime time)
```
    修改为一天的开始时间，例如：2020-02-02 00:00:00,000
    
    参数:
    
    time - 日期时间
    
    返回:
    
    一天的开始时间
  - endOfDay
```
public static LocalDateTime endOfDay(LocalDateTime time)
```
    修改为一天的结束时间，例如：2020-02-02 23:59:59,999
    
    参数:
    
    time - 日期时间
    
    返回:
    
    一天的结束时间
  - toEpochMilli
```
public static long toEpochMilli(TemporalAccessor temporalAccessor)
```
    TemporalAccessor转换为时间戳（从1970-01-01T00:00:00Z开始的毫秒数）
    
    参数:
    
    temporalAccessor - Date对象
    
    返回:
    
    Instant对象
    
    从以下版本开始:
    
    5.4.1
    
    另请参阅:
    
    TemporalAccessorUtil.toEpochMilli(TemporalAccessor)

类 LocalDateTimeUtil

构造器概要

方法概要

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

构造器详细资料

LocalDateTimeUtil

方法详细资料

now

of

ofUTC

of

of

of

of

ofUTC

of

of

of

of

ofDate

parse

parse

parse

parseDate

parseDate

parseDate

formatNormal

format

format

formatNormal

format

format

offset

between

beginOfDay

endOfDay

toEpochMilli