如何转换Retrofit请求体中Date对象的时区？

你遇到的问题核心在于：Gson的setDateFormat()方法只是定义了日期的输出格式，但默认会使用JVM的系统时区来格式化Date对象，所以没法直接通过这个方法修改时区。要实现强制的时区转换，我们需要自定义Gson的TypeAdapter来接管Date的序列化逻辑。

解决方案步骤： #

1. 自定义TypeAdapter<Date>，在序列化（把Date转成字符串发请求）时强制转换为目标时区
2. 在GsonBuilder中注册这个自定义Adapter
3. 将配置好的Gson传入Retrofit的ConverterFactory

具体代码实现 #

1. 自定义Date时区转换TypeAdapter

这个Adapter会在序列化/反序列化时，严格按照你指定的时区和格式处理Date对象：

import com.google.gson.TypeAdapter;
import com.google.gson.stream.JsonReader;
import com.google.gson.stream.JsonWriter;
import java.io.IOException;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.TimeZone;

public class TimeZoneDateTypeAdapter extends TypeAdapter<Date> {
    private final SimpleDateFormat dateFormatter;
    private final TimeZone targetTimeZone;

    // 构造方法：传入日期格式和目标时区
    public TimeZoneDateTypeAdapter(String datePattern, TimeZone targetTimeZone) {
        this.targetTimeZone = targetTimeZone;
        this.dateFormatter = new SimpleDateFormat(datePattern);
        this.dateFormatter.setTimeZone(targetTimeZone); // 强制设置时区
    }

    // 序列化：把Date转成目标时区的字符串（请求体用）
    @Override
    public void write(JsonWriter out, Date date) throws IOException {
        if (date == null) {
            out.nullValue();
            return;
        }
        String formattedDate = dateFormatter.format(date);
        out.value(formattedDate);
    }

    // 反序列化：把字符串转成Date（如果需要处理响应体的时区，可按需调整）
    @Override
    public Date read(JsonReader in) throws IOException {
        if (in.peek() == com.google.gson.stream.JsonToken.NULL) {
            in.nextNull();
            return null;
        }
        String dateStr = in.nextString();
        try {
            return dateFormatter.parse(dateStr);
        } catch (ParseException e) {
            throw new IOException("Failed to parse date string: " + dateStr, e);
        }
    }
}

2. 配置Gson并初始化Retrofit

比如你要把Date转换为UTC时区，可以这样配置：

// 指定目标时区（比如UTC，或者"Asia/Shanghai"等）
TimeZone targetTimeZone = TimeZone.getTimeZone("UTC");

// 初始化带有时区转换的Gson实例
Gson gson = new GsonBuilder()
        .registerTypeAdapter(Date.class, new TimeZoneDateTypeAdapter("yyyy-MM-dd'T'HH:mm:ss.SSS zzz", targetTimeZone))
        .create();

// 初始化Retrofit
Retrofit retrofit = new Retrofit.Builder()
        .baseUrl(baseUrl)
        .addConverterFactory(GsonConverterFactory.create(gson)) // 直接用官方的ConverterFactory即可
        .build();

关键说明 #

• 为什么之前的代码不行？setDateFormat()只是定义了格式模板，但Gson内部依然会使用JVM默认时区来生成日期字符串，没法强制切换时区。自定义TypeAdapter能完全接管Date的序列化逻辑，确保时区符合要求。
• 时区ID建议使用完整的时区名（比如"Asia/Shanghai"），避免使用缩写（比如"CST"可能对应多个时区，存在歧义）。
• 如果你只需要处理请求体的序列化（不需要修改响应体的时区解析），可以简化read()方法，比如直接使用默认的Gson解析逻辑。

内容的提问来源于stack exchange，提问作者Nadimuddin