ASP.NET Core Web API：移动端提交日历事件时区偏差问题求助

核心原因 #

问题出在时间传递时丢失了时区信息：移动端提交的是本地时间字符串，但未附带时区偏移，API端默认用服务器所在时区解析，导致时间被强制转换为服务器本地时间，出现2小时偏差。

解决方案 #

1. 移动端提交带时区的ISO 8601格式时间 #

这是最规范的做法，能直接保留时区信息，彻底避免解析歧义：

• Flutter端：将用户选择的本地时间转换为带时区偏移的ISO 8601字符串，示例：

  // userSelectedTime为用户选择的本地DateTime对象
  String isoTime = userSelectedTime.toIso8601String();
  // 输出格式示例：2024-04-08T21:30:00+02:00
  

• API端：用DateTimeOffset类型接收参数（而非DateTime），它会自动保留时区偏移，不受服务器时区干扰：

  [HttpPost]
  public IActionResult CreateEvent([FromBody] EventRequest request)
  {
      // request.EventTime包含用户提交的时间和时区偏移
      var correctTime = request.EventTime;
      // 后续可根据需求转成UTC或用户本地时间存储/处理
      return Ok();
  }
  
  public class EventRequest
  {
      public DateTimeOffset EventTime { get; set; }
  }
  

2. 移动端提交UTC时间戳 #

时间戳是绝对时间，与时区无关，完全规避解析误差：

• Flutter端：将用户选择的本地时间转为UTC后，获取毫秒级时间戳：

  int timestamp = userSelectedTime.toUtc().millisecondsSinceEpoch;
  

• API端：通过时间戳还原正确的带时区时间：

  long timestamp = 1712583000000; // 示例时间戳，对应用户提交的04/08/2024 09:30pm（+02:00时区）
  DateTimeOffset correctTime = DateTimeOffset.FromUnixTimeMilliseconds(timestamp);
  

3. 同时提交时间字符串和用户时区信息 #

如果移动端只能提交不带时区的时间字符串，必须额外传递用户的时区标识（如Europe/Paris或+02:00）：

• Flutter端：获取设备时区ID，随时间参数一起提交：

  // 使用flutter_native_timezone包获取本地时区ID
  String timeZoneId = await FlutterNativeTimezone.getLocalTimezone();
  

• API端：根据时区ID解析时间字符串，生成正确的带时区时间：

  string timeStr = "04/08/2024 09:30pm";
  string timeZoneId = "Europe/Paris";
  TimeZoneInfo userTimeZone = TimeZoneInfo.FindSystemTimeZoneById(timeZoneId);
  
  // 解析本地时间字符串
  DateTime localTime = DateTime.ParseExact(timeStr, "MM/dd/yyyy hh:mmtt", CultureInfo.InvariantCulture);
  // 结合时区偏移生成正确的DateTimeOffset
  DateTimeOffset correctTime = new DateTimeOffset(localTime, userTimeZone.GetUtcOffset(localTime));
  

关键注意事项 #

• 禁止使用DateTime.LocalTime()：服务器时区为随机地区，该方法会将时间强制转换为服务器本地时间，完全不符合用户的实际时区设定。
• 存储建议：后端统一存储UTC时间，展示或业务处理时再根据用户时区转换为本地时间，避免时区混乱。

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