Java技术专题「Java8编程系列」让你真正会用对Java新版日期时间API编程指南

Posted 2022-12-10 洛神灬殇

技术背景

一切都源于JSR-310规范

• JSR-310规范提供一个新的和改进的Java日期与时间API，会在Java8中包含，可以下载OpenJDK早期发布版本试用，详细信息可见：https://jdk8.java.net/download.html

• JSR-310规范领导者Stephen Colebourne就是joda-time作者，其主要思想也是借鉴了joda-time，而不是直接把joda-time移植到Java平台中，API是类似的，但做了改进和调整。

• 具体规范请前往如下地址下载：https://jcp.org/en/jsr/detail?id=310

代替Date类的日期类（LocalXX系列）

首当其冲的是LocalDateTime、LocalDate、LocalTime ,提供了对java.util.Date的替代，另外还提供了新的DateTimeFormatter用于对格式化/解析的支持

• 介绍相关的XXX.now()的方法，这些太简单了，接下来介绍一下相关的较为特殊的用法，例如：

相对于ZoneId.systemDefault()默认时区

LocalDateTime now = LocalDateTime.now();
System.out.println(now);

相当于使用默认时区时钟瞬时时间创建`Clock.systemDefaultZone()``；

相对于自定义时区

LocalDateTime now2= LocalDateTime.now(ZoneId.of("Europe/Paris"));
System.out.println(now2);

会以相应的时区显示日期：欧洲的巴黎时区

自定义时钟

Clock clock = Clock.system(ZoneId.of("Asia/Dhaka"));  
LocalDateTime now3= LocalDateTime.now(clock);  
System.out.println(now3);

与上面的一样，会以相应的时区显示日期

定义时间数据

不需要写什么相对时间 如java.util.Date 年是相对于1900 月是从0开始

//2013-12-31 23:59  
LocalDateTime d1 = LocalDateTime.of(2013, 12, 31, 23, 59);  

//年月日 时分秒 纳秒
LocalDateTime d2 = LocalDateTime.of(2013, 12, 31, 23, 59,59, 11);

使用瞬时时间 + 时区

Instant instant = Instant.now();
LocalDateTime d3 = LocalDateTime.ofInstant(Instant.now(), ZoneId.systemDefault());
System.out.println(d3);

解析String->LocalDateTime

LocalDateTime d4 = LocalDateTime.parse("2013-12-31T23:59");
System.out.println(d4);

999毫秒 等价于999000000纳秒

LocalDateTime d5 = LocalDateTime.parse("2013-12-31T23:59:59.999");
System.out.println(d5);

使用DateTimeFormatter API 解析和格式化

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");
LocalDateTime d6 = LocalDateTime.parse("2013/12/31 23:59:59", formatter);  
System.out.println(formatter.format(d6));  

时间属性的获取

System.out.println(d6.getYear());  //获取年份
System.out.println(d6.getMonth());  //获取月份
System.out.println(d6.getDayOfYear());  // 获取当年的第几天
System.out.println(d6.getDayOfMonth());//获取属于本月的第几天
System.out.println(d6.getDayOfWeek());// 获取相对于本周的日期
System.out.println(d6.getHour());// 小时
System.out.println(d6.getMinute());  //分钟
System.out.println(d6.getSecond());  // 秒数
System.out.println(d6.getNano());  //纳秒数

时间增减

LocalDateTime d7 = d6.minusDays(1);  
LocalDateTime d8 = d7.plus(1, IsoFields.QUARTER_YEARS);  

代替System.currentTimeMillis()的瞬时对象（Instant）

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

• 瞬时时间 相当于以前的System.currentTimeMillis()

Instant instant1 = Instant.now();
//精确到秒 得到相对于1970-01-01 00:00:00 UTC的一个时间
System.out.println(instant1.getEpochSecond());
//精确到毫秒
System.out.println(instant1.toEpochMilli()); 

• 获取系统UTC默认时钟

Clock clock1 = Clock.systemUTC(); 
//得到时钟的瞬时时间
Instant instant2 = Instant.now(clock1);
System.out.println(instant2.toEpochMilli());

• 固定瞬时时间时钟

Clock clock2 = Clock.fixed(instant1, ZoneId.systemDefault()); 
Instant instant3 = Instant.now(clock2);//得到时钟的瞬时时间  
System.out.println(instant3.toEpochMilli());//与上面的 instant1代表的含义一样！

Clock时钟

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

//时钟提供给我们用于访问某个特定 时区的 瞬时时间、日期和时间的。

系统默认UTC时钟（当前瞬时时间 System.currentTimeMillis()）

Clock c1 = Clock.systemUTC(); 
System.out.println(c1.millis()); //每次调用将返回当前瞬时时间（UTC）  

系统默认时区时钟（当前瞬时时间）

Clock c2 = Clock.systemDefaultZone(); 
Clock c31 = Clock.system(ZoneId.of("Europe/Paris")); //巴黎时区  
System.out.println(c31.millis()); //每次调用将返回当前瞬时时间（UTC）  

Clock c32 = Clock.system(ZoneId.of("Asia/Shanghai"));//上海时区  
System.out.println(c32.millis());//每次调用将返回当前瞬时时间（UTC）  

Clock c4 = Clock.fixed(Instant.now(), ZoneId.of("Asia/Shanghai"));//固定上海时区时钟  
System.out.println(c4.millis());  
Thread.sleep(1000);  
System.out.println(c4.millis()); //不变 即时钟时钟在那一个点不动  

Clock c5 = Clock.offset(c1, Duration.ofSeconds(2)); //相对于系统默认时钟两秒的时钟  
System.out.println(c1.millis());  
System.out.println(c5.millis());  

ZonedDateTime

• 带有时区的date-time 存储纳秒、时区和时差（避免与本地date-time歧义）；API和LocalDateTime类似。

• API和LocalDateTime类似，只是多了时差(如2013-12-20T10:35:50.711+08:00[Asia/Shanghai])

ZonedDateTime now = ZonedDateTime.now();
System.out.println(now);

ZonedDateTime now2= ZonedDateTime.now(ZoneId.of("Europe/Paris"));  
System.out.println(now2);

其他的用法也是类似的 就不介绍了

ZonedDateTime z1 = ZonedDateTime.parse("2013-12-31T23:59:59Z[Europe/Paris]");
System.out.println(z1);

Duration

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

Duration d1 = Duration.between(Instant.ofEpochMilli(System.currentTimeMillis() - 12323123), Instant.now());
//得到相应的时差
System.out.println(d1.toDays());  
System.out.println(d1.toHours());  
System.out.println(d1.toMinutes());  
System.out.println(d1.toMillis());  
System.out.println(d1.toNanos());  

//1天时差 类似的还有如ofHours()  
Duration d2 = Duration.ofDays(1);  
System.out.println(d2.ofHours());

Calendar的替代者Chronology

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

//提供对java.util.Calendar的替换，提供对年历系统的支持  
Chronology c  = HijrahChronology.INSTANCE; 
ChronoLocalDateTime d = c.localDateTime(LocalDateTime.now());  
System.out.println(d);  

年、年月、月日、周期的API支持

Year year = Year.now();  
YearMonth yearMonth = YearMonth.now();
MonthDay monthDay = MonthDay.now();
System.out.println(year);//年  
System.out.println(yearMonth); //年-月  
System.out.println(monthDay); // 月-日  

Period 日期层面的间隔时间

周期，如表示10天前 3年5个月

Period period1 = Period.ofDays(10);
System.out.println(period1);
Period period2 = Period.of(3, 5, 0);
System.out.println(period2);

参考文章

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/