Angular传DateTime至.NET Standard 2.1 API时日期偏移问题

问题原因 #

你遇到的日期偏移是时区解析不匹配导致的：

• 前端的startDate/endDate是00:00 GMT+0100的Date对象，发送时未转成标准ISO字符串，被序列化成了非标准格式（比如Sun Jul 16 2023 00:00:00 GMT+0100）。
• .NET后端反序列化时，默认将这种格式的日期视为UTC时间，GMT+0100的00:00转成UTC就是前一天的23:00，最终显示为服务器本地时区的前一天日期。
• 而date字段是标准ISO格式字符串（2023-07-14T13:46:25.626），后端能正确解析，因此没有偏移。

前端修复方案 #

确保发送的日期是标准ISO 8601字符串，可通过以下方式处理：

1. 手动序列化Payment对象时转换日期：

// 转换Date对象为ISO字符串
const serializedPayment = JSON.stringify(yourPaymentObject, (key, value) => {
  if (['startDate', 'endDate', 'date'].includes(key) && value instanceof Date) {
    // toISOString()生成带UTC时区的字符串，如"2023-07-15T23:00:00.000Z"
    // 若需保留本地时区偏移，可使用date-fns等工具格式化为"2023-07-16T00:00:00+01:00"
    return value.toISOString();
  }
  return value;
});

// 发送请求
this.http.put('/api/your-endpoint', serializedPayment, {
  headers: { 'Content-Type': 'application/json' }
}).subscribe(...);

2. 用Angular拦截器统一处理所有Date类型：
   创建HttpInterceptor，在请求发送前自动将Date对象转为ISO字符串，避免每个请求重复处理。

后端修复方案 #

若不想修改前端代码，可在.NET端调整日期处理逻辑：

1. 改用DateTimeOffset类型（推荐）：
   将模型中的DateTime替换为DateTimeOffset，它会保留时区信息，反序列化时不会出现偏移：

public class PaymentObject
{
    public Guid Id { get; set; }
    public DateTimeOffset Date { get; set; }
    public decimal Amount { get; set; }
    public bool IsLastPayment { get; set; }
    public Guid ProfileId { get; set; }
    public DateTimeOffset StartDate { get; set; }
    public DateTimeOffset EndDate { get; set; }
}

2. 配置JSON反序列化器：
   若坚持使用DateTime，可配置反序列化规则，让后端按本地时区解析日期：

用Newtonsoft.Json（ASP.NET Core默认常用） #

在Program.cs或Startup.cs中添加：

builder.Services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        // Local：按服务器本地时区解析；Unspecified：直接使用传入的日期（不指定时区）
        options.SerializerSettings.DateTimeZoneHandling = DateTimeZoneHandling.Local;
    });

用System.Text.Json #

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.DateTimeHandling = JsonDateTimeHandling.RoundtripKind;
    });

验证建议 #

修改后先检查前端请求体，确保startDate/endDate是类似"2023-07-16T00:00:00+01:00"或"2023-07-15T23:00:00.000Z"的标准字符串，再查看后端接收的值是否正确。

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