如何全局转换URL/查询参数中未指定Kind的DateTime为本地时间

完全不需要在每个端点中单独编写转换逻辑，可以在请求进入端点逻辑之前，通过全局模型绑定机制统一完成所有非JSON来源的DateTime类型转换，和你之前实现的JSON转换器逻辑保持一致。

核心逻辑说明 #

你之前实现的JsonConverter<DateTime>仅负责请求体JSON序列化/反序列化流程的转换，而URL查询参数、路由值、表单参数这类输入，在ASP.NET Core请求管道中走模型绑定流程，不会触发JSON序列化逻辑，因此不会走到你之前编写的转换器，这是框架的流程设计决定的，不属于实现bug。

模型绑定阶段是在请求进入端点逻辑之前执行的，完全满足你提前做转换的需求，全局配置一次即可对所有接口生效。

具体实现步骤（ASP.NET Core 控制器/ Razor Pages 场景） #

1. 编写自定义DateTime模型绑定逻辑 #

实现和你JSON转换器完全一致的Unspecified Kind转本地时间的判断：

public class DateTimeModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        if (bindingContext == null)
            throw new ArgumentNullException(nameof(bindingContext));

        var modelName = bindingContext.ModelName;
        var valueProviderResult = bindingContext.ValueProvider.GetValue(modelName);
        if (valueProviderResult == ValueProviderResult.None)
            return Task.CompletedTask;

        bindingContext.ModelState.SetModelValue(modelName, valueProviderResult);
        var rawValue = valueProviderResult.FirstValue;
        if (string.IsNullOrEmpty(rawValue))
            return Task.CompletedTask;

        // 解析传入的DateTime字符串
        if (!DateTime.TryParse(rawValue, out var parsedDate))
        {
            bindingContext.Result = ModelBindingResult.Failed();
            return Task.CompletedTask;
        }

        // 核心转换逻辑，和你JsonConverter里的规则保持完全一致
        if (parsedDate.Kind == DateTimeKind.Unspecified)
        {
            parsedDate = DateTime.SpecifyKind(parsedDate, DateTimeKind.Local);
        }

        bindingContext.Result = ModelBindingResult.Success(parsedDate);
        return Task.CompletedTask;
    }
}

2. 编写模型绑定提供器，告诉框架何时使用自定义逻辑 #

public class DateTimeModelBinderProvider : IModelBinderProvider
{
    public IModelBinder? GetBinder(ModelBinderProviderContext context)
    {
        if (context == null)
            throw new ArgumentNullException(nameof(context));

        // 匹配非可空、可空的DateTime类型
        if (context.Metadata.ModelType == typeof(DateTime) || 
            context.Metadata.ModelType == typeof(DateTime?))
        {
            return new BinderTypeModelBinder(typeof(DateTimeModelBinder));
        }

        return null;
    }
}

3. 全局注册绑定规则 #

在Program.cs的服务配置中，把自定义的BinderProvider注入到框架的绑定流程中：

builder.Services.AddControllers(options =>
{
    // 插到绑定提供器列表最前面，优先匹配DateTime类型的参数
    options.ModelBinderProviders.Insert(0, new DateTimeModelBinderProvider());
});

配置完成后，所有从查询参数、路由值、表单提交传入的DateTime参数，都会在进入端点前自动完成Unspecified Kind转本地时间的逻辑，和JSON入参的转换规则完全统一。

Minimal API 场景的适配 #

Minimal API 从.NET 6开始就逐步复用ASP.NET Core的通用模型绑定基础设施，上述控制器场景的全局配置同样可以直接在Minimal API项目中生效，不需要为每个端点单独编写解析逻辑。对于特殊版本下的兼容性问题，也可以通过全局注册参数解析委托的方式实现同样的转换效果，无需逐端点重复编写判断代码。

注意事项 #

• 一定要保证模型绑定阶段的转换逻辑，和你之前编写的JsonConverter<DateTime>内的判断规则、转换结果完全一致，避免不同来源的DateTime出现行为不一致的问题
• 该方案覆盖所有非JSON格式的参数来源，全局生效，不会出现漏配某个接口的问题
• 整个转换流程在请求进入端点逻辑前执行，完全符合你提前处理的需求

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