.NET控制台应用与独立Azure函数中DateTimeOffset解析差异排查

测试代码 #

var timestamp = "Fri Sep 8 07:00:37 BST 2023";

var isBst = timestamp.Contains("BST");
var tz = isBst ? "BST" : "GMT";
var formatString = $"ddd MMM d HH:mm:ss {tz} yyyy";
DateTimeOffset dto = DateTimeOffset.ParseExact(timestamp, formatString, CultureInfo.InvariantCulture);

问题背景 #

外部Web API返回伦敦时区的时间戳，需要解析成DateTimeOffset。这段代码在本地.NET控制台应用中可正常运行，输出08.09.2023 07:00:37 +02:00，但部署到独立Azure函数应用时抛出格式错误——尽管Azure函数本质是托管的控制台应用。时间戳为硬编码示例。

错误信息 #

Result: Failure Exception: System.AggregateException: One or more errors occurred.
(String 'Fri Sep 8 07:00:37 BST 2023' was not recognized as a valid DateTime.)
---> System.FormatException: String 'Fri Sep 8 07:00:37 BST 2023' was not recognized as a valid DateTime.
at System.DateTimeParse.ParseExact(ReadOnlySpan1 s, ReadOnlySpan1 format, DateTimeFormatInfo dtfi, DateTimeStyles style, TimeSpan& offset)
at System.DateTimeOffset.ParseExact(String input, String format, IFormatProvider formatProvider, DateTimeStyles styles)

（注：为可读性添加了换行）

Azure函数时区配置 #

{
    "name": "WEBSITE_TIME_ZONE",
    "value": "W. Europe Standard Time",
    "slotSetting": false
}

问题原因 #

CultureInfo.InvariantCulture对时区缩写的识别存在环境差异：本地环境可能已注册BST/GMT的时区映射，但Azure函数的托管环境中，InvariantCulture无法识别这些缩写，导致解析失败。另外，WEBSITE_TIME_ZONE配置仅影响函数的本地时区设置，不会改变InvariantCulture的时区解析规则。

正确解析方案 #

方案1：手动映射时区缩写到偏移量 #

直接根据BST/GMT设置对应偏移，再解析为DateTimeOffset：

var timestamp = "Fri Sep 8 07:00:37 BST 2023";
var formatWithoutTz = "ddd MMM d HH:mm:ss yyyy";

// 提取时区缩写
var tzPart = timestamp.Split(' ')[4];
TimeSpan offset = tzPart switch
{
    "BST" => TimeSpan.FromHours(1), // 英国夏令时为UTC+1
    "GMT" => TimeSpan.Zero,         // 格林威治标准时间为UTC+0
    _ => throw new InvalidOperationException("未知时区缩写")
};

// 先解析为无时区的DateTime，再结合偏移量创建DateTimeOffset
DateTime dt = DateTime.ParseExact(timestamp.Replace(tzPart, "").Trim(), formatWithoutTz, CultureInfo.InvariantCulture);
DateTimeOffset dto = new DateTimeOffset(dt, offset);

方案2：使用时区ID（推荐） #

利用伦敦时区的系统ID（"GMT Standard Time"）自动处理夏令时和标准时间的偏移切换，无需手动维护映射：

var timestamp = "Fri Sep 8 07:00:37 BST 2023";
var formatWithoutTz = "ddd MMM d HH:mm:ss yyyy";

// 解析为不带时区的DateTime
DateTime dt = DateTime.ParseExact(timestamp.Substring(0, timestamp.Length - 4).Trim(), formatWithoutTz, CultureInfo.InvariantCulture);

// 获取伦敦时区
TimeZoneInfo londonTz = TimeZoneInfo.FindSystemTimeZoneById("GMT Standard Time");

// 自动匹配对应偏移量，生成DateTimeOffset
DateTimeOffset dto = new DateTimeOffset(dt, londonTz.GetUtcOffset(dt));

方案3：使用NodaTime库（更可靠的时区处理） #

如果频繁处理时区场景，推荐使用NodaTime库，它对时区的支持更完善：

1. 安装NodaTime NuGet包
2. 代码示例：

using NodaTime;
using NodaTime.Text;

var timestamp = "Fri Sep 8 07:00:37 BST 2023";
var pattern = DateTimePattern.CreateWithInvariantCulture("ddd MMM d HH:mm:ss zzz yyyy");
var parseResult = pattern.Parse(timestamp);
if (parseResult.Success)
{
    ZonedDateTime zonedDt = parseResult.Value;
    DateTimeOffset dto = zonedDt.ToDateTimeOffset();
}

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