Spring MVC中自定义日期类型格式转换器

在Spring MVC中，自定义日期类型格式转换器可以通过实现Converter接口或使用@DateTimeFormat注解。以下是两种方法的详细说明：

---

方法一：全局自定义转换器（推荐）

1. 创建日期转换器类

实现 org.springframework.core.convert.converter.Converter 接口：

import org.springframework.core.convert.converter.Converter;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;public class StringToDateConverter implements Converter<String, Date> {private static final String DATE_FORMAT = "yyyy-MM-dd HH:mm:ss";@Overridepublic Date convert(String source) {SimpleDateFormat format = new SimpleDateFormat(DATE_FORMAT);try {return format.parse(source);} catch (ParseException e) {throw new IllegalArgumentException("日期格式错误，请使用 " + DATE_FORMAT, e);}}
}

2. 注册转换器到Spring容器

方法1：通过配置类实现 WebMvcConfigurer：

import org.springframework.context.annotation.Configuration;
import org.springframework.format.FormatterRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;@Configuration
public class WebConfig implements WebMvcConfigurer {@Overridepublic void addFormatters(FormatterRegistry registry) {registry.addConverter(new StringToDateConverter());}
}

方法2：通过配置applicationContex.xml实现：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:mvc="http://www.springframework.org/schema/mvc"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsdhttp://www.springframework.org/schema/mvchttp://www.springframework.org/schema/mvc/spring-mvc.xsd"><!-- 1. 声明自定义转换器 --><bean id="stringToDateConverter" class="com.example.converter.StringToDateConverter"/><!-- 2. 配置 ConversionService --><bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean"><property name="converters"><set><ref bean="stringToDateConverter"/><!-- 可添加其他转换器，如日期转字符串 --></set></property></bean><!-- 3. 启用 MVC 注解驱动并关联 ConversionService --><mvc:annotation-driven conversion-service="conversionService"/><!-- 其他配置（如组件扫描、视图解析器等） --><context:component-scan base-package="com.example.controller"/>
</beans>

---

方法二：局部使用 @DateTimeFormat

直接在实体类字段上标注日期格式：

import org.springframework.format.annotation.DateTimeFormat;
import java.util.Date;public class MyEntity {@DateTimeFormat(pattern = "yyyy/MM/dd")private Date createTime;// Getter & Setter
}

---

使用 Java 8 的 DateTimeFormatter（更安全）

如果使用Java 8+，建议用 DateTimeFormatter 替代 SimpleDateFormat：

import org.springframework.core.convert.converter.Converter;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;public class StringToLocalDateTimeConverter implements Converter<String, LocalDateTime> {private static final DateTimeFormatter FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");@Overridepublic LocalDateTime convert(String source) {return LocalDateTime.parse(source, FORMATTER);}
}

注册方式与全局转换器相同。

---

注意事项：

1. 时区处理：如果涉及跨时区，需在格式化时指定时区：

   DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss").withZone(ZoneId.systemDefault());
   

2. 异常处理：转换失败时会抛出 IllegalArgumentException，可在Controller中捕获并处理。

3. 多格式支持：若需支持多种格式，可在转换器中按顺序尝试不同格式。

---

通过以上步骤，即可实现全局或局部的日期格式自定义转换。