在前后端数据交互场景中,Json作为主流的数据传输格式,其日期类型的序列化结果经常不符合业务预期,比如Java默认的日期序列化会生成带时区信息的字符串,或者JavaScript的Date对象转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的日期类型都会按照设置的格式输出,不需要额外处理。
四种方法对比
可以根据项目实际情况选择合适的方法,以下是四种方法的适用场景对比:
| 方法 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|
| 自定义序列化器 | 需要复杂日期处理逻辑的场景 | 逻辑灵活,可自定义处理规则 | 需要额外编写序列化类 |
| 注解指定格式 | 少量字段需要特殊格式 | 配置简单,无需额外类 | 每个字段需要单独配置 |
| 前端转换格式 | 无法修改后端代码 | 不依赖后端调整 | 前端需要额外处理代码 |
| 全局配置规则 | 项目统一日期格式规范 | 一次配置全局生效 | 不够灵活,无法单独调整字段格式 |
实际开发中可以根据项目的技术栈、调整权限、业务需求选择最合适的方法,大部分场景下注解指定格式或者全局配置就能满足需求,特殊场景再考虑自定义序列化器或者前端转换的方式。