大家好，我是小虚竹。之前有粉丝私聊我，问能不能把JAVA8 新的日期时间API（JSR-310）知识点梳理出来。答案是肯定的，谁让我宠粉呢。由于内容偏多（超十万字了），会拆成多篇来写。

闲话就聊到这，请看下面的正文。

使用场景

对JDK8+中的日期时间工具类封装

项目引用

此博文的依据：hutool-5.6.5版本源码

方法明细-now()

方法名称:cn.hutool.core.date.LocalDateTimeUtil.now()

方法描述

当前时间，默认时区

支持版本及以上

参数描述:

    String dateStr = "2021-05-21T11:23:56";
    // 通过转换获取的Instant为UTC时间
    Instant instant1 = DateUtil.parse(dateStr).toInstant();
    LocalDateTime localDateTime = LocalDateTimeUtil.of(instant1,TimeZone.getTimeZone(ZoneId.of("Asia/Shanghai")));
    Assert.assertEquals("2021-05-21T19:23:56", localDateTime.toString());
    System.out.println(localDateTime);

方法明细-of(java.util.Date)

方法名称:cn.hutool.core.date.LocalDateTimeUtil.of(java.util.Date)

方法描述

{@link Date}转{@link LocalDateTime}，使用默认时区

支持版本及以上

参数描述:

    final LocalDateTime localDateTime = LocalDateTimeUtil.parse("2020-01-23T12:23:56", DateTimeFormatter.ISO_DATE_TIME);
    Assert.assertEquals("2020-01-23T12:23:56", localDateTime.toString());
    System.out.println(localDateTime);

    LocalDate localDate = LocalDateTimeUtil.parseDate("2020-01-23");    Assert.assertEquals("2020-01-23", localDate.toString());

//TemporalAccessorUtil
/**
 * 格式化日期时间为指定格式
 *
 * @param time      {@link TemporalAccessor}
 * @param formatter 日期格式化器，预定义的格式见：{@link DateTimeFormatter}
 * @return 格式化后的字符串
 * @since 5.3.10
 */
public static String format(TemporalAccessor time, DateTimeFormatter formatter) {
   if (null == time) {
      return null;
   }
   if(null == formatter){
      formatter = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
   }
   try {
      return formatter.format(time);
   } catch (UnsupportedTemporalTypeException e){
      if(time instanceof LocalDate && e.getMessage().contains("HourOfDay")){
         // 用户传入LocalDate，但是要求格式化带有时间部分，转换为LocalDateTime重试
         return formatter.format(((LocalDate) time).atStartOfDay());
      }else if(time instanceof LocalTime && e.getMessage().contains("YearOfEra")){
         // 用户传入LocalTime，但是要求格式化带有日期部分，转换为LocalDateTime重试
         return formatter.format(((LocalTime) time).atDate(LocalDate.now()));
      }
      throw e;
   }
}

这两个demo的数据，反应出了结果是按时间差单位来产生的。

方法明细-betweenPeriod(java.time.LocalDate, java.time.LocalDate)

方法名称:cn.hutool.core.date.LocalDateTimeUtil.betweenPeriod(java.time.LocalDate, java.time.LocalDate)

方法描述

获取两个日期的表象时间差，如果结束时间早于开始时间，获取结果为负。

比如2011年2月1日，和2021年8月11日，日相差了10天，月相差6月

支持版本及以上

5.4.5

参数描述:

  LocalDateTime currentTime = LocalDateTime.now(); // 当前日期和时间
  System.out.println("------------------时间的加减法及修改-----------------------");
  //3.LocalDateTime的加减法包含了LocalDate和LocalTime的所有加减,上面说过,这里就只做简单介绍
  System.out.println("3.当前时间：" + currentTime);
  System.out.println("3.当前时间加5年：" + currentTime.plusYears(5));
  System.out.println("3.当前时间加2个月：" + currentTime.plusMonths(2));
  System.out.println("3.当前时间减2天：" + currentTime.minusDays(2));
  System.out.println("3.当前时间减5个小时：" + currentTime.minusHours(5));
  System.out.println("3.当前时间加5分钟：" + currentTime.plusMinutes(5));
  System.out.println("3.当前时间加20秒：" + currentTime.plusSeconds(20));
  //还可以灵活运用比如：向后加一年，向前减一天，向后加2个小时，向前减5分钟，可以进行连写
  System.out.println("3.同时修改(向后加一年，向前减一天，向后加2个小时，向前减5分钟)：" + currentTime.plusYears(1).minusDays(1).plusHours(2).minusMinutes(5));
  System.out.println("3.修改年为2025年：" + currentTime.withYear(2025));
  System.out.println("3.修改月为12月：" + currentTime.withMonth(12));
  System.out.println("3.修改日为27日：" + currentTime.withDayOfMonth(27));
  System.out.println("3.修改小时为12：" + currentTime.withHour(12));
  System.out.println("3.修改分钟为12：" + currentTime.withMinute(12));
  System.out.println("3.修改秒为12：" + currentTime.withSecond(12));

请看上面的源码分析。

方法明细-toEpochMilli(java.time.temporal.TemporalAccessor)

方法名称:cn.hutool.core.date.LocalDateTimeUtil.toEpochMilli(java.time.temporal.TemporalAccessor)

方法描述

{@link TemporalAccessor}转换为 时间戳（从1970-01-01T00:00:00Z开始的毫秒数）

支持版本及以上

5.4.1

参数描述:

    String dateStr = "2021-05-22";
    //TemporalAccessor 的实现类包含Instant LocalDateTime ZonedDateTime OffsetDateTime LocalDate LocalTime OffsetTime
    LocalDate localDate = LocalDate.parse(dateStr);
    //Date对象
    long time = LocalDateTimeUtil.toEpochMilli(localDate);
    Assert.assertEquals(DateUtil.parse(dateStr).getTime(), time);

总结

本文的实战+源码分析只是抛转引玉，实战让大家能知道如何去使用JSR-310 新的日期时间API，源码分析可以让大家知其所以然。

本篇文章 是JSR-310系列的一个里程碑，感谢大家的一路支持，让博主坚持把这个系列的文章写完。

❤️祝大家中秋快乐❤️

推荐相关文章

hutool日期时间系列文章

1DateUtil(时间工具类)-当前时间和当前时间戳

2DateUtil(时间工具类)-常用的时间类型Date，DateTime，Calendar和TemporalAccessor（LocalDateTime）转换

3DateUtil(时间工具类)-获取日期的各种内容

4DateUtil(时间工具类)-格式化时间

5DateUtil(时间工具类)-解析被格式化的时间

6DateUtil(时间工具类)-时间偏移量获取

7DateUtil(时间工具类)-日期计算

8ChineseDate(农历日期工具类)

9LocalDateTimeUtil(JDK8+中的{@link LocalDateTime} 工具类封装)

10TemporalAccessorUtil{@link TemporalAccessor} 工具类封装

其他

要探索JDK的核心底层源码，那必须掌握native用法

万字博文教你搞懂java源码的日期和时间相关用法

java的SimpleDateFormat线程不安全出问题了，虚竹教你多种解决方案

源码分析：JDK获取默认时区的风险和最佳实践

高级JAVA开发必备技能：时区的规则发生变化时，如何同步JDK的时区规则

今天是持续写作的第 12 / 100 天。

可以关注我，点赞我、评论我、收藏我啦。