别用Date了，Java8新特性之日期处理，现在学会也不迟！

小Hub领读：

前天小Hub发了一篇《SpringBoot 全局日期格式化（基于注解）》文章，很多读者都指出了文中几个不严谨的地方，其中关于实体类中使用Date类型线程不安全。在JDK8中我们已经开始使用LocalDateTime，那么对于这个类的用法，如果有同学不了解的话，来看看下面的文章，小Hub看了一遍，觉得作者写得很详细了，对比式写法，更加通俗易懂！

看完别忘了在文末右下角点个[在看]赞一赞噢~

---

作者：WayfreemBlog

来源：segmentfault.com/a/1190000012922933

简介

伴随 lambda表达式、 streams 以及一系列小优化，Java 8 推出了全新的日期时间API。

Java处理日期、日历和时间的不足之处：将 java.util.Date 设定为可变类型，以及 SimpleDateFormat 的非线程安全使其应用非常受限。然后就在 java8 上面增加新的特性。

全新API的众多好处之一就是，明确了日期时间概念，例如： 瞬时（instant）、 长短（duration）、 日期、 时间、 时区和 周期。

同时继承了Joda 库按人类语言和计算机各自解析的时间处理方式。不同于老版本，新API基于ISO标准日历系统，java.time包下的所有类都是不可变类型而且线程安全。

关键类

• Instant：瞬时实例。

• LocalDate：本地日期，不包含具体时间 例如：2014-01-14 可以用来记录生日、纪念日、加盟日等。

• LocalTime：本地时间，不包含日期。

• LocalDateTime：组合了日期和时间，但不包含时差和时区信息。

• ZonedDateTime：最完整的日期时间，包含时区和相对UTC或格林威治的时差。

新API还引入了 ZoneOffSet 和 ZoneId 类，使得解决时区问题更为简便。解析、格式化时间的 DateTimeFormatter 类也全部重新设计。

实战

在教程中我们将通过一些简单的实例来学习如何使用新API，因为只有在实际的项目中用到，才是学习新知识以及新技术最快的方式。

1. 获取当前的日期

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

1. //获取今天的日期

2. public void getCurrentDate(){

3. LocalDate today = LocalDate.now();

4. System.out.println("Today's Local date : " + today);

5. //这个是作为对比

6. Date date = new Date();

7. System.out.println(date);

8. }

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

2. 获取年、月、日信息

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

1. //获取年、月、日信息

2. public void getDetailDate(){

3. LocalDate today = LocalDate.now();

4. int year = today.getYear();

5. int month = today.getMonthValue();

6. int day = today.getDayOfMonth();

7. System.out.printf("Year : %d Month : %d day : %d t %n", year, month, day);

8. }

3.处理特定日期

在第一个例子里，我们通过静态工厂方法now()非常容易地创建了当天日期。

我们还可以调用另一个有用的工厂方法 LocalDate.of() 创建任意日期， 该方法需要传入年、月、日做参数，返回对应的LocalDate实例。这个方法的好处是没再犯老API的设计错误，比如年度起始于1900，月份是从 0 开始等等。日期所见即所得，就像下面这个例子表示了1月21日，直接明了。

1. //处理特定日期

2. public void handleSpecilDate(){

3. LocalDate dateOfBirth = LocalDate.of(2018, 01, 21);

4. System.out.println("The specil date is : " + dateOfBirth);

5. }

4.判断两个日期是否相等

现实生活中有一类时间处理就是判断两个日期是否相等。在项目开发的时候总会遇到这样子的问题。

下面这个例子会帮助你用Java 8的方式去解决， LocalDate 重载了equal方法。

注意，如果比较的日期是字符型的，需要先解析成日期对象再作判断。

请看下面的例子：

1. //判断两个日期是否相等

2. public void compareDate(){

3. LocalDate today = LocalDate.now();

4. LocalDate date1 = LocalDate.of(2018, 01, 21);

5. if(date1.equals(today)){

6. System.out.printf("TODAY %s and DATE1 %s are same date %n", today, date1);

7. }

8. }

5.检查像生日这种周期性事件

Java 中另一个日期时间的处理就是检查类似生日、纪念日、法定假日（国庆以及春节）、或者每个月固定时间发送邮件给客户 这些周期性事件。

Java中如何检查这些节日或其它周期性事件呢？答案就是 MonthDay类。这个类组合了月份和日，去掉了年，这意味着你可以用它判断每年都会发生事件。

和这个类相似的还有一个 YearMonth类。这些类也都是不可变并且线程安全的值类型。下面我们通过 MonthDay来检查周期性事件：

1. //处理周期性的日期

2. public void cycleDate(){

3. LocalDate today = LocalDate.now();

4. LocalDate dateOfBirth = LocalDate.of(2018, 01, 21);

5. MonthDay birthday = MonthDay.of(dateOfBirth.getMonth(), dateOfBirth.getDayOfMonth());

6. MonthDay currentMonthDay = MonthDay.from(today);

7. if(currentMonthDay.equals(birthday)){

8. System.out.println("Many Many happy returns of the day !!");

9. }else{

10. System.out.println("Sorry, today is not your birthday");

11. }

12. }

6.获取当前时间

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

1. //获取当前时间

2. public void getCurrentTime(){

3. LocalTime time = LocalTime.now();

4. System.out.println("local time now : " + time);

5. }

7.在现有的时间上增加小时

Java 8 提供了更好的 plusHours() 方法替换 add() ，并且是兼容的。注意，这些方法返回一个全新的LocalTime实例，由于其不可变性，返回后一定要用变量赋值。

1. //增加小时

2. public void plusHours(){

3. LocalTime time = LocalTime.now();

4. LocalTime newTime = time.plusHours(2); // 增加两小时

5. System.out.println("Time after 2 hours : " + newTime);

6. }

8.如何计算一个星期之后的日期

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

可以用同样的方法增加1个月、1年、1小时、1分钟甚至一个世纪，更多选项可以查看Java 8 API中的ChronoUnit类。

1. //如何计算一周后的日期

2. public void nextWeek(){

3. LocalDate today = LocalDate.now();

4. LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS); //使用变量赋值

5. System.out.println("Today is : " + today);

6. System.out.println("Date after 1 week : " + nextWeek);

7. }

9.计算一年前或一年后的日期

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

1. //计算一年前或一年后的日期

2. public void minusDate(){

3. LocalDate today = LocalDate.now();

4. LocalDate previousYear = today.minus(1, ChronoUnit.YEARS);

5. System.out.println("Date before 1 year : " + previousYear);

6. LocalDate nextYear = today.plus(1, ChronoUnit.YEARS);

7. System.out.println("Date after 1 year : " + nextYear);

8. }

10.使用Java 8的Clock时钟类

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

1. public void clock(){

2. // 根据系统时间返回当前时间并设置为UTC。

3. Clock clock = Clock.systemUTC();

4. System.out.println("Clock : " + clock);

5. // 根据系统时钟区域返回时间

6. Clock defaultClock = Clock.systemDefaultZone();

7. System.out.println("Clock : " + clock);

8. }

11.判断日期是早于还是晚于另一个日期

LocalDate 类有两类方法 isBefore() 和 isAfter() 用于比较日期。调用 isBefore() 方法时，如果给定日期小于当前日期则返回 true。

1. //如何用Java判断日期是早于还是晚于另一个日期

2. public void isBeforeOrIsAfter(){

3. LocalDate today = LocalDate.now();

4. LocalDate tomorrow = LocalDate.of(2018, 1, 29);

5. if(tomorrow.isAfter(today)){

6. System.out.println("Tomorrow comes after today");

7. }

8. //减去一天

9. LocalDate yesterday = today.minus(1, ChronoUnit.DAYS);

10. if(yesterday.isBefore(today)){

11. System.out.println("Yesterday is day before today");

12. }

13. }

12.处理时区

Java 8不仅分离了日期和时间，也把时区分离出来了。现在有一系列单独的类如 ZoneId 来处理特定时区，ZoneDateTime 类来表示某时区下的时间。

1. //获取特定时区下面的时间

2. public void getZoneTime(){

3. //设置时区

4. ZoneId america = ZoneId.of("America/New_York");

5. LocalDateTime localtDateAndTime = LocalDateTime.now();

6. ZonedDateTime dateAndTimeInNewYork = ZonedDateTime.of(localtDateAndTime, america );

7. System.out.println("现在的日期和时间在特定的时区 : " + dateAndTimeInNewYork);

8. }

13.如何体现出固定日期

例如：表示信用卡到期这类固定日期。与 MonthDay 检查重复事件的例子相似， YearMonth 是另一个组合类，用于表示信用卡到期日、FD到期日、期货期权到期日等。

还可以用这个类得到 当月共有多少天，YearMonth 实例的 lengthOfMonth() 方法可以返回当月的天数，在判断2月有28天还是29天时非常有用。

1. //使用 YearMonth类处理特定的日期

2. public void checkCardExpiry(){

3. YearMonth currentYearMonth = YearMonth.now();

4. System.out.printf("Days in month year %s: %d%n", currentYearMonth, currentYearMonth.lengthOfMonth());

5. YearMonth creditCardExpiry = YearMonth.of(2028, Month.FEBRUARY);

6. System.out.printf("Your credit card expires on %s %n", creditCardExpiry);

7. }

14.检查闰年

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

1. //检查闰年

2. public void isLeapYear(){

3. LocalDate today = LocalDate.now();

4. if(today.isLeapYear()){

5. System.out.println("This year is Leap year");

6. }else {

7. System.out.println("2018 is not a Leap year");

8. }

9. }

15.计算两个日期之间的天数和月数

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

下面的例子：现在是一月份，距离到五月份，中间相隔3月

1. //计算两个日期之间的天数和月数

2. public void calcDateDays(){

3. LocalDate today = LocalDate.now();

4. LocalDate java8Release = LocalDate.of(2018, Month.MAY, 14);

5. Period periodToNextJavaRelease = Period.between(today, java8Release);

6. System.out.println("Months left between today and Java 8 release : "

7. + periodToNextJavaRelease.getMonths() );

8. }

16.包含时差信息的日期和时间

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

1. public void ZoneOffset(){

2. LocalDateTime datetime = LocalDateTime.of(2018, Month.FEBRUARY, 14, 19, 30);

3. ZoneOffset offset = ZoneOffset.of("+05:30");

4. OffsetDateTime date = OffsetDateTime.of(datetime, offset);

5. System.out.println("Date and Time with timezone offset in Java : " + date);

6. }

17.获取当前的时间戳

Instant类有一个静态工厂方法now()会返回当前的时间戳，如下所示：

1. public void getTimestamp(){

2. Instant timestamp = Instant.now();

3. System.out.println("What is value of this instant " + timestamp);

4. }

18.使用预定义的格式化工具去解析或格式化日期

Java 8引入了全新的日期时间格式工具，线程安全而且使用方便。它自带了一些常用的内置格式化工具。

下面这个例子使用了BASICISODATE格式化工具将2018年2月10日格式化成20180210。

1. // 使用预定义的格式化工具去解析或格式化日期

2. public void formateDate(){

3. String dayAfterTommorrow = "20180210";

4. LocalDate formatted = LocalDate.parse(dayAfterTommorrow, DateTimeFormatter.BASIC_ISO_DATE);

5. System.out.printf("Date generated from String %s is %s %n", dayAfterTommorrow, formatted);

6. }

最后

最后附上全部代码

1. package com.wq.study.java8.date;

2. import java.time.Clock;

3. import java.time.Instant;

4. import java.time.LocalDate;

5. import java.time.LocalDateTime;

6. import java.time.LocalTime;

7. import java.time.Month;

8. import java.time.MonthDay;

9. import java.time.OffsetDateTime;

10. import java.time.ZoneOffset;

11. import java.time.Period;

12. import java.time.YearMonth;

13. import java.time.ZoneId;

14. import java.time.ZonedDateTime;

15. import java.time.format.DateTimeFormatter;

16. import java.time.temporal.ChronoUnit;

17. import java.util.Date;

18. public class DateTest {

19. //获取今天的日期

20. public void getCurrentDate(){

21. LocalDate today = LocalDate.now();

22. System.out.println("Today's Local date : " + today);

23. //这个是作为对比

24. Date date = new Date();

25. System.out.println(date);

26. }

27. //获取年、月、日信息

28. public void getDetailDate(){

29. LocalDate today = LocalDate.now();

30. int year = today.getYear();

31. int month = today.getMonthValue();

32. int day = today.getDayOfMonth();

33. System.out.printf("Year : %d Month : %d day : %d t %n", year, month, day);

34. }

35. //处理特定日期

36. public void handleSpecilDate(){

37. LocalDate dateOfBirth = LocalDate.of(2018, 01, 21);

38. System.out.println("The specil date is : " + dateOfBirth);

39. }

40. //判断两个日期是否相等

41. public void compareDate(){

42. LocalDate today = LocalDate.now();

43. LocalDate date1 = LocalDate.of(2018, 01, 21);

44. if(date1.equals(today)){

45. System.out.printf("TODAY %s and DATE1 %s are same date %n", today, date1);

46. }

47. }

48. //处理周期性的日期

49. public void cycleDate(){

50. LocalDate today = LocalDate.now();

51. LocalDate dateOfBirth = LocalDate.of(2018, 01, 21);

52. MonthDay birthday = MonthDay.of(dateOfBirth.getMonth(), dateOfBirth.getDayOfMonth());

53. MonthDay currentMonthDay = MonthDay.from(today);

54. if(currentMonthDay.equals(birthday)){

55. System.out.println("Many Many happy returns of the day !!");

56. }else{

57. System.out.println("Sorry, today is not your birthday");

58. }

59. }

60. //获取当前时间

61. public void getCurrentTime(){

62. LocalTime time = LocalTime.now();

63. System.out.println("local time now : " + time);

64. }

65. //增加小时

66. public void plusHours(){

67. LocalTime time = LocalTime.now();

68. LocalTime newTime = time.plusHours(2); // 增加两小时

69. System.out.println("Time after 2 hours : " + newTime);

70. }

71. //如何计算一周后的日期

72. public void nextWeek(){

73. LocalDate today = LocalDate.now();

74. LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);

75. System.out.println("Today is : " + today);

76. System.out.println("Date after 1 week : " + nextWeek);

77. }

78. //计算一年前或一年后的日期

79. public void minusDate(){

80. LocalDate today = LocalDate.now();

81. LocalDate previousYear = today.minus(1, ChronoUnit.YEARS);

82. System.out.println("Date before 1 year : " + previousYear);

83. LocalDate nextYear = today.plus(1, ChronoUnit.YEARS);

84. System.out.println("Date after 1 year : " + nextYear);

85. }

86. public void clock(){

87. // 根据系统时间返回当前时间并设置为UTC。

88. Clock clock = Clock.systemUTC();

89. System.out.println("Clock : " + clock);

90. // 根据系统时钟区域返回时间

91. Clock defaultClock = Clock.systemDefaultZone();

92. System.out.println("Clock : " + clock);

93. }

94. //如何用Java判断日期是早于还是晚于另一个日期

95. public void isBeforeOrIsAfter(){

96. LocalDate today = LocalDate.now();

97. LocalDate tomorrow = LocalDate.of(2018, 1, 29);

98. if(tomorrow.isAfter(today)){

99. System.out.println("Tomorrow comes after today");

100. }

101. LocalDate yesterday = today.minus(1, ChronoUnit.DAYS);

102. if(yesterday.isBefore(today)){

103. System.out.println("Yesterday is day before today");

104. }

105. }

106. //时区处理

107. public void getZoneTime(){

108. //设置时区

109. ZoneId america = ZoneId.of("America/New_York");

110. LocalDateTime localtDateAndTime = LocalDateTime.now();

111. ZonedDateTime dateAndTimeInNewYork = ZonedDateTime.of(localtDateAndTime, america );

112. System.out.println("现在的日期和时间在特定的时区 : " + dateAndTimeInNewYork);

113. }

114. //使用 YearMonth类处理特定的日期

115. public void checkCardExpiry(){

116. YearMonth currentYearMonth = YearMonth.now();

117. System.out.printf("Days in month year %s: %d%n", currentYearMonth, currentYearMonth.lengthOfMonth());

118. YearMonth creditCardExpiry = YearMonth.of(2028, Month.FEBRUARY);

119. System.out.printf("Your credit card expires on %s %n", creditCardExpiry);

120. }

121. //检查闰年

122. public void isLeapYear(){

123. LocalDate today = LocalDate.now();

124. if(today.isLeapYear()){

125. System.out.println("This year is Leap year");

126. }else {

127. System.out.println("2018 is not a Leap year");

128. }

129. }

130. //计算两个日期之间的天数和月数

131. public void calcDateDays(){

132. LocalDate today = LocalDate.now();

133. LocalDate java8Release = LocalDate.of(2018, Month.MAY, 14);

134. Period periodToNextJavaRelease = Period.between(today, java8Release);

135. System.out.println("Months left between today and Java 8 release : "

136. + periodToNextJavaRelease.getMonths() );

137. }

138. // 包含时差信息的日期和时间

139. public void ZoneOffset(){

140. LocalDateTime datetime = LocalDateTime.of(2018, Month.FEBRUARY, 14, 19, 30);

141. ZoneOffset offset = ZoneOffset.of("+05:30");

142. OffsetDateTime date = OffsetDateTime.of(datetime, offset);

143. System.out.println("Date and Time with timezone offset in Java : " + date);

144. }

145. // 获取时间戳

146. public void getTimestamp(){

147. Instant timestamp = Instant.now();

148. System.out.println("What is value of this instant " + timestamp);

149. }

150. // 使用预定义的格式化工具去解析或格式化日期

151. public void formateDate(){

152. String dayAfterTommorrow = "20180210";

153. LocalDate formatted = LocalDate.parse(dayAfterTommorrow, DateTimeFormatter.BASIC_ISO_DATE);

154. System.out.printf("Date generated from String %s is %s %n", dayAfterTommorrow, formatted);

155. }

156. public static void main(String[] args) {

157. DateTest dt = new DateTest();

158. dt.formateDate();

159. }

160. }

总结

Java 8日期时间API的重点

1）提供了javax.time.ZoneId 获取时区。

2）提供了LocalDate和LocalTime类。

3）Java 8 的所有日期和时间API都是不可变类并且线程安全，而现有的Date和Calendar API中的java.util.Date和SimpleDateFormat是非线程安全的。

4）主包是 java.time,包含了表示日期、时间、时间间隔的一些类。里面有两个子包java.time.format用于格式化， java.time.temporal用于更底层的操作。

5）时区代表了地球上某个区域内普遍使用的标准时间。每个时区都有一个代号，格式通常由区域/城市构成（Asia/Tokyo），在加上与格林威治或 UTC的时差。例如：东京的时差是+09:00。

---

（完）

MarkerHub文章索引：（点击阅读原文直达）

https://github.com/MarkerHub/JavaIndex

【推荐阅读】

好文章！我在看！