当前位置：首页 > news >正文

Spring MVC 中日期格式转换的两种实用方法

news 来源：原创 2025/6/15 5:18:39

在开发基于 Spring MVC 的 Web 应用时，日期格式的转换是一个常见的需求。用户在表单中输入的日期通常是字符串类型，而在 Java 代码中我们往往需要将其转换为 Date 类型进行处理。本文将详细介绍 Spring MVC 中两种日期格式转换的方法，包括创建过程和最终的运行结果。

方法一：使用 `@DateTimeFormat` 注解

1. 原理

@DateTimeFormat 注解是 Spring 框架提供的一个便捷注解，用于将字符串类型的日期转换为 Date 类型。它可以直接应用在实体类的日期属性上，Spring MVC 在接收到请求参数时会自动根据注解中指定的格式进行转换。

2. 创建过程

2.1 实体类添加注解

在 User 类的 birthday 属性上添加 @DateTimeFormat 注解，指定日期格式。示例代码如下：

package cn.tx.demo2;import org.springframework.format.annotation.DateTimeFormat;
import java.io.Serializable;
import java.util.Date;
import java.util.List;
import java.util.Map;public class User implements Serializable {// ... 其他属性 ...@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")private Date birthday;// ... 其他方法 ...
}

2.2 控制器接收参数

在控制器中，当接收到包含日期参数的请求时，Spring MVC 会自动将字符串日期转换为 Date 类型。示例代码如下：

package cn.tx.demo2;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;@Controller
@RequestMapping("/user")
public class UserController {@RequestMapping("/save2.do")public String save2(User user) {System.out.println("USER:" + user);return "suc";}
}

3.运行结果：

使用原来日期格式：

报错：因为日期格式改了

改成现在的格式：

成功：

方法二：自定义转换器 `StringToDate`

1. 原理

自定义转换器可以实现更复杂的日期格式转换逻辑。通过实现 org.springframework.core.convert.converter.Converter 接口，我们可以自定义字符串到 Date 类型的转换规则。

2. 创建过程

2.1 创建自定义转换器类

创建一个实现 Converter<String, Date> 接口的类，实现 convert 方法，用于将字符串类型的日期转换为 Date 类型。示例代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"xmlns:mvc="http://www.springframework.org/schema/mvc"xmlns:context="http://www.springframework.org/schema/context"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"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.xsdhttp://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsd"><!-- 启用注解驱动 --><mvc:annotation-driven/><!-- 配置组件扫描 --><context:component-scan base-package="cn.tx.demo1"/><context:component-scan base-package="cn.tx.demo2"/><!-- 配置视图解析器 --><bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"><property name="prefix" value="/WEB-INF/pages/"/><property name="suffix" value=".jsp"/></bean><!--配置日期类型转换器，类型转换器的组件，把日期类型转换注入到组件对象中--><bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean"><property name="converters"><set><bean class="cn.tx.demo2.StringToDate" /></set></property></bean><!--让映射器、适配器和处理器生效(默认不配置也是可以的)--><mvc:annotation-driven conversion-service="conversionService"/>
</beans>

2.3 控制器接收参数

在控制器中，同样可以正常接收包含日期参数的请求，Spring MVC 会使用自定义的转换器进行日期转换。示例代码如下：

package cn.tx.demo2;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;@Controller
@RequestMapping("/user")
public class UserController {@RequestMapping("/save3.do")public String save3(User user) {System.out.println("user：" + user);return "suc";}
}