ASP.NET Core 3.1日期控件与链接提交日期格式不一致问题排查

核心问题是表单提交与路由链接生成时的日期格式不匹配，导致ModelState中的值无法和输入框的asp-format规则兼容，进而无法回显：

• 表单提交时，asp-for结合asp-format="{0:dd/MM/yyyyTHH:mm}"会强制输入框输出/提交带T分隔符的日期字符串（如2022-11-01T18:27），这个格式能被模型绑定正确解析，同时也符合输入框的回显规则。
• 路由链接（<a asp-route-*>）生成时，直接将DateTime?对象转换为当前服务器文化默认的日期字符串（如01/11/2022 18:27:00），虽然后端能正确解析这个值，但ModelState中会留存这个带空格分隔的格式字符串。当页面渲染时，asp-for会优先读取ModelState中的值，而这个值和asp-format指定的dd/MM/yyyyTHH:mm格式不匹配，导致输入框无法正确回显日期。

方案1：给路由链接的日期参数指定统一格式 #

直接在asp-route-*中对日期值按输入框的格式格式化，确保路由参数的日期格式和表单提交的一致：

<a asp-controller="Submissions"
   asp-action="Index"
   asp-route-SortField="Submitted"
   asp-route-SortDir="@Model.SortDir"
   asp-route-SortDirNext="@Model.SortDirNext"
   asp-route-PageSize="@Model.PageSize"
   asp-route-PageNumber="@Model.PageNumber"
   asp-route-SubmittedDateFrom="@Model.SubmittedDateFrom?.ToString("dd/MM/yyyyTHH:mm")"
   asp-route-SubmittedDateTo="@Model.SubmittedDateTo?.ToString("dd/MM/yyyyTHH:mm")">
    @Html.DisplayNameFor(model => model.First().Submitted)
</a>

这样路由生成的查询参数日期格式和表单提交的完全一致，ModelState中的值能匹配asp-format规则，输入框就能正常回显。

方案2：配置全局日期绑定规则（可选） #

如果希望整个应用的日期格式统一，可以在Startup.cs中配置模型绑定的日期格式，同时兼容表单和GET请求的参数：

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllersWithViews()
        .AddMvcOptions(options =>
        {
            options.ModelMetadataDetailsProviders.Add(new DisplayMetadataProvider(
                context =>
                {
                    if (context.ModelType == typeof(DateTime) || context.ModelType == typeof(DateTime?))
                    {
                        context.DisplayMetadata.DisplayFormatString = "dd/MM/yyyyTHH:mm";
                        context.DisplayMetadata.EditFormatString = "dd/MM/yyyyTHH:mm";
                    }
                }));
        });
}

不过这种方式会全局生效，需要确认是否符合其他页面的日期格式需求。

方案3：升级到ASP.NET Core 6.0后的优化 #

升级到.NET 6后，默认的模型绑定行为有调整，你可以利用DateOnly/TimeOnly类型（如果不需要完整的日期时间），或者在Program.cs中更简洁地配置日期格式：

builder.Services.AddControllersWithViews()
    .AddMvcOptions(options =>
    {
        options.FormatterMappings.SetMediaTypeMappingForFormat("dd/MM/yyyyTHH:mm", MediaTypeNames.Application.Json);
    });

但核心还是要保证路由参数和输入框的格式统一，方案1在.NET 3.1和6.0中都能直接生效。

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