Java8中关于日期和时间API的20个使用示例
Java
后端 2018-09-13

一、前言

随着lambda表达式、streams以及一系列小优化，Java8推出了全新的日期时间API，在一下的指南中我们将通过一些简单的示例来学习如何使用新API。Java处理日期、日历和时间的方式一直为社区所诟病，将java.util.Date设定为可变类型，以及SimpleDateFormat的非线程安全使其应用非常受限。Java也意识到需要一个更好的API来满足社区中已经习惯了使用JodaTime API的人们。全新API的众多好处之一就是，明确了日期时间概念，例如：瞬时（instant）、期间（duration）、日期、时间、时区和周期。同时继承了Joda库按人类语言和计算机各自解析的时间处理方式。不同于老版本，新API基于ISO标准日历系统，java.time包下的所有类都是不可变类型而且线程安全。下面是新版API中java.time包里的一些关键类：

  • Instant：瞬时实例。
  • LocalDate：本地日期，不包含具体时间。例如：2014-01-14可以用来记录生日、纪念日、加盟日等。
  • LocalTime：本地时间，不包含日期。
  • LocalDateTime：组合了日期和时间，但不包含时差和时区信息。
  • ZonedDateTime：最完整的日期时间，包含时区和相对UTC或格林威治的时差。

新API还引入了ZoneOffSet和ZoneId类，使得解决时区问题更为简便。解析和格式化时间的DateTimeFormatter类也全部重新设计。注意，这篇文章是翻译自Java 8 - 20 Examples of Date and Time API，以下示例代码我做过一些简单的修改，当运行这些例子时会返回你当前的时间。

二、在Java8中如何处理日期和时间

常有人问我学习一个新库的最好方式是什么？我的答案是在实际项目中使用它。项目中有很多真正的需求驱使开发者去发掘并学习新库。简单得说就是任务驱动学习探索。这对Java8新日期时间API也不例外。我创建了20个基于任务的实例来学习Java8的新特性。从最简单创建当天的日期开始，然后创建时间及时区，接着模拟一个日期提醒应用中的任务——计算重要日期的到期天数，例如生日、纪念日、账单日、保费到期日、信用卡过期日等。

示例 1、在Java8中获取今天的日期

Java8中的LocalDate用于表示当天日期。和java.util.Date不同，它只有日期，不包含时间。当你仅需要表示日期时就用这个类。

LocalDate today = LocalDate.now();
System.out.println("今天的日期是：" + today);

// 今天的日期是：2016-04-18

上面的代码创建了当天的日期，不含时间信息。打印出的日期格式非常友好，不像老的Date类打印出一堆没有格式化的信息。

示例 2、在Java8中获取当前的年、月、日信息

LocalDate类提供了获取年、月、日的快捷方法，其实例还包含很多其它的日期属性。通过调用这些方法就可以很方便的得到需要的日期信息，不用像以前一样需要依赖java.util.Calendar类了。

LocalDate today = LocalDate.now();
int year = today.getYear();
int month = today.getMonthValue();
int day = today.getDayOfMonth();
System.out.printf("当前的年 : %d  月 : %d  日 : %d%n", year, month, day);

// 当前的年 : 2016  月 : 4  日 : 18

看到了吧，在Java8中得到年、月、日信息是这么简单直观，想用就用，没什么需要记的。对比看看以前Java是怎么处理年月日信息的吧。

示例 3、在Java8中获取特定日期

在第一个例子里，我们通过静态工厂方法now()非常容易地创建了当天日期，你还可以调用另一个有用的工厂方法LocalDate.of()创建任意日期，该方法需要传入年、月、日做参数，返回对应的LocalDate实例。这个方法的好处是没再犯老API的设计错误，比如年度起始于1900，月份是从0开始等等。日期所见即所得，就像下面这个例子表示了1月14日，没有任何隐藏机关。

LocalDate dateOfBirth = LocalDate.of(2016, 4, 18);
System.out.println("你的出生日期是：" + dateOfBirth);

// 你的出生日期是：2016-04-18

可以看到创建的日期完全符合预期，与你写入的2016年4月18日完全一致。

示例 4、在Java8中判断两个日期是否相等

现实生活中有一类时间处理就是判断两个日期是否相等。你常常会检查今天是不是个特殊的日子，比如生日、纪念日或非交易日。这时就需要把指定的日期与某个特定日期做比较，例如判断这一天是否是假期。下面这个例子会帮助你用Java8的方式去解决，你肯定已经想到了，LocalDate重载了equal方法，请看下面的例子：

LocalDate today = LocalDate.now();
LocalDate date1 = LocalDate.of(2016, 4, 18);
if (date1.equals(today)) {
    System.out.printf("今天 %s 和 date1 %s 是同一天!%n", today, date1);
}

// 今天 2016-04-18 和 date1 2016-04-18 是同一天!

这个例子中我们比较的两个日期相同。注意，如果比较的日期是字符型的，需要先解析成日期对象再作判断。对比Java老的日期比较方式，你会感到清风拂面。

示例 5、在Java8中检查像生日这种周期性事件

Java中另一个日期时间的处理就是检查类似每月账单、结婚纪念日、EMI日或保险缴费日这些周期性事件。如果你在电子商务网站工作，那么一定会有一个模块用来在圣诞节、感恩节这种节日时向客户发送问候邮件。Java中如何检查这些节日或其它周期性事件呢？答案就是MonthDay类。这个类组合了月份和日，去掉了年，这意味着你可以用它判断每年都会发生事件。和这个类相似的还有一个YearMonth类。这些类也都是不可变并且线程安全的值类型。下面我们通过MonthDay来检查周期性事件：

LocalDate today = LocalDate.now();
LocalDate dateOfBirth = LocalDate.of(2016, 4, 18);
MonthDay birthday = MonthDay.of(dateOfBirth.getMonth(), dateOfBirth.getDayOfMonth());
MonthDay currentMonthDay = MonthDay.from(today);

if(currentMonthDay.equals(birthday)){
    System.out.println("好高兴今天是您的生日!!");
}else{
    System.out.println("对不起，今天不是您的生日!!");
}

// 好高兴今天是您的生日!!

只要当天的日期和生日匹配，无论是哪一年都会打印出祝贺信息。你可以把程序整合进系统时钟，看看生日时是否会受到提醒，或者写一个单元测试来检测代码是否运行正确。

示例 6、在Java8中获取当前时间

与Java8获取日期的例子很像，获取时间使用的是LocalTime类，一个只有时间没有日期的LocalDate的近亲。可以调用静态工厂方法now()来获取当前时间。默认的格式是hh:mm:ss:nnn。对比一下Java8之前获取当前时间的方式。

LocalTime time = LocalTime.now();
System.out.println("当前时间是:" + time);

// 当前时间是:23:43:42.200

可以看到当前时间就只包含时间信息，没有日期。

示例 7、如何在现有的时间上增加小时

通过增加小时、分、秒来计算将来的时间很常见。Java8除了不变类型和线程安全的好处之外，还提供了更好的plusHours()方法替换add()，并且是兼容的。注意，这些方法返回一个全新的LocalTime实例，由于其不可变性，返回后一定要用变量赋值。

LocalTime time = LocalTime.now();
LocalTime newTime = time.plusHours(2); // 添加两小时
System.out.println("当前时间:" + time + ",两小时后的时间: " +  newTime);

// 当前时间:23:50:56.195,两小时后的时间: 01:50:56.195

可以看到，新的时间在当前时间23:50:56.195的基础上增加了2个小时。和旧版Java的增减时间的处理方式对比一下，看看哪种更好。

示例 8、如何计算一周后的日期

和上个例子计算两小时以后的时间类似，这个例子会计算一周后的日期。LocalDate日期不包含时间信息，它的plus()方法用来增加天、周、月，ChronoUnit类声明了这些时间单位。由于LocalDate也是不变类型，返回后一定要用变量赋值。

LocalDate today = LocalDate.now();
LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);
System.out.println("今天是:" + today + ",一周以后的日期: " + nextWeek);

// 今天是:2016-04-18,一周以后的日期: 2016-04-25

可以看到新日期离当天日期是7天，也就是一周。你可以用同样的方法增加1个月、1年、1小时、1分钟甚至一个世纪，更多选项可以查看Java 8 API中的ChronoUnit类。

示例 9、计算一年前或一年后的日期

继续上面的例子，上个例子中我们通过LocalDate的plus()方法增加天数、周数或月数，这个例子我们利用minus()方法计算一年前的日期。

LocalDate today = LocalDate.now();
LocalDate preYear = today.minus(1, ChronoUnit.YEARS);
LocalDate nextYear = today.plus(1, ChronoUnit.YEARS);
System.out.println("今天是:" + today + ",一年前的日期: " + preYear + ",一年后的日期: " + nextYear);

// 今天是:2016-04-18,一年前的日期: 2015-04-18,一年后的日期: 2017-04-18

例子结果中得到了两个日期，一个2015年、一个2017年、分别是2016年的前一年和后一年。

示例 10、使用Java8的Clock时钟类

Java8增加了一个Clock时钟类用于获取当时的时间戳，或当前时区下的日期时间信息。以前用到System.currentTimeInMillis()和TimeZone.getDefault()的地方都可用Clock替换。

// 得到UTC的时区的日期时间clock对象
Clock clock = Clock.systemUTC();
System.out.println("Clock : " + clock);
// Clock : SystemClock[Z]

// 得到基于当前时区的日期时间clock对象
Clock defaultClock = Clock.systemDefaultZone();
System.out.println("Clock : " + clock);

// Clock : SystemClock[Z]

还可以针对clock时钟做比较，像下面这个例子：

public class MyClass {
    // 依赖注入
    private Clock clock;
    ...
    public void process(LocalDate eventDate) {
        if (eventDate.isBefore(LocalDate.now(clock)) {
            ...
        }
    }
}

这种方式在不同时区下处理日期时会非常管用。

示例 11、如何用Java判断日期是早于还是晚于另一个日期

另一个工作中常见的操作就是如何判断给定的一个日期是大于某天还是小于某天？在Java8中，LocalDate类有两类方法isBefore()和isAfter()用于比较日期。调用isBefore()方法时，如果给定日期小于当前日期则返回true。

LocalDate today = LocalDate.now();

LocalDate tomorrow = LocalDate.of(2016, 4, 19);
if (tomorrow.isAfter(today)) {
    System.out.println("明天晚于今天！");
}
// 明天晚于今天！

LocalDate yesterday = today.minus(1, ChronoUnit.DAYS);
if (yesterday.isBefore(today)) {
    System.out.println("昨天先于今天！");
}
// 昨天先于今天！

在Java 8中比较日期非常方便，不需要使用额外的Calendar类来做这些基础工作了。

示例 12、在Java8中处理时区

Java8不仅分离了日期和时间，也把时区分离出来了。现在有一系列单独的类如ZoneId来处理特定时区，ZoneDateTime类来表示某时区下的时间。这在Java8以前都是GregorianCalendar类来做的。下面这个例子展示了如何把本时区的时间转换成另一个时区的时间。

// Java 8中某时区下的日期和时间
ZoneId america = ZoneId.of("America/New_York");
LocalDateTime localtDateAndTime = LocalDateTime.now();
ZonedDateTime dateAndTimeInNewYork  = ZonedDateTime.of(localtDateAndTime, america );
System.out.println("Current date and time in a particular timezone : " + dateAndTimeInNewYork);

// Current date and time in a particular timezone : 2016-04-19T23:10:09.251-04:00[America/New_York]

和以前使用GMT的方式转换本地时间对比一下。注意，在Java8以前，一定要牢牢记住时区的名称，不然就会抛出下面的异常：

Exception in thread "main" java.time.zone.ZoneRulesException: Unknown time-zone ID: ASIA/Tokyo
        at java.time.zone.ZoneRulesProvider.getProvider(ZoneRulesProvider.java:272)
        at java.time.zone.ZoneRulesProvider.getRules(ZoneRulesProvider.java:227)
        at java.time.ZoneRegion.ofId(ZoneRegion.java:120)
        at java.time.ZoneId.of(ZoneId.java:403)
        at java.time.ZoneId.of(ZoneId.java:351)

示例 13、如何表示信用卡到期这类固定日期，答案就在YearMonth

与MonthDay检查重复事件的例子相似，YearMonth是另一个组合类，用于表示信用卡到期日、FD到期日、期货期权到期日等。还可以用这个类得到当月共有多少天，YearMonth实例的lengthOfMonth()方法可以返回当月的天数，在判断2月有28天还是29天时非常有用。

YearMonth currentYearMonth = YearMonth.now();
System.out.printf("该月的天数 %s: %d%n", currentYearMonth, currentYearMonth.lengthOfMonth());
// 该月的天数 2016-04: 30

YearMonth creditCardExpiry = YearMonth.of(2018, Month.FEBRUARY);
System.out.printf("您的信用卡到期是： %s%n", creditCardExpiry);
// 您的信用卡到期是： 2018-02

根据上述数据，你可以提醒客户信用卡快要到期了，个人认为这个类非常有用。

示例 14、如何在Java8中检查闰年

LocalDate类有一个很实用的方法isLeapYear()判断该实例是否是一个闰年，如果你还是想重新发明轮子，这有一个代码示例，纯Java逻辑编写的判断闰年的程序。

LocalDate today = LocalDate.now();
if (today.isLeapYear()) {
    System.out.println("今年是闰年！");
} else {
    System.out.println("今年不是闰年！");
}

// 今年是闰年！

你可以多写几个日期来验证是否是闰年，最好是写JUnit单元测试做判断。

示例 15、计算两个日期之间的天数和月数

有一个常见日期操作是计算两个日期之间的天数、周数或月数。在Java8中可以用java.time.Period类来做计算。下面这个例子中，我们计算了当天和将来某一天之间的月数。

LocalDate today = LocalDate.now();
LocalDate java8Release = LocalDate.of(2016, Month.APRIL, 21);
Period periodToNext = Period.between(today, java8Release);
System.out.println("2016年4月21日距离今天的天数：" + periodToNext.getDays() );

// 2016年4月21日距离今天的天数：3

从上面可以看到现在是一月，Java8的中计算的当前日期是4月18日，中间相隔3天。

示例 16、包含时差信息的日期和时间

在Java8中，ZoneOffset类用来表示时区，举例来说印度与GMT或UTC标准时区相差+05:30，可以通过ZoneOffset.of()静态方法来 获取对应的时区。一旦得到了时差就可以通过传入LocalDateTime和ZoneOffset来创建一个OffSetDateTime对象。

LocalDateTime datetime = LocalDateTime.of(2016, Month.APRIL, 19, 23, 35);
ZoneOffset offset = ZoneOffset.of("+05:30");
OffsetDateTime date = OffsetDateTime.of(datetime, offset);
System.out.println("包含时差信息的日期和时间 : " + date);

//包含时差信息的日期和时间 : 2016-04-19T23:35+05:30

现在的时间信息里已经包含了时区信息了。注意：OffSetDateTime是对计算机友好的，ZoneDateTime则对人更友好。

示例 17、在Java8中获取当前的时间戳

如果你还记得Java8以前是如何获得当前时间戳，那么现在你终于解脱了。Instant类有一个静态工厂方法now()会返回当前的时间戳，如下所示：

Instant timestamp = Instant.now();
System.out.println("时间戳是：" + timestamp);

// 时间戳是：2016-04-18T15:41:06.876Z

时间戳信息里同时包含了日期和时间，这和java.util.Date很像。实际上Instant类确实等同于Java8之前的Date类，你可以使用Date类和Instant类各自的转换方法互相转换，例如：Date.from(Instant) 将Instant转换成java.util.Date，Date.toInstant()则是将Date类转换成Instant类。

示例 18、在Java8中如何使用预定义的格式化工具去解析或格式化日期

在Java8以前的世界里，日期和时间的格式化非常诡异，唯一的帮助类SimpleDateFormat也是非线程安全的，而且用作局部变量解析和格式化日期时显得很笨重。幸好线程局部变量能使它在多线程环境中变得可用，不过这都是过去时了。Java8引入了全新的日期时间格式工具，线程安全而且使用方便。它自带了一些常用的内置格式化工具。下面这个例子使用了BASIC_ISO_DATE格式化工具将2016年4月18日格式化成20160418。

String day = "20160418";
LocalDate formatted = LocalDate.parse(day, DateTimeFormatter.BASIC_ISO_DATE);
System.out.printf("从字符串中解析的日期: %s 是 %s %n", day, formatted);

// 从字符串中解析的日期: 20160418 是 2016-04-18

很明显的看出得到的日期和给出的日期是同一天，但是格式不同。

示例 19、如何在Java中使用自定义格式化工具解析日期

上个例子使用了Java内置的格式化工具去解析日期字符串。尽管内置格式化工具很好用，有时还是需要定义特定的日期格式，下面这个例子展示了如何创建自定义日期格式化工具。例子中的日期格式是“MMM dd yyyy”。可以调用DateTimeFormatter的ofPattern()静态方法并传入任意格式返回其实例，格式中的字符和以前代表的一样，M代表月，m代表分。如果格式不规范会抛出DateTimeParseException异常，不过如果只是把M写成m这种逻辑错误是不会抛异常的。

String day = "2016 04 18";
try {
    DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy MM dd");
    LocalDate holiday = LocalDate.parse(day, formatter);
    System.out.printf("成功解析字符串：%s, 时间是：%s%n", day, holiday);
} catch (DateTimeParseException ex) {
    System.out.printf("%s 解析失败!", day);
    ex.printStackTrace();
}

// 成功解析字符串：2016 04 18, 时间是：2016-04-18

日期值与传入的字符串是匹配的，只是格式不同而已。

示例 20、在Java8中如何把日期转换成字符串

上 两个例子都用到了DateTimeFormatter类，主要是从字符串解析日期。现在我们反过来，把LocalDateTime日期实例转换成特定格式的字符串。这是迄今为止Java日期转字符串最为简单的方式了。下面的例子将返回一个代表日期的格式化字符串。和前面类似，还是需要创建DateTimeFormatter实例并传入格式，但这回调用的是format()方法，而非parse()方法。这个方法会把传入的日期转化成指定格式的字符串。

LocalDateTime arrivalDate  = LocalDateTime.now();
try {
    DateTimeFormatter format = DateTimeFormatter.ofPattern("MMM dd yyyy  hh:mm a");
    String landing = arrivalDate.format(format);
    System.out.printf("格式化的日期时间:  %s %n", landing);
} catch (DateTimeException ex) {
    System.out.printf("%s 不能格式化!%n", arrivalDate);
    ex.printStackTrace();
}

// 格式化的日期时间:  四月 19 2016  12:02 上午

当前时间被指定的“MMM dd yyyy hh:mm a”格式格式化，格式包含3个代表月的字符串，时间后面带有AM和PM标记。

Java 8日期时间API的重点

通过这些例子，你肯定已经掌握了Java8日期时间API的新知识点。现在我们来回顾一下这个优雅API的使用要点：

  1. 提供了javax.time.ZoneId获取时区。
  2. 提供了LocalDate`和LocalTime`类。
  3. Java8的所有日期和时间API都是不可变类并且线程安全，而现有的Date和Calendar API中的java.util.Date和SimpleDateFormat是非线程安全的。
  4. 主包是java.time,包含了表示日期、时间、时间间隔的一些类。里面有两个子包java.time.format用于格式化， java.time.temporal用于更底层的操作。
  5. 时区代表了地球上某个区域内普遍使用的标准时间。每个时区都有一个代号，格式通常由区域/城市构成（Asia/Tokyo），在加上与格林威治或UTC的时差。例如：东京的时差是+09:00。
  6. OffsetDateTime类实际上组合了LocalDateTime类和ZoneOffset类。用来表示包含和格林威治或UTC时差的完整日期（年、月、日）和时间（时、分、秒、纳秒）信息。
  7. DateTimeFormatter类用来格式化和解析时间。与SimpleDateFormat不同，这个类不可变并且线程安全，需要时可以给静态常量赋值。DateTimeFormatter类提供了大量的内置格式化工具，同时也允许你自定义。在转换方面也提供了parse()将字符串解析成日期，如果解析出错会抛出DateTimeParseException。DateTimeFormatter类同时还有format()用来格式化日期，如果出错会抛出DateTimeException异常。
  8. 再补充一点，日期格式“MMM d yyyy”和“MMM dd yyyy”有一些微妙的不同，第一个格式可以解析“Jan 2 2014”和“Jan 14 2014”，而第二个在解析“Jan 2 2014”就会抛异常，因为第二个格式里要求日必须是两位的。如果想修正，你必须在日期只有个位数时在前面补零，就是说“Jan 2 2014”应该写成 “Jan 02 2014”。

如何使用Java8的全新日期时间API就介绍到这了。这些简单的例子对帮助理解新API非常有用。由于这些例子都基于真实任务，你在做Java日期编程时不用再东张西望了。我们学会了如何创建并操作日期实例，学习了纯日期、以及包含时间信息和时差信息的日期、学会了怎样计算两个日期的间隔，这些在计算当天与某个特定日期间隔的例子中都有所展示。 我们还学到了在Java8中如何线程安全地解析和格式化日期，不用再使用蹩脚的线程局部变量技巧，也不用依赖Joda Time第三方库。新API可以作为处理日期时间操作的标准。

如果你喜欢这个教程并希望看到更多关于Java 8的教程，下面这些精彩的文章都值得一看：

  • 如何在Java8中用一行代码搞定文件读取？(示例)
  • 学习Java8的十大教程（教程）
  • 免费的Java8教程和图书 （资源）
  • Java 8 Comparator例子 （示例）
  • 如何使用Java8的Map函数（示例）
  • 你准备好学习Java8的认证了吗 （更多）
  • 如何使用Java8的默认方法。（看这里）
  • 开始Java8之前需要温习的十个Java 7特性（更多）
  • Java8学习Stream API十例（示例）
  • 如何在匿名类中使用Lambda表达式（答案）
  • 如何使用Java8的Predicates类过滤Collection？（答案）
  • Java中如何随即访问文件？（答案）
赏

Reprint please specify: Blog4Jun Java8中关于日期和时间API的20个使用示例

Previous
Apache Commons Collections包和简介 Apache Commons Collections包和简介
背景介绍Apache Commons是Apache软件基金会的项目，曾经隶属于Jakarta项目。Commons的目的是提供可重用的、解决各种实际的通用问题且开源的Java代码。Commons由三部分组成：Proper（是一些已发布的项目）
2018-09-13 后端
Java Apache
Next
我对我的部分同学非常失望！懒惰、愚蠢、耍小心机 我对我的部分同学非常失望！懒惰、愚蠢、耍小心机
我对我的部分同学非常失望！懒惰、愚蠢、耍小心机,他们竟然把学校学生会的那一套带到了公司，真的担心他们教坏学弟学妹！这群人只配做一些低级码农，全然没有珍惜时间的概念和大学生应有的活力和朝气。
2018-09-02 相册
Java