在使用Spring mvc 进行开发时我们经常遇到前端传来的某种格式的时间字符串无法用java8的新特性 java.time 包下的具体类型参数来直接接收。 我们使用含有 `java.tim…

一、SpringMVC时间格式化问题解决

1.1 痛点

在使用Spring mvc 进行开发时我们经常遇到前端传来的某种格式的时间字符串无法用java8的新特性 java.time 包下的具体类型参数来直接接收。 我们使用含有 java.time 封装类型的参数接收也会报反序列化问题，在返回前端带时间类型的同样会出现一些格式化的问题。今天我们来彻底解决他们。

1.2 建议

其实最科学的建议统一使用时间戳来代表时间。这个是最完美的，避免了前端浏览器的兼容性问题，同时也避免了其它一些中间件的序列化/反序列化问题。但是用时间表达可能更清晰语义化。两种方式各有千秋，如果我们坚持使用java8的时间类库也不是没有办法。下面我们会以 java.time.LocalDateTime 为例逐一解决这些问题。

1.3 局部注解方式

网上有很多文章说该注解是前端指向后端的，也就是前端向后端传递时间参数格式化使用的，这没有错！但是有一个小问题，该方式只能适用于不涉及反序列化的情况下。也就是以下场景才适用：

1
2
3
4
5
6
7
8
9
    @GetMapping("/local")
  public Map<String, String> data(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime localDateTime) {
      Map<String, String> map = new HashMap<>(1);
      map.put("data", localDateTime.format(DateTimeFormatter.ofPattern("yyyy-MM-dd")));
      return map;
  }

如果你在下面这个场景使用就不行了：

@Data

public class UserInfo {

@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime birthday;
private String name;
private Integer age;

}

@PostMapping(“/user”)
public Object postData(@RequestBody UserInfo userInfo) {
System.out.println(“userInfo = “ + userInfo);
return userInfo;
}

1
2
原因是Post请求参数在body中，需要反序列化成对象。默认是jackson类库来进行反序列化，并不触发
  @DateTimeFormat

注解机制。 这时我们就需要使用jackson的格式化注解

@JsonFormat

1
2
。我们将实体类

UserInfo
改造成下面的就可以了：

@Data

@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")

1
2
}

以上两个注解可以并存，但是一定要清楚各自的使用场景。这里还有一个小细节：格式一定要对应好时间类型。比如 ```
yyyy-MM-dd
对应

1
2
3
java.time.LocalDate
。如果再个性化一些

可以被

1
2
3
4
5
6
7
  @JsonDeserialize
  和

```text
  @JsonSerialize
  代替。但是它们的

using
参数需要你自己实现为你对应的时间类型类型。 如果

1
2
、

同时存在

的优先级要更高。

1.4 局部处理的好处

局部处理的好处在于八个字：百花齐放，百家争鸣 。可以保持多样性、个性化 。但是局部带来了一个新的问题 ：没有共同的标准 、不兼容。进而不方便维护。所以有时候基于业务需要我们全局化可以统一管理。下面我们将讲解如何进行全局化配置。

1.5 全局化化时间格式配置

全局化其实也是基于 @DateTimeFormat 和 @JsonFormat 两种场景来进行配置。对于 @DateTimeFormat 的场景我们通过实现Spring提供的接口：
DateTimeFormatter :

1
2
   // 时间格式化
private static final DateTimeFormatter FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss", Locale.CHINA);

类型转换接口：

org.springframework.core.convert.converter.Converter<S,T>

1
2
3
4
5
6
7
8
9
10
11

实现：

    @Bean

  public Converter<String, LocalDateTime> localDateConverter() {
      return new Converter<String, LocalDateTime>() {
          @Override

          public LocalDateTime convert(String source) {
              return LocalDateTime.parse(source, FORMATTER);
        }
    };

或者格式化接口：

org.springframework.format.Formatter

1
2
3
4
5
6
7
8
9
10

实现 ：

    @Bean

  public Formatter<LocalDateTime> localDateFormatter() {
      return new Formatter<LocalDateTime>() {

          public LocalDateTime parse(String text, Locale locale) throws ParseException {
              return LocalDateTime.parse(text, FORMATTER);
        }

1
2
public String print(LocalDateTime object, Locale locale) {
    return object.format(FORMATTER);
        }
    };

1
2
3
4
5
6
7
8
9
10
11
12
13
以上两个接口的实现都要注册为Spring Bean，配置的时候二者选其一即可，其中S即Source也就是来源，其实就是前端的时间字符串。T即Target也就是目标，代表你需要转化或者格式化的时间java类型。
那么对于时间序列化和反序列化我们进行如下配置就行了（基于默认jackson,以LocalDateTime 为例）：
      @Bean

    public Jackson2ObjectMapperBuilderCustomizer jackson2ObjectMapperBuilderCustomizer() {

        return jacksonObjectMapperBuilder -> jacksonObjectMapperBuilder
                 // 反序列化
                .deserializerByType(LocalDateTime.class, new LocalDateTimeDeserializer(FORMATTER))
                 // 序列化
                .serializerByType(LocalDateTime.class, new LocalDateTimeSerializer(FORMATTER));
    }

同样该jsonMapper自定义构建器要注册成Spring Bean才行。

1.6 全局配置要点

全局配置的一些优缺点上面已经阐述了，这里我还是要啰嗦一下要点避免你踩坑。全局配置跟局部配置一样。同样要约定pattern。这就要求我们全局保持一致。我们可以实现多个以上的全局配置来对其他诸如 LocalDate 、 OffsetDateTime 的适配。同时如果们接入了其它一些需要用到序列化/反序列化的中间件，比如redis、rabbitmq，我们也要注意进行适配。

1.7 总结

通过以上对时间格式的局部和全局处理方式的介绍，相信困扰你的Spring mvc 时间问题不会再存在了。

本文标题： 解决SpringMVC中时间格式化问题

发布时间： 2019年03月17日 00:00

最后更新： 2026年09月16日 05:40

原始链接： https://haoxiang.eu.org/2d449a9b/

版权声明： 本文著作权归作者所有，均采用CC BY-NC-SA 4.0许可协议，转载请注明出处！

赏
× 喜欢就赞赏一下呗！
打赏二维码