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

语言: CN / TW / HK

theme: smartblue

小知识,大挑战!本文正在参与“程序员必备小知识”创作活动。

技术背景

一切都源于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()默认时区

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

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

相对于自定义时区

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

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

自定义时钟

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

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

定义时间数据

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

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

使用瞬时时间 + 时区

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

解析String->LocalDateTime

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

999毫秒 等价于999000000纳秒

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

使用DateTimeFormatter API 解析和格式化

java 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));

时间属性的获取

java 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()); //纳秒数

时间增减

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

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

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

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

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

  • 获取系统UTC默认时钟
    java Clock clock1 = Clock.systemUTC(); //得到时钟的瞬时时间 Instant instant2 = Instant.now(clock1); System.out.println(instant2.toEpochMilli());

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

Clock时钟

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

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

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

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

系统默认时区时钟(当前瞬时时间)

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

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

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

java 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])

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

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

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

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

Duration

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

```java 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 //提供对java.util.Calendar的替换,提供对年历系统的支持 Chronology c = HijrahChronology.INSTANCE; ChronoLocalDateTime d = c.localDateTime(LocalDateTime.now()); System.out.println(d);

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

java 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个月

java 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/

「其他文章」