如何在ASP.NET Core Web API中保持客户端发送的DateTime不变

1. 全局配置JSON序列化行为（推荐） #

通过配置API的JSON序列化器，强制保留传入的DateTime时区偏移信息，避免自动转换为服务器时区。

ASP.NET Core（System.Text.Json） #

在Program.cs中添加序列化配置：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 保留DateTime的原始时区信息，不自动转换
        options.JsonSerializerOptions.DateTimeHandling = JsonDateTimeHandling.RoundtripKind;
    });

JsonDateTimeHandling.RoundtripKind会让序列化器严格按照请求中的DateTime格式解析，保留原始的时区偏移或DateTimeKind标记，不会自动转换为服务器本地时间。

旧版ASP.NET（Newtonsoft.Json） #

在WebApiConfig.cs中配置：

config.Formatters.JsonFormatter.SerializerSettings.DateTimeZoneHandling = DateTimeZoneHandling.RoundtripKind;

该配置同样会阻止序列化器自动转换时区，保留原始的日期时间及偏移信息。

2. 自定义模型绑定器 #

如果全局配置不适用，可以针对特定DateTime属性创建自定义绑定器，手动解析并保留客户端的本地时间值。

首先实现自定义绑定器：

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

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

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

        if (string.IsNullOrEmpty(value))
            return Task.CompletedTask;

        // 解析为DateTimeOffset后，提取客户端本地时间部分
        if (DateTimeOffset.TryParse(value, out var dateTimeOffset))
        {
            bindingContext.Result = ModelBindingResult.Success(dateTimeOffset.LocalDateTime);
        }
        else
        {
            bindingContext.ModelState.TryAddModelError(bindingContext.ModelName, "无效的日期格式");
        }

        return Task.CompletedTask;
    }
}

然后在模型的目标属性上标记绑定器：

[ModelBinder(BinderType = typeof(DateTimeLocalBinder))]
public DateTime TransDate { get; set; }

这种方式无需修改全局配置，仅针对需要保留本地时间的属性生效。

3. 传递无偏移的日期字符串（临时方案） #

如果暂时无法修改后端配置，可以让客户端传递不带时区偏移的日期字符串（例如"2023-03-26T00:00:00"），后端解析时直接按字符串对应的本地时间处理。但此方法会丢失时区信息，仅适用于无需区分时区的业务场景。

额外提示 #

全局配置是最轻量化的解决方案，无需修改大量模型代码。若业务长期需要处理多时区场景，建议逐步迁移到DateTimeOffset类型——这是.NET官方推荐的带时区日期处理方式，能从根源上避免时区转换导致的问题。

内容的提问来源于stack exchange，提问作者Neeraj Kumar Gupta