.NET 8中请求查询参数与请求体的DateTime解析行为差异问询

我正在使用.NET 8，发现请求中的DateTime字符串在查询参数与请求体中的解析行为存在差异。示例请求如下：

POST /api/Save?ValidFrom=2024-01-01T00:00:00+01:00

{
"validFrom":"2024-01-01T00:00:00+01:00"
}

可见查询参数与请求体中的日期字符串完全一致，均采用ISO8601格式。但在控制器方法中，查询参数的日期被解析为UTC类型的「31.12.2023 23:00:00」，而请求体中的日期被解析为Local类型的「01.01.2024 00:00:00」：

[HttpPost]
public async Task<ActionResult<InstitutionContributionRecognitionModel>> SaveAsync(DateTime ValidFrom, [FromBody] Model model, CancellationToken cancellationToken)
{
    // ValidFrom = 31.12.2023 23:00:00
    // model.ValidFrom = 01.01.2024 00:00:00
}

请问是否有方法让查询参数采用与请求体相同的解析行为？目前我想到的仅有的解决办法是在查询参数中使用DateTimeOffset，再通过DateTimeOffset.DateTime获取客户端本地日期。

方法1：自定义查询参数DateTime绑定器 #

通过自定义模型绑定器，让查询参数的DateTime解析逻辑和请求体的JSON解析对齐。

首先在Program.cs中注册自定义绑定器：

builder.Services.AddControllers(options =>
{
    options.ModelBinderProviders.Insert(0, new LocalDateTimeModelBinderProvider());
});

然后实现对应的绑定器类：

public class LocalDateTimeModelBinderProvider : IModelBinderProvider
{
    public IModelBinder? GetBinder(ModelBinderProviderContext context)
    {
        if (context.Metadata.ModelType == typeof(DateTime))
        {
            return new LocalDateTimeModelBinder();
        }
        return null;
    }
}

public class LocalDateTimeModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueProviderResult == ValueProviderResult.None)
        {
            return Task.CompletedTask;
        }

        bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueProviderResult);
        var stringValue = valueProviderResult.FirstValue;

        if (string.IsNullOrEmpty(stringValue))
        {
            return Task.CompletedTask;
        }

        try
        {
            // 解析为本地时间，和请求体JSON解析行为一致
            var dateTime = DateTime.Parse(stringValue);
            bindingContext.Result = ModelBindingResult.Success(DateTime.SpecifyKind(dateTime, DateTimeKind.Local));
        }
        catch (FormatException ex)
        {
            bindingContext.ModelState.TryAddModelError(bindingContext.ModelName, $"无效的日期格式: {ex.Message}");
        }

        return Task.CompletedTask;
    }
}

方法2：统一全局DateTime处理规则 #

同时配置JSON序列化和查询参数绑定的DateTime处理逻辑，让两者都保留原始时区对应的本地时间：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.Converters.Add(new System.Text.Json.Serialization.JsonConverter<DateTime>
        {
            Read = (reader, typeToConvert, options) =>
            {
                var dateTime = DateTime.Parse(reader.GetString()!);
                return DateTime.SpecifyKind(dateTime, DateTimeKind.Local);
            },
            Write = (writer, value, options) =>
            {
                writer.WriteStringValue(value.ToString("o"));
            }
        });
    });

// 复用上述方法1中的LocalDateTimeModelBinderProvider注册逻辑
builder.Services.Configure<MvcOptions>(options =>
{
    options.ModelBinderProviders.Insert(0, new LocalDateTimeModelBinderProvider());
});

方法3：使用DateTimeOffset（你当前的思路） #

这是最轻量化的方案，无需全局配置或自定义绑定器，直接修改查询参数类型：

[HttpPost]
public async Task<ActionResult<InstitutionContributionRecognitionModel>> SaveAsync(DateTimeOffset ValidFrom, [FromBody] Model model, CancellationToken cancellationToken)
{
    // 转换为本地时间，与请求体解析结果一致
    DateTime localValidFrom = ValidFrom.LocalDateTime;
    // localValidFrom = 01.01.2024 00:00:00
}

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