从.NET 6升级至8后，如何取消PostgreSQL无时区DateTime的Z标识？

问题根源 #

.NET 8 对 System.Text.Json 的 DateTime 序列化逻辑做了调整：默认会将 DateTimeKind.Unspecified 类型的日期时间当作 UTC 处理，序列化后自动添加 Z 标识；而 .NET 6 则直接输出无时区的原始格式。同时，Npgsql 从 PostgreSQL 读取无时区类型的 DateTime 时，默认映射为 DateTimeKind.Unspecified，但序列化行为的变化导致了输出差异。

解决方案 #

1. 全局配置 System.Text.Json 序列化规则 #

在 Program.cs 中配置控制器的 Json 选项，强制输出无时区的日期格式：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 设置DateTime处理为Unspecified模式，不添加时区标识
        options.JsonSerializerOptions.DefaultDateTimeHandling = JsonDateTimeHandling.Unspecified;
        // 自定义日期格式，确保和.NET6输出格式完全一致
        options.JsonSerializerOptions.DateTimeFormat = new JsonDateTimeFormat
        {
            CustomFormat = "yyyy-MM-dd'T'HH:mm:ss.fffffff"
        };
    });

如果内置设置不生效，可通过自定义转换器实现精确控制：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.Converters.Add(new DateTimeWithoutTimeZoneConverter());
    });

// 自定义DateTime序列化转换器
public class DateTimeWithoutTimeZoneConverter : JsonConverter<DateTime>
{
    private const string Format = "yyyy-MM-dd'T'HH:mm:ss.fffffff";

    public override DateTime Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        return DateTime.ParseExact(reader.GetString()!, Format, CultureInfo.InvariantCulture);
    }

    public override void Write(Utf8JsonWriter writer, DateTime value, JsonSerializerOptions options)
    {
        writer.WriteStringValue(value.ToString(Format, CultureInfo.InvariantCulture));
    }
}

2. 确保Npgsql读取的DateTime为Unspecified类型 #

在 PostgreSQL 连接字符串中添加 DateTimeKind=Unspecified，避免Npgsql将无时区的日期自动转换为UTC类型：

Host=your_host;Database=your_db;Username=your_user;Password=your_pass;DateTimeKind=Unspecified

3. 局部属性级配置（按需使用） #

如果不需要全局修改，可在实体类的特定 DateTime 属性上添加转换器特性：

public class YourEntity
{
    [JsonConverter(typeof(DateTimeWithoutTimeZoneConverter))]
    public DateTime CreateTime { get; set; }
}

验证 #

完成配置后，后端返回的日期格式会恢复为 2024-02-11T14:00:00.0000000 这种无时区的形式，与.NET6的输出完全一致，前端无需额外处理时区计算。

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