在c#中将dateonly属性序列化为json日期字符串,最直接的方法是使用system.text.json并配置jsonserializeroptions的dateonlyhandling选项为jsondateonlyhandlingmode.string。这样设置后,序列化器会自动将dateonly类型的值转换为iso 8601格式的日期字符串(如"2023-10-01"),而无需编写自定义转换器。
如何配置System.Text.Json以支持DateOnly字符串序列化
要启用此功能,需要在创建JsonSerializerOptions实例时显式设置DateOnlyHandling属性。默认情况下,System.Text.Json可能不支持DateOnly或将其序列化为对象结构,因此必须指定处理模式。以下代码展示了完整的配置和序列化过程。

using System; using System.Text.Json; using System.Text.Json.Serialization; public class Program { public static void Main() { var options = new JsonSerializerOptions { DateOnlyHandling = JsonDateOnlyHandlingMode.String }; var date = new DateOnly(2023, 10, 1); var json = JsonSerializer.Serialize(date, options); Console.WriteLine(json); // 输出: "2023-10-01" } }
运行上述代码,控制台将输出标准的日期字符串格式。这种配置适用于所有使用System.Text.Json进行序列化的场景,包括ASP.NET Core API响应。
Newtonsoft.Json中如何处理DateOnly序列化
如果使用Newtonsoft.Json(即Json.NET),它原生不直接支持DateOnly类型。需要通过注册一个自定义的JsonConverter来实现字符串序列化。以下代码展示了一个简单的转换器实现。
KeystoneJS 是一个功能强大的开源无头 CMS,适用于 Node.js,它根据您的模式定义自动生成 GraphQL API 和基于 React 的管理界面。由 Thinkmill 构建,支持 PostgreSQL 和 SQLite、自定义访问控制、钩子、虚拟字段和基于文档的富文本编辑。

using System; using Newtonsoft.Json; public class DateOnlyConverter : JsonConverter<dateonly> { public override void WriteJson(JsonWriter writer, DateOnly value, JsonSerializer serializer) { writer.WriteValue(value.ToString("yyyy-MM-dd")); } public override DateOnly ReadJson(JsonReader reader, Type objectType, DateOnly existingValue, bool hasExistingValue, JsonSerializer serializer) { return DateOnly.ParseExact(reader.Value.ToString(), "yyyy-MM-dd", null); } }</dateonly>
在使用时,将该转换器添加到JsonSerializerSettings的Converters集合中即可。这种方法提供了更细粒度的控制,但相比System.Text.Json的原生支持,代码量稍多。
DateOnly序列化时的时区影响是什么
DateOnly类型本身不包含时间信息,也不涉及时区。因此,无论系统时区如何设置,序列化结果始终是基于本地日期的字符串表示。例如,即使服务器位于UTC+8,DateOnly序列化为"2023-10-01"也不会附加任何时区后缀。这与DateTime不同,后者可能需要根据DateTimeKind调整序列化行为。










