.NET Core 2.0 WebAPI如何配置全局默认yyyy-mm-dd日期格式

当然可以解决这个问题！环境差异导致日期格式解析不一致是.NET Core WebAPI部署时常见的坑，主要是因为不同环境的系统文化设置不同（比如生产服务器可能用了dd-MM-yyyy的默认文化）。下面几个方案可以帮你彻底统一所有环境下的日期处理逻辑：

1. 统一JSON请求/响应的日期格式 #

如果你的API主要通过JSON请求体传递日期，直接在全局配置JSON序列化规则即可。在.NET 6+的Program.cs中，修改AddControllers的配置：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 全局设置DateTime类型的序列化/反序列化格式为yyyy-MM-dd
        options.JsonSerializerOptions.DateFormatString = "yyyy-MM-dd";
        // 该配置自动覆盖可空DateTime类型的处理
    });

这个配置会让System.Text.Json在序列化和反序列化所有DateTime（包括DateTime?）类型时，强制使用yyyy-MM-dd格式，完全不受环境文化影响。

2. 处理URL参数/表单中的日期绑定 #

如果你的API有通过查询参数、路由参数或者表单提交日期的场景，上面的JSON配置管不到这部分，需要自定义模型绑定器来强制解析规则：

首先，创建自定义的模型绑定器和绑定器提供器：

public class CustomDateTimeModelBinderProvider : IModelBinderProvider
{
    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        // 只针对DateTime和可空DateTime类型生效
        if (context.Metadata.ModelType == typeof(DateTime) || context.Metadata.ModelType == typeof(DateTime?))
        {
            return new BinderTypeModelBinder(typeof(CustomDateTimeModelBinder));
        }
        return null;
    }
}

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

        bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueResult);
        var dateValue = valueResult.FirstValue;

        if (string.IsNullOrWhiteSpace(dateValue))
        {
            return Task.CompletedTask;
        }

        // 强制用yyyy-MM-dd格式解析，使用InvariantCulture避免环境影响
        if (DateTime.TryParseExact(dateValue, "yyyy-MM-dd", CultureInfo.InvariantCulture, DateTimeStyles.None, out var parsedDate))
        {
            bindingContext.Result = ModelBindingResult.Success(parsedDate);
        }
        else
        {
            bindingContext.ModelState.TryAddModelError(bindingContext.ModelName, $"日期格式无效，请使用yyyy-MM-dd格式");
        }

        return Task.CompletedTask;
    }
}

然后在Program.cs中注册这个绑定器提供器：

builder.Services.Configure<MvcOptions>(options =>
{
    // 将自定义绑定器放在最前面，优先使用
    options.ModelBinderProviders.Insert(0, new CustomDateTimeModelBinderProvider());
});

这样不管环境的默认文化是什么，URL/表单中的日期都会按照yyyy-MM-dd来解析，解析失败还会返回友好的错误提示。

3. 全局设置应用文化（可选） #

如果你的应用不需要适配多文化场景，也可以直接全局设置应用的默认文化，强制所有日期相关处理都使用yyyy-MM-dd：

在Program.cs的开头添加：

var defaultCulture = new CultureInfo("en-US");
// 覆盖短日期和长日期格式
defaultCulture.DateTimeFormat.ShortDatePattern = "yyyy-MM-dd";
defaultCulture.DateTimeFormat.LongDatePattern = "yyyy-MM-dd";

// 设置线程默认文化
CultureInfo.DefaultThreadCurrentCulture = defaultCulture;
CultureInfo.DefaultThreadCurrentUICulture = defaultCulture;

这个方法最简单，但会影响整个应用的文化相关设置（比如数字、货币的格式），所以只适合不需要多文化支持的场景。

推荐组合方案 #

如果你的API同时有JSON请求体和URL/表单参数的日期传递，推荐同时使用方案1 + 方案2，这样可以覆盖所有场景，彻底解决环境差异导致的日期格式问题。

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