10hutool实战:TemporalAccessorUtil{TemporalAccessor} 工具类封装

约定不等于承诺〃 2022-10-17 00:56 159阅读 0赞

技术活，该赏
    点赞再看，养成习惯

[hutool实战（带你掌握里面的各种工具）目录][hutool]

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

--------------------

# 用途：TemporalAccessor 工具类封装 #

## 使用场景 ##

TemporalAccessor 的实现类包含

*  Instant
 *  LocalDateTime
 *  ZonedDateTime
 *  OffsetDateTime
 *  LocalDate
 *  LocalTime
 *  OffsetTime

## 项目引用 ##

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

<dependency>
    			<groupId>cn.hutool</groupId>
    			<artifactId>hutool-core</artifactId>
    			<version>5.6.5</version>
    		</dependency>

## 方法摘要 ##

<table> 
 <thead> 
  <tr> 
   <th>方法</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.TemporalAccessorUtil.get(java.time.temporal.TemporalAccessor, java.time.temporal.TemporalField)</a></td> 
   <td> 
    <div>
      安全获取时间的某个属性，属性不存在返回0 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.TemporalAccessorUtil.format(java.time.temporal.TemporalAccessor, java.time.format.DateTimeFormatter)</a></td> 
   <td> 
    <div>
      格式化日期时间为指定格式 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.TemporalAccessorUtil.format(java.time.temporal.TemporalAccessor, java.lang.String)</a></td> 
   <td> 
    <div>
      格式化日期时间为指定格式 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.TemporalAccessorUtil.toEpochMilli(java.time.temporal.TemporalAccessor)</a></td> 
   <td> 
    <div>
      {@link TemporalAccessor}转换为 时间戳（从1970-01-01T00:00:00Z开始的毫秒数） 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.TemporalAccessorUtil.toInstant(java.time.temporal.TemporalAccessor)</a></td> 
   <td> 
    <div>
      {@link TemporalAccessor}转换为 {@link Instant}对象 
    </div></td> 
  </tr> 
 </tbody> 
</table>

## 方法明细 ##

### 方法名称:cn.hutool.core.date.TemporalAccessorUtil.get(java.time.temporal.TemporalAccessor, java.time.temporal.TemporalField) ###

### 方法描述 ###

安全获取时间的某个属性，属性不存在返回0

### 支持版本及以上 ###

### 参数描述: ###

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>TemporalAccessor temporalAccessor</td> 
   <td> 
    <div>
      temporalAccessor 需要获取的时间对象 
    </div></td> 
  </tr> 
  <tr> 
   <td>TemporalField field</td> 
   <td> 
    <div>
      field 需要获取的属性 
    </div></td> 
  </tr> 
 </tbody> 
</table>

### 返回值: ###

时间的值，如果无法获取则默认为 0

### 参考案例: ###

String dateStr = "2021-05-22T14:05:20";
    		LocalDateTime localDate = LocalDateTime.parse(dateStr);
    		//ChronoField 为ChronoField的实现类/枚举
    		Assert.assertEquals(2021, TemporalAccessorUtil.get(localDate, ChronoField.YEAR));
    		Assert.assertEquals(5, TemporalAccessorUtil.get(localDate, ChronoField.MONTH_OF_YEAR));
    		Assert.assertEquals(22, TemporalAccessorUtil.get(localDate, ChronoField.DAY_OF_MONTH));
    		Assert.assertEquals(14, TemporalAccessorUtil.get(localDate, ChronoField.HOUR_OF_DAY));
    		Assert.assertEquals(05, TemporalAccessorUtil.get(localDate, ChronoField.MINUTE_OF_HOUR));
    		Assert.assertEquals(20, TemporalAccessorUtil.get(localDate, ChronoField.SECOND_OF_MINUTE));

### 源码解析： ###

链接：待补充

## 方法明细 ##

### 方法名称:cn.hutool.core.date.TemporalAccessorUtil.format(java.time.temporal.TemporalAccessor, java.time.format.DateTimeFormatter) ###

### 方法描述 ###

格式化日期时间为指定格式

### 支持版本及以上 ###

5.3.10

### 参数描述: ###

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>TemporalAccessor time</td> 
   <td> 
    <div>
      time {@link TemporalAccessor} 
    </div></td> 
  </tr> 
  <tr> 
   <td>DateTimeFormatter formatter</td> 
   <td> 
    <div>
      formatter 日期格式化器，预定义的格式见：{@link DateTimeFormatter} 
    </div></td> 
  </tr> 
 </tbody> 
</table>

### 返回值: ###

格式化后的字符串

### 参考案例: ###

String dateStr = "2021-05-22T14:05:20";
    		LocalDateTime localDateTime = LocalDateTime.parse(dateStr);
    		Assert.assertEquals(dateStr,TemporalAccessorUtil.format(localDateTime,DateTimeFormatter.ISO_LOCAL_DATE_TIME));

### 源码解析： ###

链接：待补充

## 方法明细 ##

### 方法名称:cn.hutool.core.date.TemporalAccessorUtil.format(java.time.temporal.TemporalAccessor, java.lang.String) ###

### 方法描述 ###

格式化日期时间为指定格式

### 支持版本及以上 ###

5.3.10

### 参数描述: ###

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>TemporalAccessor time</td> 
   <td> 
    <div>
      time {@link TemporalAccessor} 
    </div></td> 
  </tr> 
  <tr> 
   <td>String format</td> 
   <td> 
    <div>
      format 日期格式 
    </div></td> 
  </tr> 
 </tbody> 
</table>

### 返回值: ###

格式化后的字符串

### 参考案例: ###

String dateStr = "2021-05-22";
    		LocalDate localDate = LocalDate.parse(dateStr);
    		Assert.assertEquals(dateStr,TemporalAccessorUtil.format(localDate,"yyyy-MM-dd"));

### 源码解析： ###

链接：待补充

## 方法明细 ##

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

### 方法描述 ###

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

### 支持版本及以上 ###

5.4.1

### 参数描述: ###

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>TemporalAccessor temporalAccessor</td> 
   <td> 
    <div>
      temporalAccessor Date对象 
    </div></td> 
  </tr> 
 </tbody> 
</table>

### 返回值: ###

\{@link Instant\}对象

### 参考案例: ###

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

### 源码解析： ###

链接：待补充

## 方法明细 ##

### 方法名称:cn.hutool.core.date.TemporalAccessorUtil.toInstant(java.time.temporal.TemporalAccessor) ###

### 方法描述 ###

\{@link TemporalAccessor\}转换为 \{@link Instant\}对象

### 支持版本及以上 ###

5.3.10

### 参数描述: ###

### 返回值: ###

\{@link Instant\}对象

### 参考案例: ###

LocalDateTime localDateTime = LocalDateTime.parse("2021-05-22T08:30:00", DateTimeFormatter.ISO_DATE_TIME);
    		Instant instant = TemporalAccessorUtil.toInstant(localDateTime);
    		Assert.assertEquals("2021-05-22T00:30:00Z", instant.toString());

### 源码解析： ###

链接：待补充

[hutool]: https://blog.csdn.net/shi_hong_fei_hei/article/details/117253917
[java]: https://xiaoxuzhu.blog.csdn.net/article/details/118947669