C#怎么格式化JSON的时间格式_C#如何配置全局序列化器【避坑】

千丽小哥_2951

千丽小哥_2951

2026-03-31

908人浏览

原创

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 字段并用转换器统一处理序列化与反序列化。

c#怎么格式化json的时间格式_c#如何配置全局序列化器【避坑】

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 时配置,或者封装一个复用的实例。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • 用 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

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

2023.08.08

1032

5

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2023.08.31

2971

3

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

2024.03.13

885

8

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2024.03.14

2615

11

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

2026.02.03

312

18

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

2026.02.06

389

20

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

2026.03.11

631

24

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

2026.04.13

329

20

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

6479

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习