使用EF Core操作PostgreSQL时自动转换DateTimeOffset为UTC

方法一：全局配置值转换器 #

通过EF Core的值转换器，让所有DateTimeOffset类型的属性自动转换为UTC时间后与数据库交互。在你的DbContext类中重写OnModelCreating方法：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 遍历所有实体类型
    foreach (var entityType in modelBuilder.Model.GetEntityTypes())
    {
        // 遍历实体的所有属性
        foreach (var property in entityType.GetProperties())
        {
            // 匹配DateTimeOffset及可空DateTimeOffset类型
            if (property.ClrType == typeof(DateTimeOffset) || property.ClrType == typeof(DateTimeOffset?))
            {
                // 设置值转换器：写入时转UTC，读取时保持原样
                property.SetValueConverter(new ValueConverter<DateTimeOffset, DateTimeOffset>(
                    write => write.ToUniversalTime(),
                    read => read
                ));
            }
        }
    }
}

这个配置会自动处理实体属性的读写转换，无论是新增、修改还是查询时的属性值，都会被转为UTC后再和PostgreSQL交互。

方法二：使用EF Core拦截器 #

如果需要更灵活的控制（比如单独处理查询参数或实体状态变更），可以通过自定义拦截器实现：

1. 实体保存拦截器（处理新增/修改） #

创建拦截器自动将待保存的DateTimeOffset值转为UTC：

public class UtcDateTimeOffsetSaveInterceptor : SaveChangesInterceptor
{
    public override ValueTask<InterceptionResult<int>> SavingChangesAsync(DbContextEventData eventData, InterceptionResult<int> result, CancellationToken cancellationToken = default)
    {
        if (eventData.Context == null)
            return base.SavingChangesAsync(eventData, result, cancellationToken);

        // 遍历所有状态为新增或修改的实体
        foreach (var entry in eventData.Context.ChangeTracker.Entries())
        {
            if (entry.State is EntityState.Added or EntityState.Modified)
            {
                // 遍历实体属性，转换DateTimeOffset值
                foreach (var property in entry.Properties)
                {
                    if (property.CurrentValue is DateTimeOffset dto)
                    {
                        property.CurrentValue = dto.ToUniversalTime();
                    }
                }
            }
        }

        return base.SavingChangesAsync(eventData, result, cancellationToken);
    }
}

2. 查询参数拦截器（处理查询条件中的DateTimeOffset） #

创建拦截器自动转换查询表达式中的DateTimeOffset参数为UTC：

public class UtcDateTimeOffsetQueryInterceptor : IQueryExpressionInterceptor
{
    public Expression QueryCompilationStarting(Expression queryExpression, QueryExpressionEventData eventData)
    {
        return new UtcDateTimeOffsetExpressionVisitor().Visit(queryExpression);
    }

    private class UtcDateTimeOffsetExpressionVisitor : ExpressionVisitor
    {
        protected override Expression VisitConstant(ConstantExpression node)
        {
            // 转换常量中的DateTimeOffset值为UTC
            if (node.Value is DateTimeOffset dto)
            {
                return Expression.Constant(dto.ToUniversalTime(), typeof(DateTimeOffset));
            }
            return base.VisitConstant(node);
        }
    }
}

3. 注册拦截器 #

在Program.cs（或DbContext配置处）注册这两个拦截器：

builder.Services.AddDbContext<YourDbContext>(options =>
{
    options.UseNpgsql("你的数据库连接字符串")
           .AddInterceptors(
               new UtcDateTimeOffsetSaveInterceptor(),
               new UtcDateTimeOffsetQueryInterceptor()
           );
});

注意事项 #

• 不建议启用Npgsql.EnableLegacyTimestampBehavior开关，该选项仅用于兼容旧版行为，并非规范的UTC时间处理方式。
• 两种方法选其一即可，值转换器配置更简洁，拦截器则提供更细粒度的控制。

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