大家好，我是小虚竹。之前有粉丝私聊我，问能不能把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 天。
可以关注我，点赞我、评论我、收藏我啦。
