Java 8 Time Api 使用指南-珍藏限量版

1.概述

Java 8为Date和Time引入了新的API，以解决旧java.util.Date和java.util.Calendar的缺点。做为本文的一部分，让咱们从现有Date和Calendar API存在的一些问题入手，来探讨新的Java 8 Date和Time API如何解决这些问题。咱们还将搞一搞Java 8时间类库中的核心类，好比LocalDate, LocalTime, LocalDateTime, ZonedDateTime, Period, Duration以及它们的api。

2. 旧的时间API（java8以前）的问题

• 线程安全 - Date 和Calendar类不是线程安全的，使开发者难以调试这些api的并发问题，须要编写额外的代码来处理线程安全。Java 8中引入的新的Date和Time API是不可变的和线程安全的，使得这些痛点得以解决。
• API设计和易于理解 - 旧的时间api很是难以理解，操做都很是复杂，很是绕口，没有提供一些经常使用的解析转换方法。新的时间API是以ISO为中心的，并遵循 date, time, duration 和 periods的一致域模型。提供了一些很是实用方法以支持最多见的操做。再也不须要咱们本身封装一些时间操做类，并且描述语义化。
• ZonedDate和Time - 在旧的时间api中开发人员必须编写额外的逻辑来处理旧API的时区逻辑，而使用新的API，可使用 Local和ZonedDate / Time API来处理时区。无需过多关心时区转换问题。

3. 使用LocalDate，LocalTime和LocalDateTime

最经常使用的类是LocalDate，LocalTime和LocalDateTime。正如他们的名字所示，它们表明与上下文相结合的本地日期/时间。 这些类主要用于不须要在上下文中明确指定时区的状况。做为本节的一部分，咱们将介绍最经常使用的API。

3.1 使用LocalDate

LocalDate表示在ISO格式（YYYY-MM-DD）下的不带具体时间的日期。经常使用于表示生日或者咱们最关心的发工资的的日期。获取当前系统时钟下的日期，以下所示： LocalDate localDate = LocalDate.now(); 表示特定日，月和年的LocalDate可使用“ of ”方法或使用“ parse ”方法得到。例如，如下代码段表明2015年2月20日的LocalDate： LocalDate.of(2015, 02, 20); LocalDate.parse("2015-02-20"); 是否是很是直观并且方便呢！LocalDate提供各类实用方法，以得到各类日期信息。让咱们快速浏览一下这些API方法。如下代码段获取当前本地日期并添加一天： LocalDate tomorrow = LocalDate.now().plusDays(1); 此示例获取当前日期并减去一个月。请注意它是如何接受枚举做为时间单位的： LocalDate previousMonthSameDay = LocalDate.now().minus(1, ChronoUnit.MONTHS); 在如下两个代码示例中，咱们分析日期“2016-06-12”并分别获取星期几和月中的某天。注意返回值，第一个是表示DayOfWeek的对象，而第二个是表示月份的序数值的int：

DayOfWeek sunday = LocalDate.parse("2019-06-12").getDayOfWeek(); 
int twelve = LocalDate.parse("2016-09-12").getDayOfMonth();
复制代码

咱们还能够测试一个日期是否发生在闰年，若是用老方法怕不是要上天： boolean leapYear = LocalDate.now().isLeapYear(); 判断日期的前后：

boolean notBefore = LocalDate.parse("2019-06-12").isBefore(LocalDate.parse("2019-06-11")); 
boolean isAfter = LocalDate.parse("2019-06-12")  .isAfter(LocalDate.parse("2019-06-11"));
复制代码

日期边界能够从给定日期得到。在如下两个示例中，咱们获得LocalDateTime，它表明给定日期的一天的开始（2016-06-12T00：00）和表明月初的LocalDate（2019-06-01）：

LocalDateTime beginningOfDay = LocalDate.parse("2019-06-12").atStartOfDay();
LocalDate firstDayOfMonth = LocalDate.parse("2019-09-12").with(TemporalAdjusters.firstDayOfMonth());
复制代码

如今让咱们来看看咱们如何使用当地时间LocalTime。

3.2 使用LocalTime

在本地时间表示不带日期的时间。与LocalDate相似，能够从系统时钟或使用“parse”和“of”方法建立LocalTime实例。快速浏览下面的一些经常使用API。能够从系统时钟建立当前LocalTime的实例，以下所示： LocalTime now = LocalTime.now(); 在下面的代码示例中，咱们经过解析字符串表示建立表示06:30 AM 的LocalTime： LocalTime sixThirty = LocalTime.parse("06:30"); 方法“of”可用于建立LocalTime。例如，下面的代码使用“of”方法建立表示06:30 AM的LocalTime： LocalTime sixThirty = LocalTime.of(6, 30); 下面的示例经过解析字符串来建立LocalTime，并使用“plus”API为其添加一小时。结果将是表明07:30 AM的LocalTime： LocalTime sevenThirty = LocalTime.parse("06:30").plus(1, ChronoUnit.HOURS); 各类getter方法可用于获取特定的时间单位，如小时，分钟和秒，以下所示获取小时： int six = LocalTime.parse("06:30").getHour(); 同LocalDate同样检查特定时间是否在另外一特定时间以前或以后。下面的代码示例比较结果为true的两个LocalTime： boolean isbefore = LocalTime.parse("06:30").isBefore(LocalTime.parse("07:30")); 一天中的最大，最小和中午时间能够经过LocalTime类中的常量得到。在执行数据库查询以查找给定时间范围内的记录时，这很是有用。例如，下面的代码表明23：59：59.99： LocalTime maxTime = LocalTime.MAX; 如今让咱们深刻了解LocalDateTime。

3.3 使用LocalDateTime

所述LocalDateTime用于表示日期和时间的组合。当咱们须要结合日期和时间时，这是最经常使用的类。该类提供了各类API，咱们将介绍一些最经常使用的API。相似于LocalDate和LocalTime从系统时钟获取LocalDateTime的实例： LocalDateTime.now(); 下面的代码示例解释了如何使用工厂“of”和“parse”方法建立实例。结果将是表明2019年2月20日06:30 AM 的LocalDateTime实例：

LocalDateTime.of(2019, Month.FEBRUARY, 20, 06, 30);
LocalDateTime.parse("2019-02-20T06:30:00");
复制代码

有一些实用的API能够支持特定时间单位的时间运算，例如天，月，年和分钟。如下代码示例演示了“加”和“减”方法的用法。这些API的行为与LocalDate和LocalTime中的 API彻底相同：

localDateTime.plusDays(1);
localDateTime.minusHours(2);
复制代码

Getter方法可用于提取相似于日期和时间类的特定单位。鉴于上面的LocalDateTime实例，下面的代码示例将返回2月份的月份： localDateTime.getMonth();

4.使用ZonedDateTime API

当咱们须要处理时区特定的日期和时间时，Java 8提供了ZonedDateTime类。ZoneID是用于表示不一样区域的标识符。大约有40个不一样的时区，使用ZoneID表示它们，以下所示 下面的代码咱们来获取下“亚洲/上海”时区: ZoneId zoneId = ZoneId.of("Aisa/Shanghai"); 获取全部的时区： Set<String> allZoneIds = ZoneId.getAvailableZoneIds(); LocalDateTime转化为特定的时区中的时间： ZonedDateTime zonedDateTime = ZonedDateTime.of(localDateTime, zoneId); ZonedDateTime提供解析方法来获取时区的特定日期时间： ZonedDateTime.parse("2019-06-03T10:15:30+01:00[Aisa/Shanghai]"); 使用时区的另外一种方法是使用OffsetDateTime。OffsetDateTime是具备偏移量的日期时间的不可变表示形式。此类存储全部日期和时间字段，精确到纳秒，以及从UTC/格林威治的偏移量。可使用ZoneOffset建立OffsetDateTime实例。这里咱们建立一个LocalDateTime来表示2015年2月20日上午6:30： LocalDateTime localDateTime = LocalDateTime.of(2019, Month.FEBRUARY, 20, 06, 30); 而后咱们经过建立ZoneOffset并为LocalDateTime实例设置来增长两个小时：

ZoneOffset offset = ZoneOffset.of("+02:00"); 
OffsetDateTime offSetByTwo = OffsetDateTime.of(localDateTime, offset);
复制代码

咱们如今假定本地日期时间为2019-02-20 06:30 +02：00。如今让咱们继续讨论如何使用Period和Duration类修改日期和时间值。

5.使用Period和Duration

• Period : 用于计算两个日期（年月日）间隔。
• Duration : 用于计算两个时间（秒，纳秒）间隔。

5.1 使用Period

Period 类被普遍地用于修改给定的日期的值或者获取两个日期之间的差值：

LocalDate initialDate = LocalDate.parse("2007-05-10");
LocalDate finalDate = initialDate.plus(Period.ofDays(5));
复制代码

Period 类有各类getter方法，如getYears，getMonths和getDays从获取值周期对象。下面的代码示例返回一个int值为5，是基于上面示例的逆序操做： int five = Period.between(finalDate, initialDate).getDays(); 该Period 能够在特定的单元得到两个日期之间的如天或月或数年，使用ChronoUnit.between： int five = ChronoUnit.DAYS.between(finalDate , initialDate); 此代码示例返回五天。让咱们继续看看Duration类。

5.2 使用Duration

相似Period ，Duration类是用来处理时间。在下面的代码中，咱们建立一个本地时间上午6:30，而后加30秒的持续时间，以使本地时间上午6时30分30秒的：

LocalTime initialTime = LocalTime.of(6, 30, 0); 
LocalTime finalTime = initialTime.plus(Duration.ofSeconds(30));
复制代码

两个时刻之间的持续时间能够做为持续时间或做为特定单位得到。在第一个代码片断中，咱们使用Duration类的between（）方法来查找finalTime和initialTime之间的时间差，并以秒为单位返回差别： int thirty = Duration.between(finalTime, initialTime).getSeconds(); 在第二个例子中，咱们使用ChronoUnit类的between（）方法来执行相同的操做： int thirty = ChronoUnit.SECONDS.between(finalTime, initialTime); 如今咱们来看看如何将旧的Date 和Calendar 转换为新的Date和Time。

6.与日期和日历的兼容性

Java 8添加了toInstant（）方法，该方法有助于将旧API中的Date和Calendar实例转换为新的Date Time API，以下面的代码片断所示：

LocalDateTime.ofInstant(date.toInstant(), ZoneId.systemDefault());
LocalDateTime.ofInstant(calendar.toInstant(), ZoneId.systemDefault());
复制代码

所述LocalDateTime能够从以下“ofEpochSecond”方法来构造。如下代码的结果将是表明2019-06-13T11：34：50 的LocalDateTime： LocalDateTime.ofEpochSecond(1465817690, 0, ZoneOffset.UTC); 如今让咱们继续进行日期和时间格式化。

7. 日期和时间格式化

Java 8提供了用于轻松格式化日期和时间的 API ： LocalDateTime localDateTime = LocalDateTime.of(2019, Month.JANUARY, 25, 6, 30); 如下代码传递ISO日期格式以格式化本地日期。结果将是2019-01-25： String localDateString = localDateTime.format(DateTimeFormatter.ISO_DATE); 该DateTimeFormatter提供多种标准格式选项。也能够提供自定义模式来格式化方法，以下所示对上面的例子进行自定义格式化，它将返回LocalDate为2019/01/25： localDateTime.format(DateTimeFormatter.ofPattern("yyyy/MM/dd")); 咱们能够将格式样式传递为SHORT，LONG或MEDIUM做为格式化选项的一部分。下面的代码示例将在2019年1月25日06:30:00 给出表示LocalDateTime的输出： localDateTime.format(DateTimeFormatter.ofLocalizedDateTime(FormatStyle.MEDIUM).withLocale(Locale.UK); 最后让咱们看看Java 8 Core Date / Time API 可用的替代方案。并非全部的项目都使用java 8。

8.替代方案

8.1 使用Threeten 类库

对于从Java 7或Java 6这些老项目来讲可使用Threeten ,而后能够像在上面java 8同样使用相同的功能，一旦你迁移到java 8 只须要修改你的包路径代码而无需变动。经过在项目中引用如下pom依赖项就能够当即使用：

<dependency>    
   <groupId>org.threeten</groupId>    
   <artifactId>threetenbp</artifactId>    
   <version>LATEST</version>
 </dependency>
复制代码

8.2 Joda-Time类库

Java 8 日期和时间库的另外一种替代方案是老牌时间处理类库Joda-Time。事实上，Java 8 Date Time API 吸取了大量的Joda-Time库。该库提供了Java 8 Date Time项目中支持的几乎全部功能。经过在项目中引用如下pom依赖项就能够当即使用：

<dependency>    
   <groupId>joda-time</groupId>    
   <artifactId>joda-time</artifactId>    
   <version>LATEST</version>
</dependency>
复制代码

原创做者：码农小胖哥 转载地址：gper.club/articles/7e…