Npgsql COUNT查询匹配数据却返回0的问题排查

核心原因：时区解析与DateTime.Kind的差异 #

你的问题根源在于UTC时间的反序列化处理以及DateTime.Date属性的时区特性：

1. 请求中的date是UTC时间（2024-12-29T21:42:58.251Z），如果反序列化时被错误解析为本地时区的DateTime（Kind=Local），调用timeEntry.Date.Date会得到本地时区的0点时间（比如东八区的2024-12-29 00:00:00）。
2. 当Npgsql将这个本地时区的DateTime传给PostgreSQL时，数据库会根据自身时区设置转换为UTC时间。比如东八区的2024-12-29 00:00:00转换为UTC是2024-12-28 16:00:00，对应的date值是2024-12-28，和表中的2024-12-29完全不匹配，因此查询返回0。

而你手动构造的代码：

var data = new DateTime(timeEntry.Date.Year, timeEntry.Date.Month, timeEntry.Date.Day, 0, 0, 0);

创建的是未指定时区的DateTime（Kind=Unspecified），Npgsql默认会将这种DateTime当作UTC时间传入数据库，转换后的date值是2024-12-29，和表中数据匹配，因此查询正常。

验证过程佐证 #

你手动执行的SQL能返回正确结果，是因为PostgreSQL将字符串'2024-12-29 00:00:00'当作本地时区时间（或按数据库时区解析），恰好和表中数据匹配；但代码中传入的是本地时区的0点，转换为UTC后日期已偏移，所以不匹配。

正确的解决方案 #

方案1：确保反序列化时保留UTC时区 #

检查JSON反序列化配置，确保带Z标识的UTC时间被解析为Kind=Utc的DateTime：

• 使用Newtonsoft.Json时：

  var settings = new JsonSerializerSettings
  {
      DateTimeZoneHandling = DateTimeZoneHandling.Utc
  };
  var timeEntry = JsonConvert.DeserializeObject<TimeEntry>(json, settings);
  

• 使用System.Text.Json时：

  var options = new JsonSerializerOptions
  {
      PropertyNameCaseInsensitive = true,
      DateTimeHandling = JsonDateTimeHandling.Utc
  };
  var timeEntry = JsonSerializer.Deserialize<TimeEntry>(json, options);
  

这样timeEntry.Date.Date返回的是UTC时区的2024-12-29 00:00:00，传入数据库后转换为date类型就是2024-12-29，匹配表中数据。

方案2：显式构造UTC时间 #

如果无法修改反序列化配置，直接构造UTC时间传入参数：

command.Parameters.AddWithValue("@Date", new DateTime(timeEntry.Date.Year, timeEntry.Date.Month, timeEntry.Date.Day, 0, 0, 0, DateTimeKind.Utc));

方案3：修改SQL查询逻辑 #

直接在查询中统一转换为date类型，避免时区差异影响：

SELECT COUNT(1)
FROM TimeEntries
WHERE EmployeeId = @EmployeeId AND Date::date = @Date::date

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