Spring4新特性——JSR310日期时间API的支持

JSR-310规范提供一个新的和改进的Java日期与时间API。从2007投票到2013年11月发布公共Review版本已经好多年了,会在Java8中包含,可以下载OpenJDK早期发布版本试用(Win XP不支持):

 

https://jdk8.java.net/download.html

 

JSR 310规范领导者Stephen Colebourne就是joda-time作者,其主要思想也是借鉴了joda-time,而不是直接把joda-time移植到Java平台中,API是类似的,但做了改进,具体的改进请参考其2009年的一篇文章和InfoQ对他的采访:

http://blog.joda.org/2009/11/why-jsr-310-isn-joda-time_4941.html 

http://www.infoq.com/cn/news/2010/05/jsr-310 

http://blog.joda.org/2010/12/what-about-jsr-310_153.html

 

规范请前往如下地址下载:

https://jcp.org/en/jsr/detail?id=310

 

JSR310 日期与时间规范主要API如下:

Clock

时钟,类似于钟表的概念,提供了如系统时钟、固定时钟、特定时区的时钟

Java代码   收藏代码
  1. //时钟提供给我们用于访问某个特定 时区的 瞬时时间、日期 和 时间的。  
  2. Clock c1 = Clock.systemUTC(); //系统默认UTC时钟(当前瞬时时间 System.currentTimeMillis())  
  3. System.out.println(c1.millis()); //每次调用将返回当前瞬时时间(UTC)  
  4.   
  5. Clock c2 = Clock.systemDefaultZone(); //系统默认时区时钟(当前瞬时时间)  
  6.   
  7. Clock c31 = Clock.system(ZoneId.of("Europe/Paris")); //巴黎时区  
  8. System.out.println(c31.millis()); //每次调用将返回当前瞬时时间(UTC)  
  9.   
  10. Clock c32 = Clock.system(ZoneId.of("Asia/Shanghai"));//上海时区  
  11. System.out.println(c32.millis());//每次调用将返回当前瞬时时间(UTC)  
  12.   
  13. Clock c4 = Clock.fixed(Instant.now(), ZoneId.of("Asia/Shanghai"));//固定上海时区时钟  
  14. System.out.println(c4.millis());  
  15. Thread.sleep(1000);  
  16. System.out.println(c4.millis()); //不变 即时钟时钟在那一个点不动  
  17.   
  18. Clock c5 = Clock.offset(c1, Duration.ofSeconds(2)); //相对于系统默认时钟两秒的时钟  
  19. System.out.println(c1.millis());  
  20. System.out.println(c5.millis());  

 

 

Instant

瞬时时间,等价于以前的System.currentTimeMillis()

Java代码   收藏代码
  1. //瞬时时间 相当于以前的System.currentTimeMillis()  
  2. Instant instant1 = Instant.now();  
  3. System.out.println(instant1.getEpochSecond());//精确到秒 得到相对于1970-01-01 00:00:00 UTC的一个时间  
  4. System.out.println(instant1.toEpochMilli()); //精确到毫秒  
  5.   
  6. Clock clock1 = Clock.systemUTC(); //获取系统UTC默认时钟  
  7. Instant instant2 = Instant.now(clock1);//得到时钟的瞬时时间  
  8. System.out.println(instant2.toEpochMilli());  
  9.   
  10. Clock clock2 = Clock.fixed(instant1, ZoneId.systemDefault()); //固定瞬时时间时钟  
  11. Instant instant3 = Instant.now(clock2);//得到时钟的瞬时时间  
  12. System.out.println(instant3.toEpochMilli());//equals instant1  

 

LocalDateTime、LocalDate、LocalTime 

提供了对java.util.Date的替代,另外还提供了新的DateTimeFormatter用于对格式化/解析的支持

Java代码   收藏代码
  1. //使用默认时区时钟瞬时时间创建 Clock.systemDefaultZone() -->即相对于 ZoneId.systemDefault()默认时区  
  2. LocalDateTime now = LocalDateTime.now();  
  3. System.out.println(now);  
  4.   
  5. //自定义时区  
  6. LocalDateTime now2= LocalDateTime.now(ZoneId.of("Europe/Paris"));  
  7. System.out.println(now2);//会以相应的时区显示日期  
  8.   
  9. //自定义时钟  
  10. Clock clock = Clock.system(ZoneId.of("Asia/Dhaka"));  
  11. LocalDateTime now3= LocalDateTime.now(clock);  
  12. System.out.println(now3);//会以相应的时区显示日期  
  13.   
  14. //不需要写什么相对时间 如java.util.Date 年是相对于1900 月是从0开始  
  15. //2013-12-31 23:59  
  16. LocalDateTime d1 = LocalDateTime.of(201312312359);  
  17.   
  18. //年月日 时分秒 纳秒  
  19. LocalDateTime d2 = LocalDateTime.of(201312312359,5911);  
  20.   
  21. //使用瞬时时间 + 时区  
  22. Instant instant = Instant.now();  
  23. LocalDateTime d3 = LocalDateTime.ofInstant(Instant.now(), ZoneId.systemDefault());  
  24. System.out.println(d3);  
  25.   
  26. //解析String--->LocalDateTime  
  27. LocalDateTime d4 = LocalDateTime.parse("2013-12-31T23:59");  
  28. System.out.println(d4);  
  29.   
  30. LocalDateTime d5 = LocalDateTime.parse("2013-12-31T23:59:59.999");//999毫秒 等价于999000000纳秒  
  31. System.out.println(d5);  
  32.   
  33. //使用DateTimeFormatter API 解析 和 格式化  
  34. DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");  
  35. LocalDateTime d6 = LocalDateTime.parse("2013/12/31 23:59:59", formatter);  
  36. System.out.println(formatter.format(d6));  
  37.   
  38.   
  39. //时间获取  
  40. System.out.println(d6.getYear());  
  41. System.out.println(d6.getMonth());  
  42. System.out.println(d6.getDayOfYear());  
  43. System.out.println(d6.getDayOfMonth());  
  44. System.out.println(d6.getDayOfWeek());  
  45. System.out.println(d6.getHour());  
  46. System.out.println(d6.getMinute());  
  47. System.out.println(d6.getSecond());  
  48. System.out.println(d6.getNano());  
  49. //时间增减  
  50. LocalDateTime d7 = d6.minusDays(1);  
  51. LocalDateTime d8 = d7.plus(1, IsoFields.QUARTER_YEARS);  
  52.   
  53. //LocalDate 即年月日 无时分秒  
  54. //LocalTime即时分秒 无年月日  
  55. //API和LocalDateTime类似就不演示了  

 

ZonedDateTime

带有时区的date-time 存储纳秒、时区和时差(避免与本地date-time歧义);API和LocalDateTime类似,只是多了时差(如2013-12-20T10:35:50.711+08:00[Asia/Shanghai])  

Java代码   收藏代码
  1. //即带有时区的date-time 存储纳秒、时区和时差(避免与本地date-time歧义)。  
  2. //API和LocalDateTime类似,只是多了时差(如2013-12-20T10:35:50.711+08:00[Asia/Shanghai])  
  3. ZonedDateTime now = ZonedDateTime.now();  
  4. System.out.println(now);  
  5.   
  6. ZonedDateTime now2= ZonedDateTime.now(ZoneId.of("Europe/Paris"));  
  7. System.out.println(now2);  
  8.   
  9. //其他的用法也是类似的 就不介绍了  
  10.   
  11. ZonedDateTime z1 = ZonedDateTime.parse("2013-12-31T23:59:59Z[Europe/Paris]");  
  12. System.out.println(z1);  

 

 

Duration

表示两个瞬时时间的时间段 

 

Java代码   收藏代码
  1. //表示两个瞬时时间的时间段  
  2. Duration d1 = Duration.between(Instant.ofEpochMilli(System.currentTimeMillis() - 12323123), Instant.now());  
  3. //得到相应的时差  
  4. System.out.println(d1.toDays());  
  5. System.out.println(d1.toHours());  
  6. System.out.println(d1.toMinutes());  
  7. System.out.println(d1.toMillis());  
  8. System.out.println(d1.toNanos());  
  9.   
  10. //1天时差 类似的还有如ofHours()  
  11. Duration d2 = Duration.ofDays(1);  
  12. System.out.println(d2.toDays());  

 

 

Chronology

用于对年历系统的支持,是java.util.Calendar的替代者

Java代码   收藏代码
  1. //提供对java.util.Calendar的替换,提供对年历系统的支持  
  2. Chronology c  = HijrahChronology.INSTANCE;  
  3. ChronoLocalDateTime d = c.localDateTime(LocalDateTime.now());  
  4. System.out.println(d);  

  

其他

如果提供了年、年月、月日、周期的API支持

Java代码   收藏代码
  1. Year year = Year.now();  
  2. YearMonth yearMonth = YearMonth.now();  
  3. MonthDay monthDay = MonthDay.now();  
  4.   
  5. System.out.println(year);//年  
  6. System.out.println(yearMonth); //年-月  
  7. System.out.println(monthDay); // 月-日  
  8.   
  9. //周期,如表示10天前  3年5个月钱  
  10. Period period1 = Period.ofDays(10);  
  11. System.out.println(period1);  
  12. Period period2 = Period.of(350);  
  13. System.out.println(period2);  

 

代码示例请参考:TimeTest.java

 

从以上来看,JSR310提供了更好、更强大的、更易使用的API。另外有三篇对joda-time和jsr310 使用的介绍文章:

http://www.codedata.com.tw/java/jodatime-jsr310-1-date-calendar/

http://www.codedata.com.tw/java/jodatime-jsr310-2-time-abc/

http://www.codedata.com.tw/java/jodatime-jsr310-3-using-jodatime/

 

spring4提供了对jsr310的支持,只要能发现如java.time.LocalDate,DefaultFormattingConversionService就会自动注册对jsr310的支持;对于ConversionService请参考:

SpringMVC数据格式化——第七章 注解式控制器的数据验证、类型转换及格式化——跟着开涛学SpringMVC 

 

我们只需要在实体/Bean上使用DateTimeFormat注解:

Java代码   收藏代码
  1. @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")  
  2. private LocalDateTime dateTime;  
  3.   
  4. @DateTimeFormat(pattern = "yyyy-MM-dd")  
  5. private LocalDate date;  
  6.   
  7. @DateTimeFormat(pattern = "HH:mm:ss")  
  8. private LocalTime time;  

比如我们在springmvc中:

Java代码   收藏代码
  1. @RequestMapping("/test")  
  2. public String test(@ModelAttribute("entity") Entity entity) {  
  3.     return "test";  
  4. }  

当前端页面请求:

localhost:9080/spring4/test?dateTime=2013-11-11 11:11:11&date=2013-11-11&time=12:12:12

会自动进行类型转换。

 

另外spring4也提供了对TimeZone的支持;比如在springmvc中注册了LocaleContextResolver相应实现的话(如CookieLocaleResolver),我们就可以使用如下两种方式得到相应的TimeZone:

RequestContextUtils.getTimeZone(request)

LocaleContextHolder.getTimeZone()

 

不过目前的缺点是不能像Local那样自动的根据当前请求得到相应的TimeZone,如果需要这种功能需要覆盖相应的如CookieLocaleResolver中的如下方法来得到:

Java代码   收藏代码
  1. protected TimeZone determineDefaultTimeZone(HttpServletRequest request) {  
  2.     return getDefaultTimeZone();  
  3. }  

 

另外还提供了DateTimeContextHolder,其用于线程绑定DateTimeContext;而DateTimeContext提供 了如:Chronology、ZoneId、DateTimeFormatter等上下文数据,如果需要这种上下文信息的话,可以使用这个API进行绑 定。比如在进行日期格式化时,就会去查找相应的DateTimeFormatter,因此如果想自定义相应的格式化格式,那么使用 DateTimeContextHolder绑定即可。

 

源代码请参考github项目:spring4-datetime-jsr310 

 

spring4只是简单的对jsr310提供了相应的支持,没有太多的增强。

 

 

你可能感兴趣的:(Spring4新特性——JSR310日期时间API的支持)