.NET Framework 4.5 Web API DateTime序列化强制转UTC问题排查

我来帮你搞定这个DateTime序列化的问题，你遇到的核心问题是Json.NET的默认行为会将本地时间强制转换为UTC，而且你的自定义转换器和全局配置没正确覆盖这个规则。下面给你几个可行的解决方案：

方案1：修改自定义转换器，强制保留本地时区偏移 #

你的JsonDateFormatConverter继承自IsoDateTimeConverter，而这个基类默认会把DateTimeKind.Local的时间转成UTC格式（带Z后缀）。只需要在转换器里显式设置DateTimeZoneHandling为Local就能解决：

public class JsonDateFormatConverter : IsoDateTimeConverter { 
    public JsonDateFormatConverter(string format) { 
        DateTimeFormat = format; 
        // 新增这行，强制保留本地时区偏移
        DateTimeZoneHandling = Newtonsoft.Json.DateTimeZoneHandling.Local;
    } 
}

同时要确保你的StartDate属性值的DateTimeKind确实是Local，比如赋值时：

// 假设从数据库或其他地方拿到的时间是unspecified，手动指定为Local
model.StartDate = DateTime.SpecifyKind(yourOriginalDateTime, DateTimeKind.Local);
// 如果是当前时间，直接用DateTime.Now（本身就是Local类型）
// model.StartDate = DateTime.Now;

方案2：全局配置序列化规则，无需自定义转换器 #

如果不想在每个属性上加特性，可以直接在WebApiConfig里全局配置Json序列化规则，这样所有DateTime都会按指定格式输出：

public static class WebApiConfig
{
    public static void Register(HttpConfiguration config)
    {
        // 其他路由配置...
        
        // 配置Json序列化
        var jsonFormatter = config.Formatters.JsonFormatter;
        var serializerSettings = jsonFormatter.SerializerSettings;
        
        // 强制保留本地时区
        serializerSettings.DateTimeZoneHandling = Newtonsoft.Json.DateTimeZoneHandling.Local;
        // 设置你需要的日期格式
        serializerSettings.DateFormatString = "yyyy-MM-ddTHH:mm:sszzz";
        
        // 移除默认的Xml格式化器（如果不需要的话）
        config.Formatters.Remove(config.Formatters.XmlFormatter);
    }
}

这种方式下，你可以去掉属性上的[JsonConverter]特性，全局生效更省心。

关键注意点 #

• DateTimeKind的重要性：如果你的DateTime值是DateTimeKind.Unspecified（比如从数据库读取的大部分时间都是这个类型），Json.NET会默认把它当作UTC处理。所以一定要手动指定Kind为Local，不然不管怎么配置都会输出Z格式。
• 优先级问题：属性上的[JsonConverter]特性会覆盖全局配置，所以如果用了自定义转换器，一定要在转换器里设置DateTimeZoneHandling，全局的设置不会生效。

按照上面的方法调整后，应该就能得到你预期的2020-03-07T00:00:00+01:00格式了。

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