newtonsoft.json 默认将 datetime 序列化为 iso 8601 字符串,但 datetimekind.unspecified 易被误处理且 js 解析不一致;推荐统一用 utc 存储并调用 touniversaltime(),或配置 datetimezonehandling.roundtripkind 保留 kind;system.text.json 需自定义转换器控制格式并手动处理 datetimekind;asp.net core 中 addjsonoptions 不影响 readfromjsonasync,需显式传入共享 jsonserializeroptions;dto 应仅保留一个 datetime 字段并用转换器统一处理序列化与反序列化。

Newtonsoft.Json 默认把 DateTime 序列化成 ISO 8601 字符串,但时区容易出错
Newtonsoft.Json(Json.NET)默认把 DateTime 序列化为类似 "2024-05-20T14:30:00+08:00" 的格式,看着标准,但实际项目里常踩两个坑:一是 DateTimeKind.Unspecified 被当成本地时间处理;二是 Web API 返回给前端后,JavaScript 的 Date 构造函数在不同浏览器里解析行为不一致。
- 如果业务时间全是服务器本地时间(比如中国服务器 +08:00),建议统一用
DateTimeKind.Utc存储,序列化前调用.ToUniversalTime() - 若必须保留本地时区标识,配置
DateFormatHandling为DateFormatHandling.IsoDateFormat(默认值),再设DateTimeZoneHandling为DateTimeZoneHandling.RoundtripKind—— 这样能保留Kind信息,反序列化时不会丢 - 别用
DateTimeZoneHandling.AssumeLocal,它会强行把所有Unspecified当成本地时间,跨服务器部署时极易出错
System.Text.Json 不支持全局自定义 DateTime 格式,得靠 JsonSerializerOptions
System.Text.Json 是 .NET Core 3.0+ 默认序列化器,但它没有像 Newtonsoft 那样的 JsonConvert.DefaultSettings 全局钩子。想统一改时间格式,只能在每次创建 JsonSerializerOptions 时配置,或者封装一个复用的实例。
- 用
options.Converters.Add(new JsonStringEnumConverter())这类方式对时间无效 ——DateTime没内置字符串格式转换器 - 正确做法是添加自定义转换器:
options.Converters.Add(new JsonConverter<datetime>(...))</datetime>,里面用ToString("yyyy-MM-dd HH:mm:ss")控制输出 - 注意:
System.Text.Json默认忽略DateTimeKind,反序列化后全是Unspecified,如需保留,必须手动在转换器里处理DateTimeKind字段或加额外元数据
ASP.NET Core 里配置全局序列化器,别只改 Controller 层
很多人在 Startup.ConfigureServices 或 Program.cs 里配了 AddJsonOptions,结果发现 HttpContext.Request.ReadFromJsonAsync<t>()</t> 还是用默认格式 —— 因为这个 API 走的是底层 System.Text.Json 默认选项,不走 MVC 的 JSON 配置。
- MVC 的
AddJsonOptions只影响Controller返回值(Ok(model))和模型绑定([FromBody]) - 要统一
ReadFromJsonAsync行为,得显式传入共享的JsonSerializerOptions实例,比如HttpContext.Request.ReadFromJsonAsync<t>(sharedOptions)</t> - 更稳妥的做法是把
JsonSerializerOptions注册为单例服务,然后在需要的地方IServiceProvider.GetRequiredService<jsonserializeroptions>()</jsonserializeroptions>
时区转换和序列化混用时,最容易漏掉的一步
很多团队在日志、导出、第三方对接场景下,要求时间字段固定为“北京时间”字符串(如 "2024-05-20 14:30:00"),但直接在 DTO 里写 [JsonIgnore] + 新增 string DisplayTime => Time.ToLocalTime().ToString("yyyy-MM-dd HH:mm:ss"),会导致反序列化失败或数据不一致。
- 这种只读属性无法反序列化,POST 过来的 JSON 里
DisplayTime字段会被忽略,原始Time字段还是按默认规则解析 - 真正安全的做法是:DTO 中只保留一个
DateTime字段,用自定义转换器控制其序列化/反序列化行为,而不是拆成两个字段 - 如果必须兼容旧协议(比如对方只认字符串时间),转换器里要同时支持从字符串(带时区或无时区)和
DateTime两种输入解析,否则JsonSerializer.Deserialize会抛JsonException











