java8时间API

曾经终败给现在 2022-05-24 06:44 139阅读 0赞

当你开始使用Java操作日期和时间的时候，会有一些棘手。你也许会通过System.currentTimeMillis() 来返回1970年1月1日到今天的毫秒数。或者使用Date类来操作日期；当遇到加减月份、天数的时候 你又需要用到Calendar类；当需要格式化日期的时候需要使用java.text.DateFormat类。 总而言之在Java中操作日期不是很方便，以至于很多开发者不得不使用第三方库，比如: joda-time。

[![java8-clock][]][java8-clock 1]

## 现有API存在的问题 ##

*  线程安全: Date和Calendar不是线程安全的，你需要编写额外的代码处理线程安全问题
 *  API设计和易用性: 由于Date和Calendar的设计不当你无法完成日常的日期操作
 *  ZonedDate和Time: 你必须编写额外的逻辑处理时区和那些旧的逻辑

好在JSR 310规范中为Java8添加了新的API， 在java.time包中，新的API纠正了过去的缺陷，

## 新的日期API ##

*  ZoneId: 时区ID，用来确定Instant和LocalDateTime互相转换的规则
 *  Instant: 用来表示时间线上的一个点
 *  LocalDate: 表示没有时区的日期, LocalDate是不可变并且线程安全的
 *  LocalTime: 表示没有时区的时间, LocalTime是不可变并且线程安全的
 *  LocalDateTime: 表示没有时区的日期时间, LocalDateTime是不可变并且线程安全的
 *  Clock: 用于访问当前时刻、日期、时间，用到时区
 *  Duration: 用秒和纳秒表示时间的数量

最常用的就是LocalDate、LocalTime、LocalDateTime了，从它们的名字就可以看出是操作日期 和时间的。这些类是主要用于当时区不需要显式地指定的上下文。在本章节中我们将讨论最常用的api。

## LocalDate ##

LocalDate代表一个IOS格式(yyyy-MM-dd)的日期，可以存储 生日、纪念日等日期。 获取当前的日期：

LocalDate localDate = LocalDate.now();
    System.out.println("localDate: " + localDate);

<table style="border-spacing:0px;width:620px;border:0px;margin:0px;padding:0px;font-size:12px;background:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;min-height:auto;"> 
 <tbody style="margin:0px;padding:0px;background:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;width:auto;min-height:auto;"> 
  <tr style="border-top:0px;margin:0px;padding:0px;background:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;width:auto;min-height:auto;"> 
   <td style="border-width:0px;margin:0px;padding:0px;font-size:12px;vertical-align:baseline;background:none;float:none;height:auto;line-height:1.1em;width:auto;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;min-height:auto;color:rgb(175,175,175);"> 
    <div style="border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(108,226,108);margin:0px;padding:0px .5em 0px 1em;background-image:none;float:none;height:auto;line-height:1.1em;text-align:right;vertical-align:baseline;width:auto;min-height:auto;white-space:pre;">
      1 
    </div></td> 
   <td style="width:592px;border-width:0px;margin:0px;padding:0px;font-size:12px;vertical-align:baseline;background:none;float:none;height:auto;line-height:1.1em;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;min-height:auto;"> 
    <div style="margin-left:-10px;width:640px;border:0px;margin-top:0px;margin-right:0px;margin-bottom:0px;padding:0px;background:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;min-height:auto;"> 
     <div style="border:0px;margin:0px;padding:0px 1em;background-image:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;width:auto;min-height:auto;white-space:pre;"> 
      <code style="border:0px;margin:0px;padding:0px;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;background:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;width:auto;min-height:auto;color:#000000;">localDate: </code> 
      <code style="border:0px;margin:0px;padding:0px;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;background:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;width:auto;min-height:auto;color:rgb(0,153,0);">2017</code> 
      <code style="border:0px;margin:0px;padding:0px;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;background:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;width:auto;min-height:auto;color:#000000;">-</code> 
      <code style="border:0px;margin:0px;padding:0px;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;background:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;width:auto;min-height:auto;color:rgb(0,153,0);">07</code> 
      <code style="border:0px;margin:0px;padding:0px;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;background:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;width:auto;min-height:auto;color:#000000;">-</code> 
      <code style="border:0px;margin:0px;padding:0px;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;background:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;width:auto;min-height:auto;color:rgb(0,153,0);">20</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

LocalDate可以指定特定的日期，调用of或parse方法返回该实例：

LocalDate.of(2017, 07, 20);
    LocalDate.parse("2017-07-20");

当然它还有一些其他方法，我们一起来看看：

为今天添加一天，也就是获取明天

LocalDate tomorrow = LocalDate.now().plusDays(1);

从今天减去一个月

LocalDate prevMonth = LocalDate.now().minus(1, ChronoUnit.MONTHS);

下面写两个例子，分别解析日期 2017-07-20，获取每周中的星期和每月中的日：

DayOfWeek thursday = LocalDate.parse("2017-07-20").getDayOfWeek();
    System.out.println("周四: " + thursday);
    int twenty = LocalDate.parse("2017-07-20").getDayOfMonth();
    System.out.println("twenty: " + twenty);

试试今年是不是闰年:

boolean leapYear = LocalDate.now().isLeapYear();
    System.out.println("是否闰年: " + leapYear);

判断是否在日期之前或之后:

boolean notBefore = LocalDate.parse("2017-07-20")
                    .isBefore(LocalDate.parse("2017-07-22"));
    System.out.println("notBefore: " + notBefore);
    boolean isAfter = LocalDate.parse("2017-07-20").isAfter(LocalDate.parse("2017-07-22"));
    System.out.println("isAfter: " + isAfter);

获取这个月的第一天:

LocalDate firstDayOfMonth = LocalDate.parse("2017-07-20")
                    .with(TemporalAdjusters.firstDayOfMonth());
    System.out.println("这个月的第一天: " + firstDayOfMonth);
    firstDayOfMonth = firstDayOfMonth.withDayOfMonth(1);
    System.out.println("这个月的第一天: " + firstDayOfMonth);

判断今天是否是我的生日，例如我的生日是 2009-07-20

LocalDate birthday = LocalDate.of(2009, 07, 20);
    MonthDay birthdayMd = MonthDay.of(birthday.getMonth(), birthday.getDayOfMonth());
    MonthDay today = MonthDay.from(LocalDate.now());
    System.out.println("今天是否是我的生日: " + today.equals(birthdayMd));

## LocalTime ##

LocalTime表示一个时间，而不是日期，下面介绍一下它的使用方法。

获取现在的时间，输出15:01:22.144

LocalTime now = LocalTime.now();
    System.out.println("现在的时间: " + now);

将一个字符串时间解析为LocalTime，输出15:02

LocalTime nowTime = LocalTime.parse("15:02");
    System.out.println("时间是: " + nowTime);

使用静态方法of创建一个时间

LocalTime nowTime = LocalTime.of(15, 02);
    System.out.println("时间是: " + nowTime);

使用解析字符串的方式并添加一小时，输出16:02

LocalTime nextHour = LocalTime.parse("15:02").plus(1, ChronoUnit.HOURS);
    System.out.println("下一个小时: " + nextHour);

获取时间的小时、分钟

int hour = LocalTime.parse("15:02").getHour();
    System.out.println("小时: " + hour);
    int minute = LocalTime.parse("15:02").getMinute();
    System.out.println("分钟: " + minute);

我们也可以通过之前类似的API检查一个时间是否在另一个时间之前、之后

boolean isBefore = LocalTime.parse("15:02").isBefore(LocalTime.parse("16:02"));
    boolean isAfter = LocalTime.parse("15:02").isAfter(LocalTime.parse("16:02"));
    System.out.println("isBefore: " + isBefore);
    System.out.println("isAfter: " + isAfter);

输出 isBefore: true, isAfter: false。

在LocalTime类中也将每天的开始和结束作为常量供我们使用:

System.out.println(LocalTime.MAX);
    System.out.println(LocalTime.MIN);

输出:

LocalTime就这些了，下面我们来了解一下LocalDateTime

## LocalDateTime ##

LocalDateTime是用来表示日期和时间的，这是一个最常用的类之一。

获取当前的日期和时间:

LocalDateTime now = LocalDateTime.now();
    System.out.println("现在: " + now);

输出

下面使用静态方法和字符串的方式分别创建LocalDateTime对象

LocalDateTime.of(2017, Month.JULY, 20, 15, 18);
    LocalDateTime.parse("2017-07-20T15:18:00");
    ``
    同时`LocalDateTime`也提供了相关API来对日期和时间进行增减操作:
    ```java
    LocalDateTime tomorrow = now.plusDays(1);
    System.out.println("明天的这个时间: " + tomorrow);
    LocalDateTime minusTowHour = now.minusHours(2);
    System.out.println("两小时前: " + minusTowHour);

这个类也提供一系列的get方法来获取特定单位:

Month month = now.getMonth();
    System.out.println("当前月份: " + month);

## 日期格式化 ##

在日常开发中我们用到最多的也许就是日期、时间的格式化了，那在Java8种该如何操作呢？

LocalDateTime now = LocalDateTime.now();
    DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
    System.out.println("默认格式化: " + now);
    System.out.println("自定义格式化: " + now.format(dateTimeFormatter));
    LocalDateTime localDateTime = LocalDateTime.parse("2017-07-20 15:27:44", dateTimeFormatter);
    System.out.println("字符串转LocalDateTime: " + localDateTime);

也可以使用DateTimeFormatter的format方法将日期、时间格式化为字符串

DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
    String dateString = dateTimeFormatter.format(LocalDate.now());
    System.out.println("日期转字符串: " + dateString);

## 日期周期 ##

Period类用于修改给定日期或获得的两个日期之间的区别。

给初始化的日期添加5天:

LocalDate initialDate = LocalDate.parse("2017-07-20");
    LocalDate finalDate = initialDate.plus(Period.ofDays(5));
    System.out.println("初始化日期: " + initialDate);
    System.out.println("加日期之后: " + finalDate);

周期API中提供给我们可以比较两个日期的差别，像下面这样获取差距天数:

long between = ChronoUnit.DAYS.between(initialDate, finalDate);
    System.out.println("差距天数: " + between);

上面的代码会返回5，当然你想获取两个日期相差多少小时也是简单的。

## 与遗留代码转换 ##

在之前的代码中你可能出现了大量的Date类，如何将它转换为Java8种的时间类呢？

Date和Instant互相转换

Date date = Date.from(Instant.now());
    Instant instant = date.toInstant();

Date转换为LocalDateTime

LocalDateTime localDateTime = LocalDateTime.from(new Date());
    System.out.println(localDateTime);

LocalDateTime转Date

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

LocalDate转Date

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

转载自： [http://www.importnew.com/26129.html][http_www.importnew.com_26129.html]

[java8-clock]: /images/20220524/2d5c236a81df456da9d22df8f32417f3.png
[java8-clock 1]: http://www.importnew.com/26129.html/java8-clock
[http_www.importnew.com_26129.html]: http://www.importnew.com/26129.html