广告位 · 页头(后台-模块管理-新建模块后替换此区域)

如何处理Json日期格式问题?详解四种实用解决方法

在前后端数据交互场景中,Json作为主流的数据传输格式,其日期类型的序列化结果经常不符合业务预期,比如Java默认的日期序列化会生成带时区信息的字符串,或者JavaScript的Date对象转Json会变成时间戳,给后续的数据处理带来很多麻烦。本文将介绍四种处理这类问题的实用方法,覆盖不同技术栈的使用场景。

如何处理Json日期格式问题?详解四种实用解决方法

方法一:后端自定义序列化器(以Java为例)

如果是Java后端项目,可以通过自定义Json序列化器,在对象转Json时直接指定日期格式,避免默认序列化产生不符合要求的格式。这种方式适合全局统一日期格式的场景,一次配置所有接口的日期输出都会生效。

首先自定义一个日期序列化器,继承JsonSerializer类,重写序列化方法:

import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.databind.JsonSerializer;
import com.fasterxml.jackson.databind.SerializerProvider;
import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.Date;
public class CustomDateSerializer extends JsonSerializer<Date> {
    // 定义统一的日期格式
    private static final SimpleDateFormat DATE_FORMAT = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    @Override
    public void serialize(Date date, JsonGenerator jsonGenerator, SerializerProvider serializerProvider) throws IOException {
        // 将日期按照指定格式转成字符串输出
        jsonGenerator.writeString(DATE_FORMAT.format(date));
    }
}

然后在实体类的日期字段上添加注解,指定使用自定义序列化器:

import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import java.util.Date;
public class User {
    private String name;
    // 指定该字段使用自定义日期序列化器
    @JsonSerialize(using = CustomDateSerializer.class)
    private Date createTime;
    // 省略getter和setter方法
}

方法二:使用注解指定日期格式

很多Json处理框架都提供了直接指定日期格式的注解,不需要自定义序列化器,配置更简单,适合单个字段或者少量字段需要特殊格式的场景。

以Jackson框架为例,直接在日期字段上添加@JsonFormat注解即可:

import com.fasterxml.jackson.annotation.JsonFormat;
import java.util.Date;
public class Order {
    private String orderId;
    // 指定日期格式和时区,避免时区偏差
    @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
    private Date orderTime;
    // 省略getter和setter方法
}

这种方式不需要额外写序列化类,配置灵活,每个字段可以单独设置不同的日期格式,适配不同的业务需求。

方法三:前端解析时转换格式

如果后端返回的Json日期是时间戳或者默认格式,无法修改后端代码,可以在前端接收数据时进行格式转换,适合前端主导或者后端不方便调整的场景。

JavaScript中可以通过Date对象处理时间戳,或者处理带特殊标识的日期字符串:

// 处理时间戳格式的日期,比如后端返回1620000000000
function formatTimestamp(timestamp) {
    const date = new Date(timestamp);
    const year = date.getFullYear();
    const month = String(date.getMonth() + 1).padStart(2, '0');
    const day = String(date.getDate()).padStart(2, '0');
    const hour = String(date.getHours()).padStart(2, '0');
    const minute = String(date.getMinutes()).padStart(2, '0');
    const second = String(date.getSeconds()).padStart(2, '0');
    return `${year}-${month}-${day} ${hour}:${minute}:${second}`;
}
// 处理带T和时区标识的日期字符串,比如"2024-05-20T12:30:00.000+08:00"
function formatIsoDate(isoDateStr) {
    const date = new Date(isoDateStr);
    return formatTimestamp(date.getTime());
}
// 使用示例
const jsonData = {
    createTime: 1716200000000,
    updateTime: "2024-05-20T12:30:00.000+08:00"
};
console.log(formatTimestamp(jsonData.createTime)); // 输出2024-05-20 14:13:20
console.log(formatIsoDate(jsonData.updateTime)); // 输出2024-05-20 12:30:00

方法四:全局配置Json序列化规则

如果是需要整个项目统一日期格式,还可以在Json处理框架的全局配置中设置默认日期格式,不需要在每个字段上单独加注解,适合项目规范统一的场景。

以Spring Boot项目为例,配置Jackson的全局ObjectMapper:

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.text.SimpleDateFormat;
@Configuration
public class JsonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        // 设置全局默认日期格式
        objectMapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));
        // 禁用时间戳格式输出日期
        objectMapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
        // 注册Java8时间模块,支持LocalDateTime等类型
        objectMapper.registerModule(new JavaTimeModule());
        return objectMapper;
    }
}

配置完成后,项目中所有返回Json的日期类型都会按照设置的格式输出,不需要额外处理。

四种方法对比

可以根据项目实际情况选择合适的方法,以下是四种方法的适用场景对比:

方法适用场景优点缺点
自定义序列化器需要复杂日期处理逻辑的场景逻辑灵活,可自定义处理规则需要额外编写序列化类
注解指定格式少量字段需要特殊格式配置简单,无需额外类每个字段需要单独配置
前端转换格式无法修改后端代码不依赖后端调整前端需要额外处理代码
全局配置规则项目统一日期格式规范一次配置全局生效不够灵活,无法单独调整字段格式

实际开发中可以根据项目的技术栈、调整权限、业务需求选择最合适的方法,大部分场景下注解指定格式或者全局配置就能满足需求,特殊场景再考虑自定义序列化器或者前端转换的方式。

广告位 · 文章底部(后台-模块管理替换此区域)