.NET 6 Azure函数中TimeZoneInfo.TryConvertIanaIdToWindowsId始终返回False

我基于.NET 6构建了一个Azure函数，核心逻辑是将用户存储的IANA时区ID转换为Windows时区ID，使用TimeZoneInfo.TryConvertIanaIdToWindowsId()方法实现。本地Windows环境运行时转换正常，但部署到Azure后转换失败。

代码实现 #

public static class HttpTriggerGetTimeZoneFromIana
{
    [FunctionName("HttpTriggerGetTimeZoneFromIana")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = null)] HttpRequest req,
        ILogger log)
    {
        log.LogInformation("C# HTTP trigger function processed a request.");
        string responseMessage = string.Empty;
        string? windowsTimeZoneId = string.Empty;
        string IanaTimeZoneId = req.Query["IanaTimeZoneId"]; // 示例值: "America/Chicago"

        string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
        dynamic data = JsonConvert.DeserializeObject(requestBody);
        IanaTimeZoneId = IanaTimeZoneId ?? data?.IanaTimeZoneId;

        if (TimeZoneInfo.TryConvertIanaIdToWindowsId(IanaTimeZoneId, out windowsTimeZoneId))
            responseMessage = windowsTimeZoneId;
        else
            responseMessage = $"No Windows time zone found for IanaTimeZoneId [{IanaTimeZoneId}]";

        return new OkObjectResult(responseMessage);
    }
}

测试结果 #

• 本地测试：请求http://localhost:7296/api/HttpTriggerGetTimeZoneFromIana?IanaTimeZoneId=America/Chicago，返回Central Standard Time
• Azure测试：请求对应函数地址，返回No Windows time zone found for IanaTimeZoneId [America/Chicago]

原因分析 #

Azure函数默认运行在Linux环境（消费/弹性计划默认配置），而TimeZoneInfo.TryConvertIanaIdToWindowsId()方法依赖Windows系统特有时区数据库，Linux环境下无此数据，因此转换失败。本地运行在Windows系统，所以可以正常执行。

解决方法 #

方案1：切换函数运行时到Windows #

在Azure门户进入函数应用的配置 > 常规设置，将操作系统从Linux改为Windows，保存后重新部署。该方案可直接沿用现有代码，但Windows运行时成本通常高于Linux。

方案2：直接使用IANA时区计算时间（推荐） #

放弃Windows时区转换，直接基于IANA时区处理时间计算，跨平台兼容性更好：

public static class HttpTriggerGetTimeZoneFromIana
{
    [FunctionName("HttpTriggerGetTimeZoneFromIana")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = null)] HttpRequest req,
        ILogger log)
    {
        log.LogInformation("C# HTTP trigger function processed a request.");
        string responseMessage = string.Empty;
        string IanaTimeZoneId = req.Query["IanaTimeZoneId"]; // 示例值: "America/Chicago"

        string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
        dynamic data = JsonConvert.DeserializeObject(requestBody);
        IanaTimeZoneId = IanaTimeZoneId ?? data?.IanaTimeZoneId;

        try
        {
            var timeZone = TimeZoneInfo.FindSystemTimeZoneById(IanaTimeZoneId);
            var localTime = TimeZoneInfo.ConvertTimeFromUtc(DateTime.UtcNow, timeZone);
            responseMessage = $"当前本地时间（{timeZone.DisplayName}）：{localTime:yyyy-MM-dd HH:mm:ss}";
        }
        catch (TimeZoneNotFoundException)
        {
            responseMessage = $"未找到对应的IANA时区：[{IanaTimeZoneId}]";
        }
        catch (InvalidTimeZoneException)
        {
            responseMessage = $"IANA时区ID无效：[{IanaTimeZoneId}]";
        }

        return new OkObjectResult(responseMessage);
    }
}

方案3：用第三方库实现跨平台转换 #

若必须保留Windows时区ID转换逻辑，可使用NodaTime库处理跨平台映射：

1. 安装NuGet包：Install-Package NodaTime
2. 修改转换逻辑：

using NodaTime;
using NodaTime.TimeZones;

// ...

if (TzdbDateTimeZoneSource.Default.WindowsMapping.PrimaryMapping.TryGetValue(IanaTimeZoneId, out var windowsId))
{
    responseMessage = windowsId;
}
else
{
    responseMessage = $"No Windows time zone found for IanaTimeZoneId [{IanaTimeZoneId}]";
}

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