背景

前後端進行時間類型的傳遞時，往往是

前端傳遞時間格式的字元串，後端反序列化成對應的時間類型
後端傳回資料時，一般是将時間類型的對象，序列化成時間格式的字元串

Spring 的生态中已經為我們提供了對應的解決方案

約定

如下是對本文的讨論背景做出的約定

架構 : Spring boot (Spring web)
json 序列化、反序列化工具： Jackson
傳輸協定 : http
接口傳回值格式 : JSON

反序列化

時間格式字元串->時間類型

常見于前端傳參，一般分為4種情況

Post + Content-Type : application/json
Post + Content-Type : application/x-www-form-urlencoded
Post + Content-Type : multipart/form-data
Get

以上四種最常見情況，每種資料編碼格式都不一樣，是以對應的反序列化方法也不同

在 Spring web 生态中，對于 Post + Content-Type : application/json 的方式一般是用 json 工具進行反序列化，例如 Spring 自帶的 jackson，抑或是阿裡巴巴的 fastjson

而其它非 json 送出的情況， json 工具就派不上用場了，Spring 提供了額外的反序列化方式，來處理這些情況

局部處理反序列化

局部處理反序列化的好處在于，粒度更細，使用更靈活，在 Spring web 生态中有兩種局部處理方式，來處理上述4種常見情況

@JsonFormat 或 @JSONField

@JsonFormat 或 @JSONField 注解都可以用在時間類型的字段上,用來對該字段提供反序列化支援，例如

@JSONField(format="yyyy-MM-dd HH:mm:ss")
private Date date;

@JSONField(format="yyyy-MM-dd HH:mm:ss")
private LocalDateTime localDateTime4;

@JSONField(format="yyyy-MM-dd")
private LocalDate localDate;
複制代碼

@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date date;

@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime localDateTime4;

@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate localDate;
複制代碼

注意 @JsonFormat 或 @JSONField 注解，隻能用于json(Post + Content-Type : application/json)送出的反序列化，表單送出或者Get送出是不支援的

// 這種帶 @RequestBody 的 Pojo ，内部的 時間類型字段就可以使用  @JsonFormat 或 @JSONField
@PostMapping("/json")
public Pojo json(@RequestBody Pojo pojo) {
    return pojo;
}
複制代碼

@JsonFormat 、 @JSONField 的差別與使用

@JsonFormat 注解來源于 Spring web 自帶 jackson，無需配置直接可以使用

@JSONField 注解來源于阿裡巴巴的 fastjson，需要進行配置，用 fastjson 替換掉Spring web 預設使用的 jackson 之後，才能使用。

@DateTimeFormat

@DateTimeFormat 是 Spring web 提供的針對非 json 送出，如

Post + Content-Type : application/x-www-form-urlencoded
Post + Content-Type : multipart/form-data
Get

等方式時，時間類型的反序列化解決方案

// Get 傳參的 Pojo ，内部的 時間類型字段可以使用 @DateTimeFormat 進行反序列化
@GetMapping
public Pojo get(Pojo pojo) {
    return pojo;
}

// 表單傳參的 Pojo ，内部的 時間類型字段可以使用 @DateTimeFormat 進行反序列化
@PostMapping
public Pojo post(Pojo pojo) {
    return pojo;
}
複制代碼

@DateTimeFormat 的用法

@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date date;

@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime localDateTime;

@DateTimeFormat(pattern = "yyyy-MM-dd")
private LocalDate localDate;
複制代碼

全局處理

Spring web 對于 json 傳參使用的是 HttpMessageConverter<T> 轉換類，而時間字元串作為普通請求參數傳入時，轉換用的是 Converter<S, T>, Converter 的不同，意味着處理方式也不同。

非 json 傳參的反序列化全局處理

import org.apache.commons.lang3.StringUtils;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.convert.converter.Converter;

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.time.*;
import java.time.format.DateTimeFormatter;
import java.util.Date;
import java.util.TimeZone;

/**
 * 自定義參數轉換器，全局反序列化 GET請求、POST表單 送出的時間字元串
 */
@Configuration
public class DateConverterConfig {

    /**
     * yyyy-MM-dd 時間格式的正規表達式
     */
    private static final String DATE_REGEX = "[1-9]\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])";

    /**
     * HH:mm:ss 時間格式的正規表達式
     */
    private static final String TIME_REGEX = "(20|21|22|23|[0-1]\d):[0-5]\d:[0-5]\d";

    /**
     * yyyy-MM-dd HH:mm:ss 時間格式的正規表達式
     */
    private static final String DATE_TIME_REGEX = DATE_REGEX + "\s" + TIME_REGEX;

    /**
     * yyyy-MM-ddTHH:mm:ss 時間格式的正規表達式
     */
    private static final String DATE_T_TIME_REGEX = DATE_REGEX + "T" + TIME_REGEX;

    /**
     * yyyy-MM-ddTHH:mm:ss.SSS 時間格式的正規表達式
     */
    private static final String DATE_T_TIME_MS_REGEX = DATE_REGEX + "T" + TIME_REGEX + ".\d{3}";

    /**
     * 13位時間戳正規表達式
     */
    private static final String TIME_STAMP_REGEX = "1\d{12}";

    /**
     * yyyy-MM 時間格式的正規表達式
     */
    private static final String YEAR_MONTH_REGEX = "[1-9]\d{3}-(0[1-9]|1[0-2])";

    /**
     * yyyy-MM 格式
     */
    private static final String YEAR_MONTH_PATTERN = "yyyy-MM";

    /**
     * DateTime格式化字元串
     */
    private static final String DEFAULT_DATETIME_PATTERN = "yyyy-MM-dd HH:mm:ss";

    /**
     * DateTime格式化字元串 ISO 格式
     */
    private static final String DEFAULT_DATETIME_ISO_PATTERN = "yyyy-MM-ddTHH:mm:ss";

    /**
     * DateTime格式化字元串 帶毫秒值的 ISO 格式
     */
    private static final String DEFAULT_DATETIME_MS_ISO_PATTERN = "yyyy-MM-ddTHH:mm:ss.SSS";

    /**
     * Date格式化字元串
     */
    private static final String DEFAULT_DATE_FORMAT = "yyyy-MM-dd";

    /**
     * Time格式化字元串
     */
    private static final String DEFAULT_TIME_FORMAT = "HH:mm:ss";

    /**
     * 根據 pattern 建構 SimpleDateFormat
     * @param pattern
     * @return
     */
    private SimpleDateFormat getSimpleDateFormat(String pattern){
        SimpleDateFormat df =  new SimpleDateFormat(pattern);
        System.out.println(TimeZone.getDefault());
        df.setTimeZone(TimeZone.getTimeZone ("GMT"));
        return df;
    }

    /**
     * String -> Date 轉換器
     * 用于轉換 @RequestParam參數、@PathVariable參數、表單參數
     */
    @Bean
    public Converter<String, Date> dateConverter() {
        return new Converter<String, Date>() {
            @SuppressWarnings("NullableProblems")
            @Override
            public Date convert(String source) {
                if (StringUtils.isEmpty(source)) {
                    return null;
                }
                // 13位毫秒值 -> Date
                if (source.matches(TIME_STAMP_REGEX)) {
                    return new Date(Long.parseLong(source));
                }
                try {
                    // yyyy-MM-dd HH:mm:ss -> Date
                    if (source.matches(DATE_TIME_REGEX)) {
                        return getSimpleDateFormat(DEFAULT_DATETIME_PATTERN).parse(source);
                    }

                    // yyyy-MM-dd -> Date
                    if (source.matches(DATE_REGEX)) {
                        return getSimpleDateFormat(DEFAULT_DATE_FORMAT).parse(source);
                    }

                    // yyyy-MM -> Date
                    if (source.matches(YEAR_MONTH_REGEX)) {
                        return getSimpleDateFormat(YEAR_MONTH_PATTERN).parse(source);
                    }
                } catch (ParseException e) {
                    throw new RuntimeException(e);
                }
                return null;
            }
        };
    }


    /**
     * String -> LocalDateTime 轉換器
     * 用于轉換 @RequestParam參數、@PathVariable參數、表單參數
     */
    @Bean
    public Converter<String, LocalDateTime> localDateTimeConverter() {
        return new Converter<String, LocalDateTime>() {
            @SuppressWarnings("NullableProblems")
            @Override
            public LocalDateTime convert(String source) {
                if (StringUtils.isEmpty(source)) {
                    return null;
                }
                // 13位毫秒值 -> LocalDateTime
                if (source.matches(TIME_STAMP_REGEX)) {
                    Instant instant = Instant.ofEpochMilli(Long.parseLong(source));
                    ZoneId zone = ZoneId.systemDefault();
                    return LocalDateTime.ofInstant(instant, zone);
                }
                // yyyy-MM-dd HH:mm:ss -> LocalDateTime
                if (source.matches(DATE_TIME_REGEX)) {
                    return LocalDateTime.parse(source, DateTimeFormatter.ofPattern(DEFAULT_DATETIME_PATTERN));
                }

                // yyyy-MM-ddTHH:mm:ss -> LocalDateTime
                if (source.matches(DATE_T_TIME_REGEX)) {
                    return LocalDateTime.parse(source, DateTimeFormatter.ofPattern(DEFAULT_DATETIME_ISO_PATTERN));
                }

                // yyyy-MM-ddTHH:mm:ss.SSS -> LocalDateTime
                if (source.matches(DATE_T_TIME_MS_REGEX)) {
                    return LocalDateTime.parse(source, DateTimeFormatter.ofPattern(DEFAULT_DATETIME_MS_ISO_PATTERN));
                }

                return null;
            }
        };
    }

    /**
     * String -> LocalDate 轉換器
     * 用于轉換 @RequestParam參數、@PathVariable參數、表單參數
     */
    @Bean
    public Converter<String, LocalDate> localDateConverter() {
        return new Converter<String, LocalDate>() {
            @SuppressWarnings("NullableProblems")
            @Override
            public LocalDate convert(String source) {
                if (StringUtils.isEmpty(source)) {
                    return null;
                }
                // 13位毫秒值 -> LocalDate
                if (source.matches(TIME_STAMP_REGEX)) {
                    Instant instant = Instant.ofEpochMilli(Long.parseLong(source));
                    ZoneId zone = ZoneId.systemDefault();
                    return LocalDateTime.ofInstant(instant, zone).toLocalDate();
                }

                // yyyy-MM-dd -> LocalDate
                if (source.matches(DATE_REGEX)) {
                    return LocalDate.parse(source, DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT));
                }

                return null;
            }
        };
    }

    /**
     * String -> LocalTime 轉換器
     * 用于轉換 @RequestParam參數、@PathVariable參數、表單參數
     */
    @Bean
    public Converter<String, LocalTime> localTimeConverter() {
        return new Converter<String, LocalTime>() {
            @SuppressWarnings("NullableProblems")
            @Override
            public LocalTime convert(String source) {
                if (StringUtils.isEmpty(source)) {
                    return null;
                }
                // HH:mm:ss -> LocalTime
                return LocalTime.parse(source, DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT));
            }
        };
    }

}
複制代碼

注意：使用了自定義參數轉化器（Converter），Spring 會優先使用該方式進行處理，@DateTimeFormat 注解将不生效!!! 這兩種方案是不相容!!!

json 傳參的反序列化全局處理

如果是 json 傳參，反序列化時，可以通過配置 json 工具進行全局處理。

以 Spring web 自帶的 jackson 為例，它配置全局時間格式化時， java.util 包中的時間類型與 java 8 之後引入了 java.time 包中的時間類型，要分開配置

全局配置 java.util 包中的時間類型的反序列化格式

常用的時間類型包括

java.util.Date
java.util.Calendar

通過配置檔案配置，以 yaml 為例

spring:
  jackson:
    date-format: yyyy-MM-dd HH:mm:ss
    time-zone: GMT+8
複制代碼

這是最簡單的配置方式，也可以采取其他方式，這裡就不例舉了

全局配置 java.time 包中的時間類型的反序列化格式

常用的時間類型包括

java.time.LocalDateTime
java.time.LocalDate

@Configuration
public class JacksonConfig {
    private static final String DATE_FORMAT = "yyyy-MM-dd";
    private static final String DATE_TIME_FORMAT = "yyyy-MM-dd HH:mm:ss";
    
    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jackson2ObjectMapperBuilderCustomizer() {
        return builder -> {
            builder.deserializerByType(LocalDateTime.class, new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern(DATE_TIME_FORMAT)));
            builder.deserializerByType(LocalDate.class, new LocalDateDeserializer(DateTimeFormatter.ofPattern(DATE_FORMAT)));
        };
    }
}
複制代碼

序列化

時間類型->時間格式字元串

常見于後端傳回，現在後端接口，傳回格式一般都采用 json ，是以處理起來比反序列化要簡單

局部處理

在要傳回類的時間類型字段上使用 @JsonFormat 或 @JSONField 注解，來對該字段提供序列化支援。例如

@JSONField(format="yyyy-MM-dd HH:mm:ss")
private Date date;

@JSONField(format="yyyy-MM-dd HH:mm:ss")
private LocalDateTime localDateTime4;

@JSONField(format="yyyy-MM-dd")
private LocalDate localDate;
複制代碼

@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date date;

@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime localDateTime4;

@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate localDate;
複制代碼

是的 @JsonFormat 或 @JSONField 注解，既能用于json送出的反序列化，也能用于傳回 json 的序列化

同樣，使用 @JSONField 注解之前，需要先進行配置。用 fastjson 替換掉Spring web 預設使用的 jackson 之後，才能使用。

全局處理

以 Spring web 自帶的 jackson 為例，它配置全局時間格式化時， java.util 包中的時間類型與 java 8 之後引入了 java.time 包中的時間類型，要分開配置

全局配置 java.util 包中的時間類型的序列化格式

常用的時間類型包括

java.util.Date
java.util.Calendar

通過配置檔案配置

以 yaml 為例

spring:
  jackson:
    date-format: yyyy-MM-dd HH:mm:ss
    time-zone: GMT+8
複制代碼

這是最簡單的配置方式，也可以采取其他方式，這裡就不例舉了

全局配置 java.time 包中的時間類型的序列化格式

常用的時間類型包括

java.time.LocalDateTime
java.time.LocalDate

@Configuration
public class JacksonConfig {
    private static final String DATE_FORMAT = "yyyy-MM-dd";
    private static final String DATE_TIME_FORMAT = "yyyy-MM-dd HH:mm:ss";

    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jackson2ObjectMapperBuilderCustomizer() {
        return jacksonObjectMapperBuilder -> {
            // 配置 Jackson 序列化 LocalDate、LocalDateTime 時使用的格式
            jacksonObjectMapperBuilder.serializers(new LocalDateSerializer(DateTimeFormatter.ofPattern(DATE_FORMAT)));
            jacksonObjectMapperBuilder.serializers(new LocalDateTimeSerializer(DateTimeFormatter.ofPattern(DATE_TIME_FORMAT)));
        };
    }
}
複制代碼

推薦配置

對時間類型進行序列化時, 由于統一傳回的都是 json 格式，推薦進行全局配置，實際開發過程中，如果遇到特殊情況，再選擇用 @JsonFormat 進行局部覆寫

對時間類型進行反序列化時

如果是 json 傳參同樣推薦全局配置，實際開發過程中，如果遇到特殊情況，再選擇用 @JsonFormat 進行局部覆寫。
如果是 Get 請求或是 Post表單，全局配置 Converter<S, T> 後，@DateTimeForma 注解将失效。看情況自行選擇。

配置一覽

spring:
  jackson:
    date-format: yyyy-MM-dd HH:mm:ss
    time-zone: GMT+8
複制代碼

@Configuration
public class JacksonConfig {
    private static final String DATE_FORMAT = "yyyy-MM-dd";
    private static final String DATE_TIME_FORMAT = "yyyy-MM-dd HH:mm:ss";

    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jackson2ObjectMapperBuilderCustomizer() {
        return jacksonObjectMapperBuilder -> {
            // 配置 Jackson 序列化 LocalDate、LocalDateTime 時使用的格式
            jacksonObjectMapperBuilder.serializers(new LocalDateSerializer(DateTimeFormatter.ofPattern(DATE_FORMAT)));
            jacksonObjectMapperBuilder.serializers(new LocalDateTimeSerializer(DateTimeFormatter.ofPattern(DATE_TIME_FORMAT)));
            // 配置 Jackson 反序列化 LocalDate、LocalDateTime 時使用的格式
            jacksonObjectMapperBuilder.deserializerByType(LocalDateTime.class, new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern(DATE_TIME_FORMAT)));
            jacksonObjectMapperBuilder.deserializerByType(LocalDate.class, new LocalDateDeserializer(DateTimeFormatter.ofPattern(DATE_FORMAT)));
        };
    }
}
複制代碼

import org.apache.commons.lang3.StringUtils;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.convert.converter.Converter;

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.time.*;
import java.time.format.DateTimeFormatter;
import java.util.Date;
import java.util.TimeZone;

/**
 * 自定義參數轉換器，全局反序列化 GET請求、POST表單 送出的時間字元串
 */
@Configuration
public class DateConverterConfig {

    /**
     * yyyy-MM-dd 時間格式的正規表達式
     */
    private static final String DATE_REGEX = "[1-9]\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])";

    /**
     * HH:mm:ss 時間格式的正規表達式
     */
    private static final String TIME_REGEX = "(20|21|22|23|[0-1]\d):[0-5]\d:[0-5]\d";

    /**
     * yyyy-MM-dd HH:mm:ss 時間格式的正規表達式
     */
    private static final String DATE_TIME_REGEX = DATE_REGEX + "\s" + TIME_REGEX;

    /**
     * yyyy-MM-ddTHH:mm:ss 時間格式的正規表達式
     */
    private static final String DATE_T_TIME_REGEX = DATE_REGEX + "T" + TIME_REGEX;

    /**
     * yyyy-MM-ddTHH:mm:ss.SSS 時間格式的正規表達式
     */
    private static final String DATE_T_TIME_MS_REGEX = DATE_REGEX + "T" + TIME_REGEX + ".\d{3}";

    /**
     * 13位時間戳正規表達式
     */
    private static final String TIME_STAMP_REGEX = "1\d{12}";

    /**
     * yyyy-MM 時間格式的正規表達式
     */
    private static final String YEAR_MONTH_REGEX = "[1-9]\d{3}-(0[1-9]|1[0-2])";

    /**
     * yyyy-MM 格式
     */
    private static final String YEAR_MONTH_PATTERN = "yyyy-MM";

    /**
     * DateTime格式化字元串
     */
    private static final String DEFAULT_DATETIME_PATTERN = "yyyy-MM-dd HH:mm:ss";

    /**
     * DateTime格式化字元串 ISO 格式
     */
    private static final String DEFAULT_DATETIME_ISO_PATTERN = "yyyy-MM-ddTHH:mm:ss";

    /**
     * DateTime格式化字元串 帶毫秒值的 ISO 格式
     */
    private static final String DEFAULT_DATETIME_MS_ISO_PATTERN = "yyyy-MM-ddTHH:mm:ss.SSS";

    /**
     * Date格式化字元串
     */
    private static final String DEFAULT_DATE_FORMAT = "yyyy-MM-dd";

    /**
     * Time格式化字元串
     */
    private static final String DEFAULT_TIME_FORMAT = "HH:mm:ss";

    /**
     * 根據 pattern 建構 SimpleDateFormat
     * @param pattern
     * @return
     */
    private SimpleDateFormat getSimpleDateFormat(String pattern){
        SimpleDateFormat df =  new SimpleDateFormat(pattern);
        System.out.println(TimeZone.getDefault());
        df.setTimeZone(TimeZone.getTimeZone ("GMT"));
        return df;
    }

    /**
     * String -> Date 轉換器
     * 用于轉換 @RequestParam參數、@PathVariable參數、表單參數
     */
    @Bean
    public Converter<String, Date> dateConverter() {
        return new Converter<String, Date>() {
            @SuppressWarnings("NullableProblems")
            @Override
            public Date convert(String source) {
                if (StringUtils.isEmpty(source)) {
                    return null;
                }
                // 13位毫秒值 -> Date
                if (source.matches(TIME_STAMP_REGEX)) {
                    return new Date(Long.parseLong(source));
                }
                try {
                    // yyyy-MM-dd HH:mm:ss -> Date
                    if (source.matches(DATE_TIME_REGEX)) {
                        return getSimpleDateFormat(DEFAULT_DATETIME_PATTERN).parse(source);
                    }

                    // yyyy-MM-dd -> Date
                    if (source.matches(DATE_REGEX)) {
                        return getSimpleDateFormat(DEFAULT_DATE_FORMAT).parse(source);
                    }

                    // yyyy-MM -> Date
                    if (source.matches(YEAR_MONTH_REGEX)) {
                        return getSimpleDateFormat(YEAR_MONTH_PATTERN).parse(source);
                    }
                } catch (ParseException e) {
                    throw new RuntimeException(e);
                }
                return null;
            }
        };
    }


    /**
     * String -> LocalDateTime 轉換器
     * 用于轉換 @RequestParam參數、@PathVariable參數、表單參數
     */
    @Bean
    public Converter<String, LocalDateTime> localDateTimeConverter() {
        return new Converter<String, LocalDateTime>() {
            @SuppressWarnings("NullableProblems")
            @Override
            public LocalDateTime convert(String source) {
                if (StringUtils.isEmpty(source)) {
                    return null;
                }
                // 13位毫秒值 -> LocalDateTime
                if (source.matches(TIME_STAMP_REGEX)) {
                    Instant instant = Instant.ofEpochMilli(Long.parseLong(source));
                    ZoneId zone = ZoneId.systemDefault();
                    return LocalDateTime.ofInstant(instant, zone);
                }
                // yyyy-MM-dd HH:mm:ss -> LocalDateTime
                if (source.matches(DATE_TIME_REGEX)) {
                    return LocalDateTime.parse(source, DateTimeFormatter.ofPattern(DEFAULT_DATETIME_PATTERN));
                }

                // yyyy-MM-ddTHH:mm:ss -> LocalDateTime
                if (source.matches(DATE_T_TIME_REGEX)) {
                    return LocalDateTime.parse(source, DateTimeFormatter.ofPattern(DEFAULT_DATETIME_ISO_PATTERN));
                }

                // yyyy-MM-ddTHH:mm:ss.SSS -> LocalDateTime
                if (source.matches(DATE_T_TIME_MS_REGEX)) {
                    return LocalDateTime.parse(source, DateTimeFormatter.ofPattern(DEFAULT_DATETIME_MS_ISO_PATTERN));
                }

                return null;
            }
        };
    }

    /**
     * String -> LocalDate 轉換器
     * 用于轉換 @RequestParam參數、@PathVariable參數、表單參數
     */
    @Bean
    public Converter<String, LocalDate> localDateConverter() {
        return new Converter<String, LocalDate>() {
            @SuppressWarnings("NullableProblems")
            @Override
            public LocalDate convert(String source) {
                if (StringUtils.isEmpty(source)) {
                    return null;
                }
                // 13位毫秒值 -> LocalDate
                if (source.matches(TIME_STAMP_REGEX)) {
                    Instant instant = Instant.ofEpochMilli(Long.parseLong(source));
                    ZoneId zone = ZoneId.systemDefault();
                    return LocalDateTime.ofInstant(instant, zone).toLocalDate();
                }

                // yyyy-MM-dd -> LocalDate
                if (source.matches(DATE_REGEX)) {
                    return LocalDate.parse(source, DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT));
                }

                return null;
            }
        };
    }

    /**
     * String -> LocalTime 轉換器
     * 用于轉換 @RequestParam參數、@PathVariable參數、表單參數
     */
    @Bean
    public Converter<String, LocalTime> localTimeConverter() {
        return new Converter<String, LocalTime>() {
            @SuppressWarnings("NullableProblems")
            @Override
            public LocalTime convert(String source) {
                if (StringUtils.isEmpty(source)) {
                    return null;
                }
                // HH:mm:ss -> LocalTime
                return LocalTime.parse(source, DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT));
            }
        };
    }

}
複制代碼

參考

如何在 Spring Boot 應用中優雅的使用 Date 和 LocalDateTime

@DateTimeFormat 實作原理

@JsonFormat 實作原理

來源：https://juejin.cn/post/7195078889767436346

Spring boot 中時間類型的序列化與反序列化

背景

約定

反序列化

局部處理反序列化

@JsonFormat 或 @JSONField

@DateTimeFormat

全局處理

非 json 傳參的反序列化全局處理

json 傳參的反序列化全局處理

全局配置 java.util 包中的時間類型的反序列化格式

全局配置 java.time 包中的時間類型的反序列化格式

序列化

局部處理

全局處理

全局配置 java.util 包中的時間類型的序列化格式

通過配置檔案配置

全局配置 java.time 包中的時間類型的序列化格式

推薦配置

參考

繼續閱讀

MyBatis-Plus 之AR模式

馴服爛代碼_馴服Tomcat：Tomcat 5的過濾技巧

基于Springboot+VUE+Mysql的大學生校園疫情防控管理系統

Using MessageConverter

馴服爛代碼_C＃中的馴服配置

Spring Cloud整合Sleuth，當請求完成後，Zipkin沒有鍊路資訊

JAVA自學之路——馬士兵

Rabbitmq指令行手動建立隊列

整合 Spring 開發架構及服務端技術

SSM整合02---Spring-SpringMVC層一、添加web架構支援二、web.xml三、spring-mvc.xml

SSM架構（二）------------表現層的SpringMVC

Intellij idea基于Maven 的SSM 架構整合

Spring資料和Redis

SpringMVC的啟動過程源碼分析1 SpringMVC 配置XML的方式啟動2 SpringMVC純注解模式啟動

Java Spring 架構

SpringCloud微服務（四）之ribbon筆記ribbon是什麼？入門案例自定義均衡負載算法