Java 8 日期时间 API

Java 8通过发布新的Date-Time API (JSR 310)来进一步加强对日期与时间的处理。

在旧版的 Java 中,日期时间 API 存在诸多问题,其中有:

  • 非线程安全 − java.util.Date 是非线程安全的,所有的日期类都是可变的,这是Java日期类最大的问题之一。

  • 设计很差 − Java的日期/时间类的定义并不一致,在java.util和java.sql的包中都有日期类,此外用于格式化和解析的类在java.text包中定义。java.util.Date同时包含日期和时间,而java.sql.Date仅包含日期,将其纳入java.sql包并不合理。另外这两个类都有相同的名字,这本身就是一个非常糟糕的设计。

  • 时区处理麻烦 − 日期类并不提供国际化,没有时区支持,因此Java引入了java.util.Calendar和java.util.TimeZone类,但他们同样存在上述所有的问题。

Java 8 在 java.time 包下提供了很多新的 API。以下为两个比较重要的 API:

  • Local(本地) − 简化了日期时间的处理,没有时区的问题。

  • Zoned(时区) − 通过制定的时区处理日期时间。

新的java.time包涵盖了所有处理日期,时间,日期/时间,时区,时刻(instants),过程(during)与时钟(clock)的操作。

本地化日期时间 API

LocalDate/LocalTime 和 LocalDateTime 类可以在处理时区不是必须的情况。代码如下:

Java8Tester.java 文件

  1. import java.time.LocalDate;
  2. import java.time.LocalTime;
  3. import java.time.LocalDateTime;
  4. import java.time.Month;
  5. public class Java8Tester {
  6. public static void main(String args[]){
  7. Java8Tester java8tester = new Java8Tester();
  8. java8tester.testLocalDateTime();
  9. }
  10. public void testLocalDateTime(){
  11. // 获取当前的日期时间
  12. LocalDateTime currentTime = LocalDateTime.now();
  13. System.out.println("当前时间: " + currentTime);
  14. LocalDate date1 = currentTime.toLocalDate();
  15. System.out.println("date1: " + date1);
  16. Month month = currentTime.getMonth();
  17. int day = currentTime.getDayOfMonth();
  18. int seconds = currentTime.getSecond();
  19. System.out.println("月: " + month +", 日: " + day +", 秒: " + seconds);
  20. LocalDateTime date2 = currentTime.withDayOfMonth(10).withYear(2012);
  21. System.out.println("date2: " + date2);
  22. // 12 december 2014
  23. LocalDate date3 = LocalDate.of(2014, Month.DECEMBER, 12);
  24. System.out.println("date3: " + date3);
  25. // 22 小时 15 分钟
  26. LocalTime date4 = LocalTime.of(22, 15);
  27. System.out.println("date4: " + date4);
  28. // 解析字符串
  29. LocalTime date5 = LocalTime.parse("20:15:30");
  30. System.out.println("date5: " + date5);
  31. }
  32. }

执行以上脚本,输出结果为:

  1. $ javac Java8Tester.java
  2. $ java Java8Tester
  3. 当前时间: 2016-04-15T16:55:48.668
  4. date1: 2016-04-15
  5. 月: APRIL, 日: 15, 秒: 48
  6. date2: 2012-04-10T16:55:48.668
  7. date3: 2014-12-12
  8. date4: 22:15
  9. date5: 20:15:30

使用时区的日期时间API

如果我们需要考虑到时区,就可以使用时区的日期时间API:

Java8Tester.java 文件

  1. import java.time.ZonedDateTime;
  2. import java.time.ZoneId;
  3. public class Java8Tester {
  4. public static void main(String args[]){
  5. Java8Tester java8tester = new Java8Tester();
  6. java8tester.testZonedDateTime();
  7. }
  8. public void testZonedDateTime(){
  9. // 获取当前时间日期
  10. ZonedDateTime date1 = ZonedDateTime.parse("2015-12-03T10:15:30+05:30[Asia/Shanghai]");
  11. System.out.println("date1: " + date1);
  12. ZoneId id = ZoneId.of("Europe/Paris");
  13. System.out.println("ZoneId: " + id);
  14. ZoneId currentZone = ZoneId.systemDefault();
  15. System.out.println("当期时区: " + currentZone);
  16. }
  17. }

执行以上脚本,输出结果为:

  1. $ javac Java8Tester.java
  2. $ java Java8Tester
  3. date1: 2015-12-03T10:15:30+08:00[Asia/Shanghai]
  4. ZoneId: Europe/Paris
  5. 当期时区: Asia/Shanghai