Azure APIM中DotLiquid模板的DateTime时区转换问题求助

需求说明 #

• 输入JSON字段格式："transactionDateTime": "2023-11-08T18:28:12.123+10:00"
• 硬性输出要求："2023-11-08T18:28"（必须为AEST+10时区，仅保留年月日时分，无时区标识）

遇到的问题 #

• 无法直接对字段做字符串截断，因为DotLiquid会自动将该字段识别为DateTime类型并转换为UTC存储
• 使用DotLiquid的Date过滤器：{{header.transactionDateTime | Date: "yyyy-MM-ddTH:mm" }}，输出结果为UTC时间（例如原18:28会变成UTC的8:28）
• 尝试设置DotLiquid的culture参数（如{% param culture='fr-FR' %}），APIM不支持该写法
• DotLiquid未实现Liquid的in_time_zone过滤器，无法直接进行时区转换

解决方案 #

方案1：优化后的C#表达式（推荐，可靠性更高）

通过set-variable策略直接解析原始带时区的日期字符串，转换为AEST时区后格式化，避免依赖DotLiquid的时区缺陷：

<set-variable name="obligationDateTimeAEST" value="@{
    JObject inBody = context.Request.Body.As<JObject>(preserveContent: true);
    var dateToken = inBody.SelectToken("header.transactionDateTime");
    if (dateToken == null)
    {
        return "header.transactionDateTime not available";
    }

    if (DateTimeOffset.TryParse(dateToken.ToString(), out var dto))
    {
        // 固定转换到+10:00时区（符合AEST要求）
        var aestTime = dto.ToOffset(TimeSpan.FromHours(10));
        return aestTime.ToString("yyyy-MM-ddTHH:mm");
    }
    else
    {
        return "Failed AEST Timezone convert";
    }
}" />

说明：使用DateTimeOffset直接解析原始带时区的字符串，无需依赖UTC转换假设，转换逻辑更准确，能避免夏令时等场景下的误差。

方案2：DotLiquid模板配合变量使用（若必须依赖DotLiquid）

1. 先用上述C#表达式生成格式化后的字符串变量
2. 在DotLiquid模板中直接引用该变量：{{obligationDateTimeAEST}}

原临时代码的缺陷 #

原代码通过dt.AddHours(10)的逻辑依赖于「DateTime已被转为UTC」的假设，若原始DateTime的Kind属性不是UTC，会导致转换错误。使用DateTimeOffset能直接保留原始时区信息，规避此类问题。

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