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

看本篇文章前，建议先对java源码的日期和时间有一定的了解，如果不了解的话，可以先看这篇文章：

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

关联文章：

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

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

源码分析目的

知其然，知其所以然

项目引用

此博文的依据：hutool-5.6.5版本源码 源码**format(time, DateTimeFormatter.ofPattern(format))**可以拆解成两部分：

DateTimeFormatter.ofPattern(format)

format(LocalDateTime time, DateTimeFormatter formatter)

第一部分：**DateTimeFormatter.ofPattern(format)**是把字符串日期时间格式转化为日期时间格式化对象DateTimeFormatter ；

注意DateTimeFormatter.ofPattern(format)的用法是有坑的(代码详解–>万字博文教你搞懂java源码的日期和时间相关用法):

在正常配置按照标准格式的字符串日期，是能够正常转换的。如果月，日，时，分，秒在不足两位的情况需要补0，否则的话会转换失败，抛出异常。

YYYY和DD谨慎使用

第二部分，format(LocalDateTime time, DateTimeFormatter formatter)上面有介绍了，这里就不水字了。

方法名称:DateUtil.format(java.util.Date, java.text.DateFormat)

方法描述

根据特定格式格式化日期

源码分析一

/**
 * 根据特定格式格式化日期
 *
 * @param date   被格式化的日期
 * @param format 日期格式，常用格式见： {@link DatePattern}
 * @return 格式化后的字符串
 */
public static String format(Date date, String format) {
   if (null == date || StrUtil.isBlank(format)) {
      return null;
   }
   TimeZone timeZone = null;
   if (date instanceof DateTime) {
      timeZone = ((DateTime) date).getTimeZone();
   }
   return format(date, newSimpleFormat(format, null, timeZone));
}

从代码中**format(Date date, String format)**方法提供了两个入参，一个是Date 类型的 被格式化的日期和要日期格式的字符串。这是为了兼容java8之前的旧日期时间API提供的方法。

方法内首先对两个参数加了判空处理。

然后判断时间是否是hutool的DateTime对象，如果是，则获取时区TimeZone

接着调用format(date, newSimpleFormat(format, null, timeZone)),可拆解成两部分：

newSimpleFormat(format, null, timeZone)，获取SimpleDateFormat对象（注：此方法是非线程安全的）

format(Date date, DateFormat format) 根据特定格式格式化日期

首先：**newSimpleFormat(format, null, timeZone)**代码详解： 对两个入参进行了判空处理。然后调用SimpleDateFormat.format(date)，这是java8之前就有提供的方法。

方法名称:DateUtil.format(java.util.Date, java.time.format.DateTimeFormatter)（方法有问题，已反馈,官方已修正）

方法描述

根据特定格式格式化日期

源码分析一

首先好习惯，先对入参进行判空处理

然后调用DatePattern.HTTP_DATETIME_FORMAT.format(date)返回FastDateFormat对象

针对只支持java8之前的程序，可以使用FastDateFormat线程安全替换SimpleDateFormat线程不安全–》源码分析

 FastDateFormat 是一个线程安全的实现
来源 Apache Commons Lang 3.5

  /**
   * HTTP头中日期时间格式 {@link FastDateFormat}：EEE, dd MMM yyyy HH:mm:ss z
   */
  public static final FastDateFormat HTTP_DATETIME_FORMAT = FastDateFormat.getInstance(HTTP_DATETIME_PATTERN, TimeZone.getTimeZone("GMT"), Locale.US);

/**
 * 标准日期格式 {@link FastDateFormat}：yyyy年MM月dd日HH时mm分ss秒
 */
public static final FastDateFormat CHINESE_DATE_TIME_FORMAT = FastDateFormat.getInstance(CHINESE_DATE_TIME_PATTERN);
  /**
   * 标准日期格式 {@link FastDateFormat}：yyyy年MM月dd日
   */
  public static final FastDateFormat CHINESE_DATE_FORMAT = FastDateFormat.getInstance(CHINESE_DATE_PATTERN);

由上面源码可知，两个都是返回FastDateFormat对象。

针对只支持java8之前的程序，可以使用FastDateFormat线程安全替换SimpleDateFormat线程不安全–》源码分析

  /**
   * HTTP头中日期时间格式 {@link FastDateFormat}：EEE, dd MMM yyyy HH:mm:ss z
   */
  public static final FastDateFormat HTTP_DATETIME_FORMAT = FastDateFormat.getInstance(HTTP_DATETIME_PATTERN, TimeZone.getTimeZone("GMT"), Locale.US);

/**
 * 将指定Calendar时间格式化为纯中文形式，比如：
 *
 * <pre>
 *     2018-02-24 12:13:14转换为 二〇一八年二月二十四日（withTime为false）
 *     2018-02-24 12:13:14 转换为 二〇一八年二月二十四日一十二时一十三分一十四秒（withTime为true）
 * </pre>
 *
 * @param calendar {@link Calendar}
 * @param withTime 是否包含时间部分
 * @return 格式化后的字符串
 * @since 5.3.9
 */
public static String formatChineseDate(Calendar calendar, boolean withTime) {
   final StringBuilder result = StrUtil.builder();
   // 年
   String year = String.valueOf(calendar.get(Calendar.YEAR));
   final int length = year.length();
   for (int i = 0; i < length; i++) {
      result.append(NumberChineseFormatter.numberCharToChinese(year.charAt(i), false));
   }
   result.append('年');
   // 月
   int month = calendar.get(Calendar.MONTH) + 1;
   result.append(NumberChineseFormatter.format(month, false));
   result.append('月');
   // 日
   int day = calendar.get(Calendar.DAY_OF_MONTH);
   result.append(NumberChineseFormatter.format(day, false));
   result.append('日');
   if (withTime) {
      // 时
      int hour = calendar.get(Calendar.HOUR_OF_DAY);
      result.append(NumberChineseFormatter.format(hour, false));
      result.append('时');
      // 分
      int minute = calendar.get(Calendar.MINUTE);
      result.append(NumberChineseFormatter.format(minute, false));
      result.append('分');
      // 秒
      int second = calendar.get(Calendar.SECOND);
      result.append(NumberChineseFormatter.format(second, false));
      result.append('秒');
   }
   return result.toString().replace('零', '〇');
}

由源码可知，是按年月日时分秒，每个字段进行转化。