LocalDateTime--使用/教程/实例

深碍√TFBOYSˉ_ 2022-08-28 14:44 351阅读 0赞

原文网址：[LocalDateTime--使用/教程/实例\_IT利刃出鞘的博客-CSDN博客][LocalDateTime--_IT_-CSDN]

# **简介** #

**说明**

本文用示例来介绍LocalDateTime的用法。

**简述**

从Java 8开始，java.time包提供了新的日期和时间API，主要涉及的类型有：

*  本地日期和时间：LocalDateTime，LocalDate，LocalTime；
 *  带时区的日期和时间：ZonedDateTime；
 *  时刻：Instant；
 *  时区：ZoneId，ZoneOffset；
 *  时间间隔：Period, Duration。两个类表示两个日期或时间量之间的差

DateTimeFormatter取代SimpleDateFormat。  
和旧API相比，新API严格区分时刻、本地日期、本地时间和带时区的日期时间，对日期和时间运算更加方便。  
此外，新API修正了旧API不合理的常量设计：

*  Month的范围用1~12表示1月到12月；
 *  Week的范围用1~7表示周一到周日。
 *  最后，新API的类型几乎全部是不变类型（和String类似），可以放心使用不必担心被修改。

**对应的SQL的类型**

SQL -> Java

date -> LocalDate  
time -> LocalTime  
timestamp -> LocalDateTime

# LocalDateTime #

## **常用操作** ##

注意：以下所有用法对于LocalDate和LocalTime是类似的。

**Date转换为LocalDateTime**

Date date = new Date();
    LocalDateTime nowDteTime = date.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();

Date所在包：java.util.Date

**LocalDateTime转换为Date**

LocalDateTime now = LocalDateTime.now(ZoneId.systemDefault());
    Date date = Date.from(now.atZone(ZoneId.systemDefault()).toInstant());

**转为LocalDate/LocalTime**

LocalDateTime ldt = LocalDateTime.now();
    LocalDate ld = ldt.toLocalDate();
    LocalTime lt = ldt.toLocalTime();

**LocalDateTime转时间戳**

Long timestamp = LocalDateTime.now().toInstant(ZoneOffset.ofHours(8)).toEpochMilli();
    Long timestamp = LocalDateTime.now().toInstant(ZoneOffset.of("+8")).toEpochMilli();

toInstant(ZoneOffset.of("+8"))获得的是秒；toEpochMilli()是转为毫秒级

**时间戳转LocalDateTime**

LocalDateTime ldt = Instant.ofEpochMilli(timestamp).atZone(ZoneOffset.ofHours(8)).toLocalDateTime();
    LocalDateTime ldt = LocalDateTime.ofEpochSecond(timestamp/1000, 0, ZoneOffset.ofHours(8));

**LocalDateTime的toString是ISO\_LOCAL\_DATE\_TIME格式**

LocalDateTime now = LocalDateTime.of(2017, 9, 22, 15, 40, 00);
    System.out.println(now);  //执行结果：2017-09-22T15:40

**获取当前时间**

LocalDateTime now = LocalDateTime.now();
    LocalDateTime now = LocalDateTime.now(ZoneId.systemDefault());

**格式化时间**

LocalDateTime ldt = LocalDateTime.now();
    String s1 = ldt.format(DateTimeFormatter.BASIC_ISO_DATE);
    String s2 = ldt.format(DateTimeFormatter.ofPattern("yyyy-MM-dd hh:mm"));

**解析**

//默认采用ISO_LOCAL_DATE_TIME解析
    LocalDateTime ldt1 = LocalDateTime.parse("2020-07-21T02:30:20");
    //不指定秒也可以。但分必须指定。
    LocalDateTime ldt2 = LocalDateTime.parse("2020-07-21T02:30");
    LocalDateTime ldt3 = LocalDateTime.parse("2020-07-21T02:30:20", DateTimeFormatter.BASIC_ISO_DATE);

**时间增减**

LocalDateTime ldt = LocalDateTime.now();
    //两种写法
    LocalDateTime ldt1 = ldt.plusYears(1);
    LocalDateTime ldt2 = ldt.plus(1, ChronoUnit.YEARS);

**时间差值**

LocalDateTime ldt1 = LocalDateTime.now();
    LocalDateTime ldt2 = LocalDateTime.now().plusHours(1);
    System.out.println(ldt2.until(ldt1, ChronoUnit.HOURS));  //运行结果为-1

**通过with修改某些值**

LocalDateTime ldt = LocalDateTime.now();                           //2020-07-30T09:41:24.761
    LocalDateTime ldt1 = ldt.with(TemporalAdjusters.firstDayOfYear()); //2020-01-01T09:41:24.761
    LocalDateTime ldt2 = ldt.with(ChronoField.YEAR, 2030);             //2030-07-30T09:41:24.761
    LocalDateTime ldt3 = ldt.withYear(2010);                           //2010-07-30T09:41:24.761

with方法有两个重载：

LocalDateTime with(TemporalAdjuster adjuster) //可以通过TemporalAdjusters.xxx直接传参  
LocalDateTime with(TemporalField field, long newValue) //可以通过指定ChronoField.YEAR指定要修改的位置

**创建**

根据年、月、日、时、分、秒、纳秒等创建LocalDateTime
    
    eg：
    LocalTime zero = LocalTime.of(0, 0, 0); // 00:00:00
    LocalTime mid = LocalTime.parse("12:00:00"); // 12:00:00
    LocalTime now = LocalTime.now(); // 23:11:08.006
    
    all method
    LocalDateTime of(LocalDate date, LocalTime time)
    LocalDateTime of(int year, Month month, int dayOfMonth, int hour, int minute)
    LocalDateTime of(int year, Month month, int dayOfMonth, int hour, int minute, int second)
    LocalDateTime of(int year, Month month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)
    LocalDateTime of(int year, int month, int dayOfMonth, int hour, int minute)
    LocalDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second)
    LocalDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)

## **所有方法** ##

（以下方法LocalDate与LocalTime也有，只是含义不一样而已）。以下**加粗的都是static类型**。

<table> 
 <tbody> 
 <tr> 
 <td> 方法 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> adjustInto </td> 
 <td> 调整指定的Temporal和当前LocalDateTime对 </td> 
 </tr> 
 <tr> 
 <td> atOffset </td> 
 <td> 结合LocalDateTime和ZoneOffset创建一个 </td> 
 </tr> 
 <tr> 
 <td> atZone </td> 
 <td> 结合LocalDateTime和指定时区创建一个ZonedD </td> 
 </tr> 
 <tr> 
 <td> compareTo </td> 
 <td> 比较两个LocalDateTime </td> 
 </tr> 
 <tr> 
 <td> format </td> 
 <td> 格式化LocalDateTime生成一个字符串 </td> 
 </tr> 
 <tr> 
 <td> from </td> 
 <td> 转换TemporalAccessor为LocalDateTime </td> 
 </tr> 
 <tr> 
 <td> get </td> 
 <td> 得到LocalDateTime的指定字段的值 </td> 
 </tr> 
 <tr> 
 <td> getDayOfMonth </td> 
 <td> 得到LocalDateTime是月的第几天 </td> 
 </tr> 
 <tr> 
 <td> getDayOfWeek </td> 
 <td> 得到LocalDateTime是星期几 </td> 
 </tr> 
 <tr> 
 <td> getDayOfYear </td> 
 <td> 得到LocalDateTime是年的第几天 </td> 
 </tr> 
 <tr> 
 <td> getHour </td> 
 <td> 得到LocalDateTime的小时 </td> 
 </tr> 
 <tr> 
 <td> getLong </td> 
 <td> 得到LocalDateTime指定字段的值 </td> 
 </tr> 
 <tr> 
 <td> getMinute </td> 
 <td> 得到LocalDateTime的分钟 </td> 
 </tr> 
 <tr> 
 <td> getMonth </td> 
 <td> 得到LocalDateTime的月份 </td> 
 </tr> 
 <tr> 
 <td> getMonthValue </td> 
 <td> 得到LocalDateTime的月份，从1到12 </td> 
 </tr> 
 <tr> 
 <td> getNano </td> 
 <td> 得到LocalDateTime的纳秒数 </td> 
 </tr> 
 <tr> 
 <td> getSecond </td> 
 <td> 得到LocalDateTime的秒数 </td> 
 </tr> 
 <tr> 
 <td> getYear </td> 
 <td> 得到LocalDateTime的年份 </td> 
 </tr> 
 <tr> 
 <td> isAfter </td> 
 <td> 判断LocalDateTime是否在指定LocalDateTime </td> 
 </tr> 
 <tr> 
 <td> isBefore </td> 
 <td> 判断LocalDateTime是否在指定LocalDateTime </td> 
 </tr> 
 <tr> 
 <td> isEqual </td> 
 <td> 判断两个LocalDateTime是否相等 </td> 
 </tr> 
 <tr> 
 <td> isSupported </td> 
 <td> 判断LocalDateTime是否支持指定时间字段或单元 </td> 
 </tr> 
 <tr> 
 <td> minus </td> 
 <td> 返回LocalDateTime减去指定数量的时间得到的值 </td> 
 </tr> 
 <tr> 
 <td> minusDays </td> 
 <td> 返回LocalDateTime减去指定天数得到的值 </td> 
 </tr> 
 <tr> 
 <td> minusHours </td> 
 <td> 返回LocalDateTime减去指定小时数得到的值 </td> 
 </tr> 
 <tr> 
 <td> minusMinutes </td> 
 <td> 返回LocalDateTime减去指定分钟数得到的值 </td> 
 </tr> 
 <tr> 
 <td> minusMonths </td> 
 <td> 返回LocalDateTime减去指定月数得到的值 </td> 
 </tr> 
 <tr> 
 <td> minusNanos </td> 
 <td> 返回LocalDateTime减去指定纳秒数得到的值 </td> 
 </tr> 
 <tr> 
 <td> minusSeconds </td> 
 <td> 返回LocalDateTime减去指定秒数得到的值 </td> 
 </tr> 
 <tr> 
 <td> minusWeeks </td> 
 <td> 返回LocalDateTime减去指定星期数得到的值 </td> 
 </tr> 
 <tr> 
 <td> minusYears </td> 
 <td> 返回LocalDateTime减去指定年数得到的值 </td> 
 </tr> 
 <tr> 
 <td> now </td> 
 <td> 返回指定时钟的当前LocalDateTime </td> 
 </tr> 
 <tr> 
 <td> of </td> 
 <td> 根据年、月、日、时、分、秒、纳秒等创建LocalDateTime </td> 
 </tr> 
 <tr> 
 <td> ofEpochSecond </td> 
 <td> 根据秒数(从1970-01-0100:00:00开始)创建LocalDateTime </td> 
 </tr> 
 <tr> 
 <td> ofInstant </td> 
 <td> 根据Instant和ZoneId创建LocalDateTime </td> 
 </tr> 
 <tr> 
 <td> parse </td> 
 <td> 解析字符串得到LocalDateTime </td> 
 </tr> 
 <tr> 
 <td> plus </td> 
 <td> 返回LocalDateTime加上指定数量的时间得到的值 </td> 
 </tr> 
 <tr> 
 <td> plusDays </td> 
 <td> 返回LocalDateTime加上指定天数得到的值 </td> 
 </tr> 
 <tr> 
 <td> plusHours </td> 
 <td> 返回LocalDateTime加上指定小时数得到的值 </td> 
 </tr> 
 <tr> 
 <td> plusMinutes </td> 
 <td> 返回LocalDateTime加上指定分钟数得到的值 </td> 
 </tr> 
 <tr> 
 <td> plusMonths </td> 
 <td> 返回LocalDateTime加上指定月数得到的值 </td> 
 </tr> 
 <tr> 
 <td> plusNanos </td> 
 <td> 返回LocalDateTime加上指定纳秒数得到的值 </td> 
 </tr> 
 <tr> 
 <td> plusSeconds </td> 
 <td> 返回LocalDateTime加上指定秒数得到的值 </td> 
 </tr> 
 <tr> 
 <td> plusWeeks </td> 
 <td> 返回LocalDateTime加上指定星期数得到的值 </td> 
 </tr> 
 <tr> 
 <td> plusYears </td> 
 <td> 返回LocalDateTime加上指定年数得到的值 </td> 
 </tr> 
 <tr> 
 <td> query </td> 
 <td> 查询LocalDateTime </td> 
 </tr> 
 <tr> 
 <td> range </td> 
 <td> 返回指定时间字段的范围 </td> 
 </tr> 
 <tr> 
 <td> toLocalDate </td> 
 <td> 返回LocalDateTime的LocalDate部分 </td> 
 </tr> 
 <tr> 
 <td> toLocalTime </td> 
 <td> 返回LocalDateTime的LocalTime部分 </td> 
 </tr> 
 <tr> 
 <td> toString </td> 
 <td> 返回LocalDateTime的字符串表示 </td> 
 </tr> 
 <tr> 
 <td> truncatedTo </td> 
 <td> 返回LocalDateTime截取到指定时间单位的拷贝 </td> 
 </tr> 
 <tr> 
 <td> until </td> 
 <td> 计算LocalDateTime和另一个LocalDateTime差值 </td> 
 </tr> 
 <tr> 
 <td> with </td> 
 <td> 返回LocalDateTime指定字段更改为新值后的拷贝 </td> 
 </tr> 
 <tr> 
 <td> withDayOfMonth </td> 
 <td> 返回LocalDateTime月的第几天更改为新值后的拷贝 </td> 
 </tr> 
 <tr> 
 <td> withDayOfYear </td> 
 <td> 返回LocalDateTime年的第几天更改为新值后的拷贝 </td> 
 </tr> 
 <tr> 
 <td> withHour </td> 
 <td> 返回LocalDateTime的小时数更改为新值后的拷贝 </td> 
 </tr> 
 <tr> 
 <td> withMinute </td> 
 <td> 返回LocalDateTime的分钟数更改为新值后的拷贝 </td> 
 </tr> 
 <tr> 
 <td> withMonth </td> 
 <td> 返回LocalDateTime的月份更改为新值后的拷贝 </td> 
 </tr> 
 <tr> 
 <td> withNano </td> 
 <td> 返回LocalDateTime的纳秒数更改为新值后的拷贝 </td> 
 </tr> 
 <tr> 
 <td> withSecond </td> 
 <td> 返回LocalDateTime的秒数更改为新值后的拷贝 </td> 
 </tr> 
 <tr> 
 <td> withYear </td> 
 <td> 返回LocalDateTime年份更改为新值后的拷贝 </td> 
 </tr> 
 </tbody> 
</table>

# **LocalDate** #

## **常用操作** ##

**获取两个LocalDate的相差天数**

// 如果是 now.until(before, ChronoUnit.DAYS), 返回的结果是负数
    LocalDate before = LocalDate.of(2017, 9, 22);
    LocalDate now = LocalDate.now(ZoneId.systemDefault());
    long betweenDays = before.until(now, ChronoUnit.DAYS);

**Date转LocalDate**

Date date = new Date();
    LocalDate localDate = Instant
    		.ofEpochMilli(date.getTime()).atZone(ZoneId.systemDefault())
    		.toLocalDate();

Date所在包：java.util.Date

**LocalDate转Date**

LocalDate localDate = LocalDate.now();
    Date date = Date.from(localDate
            .atStartOfDay()
            .atZone(ZoneId.systemDefault())
            .toInstant());

## 所有方法 ##

<table> 
 <tbody> 
 <tr> 
 <td>方法</td> 
 <td>说明</td> 
 <td>示例结果</td> 
 </tr> 
 <tr> 
 <td>LocalDate today = LocalDate.now();</td> 
 <td>取当前日期</td> 
 <td>2014-12-24</td> 
 </tr> 
 <tr> 
 <td>LocalDate crischristmas = LocalDate.of(2014, 12, 25);</td> 
 <td>根据年月日取日期</td> 
 <td>2014-12-25</td> 
 </tr> 
 <tr> 
 <td>LocalDate endOfFeb = LocalDate.parse("2014-02-28");</td> 
 <td>根据字符串取。严格按照ISO yyyy-MM-dd验证，02写成2都不行。当然也有一个重载方法允许自己定义格式</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td>LocalDate firstDayOfThisMonth = today.with(TemporalAdjusters.firstDayOfMonth());</td> 
 <td>取本月第1天</td> 
 <td>2017-03-01</td> 
 </tr> 
 <tr> 
 <td>LocalDate secondDayOfThisMonth = today.withDayOfMonth(2);</td> 
 <td>取本月第2天</td> 
 <td>2017-03-02</td> 
 </tr> 
 <tr> 
 <td>LocalDate lastDayOfThisMonth = today.with(TemporalAdjusters.lastDayOfMonth());</td> 
 <td>取本月最后一天，再也不用计算是28，29，30还是31</td> 
 <td>2017-12-31</td> 
 </tr> 
 <tr> 
 <td>LocalDate firstDayOf2015 = lastDayOfThisMonth.plusDays(1);</td> 
 <td>取下一天</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td>LocalDate firstMondayOf2015 = LocalDate.parse("2017-01-01").with(TemporalAdjusters.firstInMonth(DayOfWeek.MONDAY));</td> 
 <td>取2017年1月第一个周一</td> 
 <td></td> 
 </tr> 
 </tbody> 
</table>

# Period #

**其他网址**

[介绍java 8 的 Period 和 Duration 类\_一次次失望后的平静-CSDN博客][java 8 _ Period _ Duration _-CSDN]

**简介**

Period基于日期值 ，表示一段时间的年、月、日。

**两个日期之间的差赋值给Period**

LocalDate startDate = LocalDate.of(2015, 2, 20);
    LocalDate endDate = LocalDate.of(2017, 1, 15);
    // startDate减endDate
    Period period = Period.between(startDate, endDate);
    // 任何一个时间单元为负数，则返回true。true：endDate早于startDate
    period.isNegative()

**获得年月日**

period.getYears();
    period.getMonths();
    period.getDays();

**基于年、月、日和周创建Period**

如果仅一个值表示，如使用ofDays()方法，那么其他值为0。若仅用ofWeeks，则其天数为week数乘以7.

Period fromUnits = Period.of(3, 10, 10);
    Period fromDays = Period.ofDays(50);
    Period fromMonths = Period.ofMonths(5);
    Period fromYears = Period.ofYears(10);
    Period fromWeeks = Period.ofWeeks(40);  //280天

**基于文本序列创建Period**

其格式为“PnYnMnD”：P：period（表示是年月日）； Y：year；M：month；D：day

Period fromCharYears = Period.parse("P2Y");
    System.out.println(fromCharYears.getYears()+ "（年）");
    //2（年）
    
    Period fromCharUnits = Period.parse("P2Y3M5D");
    System.out.println(fromCharUnits.getYears() + "（年)" +
             fromCharUnits.getMonths() + "（月）" + fromCharUnits.getDays() + "（日）");
    //2（年)3（月）5（日）

**增减日期**

Period period = Period.parse("P2Y3M5D");
    period.plusDays(50).getDays();          //55
    period.minusMonths(2).getMonths();      //5

# Duration #

**简介**

Duration类表示秒或纳秒时间间隔，适合处理较短的时间。

**比较两个时间的差**

Instant start = Instant.parse("2017-10-03T10:15:30.00Z");
    Instant end = Instant.parse("2017-10-03T10:16:30.00Z");
    
    // start - end         
    Duration duration = Duration.between(start, end);
    // 任何一个时间单元为负数，则返回true。true：end早于start
    duration.isNegative();
    
    Duration.between(start, end).getSeconds();
    Duration.between(start, end).getNano();

**通过LocalTime 类获取创建Duration**

LocalTime start = LocalTime.of(1, 20, 25, 1024);
    LocalTime end = LocalTime.of(3, 22, 27, 1544);
     
    Duration.between(start, end).getSeconds();
    Duration.between(start, end).getNano();

**基于天、时、分、秒、纳秒创建Duration**

ofDays(), ofHours(), ofMillis(), ofMinutes(), ofNanos(), ofSeconds()。例如：

Duration fromDays = Duration.ofDays(1);

**基于文本序列创建Duration** （格式为 “PnDTnHnMn.nS”）

Duration fromChar1 = Duration.parse("P1DT1H10M10.5S");
    Duration fromChar2 = Duration.parse("PT10M");

**把Duration对象可以转成其他时间单元**

toDays(), toHours(), toMillis(), toMinutes()。例如：

Duration fromDays = Duration.ofDays(1);
    fromDays .toHours()

**增减Duration**

> plusX()、minusX()。X表示days, hours, millis, minutes, nanos 或 seconds
> 
>     duration.plusSeconds(60).getSeconds()

> plus()/minus()方法带TemporalUnit 类型参数进行加减：
> 
>     duration.plus(60, ChronoUnit.SECONDS).getSeconds()

# 其他网址 #

[java8时间类LocalDateTime - 帅的不像男的的个人空间 - OSCHINA][java8_LocalDateTime - _ - OSCHINA]

[LocalDate和localDateTime常用方法 - 少说点话 - 博客园][LocalDate_localDateTime_ - _ -]

[LocalDateTime--_IT_-CSDN]: https://knife.blog.csdn.net/article/details/120319901
[java 8 _ Period _ Duration _-CSDN]: https://blog.csdn.net/Denny2333/article/details/94614128
[java8_LocalDateTime - _ - OSCHINA]: https://my.oschina.net/githubhty/blog/1610049
[LocalDate_localDateTime_ - _ -]: https://www.cnblogs.com/sueyyyy/p/12838312.html