跟上Java8 - 日期和时间实用技巧

àì夳堔傛蜴生んèń 2022-05-31 13:05 175阅读 0赞

https://zhuanlan.zhihu.com/p/28133858

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

## 现有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);

输出

localDate: 2017-07-20

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);

输出:

23:59:59.999999999
    00:00

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

## LocalDateTime ##

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

获取当前的日期和时间:

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

输出

现在: 2017-07-20T15:17:19.926

下面使用静态方法和字符串的方式分别创建 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());

[joda-time]: http://link.zhihu.com/?target=http%3A//joda-time.sourceforge.net/
[JSR 310]: http://link.zhihu.com/?target=http%3A//jcp.org/en/jsr/detail%3Fid%3D310