.NET 6 EF对接PostgreSql如何在Model/DTO中实现DateTimeOffset自动转换

以下是3种可落地的优化方案，可根据你的项目架构选择：

方案1：EF Core值转换器（最推荐，全局统一处理无需改动业务代码） #

直接在数据层配置全局转换规则，所有DateTimeOffset类型的属性读写时会自动完成格式转换，完全不需要修改业务层逻辑：

// 在你的DbContext类中重写OnModelCreating方法
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 定义DateTimeOffset转换规则
    var dateTimeOffsetConverter = new ValueConverter<DateTimeOffset, DateTimeOffset>(
        write => write.ToUniversalTime(), // 写入数据库时自动转UTC格式
        read => read.ToLocalTime() // 从数据库读取时自动转本地时间
    );

    // 全局应用到所有实体的DateTimeOffset/可空DateTimeOffset属性
    var allDateTimeOffsetProps = modelBuilder.Model
        .GetEntityTypes()
        .SelectMany(t => t.GetProperties())
        .Where(p => p.ClrType == typeof(DateTimeOffset) || p.ClrType == typeof(DateTimeOffset?));
    
    foreach (var prop in allDateTimeOffsetProps)
    {
        prop.SetValueConverter(dateTimeOffsetConverter);
    }
}

如果不需要全局生效，也可以单独为指定实体的指定属性配置转换器。

方案2：AutoMapper全局映射配置（适配你现有Mapper架构） #

如果你的项目已经大量使用AutoMapper做对象转换，可以直接配置DateTimeOffset类型的全局转换规则，无需为每个DTO/Model单独配置映射：

// 在AutoMapper配置类中添加全局转换规则
public class AutoMapperProfile : Profile
{
    public AutoMapperProfile()
    {
        // 写入方向：DTO转实体时自动转UTC
        CreateMap<DateTimeOffset, DateTimeOffset>()
            .ConvertUsing(src => src.ToUniversalTime());
        
        // 读取方向：实体转DTO时自动转本地时间
        CreateMap<DateTimeOffset, DateTimeOffset>()
            .ForMember(dest => dest, opt => opt.MapFrom(src => src.ToLocalTime()))
            .ReverseMap();

        // 其余实体映射规则保持不变
        CreateMap<Dto, MyModel>();
        CreateMap<MyModel, Dto>();
    }
}

配置完成后你原先的手动转换代码可以直接删除，_mapper.Map会自动完成时间格式转换。

方案3：属性层面封装转换逻辑（适合少量属性的轻量化场景） #

如果不想改动全局配置，也可以直接修改Model/DTO的属性定义，在get/set中内置转换逻辑：

// 实体类示例
public class MyModel : BaseEntity
{
    private DateTimeOffset _myDate;
    public DateTimeOffset MyDate 
    { 
        get => _myDate.ToLocalTime();
        set => _myDate = value.ToUniversalTime();
    }
}

// DTO类示例
public class Dto : BaseDto
{
    private DateTimeOffset _myDate;
    public DateTimeOffset MyDate 
    { 
        get => _myDate.ToLocalTime();
        set => _myDate = value.ToUniversalTime();
    }
}

如果需要处理接口入参的序列化转换，还可以搭配JSON全局转换器实现接口层自动转换：

// 自定义DateTimeOffset序列化转换器
public class AutoUtcDateTimeOffsetConverter : JsonConverter<DateTimeOffset>
{
    public override DateTimeOffset Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        return reader.GetDateTimeOffset().ToUniversalTime();
    }

    public override void Write(Utf8JsonWriter writer, DateTimeOffset value, JsonSerializerOptions options)
    {
        writer.WriteStringValue(value.ToLocalTime().ToString("O"));
    }
}

// 在Program.cs中注册转换器
builder.Services.AddControllers()
    .AddJsonOptions(opt =>
    {
        opt.JsonSerializerOptions.Converters.Add(new AutoUtcDateTimeOffsetConverter());
    });

内容的提问来源于stack exchange，提问作者Emre Utku Solak