在Spring Boot中自定义JSON返回日期格式的指南

在开发Spring Boot应用时,很多时候需要在返回的JSON数据中以特定格式显示日期和时间。例如,使用LocalDateTimeDate等类型的字段时,默认的序列化格式可能不是你期望的路径。本文将介绍如何在Spring Boot中实现控制返回JSON数据的日期格式 ,主要围绕@JsonFormat进行讲解。


1. 为什么需要控制JSON中的日期格式?

默认情况下,Spring Boot(基于Jackson)会按照Jackson的默认配置将日期字段序列化成类似"yyyy-MM-dd'T'HH:mm:ss"的格式。这在某些场景下可能不符合业务要求,或者在前端展示时需要特定的格式。

示例:

复制代码
{
  "name": "张三",
  "createTime": "2025-06-17T15:20:30"
}

如果你希望日期显示为"yyyy-MM-dd HH:mm:ss"形式,比如"2025-06-17 15:20:30",那么就需要自定义格式。


2. 方案一:在字段上使用@JsonFormat

这是最常用的做法。只需要在日期字段上添加注解,指定格式:

复制代码
public class User {
    private String name;

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

    // getters and setters
}

效果:

复制代码
{
  "name": "张三",
  "createTime": "2025-06-17 15:20:30"
}

3. 方案二:全局配置ObjectMapper

如果项目中大量日期字段都要统一格式,建议配置全局的ObjectMapper

示例:

复制代码
@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 设置全局日期格式
        mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));
        return mapper;
    }
}

这会影响整个应用的所有日期序列化行为。


4. 什么时候用@JsonFormat,什么时候用@DateTimeFormat

场景 使用的注解 作用范围
请求参数绑定(例如:请求中日期字符串转换为Java对象的字段) @DateTimeFormat 控制请求参数到Java对象的绑定规则
JSON序列化/反序列化(返回响应的JSON格式控制) @JsonFormat 控制序列化输出的日期格式

总结 :返回JSON数据时,主要用@JsonFormat


5. 具体示例:完整的控制器和实体类

复制代码
import com.fasterxml.jackson.annotation.JsonFormat;

public class User {
    private String name;

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

    // constructors, getters, setters
}

@RestController
public class UserController {

    @GetMapping("/user")
    public User getUser() {
        User user = new User();
        user.setName("张三");
        user.setCreateTime(LocalDateTime.now());
        return user; // 返回的JSON时间会按照@JsonFormat指定的格式输出
    }
}

6. 结语

在Spring Boot中控制返回JSON的日期格式,使用@JsonFormat是最直接、最常用的方法。结合全局配置或者字段配置,可以满足大部分业务需求。

如果你的应用还需要更复杂的日期格式化策略,比如地域性、时区等,也可以在@JsonFormat中加入timezone参数,例如:

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

7. 提示

  • 不建议只依赖@DateTimeFormat来控制JSON输出,它只对请求参数绑定起作用。
  • 全局配置应慎用,避免不同模块的格式不一致。
相关推荐
ladymorgana33 分钟前
【spring boot】三种日志系统对比:ELK、Loki+Grafana、Docker API
spring boot·elk·grafana
我是苏苏1 小时前
C#基础:Winform桌面开发中窗体之间的数据传递
开发语言·c#
一只叫煤球的猫1 小时前
【🤣离谱整活】我写了一篇程序员掉进 Java 异世界的短篇小说
java·后端·程序员
斐波娜娜1 小时前
Maven详解
java·开发语言·maven
Bug退退退1231 小时前
RabbitMQ 高级特性之事务
java·分布式·spring·rabbitmq
程序员秘密基地2 小时前
基于html,css,vue,vscode,idea,,java,springboot,mysql数据库,在线旅游,景点管理系统
java·spring boot·mysql·spring·web3
皮皮林5512 小时前
自从用了CheckStyle插件,代码写的越来越规范了....
java
小码氓2 小时前
Java填充Word模板
java·开发语言·spring·word
会飞的天明2 小时前
Java 导出word 实现饼状图导出--可编辑数据
java·word
Muxiyale2 小时前
使用spring发送邮件,部署ECS服务器
java·服务器·spring