4hutool实战:DateUtil-格式化时间

梦里梦外; 2022-10-16 04:49 384阅读 0赞

技术活，该赏
    关注+一键三连（点赞，评论，收藏）再看，养成好习惯

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

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

[java的SimpleDateFormat线程不安全出问题了，虚竹教你多种解决方案（万字长文\*建议收藏）][java_SimpleDateFormat]

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

# hutool日期时间系列文章 #

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

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

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

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

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

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

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

[8ChineseDate(农历日期工具类)][8ChineseDate]

[9LocalDateTimeUtil(JDK8+中的\{@link LocalDateTime\} 工具类封装)][9LocalDateTimeUtil_JDK8_link LocalDateTime_]

[10TemporalAccessorUtil\{@link TemporalAccessor\} 工具类封装][10TemporalAccessorUtil_link TemporalAccessor_]

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

# 用途：格式化时间 #

## 使用场景 ##

把日期按照不同的需求格式化成对应的日期字符串

## 项目引用 ##

此博文的依据：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.DateUtil.formatLocalDateTime(java.time.LocalDateTime)</a></td> 
   <td> 
    <div>
      格式化日期时间&lt;br&gt; 格式 yyyy-MM-dd HH:mm:ss 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.DateUtil.format(java.time.LocalDateTime, java.lang.String)</a></td> 
   <td> 
    <div>
      根据特定格式格式化日期 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.DateUtil.format(java.util.Date, java.lang.String)</a></td> 
   <td> 
    <div>
      根据特定格式格式化日期 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.DateUtil.format(java.util.Date, cn.hutool.core.date.format.DatePrinter)</a></td> 
   <td> 
    <div>
      根据特定格式格式化日期 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.DateUtil.format(java.util.Date, java.text.DateFormat)</a></td> 
   <td> 
    <div>
      根据特定格式格式化日期 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.DateUtil.format(java.util.Date, java.time.format.DateTimeFormatter)</a></td> 
   <td> 
    <div>
      根据特定格式格式化日期 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.DateUtil.formatDateTime(java.util.Date)</a></td> 
   <td> 
    <div>
      格式化日期时间&lt;br&gt; 格式 yyyy-MM-dd HH:mm:ss 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.DateUtil.formatDate(java.util.Date)</a></td> 
   <td> 
    <div>
      格式化日期部分（不包括时间）&lt;br&gt; 格式 yyyy-MM-dd 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.DateUtil.formatTime(java.util.Date)</a></td> 
   <td> 
    <div>
      格式化时间&lt;br&gt; 格式 HH:mm:ss 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.DateUtil.formatHttpDate(java.util.Date)</a></td> 
   <td> 
    <div>
      格式化为Http的标准日期格式&lt;br&gt; 标准日期格式遵循RFC 1123规范，格式类似于：Fri, 31 Dec 1999 23:59:59 GMT 
    </div></td> 
  </tr> 
  <tr> 
   <td><a rel="nofollow">cn.hutool.core.date.DateUtil.formatChineseDate(java.util.Date, boolean, boolean)</a></td> 
   <td> 
    <div>
      格式化为中文日期格式，如果isUppercase为false，则返回类似：2018年10月24日，否则返回二〇一八年十月二十四日 
    </div></td> 
  </tr> 
 </tbody> 
</table>

## 方法明细 ##

### 方法名称:cn.hutool.core.date.DateUtil.formatLocalDateTime(java.time.LocalDateTime) ###

### 方法描述 ###

格式化日期时间<br>  
格式 yyyy-MM-dd HH:mm:ss

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

### 参数描述: ###

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>LocalDateTime localDateTime</td> 
   <td> 
    <div>
      localDateTime 被格式化的日期 
    </div></td> 
  </tr> 
 </tbody> 
</table>

### 返回值: ###

格式化后的字符串

### 参考案例: ###

String strDate = "2019-12-01 17:02:30";
    		LocalDateTime ldt = DateUtil.parseLocalDateTime(strDate);
    		String strDate1 = DateUtil.formatLocalDateTime(ldt);
    		Assert.assertEquals(strDate, strDate1);

### 源码解析： ###

[4hutool源码分析：DateUtil(时间工具类)-格式化时间(万字长文源码分析，学大佬如何写代码)][4hutool_DateUtil_-]

## 方法明细 ##

### 方法名称:cn.hutool.core.date.DateUtil.format(java.time.LocalDateTime, java.lang.String) ###

### 方法描述 ###

根据特定格式格式化日期

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

### 参数描述: ###

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>LocalDateTime localDateTime</td> 
   <td> 
    <div>
      localDateTime 被格式化的日期 
    </div></td> 
  </tr> 
  <tr> 
   <td>String format</td> 
   <td> 
    <div>
      format 日期格式，常用格式见： {@link DatePattern} 
    </div></td> 
  </tr> 
 </tbody> 
</table>

### 返回值: ###

格式化后的字符串

### 参考案例: ###

String strDate2 = "2019-12-01 17:02:30.111";
    		ldt = DateUtil.parseLocalDateTime(strDate2, DatePattern.NORM_DATETIME_MS_PATTERN);
    		strDate1 = DateUtil.format(ldt, DatePattern.NORM_DATETIME_PATTERN);
    		Assert.assertEquals(strDate, strDate1);

### 源码解析： ###

[4hutool源码分析：DateUtil(时间工具类)-格式化时间(万字长文源码分析，学大佬如何写代码)][4hutool_DateUtil_-]

## 方法明细 ##

### 方法名称:cn.hutool.core.date.DateUtil.format(java.util.Date, java.lang.String) ###

### 方法描述 ###

根据特定格式格式化日期

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

### 参数描述: ###

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Date date</td> 
   <td> 
    <div>
      date 被格式化的日期 
    </div></td> 
  </tr> 
  <tr> 
   <td>String format</td> 
   <td> 
    <div>
      format 日期格式，常用格式见： {@link DatePattern} 
    </div></td> 
  </tr> 
 </tbody> 
</table>

### 返回值: ###

格式化后的字符串

### 参考案例: ###

String strDate = "2021-05-16";
    		SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
    		Date localDate = sdf.parse(strDate);
    		Assert.assertEquals(strDate, DateUtil.format(localDate, DatePattern.NORM_DATE_PATTERN));

### 源码解析： ###

[4hutool源码分析：DateUtil(时间工具类)-格式化时间(万字长文源码分析，学大佬如何写代码)][4hutool_DateUtil_-]

## 方法明细 ##

### 方法名称:cn.hutool.core.date.DateUtil.format(java.util.Date, cn.hutool.core.date.format.DatePrinter) ###

### 方法描述 ###

根据特定格式格式化日期

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

### 参数描述: ###

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Date date</td> 
   <td> 
    <div>
      date 被格式化的日期 
    </div></td> 
  </tr> 
  <tr> 
   <td>DatePrinter format</td> 
   <td> 
    <div>
      format {@link DatePrinter} 或 {@link FastDateFormat} 
    </div></td> 
  </tr> 
 </tbody> 
</table>

### 返回值: ###

格式化后的字符串

### 参考案例: ###

//根据特定格式格式化日期
    		String str = "2021-05-16";
    		SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd", Locale.US);
    		Date date = DateUtil.parse(str);
    		String dateStr = DateUtil.format(date,sdf);
    		System.out.println(dateStr);
    		Assert.assertEquals(str, dateStr);

### 源码解析： ###

[4hutool源码分析：DateUtil(时间工具类)-格式化时间(万字长文源码分析，学大佬如何写代码)][4hutool_DateUtil_-]

## 方法明细 ##

### 方法名称:cn.hutool.core.date.DateUtil.format(java.util.Date, java.text.DateFormat) ###

### 方法描述 ###

根据特定格式格式化日期

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

### 参数描述: ###

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Date date</td> 
   <td> 
    <div>
      date 被格式化的日期 
    </div></td> 
  </tr> 
  <tr> 
   <td>DateFormat format</td> 
   <td> 
    <div>
      format {@link SimpleDateFormat} 
    </div></td> 
  </tr> 
 </tbody> 
</table>

### 返回值: ###

格式化后的字符串

### 参考案例: ###

待补充

### 源码解析： ###

[4hutool源码分析：DateUtil(时间工具类)-格式化时间(万字长文源码分析，学大佬如何写代码)][4hutool_DateUtil_-]

## 方法明细 ##

### 方法名称:cn.hutool.core.date.DateUtil.format(java.util.Date, java.time.format.DateTimeFormatter) ###

### 方法描述 ###

根据特定格式格式化日期

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

5.0.0

### 参数描述: ###

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Date date</td> 
   <td> 
    <div>
      date 被格式化的日期 
    </div></td> 
  </tr> 
  <tr> 
   <td>DateTimeFormatter format</td> 
   <td> 
    <div>
      format {@link SimpleDateFormat} 
    </div></td> 
  </tr> 
 </tbody> 
</table>

### 返回值: ###

格式化后的字符串

### 参考案例: ###

//根据特定格式格式化日期
    		String str = "2021-05-16";
    		DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd", Locale.US);
    		Date date = DateUtil.parse(str);
    		String dateStr = DateUtil.format(date,dtf);
    		System.out.println(dateStr);
    		Assert.assertEquals(str, dateStr);
    		// 此方法有问题，官方已处理 处理版本是5.7.5 修复 
    		java.time.temporal.UnsupportedTemporalTypeException: Unsupported field: YearOfEra

### 源码解析： ###

[4hutool源码分析：DateUtil(时间工具类)-格式化时间(万字长文源码分析，学大佬如何写代码)][4hutool_DateUtil_-]

## 方法明细 ##

### 方法名称:cn.hutool.core.date.DateUtil.formatDateTime(java.util.Date) ###

### 方法描述 ###

格式化日期时间<br>  
格式 yyyy-MM-dd HH:mm:ss

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

### 参数描述: ###

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Date date</td> 
   <td> 
    <div>
      date 被格式化的日期 
    </div></td> 
  </tr> 
 </tbody> 
</table>

### 返回值: ###

格式化后的日期

### 参考案例: ###

String dateStr = "2017-03-01";
    		Date date = DateUtil.parse(dateStr);
    
    		String format = DateUtil.format(date, "yyyy/MM/dd");
    		Assert.assertEquals("2017/03/01", format);
    
    		// 常用格式的格式化
    		String formatDate = DateUtil.formatDate(date);
    		Assert.assertEquals("2017-03-01", formatDate);
    		String formatDateTime = DateUtil.formatDateTime(date);
    		Assert.assertEquals("2017-03-01 00:00:00", formatDateTime);
    		String formatTime = DateUtil.formatTime(date);
    		Assert.assertEquals("00:00:00", formatTime);

### 源码解析： ###

[4hutool源码分析：DateUtil(时间工具类)-格式化时间(万字长文源码分析，学大佬如何写代码)][4hutool_DateUtil_-]

## 方法明细 ##

### 方法名称:cn.hutool.core.date.DateUtil.formatDate(java.util.Date) ###

### 方法描述 ###

格式化日期部分（不包括时间）<br>  
格式 yyyy-MM-dd

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

### 参数描述: ###

### 返回值: ###

格式化后的字符串

### 参考案例: ###

### 源码解析： ###

[4hutool源码分析：DateUtil(时间工具类)-格式化时间(万字长文源码分析，学大佬如何写代码)][4hutool_DateUtil_-]

## 方法明细 ##

### 方法名称:cn.hutool.core.date.DateUtil.formatTime(java.util.Date) ###

### 方法描述 ###

格式化时间<br>  
格式 HH:mm:ss

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

3.0.1

### 参数描述: ###

### 返回值: ###

格式化后的字符串

### 参考案例: ###

### 源码解析： ###

[4hutool源码分析：DateUtil(时间工具类)-格式化时间(万字长文源码分析，学大佬如何写代码)][4hutool_DateUtil_-]

## 方法明细 ##

### 方法名称:cn.hutool.core.date.DateUtil.formatHttpDate(java.util.Date) ###

### 方法描述 ###

格式化为Http的标准日期格式<br>  
标准日期格式遵循RFC 1123规范，格式类似于：Fri, 31 Dec 1999 23:59:59 GMT

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

### 参数描述: ###

### 返回值: ###

HTTP标准形式日期字符串

### 参考案例: ###

String formatHttpDate = DateUtil.formatHttpDate(DateUtil.parse("2019-01-02 22:32:01"));
    		Assert.assertEquals("Wed, 02 Jan 2019 14:32:01 GMT", formatHttpDate);

### 源码解析： ###

[4hutool源码分析：DateUtil(时间工具类)-格式化时间(万字长文源码分析，学大佬如何写代码)][4hutool_DateUtil_-]

## 方法明细 ##

### 方法名称:cn.hutool.core.date.DateUtil.formatChineseDate(java.util.Date, boolean, boolean) ###

### 方法描述 ###

格式化为中文日期格式，如果isUppercase为false，则返回类似：2018年10月24日，否则返回二〇一八年十月二十四日

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

5.3.9

### 参数描述: ###

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Date date</td> 
   <td> 
    <div>
      date 被格式化的日期 
    </div></td> 
  </tr> 
  <tr> 
   <td>boolean isUppercase</td> 
   <td> 
    <div>
      isUppercase 是否采用大写形式 
    </div></td> 
  </tr> 
  <tr> 
   <td>boolean withTime</td> 
   <td> 
    <div>
      withTime 是否包含时间部分 
    </div></td> 
  </tr> 
 </tbody> 
</table>

### 返回值: ###

中文日期字符串

### 参考案例: ###

String formatChineseDate = DateUtil.formatChineseDate(DateUtil.parse("2018-02-24"), true, false);
    		Assert.assertEquals("二〇一八年二月二十四日", formatChineseDate);

### 源码解析： ###

[4hutool源码分析：DateUtil(时间工具类)-格式化时间(万字长文源码分析，学大佬如何写代码)][4hutool_DateUtil_-]

[hutool]: https://blog.csdn.net/shi_hong_fei_hei/article/details/117253917
[java]: https://xiaoxuzhu.blog.csdn.net/article/details/118947669
[java_SimpleDateFormat]: https://xiaoxuzhu.blog.csdn.net/article/details/119422646
[JDK_native]: https://xiaoxuzhu.blog.csdn.net/article/details/118658071
[1DateUtil_-]: https://blog.csdn.net/shi_hong_fei_hei/article/details/117254005
[2DateUtil_-_Date_DateTime_Calendar_TemporalAccessor_LocalDateTime]: https://blog.csdn.net/shi_hong_fei_hei/article/details/117304856
[3DateUtil_-]: https://blog.csdn.net/shi_hong_fei_hei/article/details/117305070
[4DateUtil_-]: https://blog.csdn.net/shi_hong_fei_hei/article/details/117305616
[5DateUtil_-]: https://blog.csdn.net/shi_hong_fei_hei/article/details/117305724
[6DateUtil_-]: https://blog.csdn.net/shi_hong_fei_hei/article/details/117430937
[7DateUtil_-]: https://blog.csdn.net/shi_hong_fei_hei/article/details/117431081
[8ChineseDate]: https://blog.csdn.net/shi_hong_fei_hei/article/details/117431150
[9LocalDateTimeUtil_JDK8_link LocalDateTime_]: https://blog.csdn.net/shi_hong_fei_hei/article/details/117431359
[10TemporalAccessorUtil_link TemporalAccessor_]: https://blog.csdn.net/shi_hong_fei_hei/article/details/117431538
[4hutool_DateUtil_-]: https://xiaoxuzhu.blog.csdn.net/article/details/119190227