ASP.NET Core如何覆写Newtonsoft全局日期序列化配置（特定端点/模型）

问题原因 #

你添加的[JsonConverter(typeof(IsoDateTimeConverter))]属性无效，是因为全局配置中直接设置了SerializerSettings.DateFormatString = "yyyy/MM/dd"，该全局设置的优先级高于属性级别的转换器配置，导致局部覆写被忽略。

解决方案 #

方案一：调整全局配置方式，启用局部转换器生效 #

将全局配置中直接设置DateFormatString的方式，替换为添加自定义的IsoDateTimeConverter，这样属性上的转换器就能覆盖全局设置：

// Startup.cs 或 Program.cs 中的服务配置
services.AddNewtonsoftJson(options =>
{
    // 用全局转换器替代DateFormatString
    options.SerializerSettings.Converters.Add(new IsoDateTimeConverter
    {
        DateTimeFormat = "yyyy/MM/dd"
    });
    // 保留原有的枚举转换器
    options.SerializerSettings.Converters.Add(new StringEnumConverter());
});

之后在需要ISO格式的模型属性上添加转换器属性即可：

public class TargetModel
{
    // 该属性将使用ISO格式序列化
    [JsonConverter(typeof(IsoDateTimeConverter))]
    public DateTime NeedTimeInfo { get; set; }

    // 其他属性沿用全局的yyyy/MM/dd格式
    public DateTime OnlyDate { get; set; }
}

方案二：为单个端点单独配置序列化规则 #

如果不想修改全局配置，可针对目标端点单独设置序列化选项，避免影响其他接口：

方式1：直接在端点中配置输出格式化器

[HttpGet("need-iso-datetime")]
public IActionResult GetDataWithIsoDateTime()
{
    var data = new 
    {
        IsoTime = DateTime.Now,
        NormalDate = DateTime.Now
    };

    var result = new ObjectResult(data);
    // 清空默认格式化器，添加自定义ISO格式的格式化器
    result.Formatters.Clear();
    result.Formatters.Add(new NewtonsoftJsonOutputFormatter(
        new JsonSerializerSettings
        {
            DateFormatString = "yyyy'-'MM'-'dd'T'HH':'mm':'ss.fffK", // ISO 8601标准格式
            Converters = { new StringEnumConverter() }
        },
        ArrayPool<char>.Shared,
        new MvcOptions()));
    
    return result;
}

方式2：用过滤器复用配置

创建自定义过滤器：

public class UseIsoDateTimeAttribute : ActionFilterAttribute
{
    public override void OnActionExecuted(ActionExecutedContext context)
    {
        if (context.Result is ObjectResult objectResult)
        {
            var isoSettings = new JsonSerializerSettings
            {
                DateFormatString = "yyyy'-'MM'-'dd'T'HH':'mm':'ss.fffK",
                Converters = { new StringEnumConverter() }
            };
            objectResult.Formatters.Clear();
            objectResult.Formatters.Add(new NewtonsoftJsonOutputFormatter(isoSettings, ArrayPool<char>.Shared, new MvcOptions()));
        }
        base.OnActionExecuted(context);
    }
}

在目标端点上标记该过滤器即可：

[HttpGet("need-iso-datetime")]
[UseIsoDateTime]
public IActionResult GetDataWithIsoDateTime()
{
    return Ok(new { IsoTime = DateTime.Now });
}

方案选择 #

• 若多个模型属性需要覆写全局格式，优先选方案一，配置更简洁。
• 若仅少数端点需要特殊处理，选方案二，无需改动全局配置。

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