介绍 Java 8 Date/Time API
1.概述
java8 引入新的日期时间API，为了解决原来java.util.Date , java.util.Calendar的一些缺陷。
本文首先介绍原Date,Calendar API的问题，然后来说明java8 Date , Time API是如何解决的。
同时，我们也了解java8中java.time包中一些常用类及其API，如LocalDate, LocalTime, LocalDateTime, ZonedDateTime, Period, Duration.
2.原Date/Time APIs问题
线程安全 —— Date和Calendar类不是线程安全的，在调试并发程序时让人头痛，开发者必须自己额外的代码处理线程安全。相反，java8中引入新的Date和Time API是不可变且线程安全的，因为开发者无需单向并发问题。
简单易懂 —— Date和Calendar类
时区和时间 —— 使用原来的API开发者不得不写额外逻辑处理时区逻辑,因此新的API可以使用Local、ZoneDate/TimeAPI处理时区问题。
3.使用LocalDate,LocalTime,LocalDateTime类API
最常用的类是LocalDate, LocalTime, LocalDateTime,见名思意，它们分别表示当前上下文的本地日期/时间。
这些类主要用在时区无需显示指定的场景。本节让介绍其最常用的API.
3.1.使用LocalDate
LocalDate 表示ISO格式日期 (yyyy-MM-dd)，没有时间。
可以用来存储日期，如生日，付款日期等。当前日期可以用系统时钟创建：
LocalDate localDate = LocalDate.now();
LocalDate表示特定年，月，日，可以使用of方法或parse方法创建。举例：
LocalDate.of(2015, 02, 20);
LocalDate.parse("2015-02-20");
LocalDate提供多个工具方法可以获得不同信息。让我们快速了解下。
下面代码片段获得本地日期，然后加一天：
LocalDate tomorrow = LocalDate.now().plusDays(1);LocalDate tomorrow = LocalDate.now().plusDays(1);
下面代码获得当前日期，然后减去一个月。注意其枚举时间单位参数：
LocalDate previousMonthSameDay = LocalDate.now().minus(1, ChronoUnit.MONTHS);
下面两行代码解析“2016-06-12”，然后获取星期几和月中那一天。注意其返回值，第一个为DayOfWeek，第二个是int。
DayOfWeek sunday = LocalDate.parse("2016-06-12").getDayOfWeek();
int twelve = LocalDate.parse("2016-06-12").getDayOfMonth();
也可以轻松测试闰年，示例代码如下：
boolean leapYear = LocalDate.now().isLeapYear();
两个日期比较，before和after很便捷：
boolean notBefore = LocalDate.parse("2016-06-12").isBefore(LocalDate.parse("2016-06-11"));
boolean isAfter = LocalDate.parse("2016-06-12").isAfter(LocalDate.parse("2016-06-11"));
可以从日期中获取边界。下面示例分别获取当天的开始及当月的第一天。
LocalDateTime beginningOfDay = LocalDate.parse("2016-06-12").atStartOfDay();
LocalDate firstDayOfMonth = LocalDate.parse("2016-06-12").with(TemporalAdjusters.firstDayOfMonth());
下面我们看看LocalTime类。
3.2 使用LocalTime
LocalTime表示时间，没有日期。与LocalDate类似，LocalTime能通过of和parse方法从系统时钟创建。
下面通过示例了解下常用API.
LocalTime now = LocalTime.now();
下面代码示例，我们通过解析字符串创建LocalTime表示06:30AM。
LocalTime sixThirty = LocalTime.parse("06:30");
也可以使用工厂方法创建LocalTime。示例如下：
LocalTime sixThirty = LocalTime.of(6, 30);
通过plus方法增加一小时。servenThirth为07:30AM.
LocalTime sevenThirty = LocalTime.parse("06:30").plus(1, ChronoUnit.HOURS);
提供便捷的方法获取时间单元。
int six = LocalTime.parse("06:30").getHour();
比较日期，是否晚于或早于特定时间。示例代码：
boolean isbefore = LocalTime.parse("06:30").isBefore(LocalTime.parse("07:30"));
LocalTime类中通过常量可以获得max，min，noon时间。在执行数据库时间范围查询时非常有用。下面代码表示23:59:59.99.
LocalTime maxTime = LocalTime.MAX
下面看看LocalDateTime类。
3.3使用LocalDateTime
LocalDateTime表示日期和时间组合。这时最常用的类，提供了丰富的API.
通过从系统时钟创建：
LocalDateTime.now();
通过工厂方法of或parse创建：
LocalDateTime.of(2015, Month.FEBRUARY, 20, 06, 30);
LocalDateTime.parse("2015-02-20T06:30:00");
提供了工具API实现增加或减少单元日期或时间。如年，月，日，分钟等。
localDateTime.plusDays(1);
localDateTime.minusHours(2);
通过get方法获取时间单元。
localDateTime.getMonth();
4.使用ZonedDateTime
java8提供了ZonedDateTime类，用于处理带时区的日期和时间。ZoneId表示不同的时区。大约有40不同的时区。
下面代码创建一个时区：
ZoneId zoneId = ZoneId.of("Europe/Paris");
获取所有时区集合：
Set allZoneIds = ZoneId.getAvailableZoneIds();
把LocalDateTime转换成特定的时区：
ZonedDateTime zonedDateTime = ZonedDateTime.of(localDateTime, zoneId);
ZonedDateTime提供parse方法获得特定时区的dateTime：
ZonedDateTime.parse("2015-05-03T10:15:30+01:00[Europe/Paris]");
另外和时区一起使用的类是OffsetDateTime类，OffsetDateTime是不变的，表示date-time偏移，存储所有日期和时间字段，精确至纳秒，从UTC/Greenwich计算偏移。
可以通过OffSetDateTime实例结合ZoneOffset创建LocalDateTime。
LocalDateTime localDateTime = LocalDateTime.of(2015, Month.FEBRUARY, 20, 06, 30);
我们创建ZoneOffset，增加两个小时：
ZoneOffset offset = ZoneOffset.of("+02:00");
OffsetDateTime offSetByTwo = OffsetDateTime.of(localDateTime, offset);
先localDateTime的值为 2015-02-20 06:30 +02:00.
下面我们看如何通过Period和Duration类修改日期和时间值。
5.使用Period 和 Duration
Period类代表年,月,日的时间量,Duration类代表秒和纳秒的数量。
5.1使用Period
Period类主要用来修改给定日期值，或获取两日期之间的差值：
LocalDate initialDate = LocalDate.parse("2007-05-10");
通过Period可以操作日期：
LocalDate finalDate = initialDate.plus(Period.ofDays(5));
Period类有不同的get方法，如getYears，getMonths，getDays可以获得不同周期值。下面代码返回5，反应日期间隔：
int five = Period.between(finalDate, initialDate).getDays();
也可以通过ChronoUnit实现通用功能：
int five = ChronoUnit.DAYS.between(initialDate , initialDate);
使用Duration
与Period类似, Duration类用于处理时间， 下面代码创建LocalTime然后增加30秒。
LocalTime initialTime = LocalTime.of(6, 30, 0);
LocalTime finalTime = initialTime.plus(Duration.ofSeconds(30));
两个时间之间间隔通过Duration类获得时间单元。
int thirty = Duration.between(finalTime, initialTime).getSeconds();
通用可以通过ChronoUnit 类获得。
int thirty = ChronoUnit.SECONDS.between(finalTime, initialTime);
兼容原Date and Calendar
java8已经提供了toInstant方法，可以转换Date和Calendar实例至新的DateTime。
下面是原Date类中新增的方法：
public static Date from(Instant instant) {
try {
return new Date(instant.toEpochMilli());
} catch (ArithmeticException ex) {
throw new IllegalArgumentException(ex);
}
}
public Instant toInstant() {
return Instant.ofEpochMilli(getTime());
}
示例转换：
LocalDateTime.ofInstant(date.toInstant(), ZoneId.systemDefault());
LocalDateTime.ofInstant(calendar.toInstant(), ZoneId.systemDefault());
也可以通过Epoch时间构建LocalDateTime，Epoch指的是一个特定的时间：1970-01-01 00:00:00 UTC。
结果为2016-06-13T11:34:50：
LocalDateTime.ofEpochSecond(1465817690, 0, ZoneOffset.UTC);
7.Date and Time 格式化
java8提供了非常简单的方式格式化日期和时间：
LocalDateTime localDateTime = LocalDateTime.of(2015, Month.JANUARY, 25, 6, 30);
下面代码传入一个ISO日期格式去格式化一个本地时间，结果为2015-01-25：
LocalDate localDate = localDateTime.format(DateTimeFormatter.ISO_DATE);
DateTimeFormatter 类提供了多个标准格式选项。也支持自定义的格式。下面示例代码结果为2015/01/25:
localDateTime.format(DateTimeFormatter.ofPattern("yyyy/MM/dd"));
也可以通过格式样式格式化，如SHORT, LONG or MEDIUM 。下面代码输出为25-Jan-2015 06:30:00:
localDateTime
.format(DateTimeFormatter.ofLocalizedDateTime(FormatStyle.MEDIUM)
.withLocale(Locale.UK);
总结
java8提供了丰富的API操作日期时间，相比较原来的API，使用更容易更便捷。如果使用jdk较低版本，可以使用joda库实现，本来java8API就是由joda提供。joda可以通过maven引入：
<dependency>
<groupId>joda-time</groupId>
<artifactId>joda-time</artifactId>
<version>2.9.4</version>
</dependency>
作者：neweastsun 发表于2017/11/24 16:34:02
原文链接
