如何让protobuf-net自动以UTC编码DateTime并解码为本地时间？

当然可以实现！这种跨时区消息传递的场景在分布式系统里太常见了，完全不用手动给每个DateTime属性写转换逻辑，咱们分两种主流的.NET序列化库来一步步说：

这是.NET生态里用得最久的JSON序列化库，配置起来非常灵活：

全局配置方式（推荐） #

只需要在初始化序列化器时，设置全局的时区处理规则，就能让所有DateTime属性自动遵循转UTC序列化、转本地反序列化的逻辑：

var jsonSettings = new JsonSerializerSettings
{
    // 序列化时自动将本地时间/未指定时区的时间转为UTC，反序列化时将UTC时间转为本地时间
    DateTimeZoneHandling = DateTimeZoneHandling.Utc,
    // 使用ISO 8601标准格式，确保跨系统兼容性
    DateFormatHandling = DateFormatHandling.IsoDateFormat
};

// 序列化示例
var dtoJson = JsonConvert.SerializeObject(yourDto, jsonSettings);

// 反序列化示例
var receivedDto = JsonConvert.DeserializeObject<YourDto>(dtoJson, jsonSettings);

说明： 这个配置会自动处理三种DateTimeKind：

• 本地时间（Local）：序列化时转UTC，反序列化UTC时间转本地
• UTC时间（Utc）：直接序列化，反序列化后转本地
• 未指定时区（Unspecified）：默认当作本地时间处理，序列化转UTC

自定义转换器（精细控制） #

如果某些属性需要特殊处理，或者你想完全自定义转换逻辑，可以写一个专属的转换器：

public class UtcLocalDateTimeConverter : JsonConverter<DateTime>
{
    public override DateTime ReadJson(JsonReader reader, Type objectType, DateTime existingValue, bool hasExistingValue, JsonSerializer serializer)
    {
        var dateStr = reader.Value.ToString();
        var dateTime = DateTime.Parse(dateStr);
        // 反序列化时，UTC时间转本地，其他情况保持原样
        return dateTime.Kind == DateTimeKind.Utc ? dateTime.ToLocalTime() : dateTime;
    }

    public override void WriteJson(JsonWriter writer, DateTime value, JsonSerializer serializer)
    {
        var utcValue = value.Kind switch
        {
            DateTimeKind.Local => value.ToUniversalTime(),
            DateTimeKind.Unspecified => DateTime.SpecifyKind(value, DateTimeKind.Utc), // 未指定时区的时间默认当作本地转UTC
            _ => value
        };
        // 输出标准ISO 8601格式
        writer.WriteValue(utcValue.ToString("o"));
    }
}

使用方式有两种：

1. 全局注册：在JsonSerializerSettings的Converters集合中添加这个转换器
2. 局部应用：在特定DTO属性上标记[JsonConverter(typeof(UtcLocalDateTimeConverter))]

这是.NET Core 3.0+内置的序列化库，性能更优，配置方式略有不同：

自定义转换器（核心方案） #

System.Text.Json没有像Newtonsoft那样直接的全局时区开关，所以需要自定义转换器来实现逻辑：

public class UtcToLocalDateTimeConverter : JsonConverter<DateTime>
{
    public override DateTime Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        var dateStr = reader.GetString();
        var dateTime = DateTime.Parse(dateStr);
        // 反序列化UTC时间转本地
        return dateTime.Kind == DateTimeKind.Utc ? dateTime.ToLocalTime() : dateTime;
    }

    public override void Write(Utf8JsonWriter writer, DateTime value, JsonSerializerOptions options)
    {
        var utcValue = value.Kind switch
        {
            DateTimeKind.Local => value.ToUniversalTime(),
            DateTimeKind.Unspecified => DateTime.SpecifyKind(value, DateTimeKind.Utc),
            _ => value
        };
        writer.WriteStringValue(utcValue.ToString("o"));
    }
}

然后全局注册这个转换器，让所有DateTime属性自动生效：

var jsonOptions = new JsonSerializerOptions
{
    PropertyNameCaseInsensitive = true,
    Converters = { new UtcToLocalDateTimeConverter() }
};

// 序列化
var dtoJson = JsonSerializer.Serialize(yourDto, jsonOptions);

// 反序列化
var receivedDto = JsonSerializer.Deserialize<YourDto>(dtoJson, jsonOptions);

• 尽量确保DTO中的DateTime的Kind属性正确，避免出现Unspecified导致的歧义（如果业务中确实有未指定时区的时间，要在转换器里明确处理逻辑）
• 跨语言传递时，推荐使用ISO 8601格式（带Z后缀标识UTC），确保对方系统能正确解析时区信息
• 如果业务允许，更推荐使用DateTimeOffset代替DateTime，它本身包含时区偏移量，序列化反序列化时几乎不会出现时区歧义问题

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