C# DateTime.MinValue存入PostgreSQL后Kind属性异常问题排查

结论 #

这个问题是Npgsql驱动的特殊处理逻辑导致的，与EF Core、PostgreSQL本身无关。

具体原因 #

1. PostgreSQL侧：存储正常
   PostgreSQL的timestamp with timezone（timestamptz）类型支持存储0001-01-01这个时间点，它会将传入的UTC时间转换为UTC时间戳存储，本身不会丢失时区信息。

2. Npgsql驱动的特殊处理
   Npgsql驱动在处理DateTime.MinValue（0001-01-01 00:00:00 UTC）时有特殊逻辑：

• 对于普通的UTC时间，Npgsql读取timestamptz列后会返回带Kind=Utc的DateTime对象；
• 但针对DateTime.MinValue，驱动为了避免某些时区转换场景下的溢出风险，会跳过设置Kind属性，导致返回的DateTime对象Kind=Unspecified，但日期时间值本身保持正确。

你可以通过测试验证：将DateTime.MinValue.AddTicks(1)存入数据库，读取后Kind会正常保留为Utc，这就说明问题仅针对DateTime.MinValue这个特殊值。

3. EF Core的角色
   EF Core在此流程中仅作为数据访问的封装层，直接调用Npgsql驱动执行读写操作，没有修改DateTime的Kind属性，因此不是问题的源头。

解决办法 #

• 手动设置Kind：读取数据后，手动将DateTime的Kind设置为Utc（注意确保值本身确实是UTC时间）：

  var dateTime = entity.MyDateTime;
  if (dateTime == DateTime.MinValue && dateTime.Kind == DateTimeKind.Unspecified)
  {
      entity.MyDateTime = DateTime.SpecifyKind(dateTime, DateTimeKind.Utc);
  }
  

• 改用DateTimeOffset：将实体类中的属性类型改为DateTimeOffset，它能明确存储时区信息，Npgsql对DateTimeOffset.MinValue没有特殊处理，读写后会正确保留时区标识，避免Kind丢失的问题。

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