Azure Data Factory Java SDK设置非UTC时区触发异常问题

问题核心 #

使用Java SDK的ScheduleTriggerRecurrence类配置ADF触发器时：

• 设置UTC时区时功能正常，门户显示符合预期
• 尝试用UTC-8这类UTC偏移格式指定时区时，API调用成功但门户时区配置混乱，修改起止时间时区后仍无效
• 仅传入完整标准时区名称（如Pacific Standard Time）时功能正常，但需同时指定带时区的起止时间和单独时区参数，对此存在疑问

原因解析 #

这并非Azure SDK Bug，而是**ScheduleTriggerRecurrence的timeZone参数仅支持标准时区标识符（IANA时区名称或Windows时区标识符），不直接支持UTC±X这类偏移格式**。

文档中提到的"UTC时区格式为'yyyy-MM-ddTHH:mm:ssZ'，其他时区格式为'yyyy-MM-ddTHH:mm:ss'"，指的是提交到API的起止时间字符串格式要求，而非timeZone参数的取值规则。SDK的OffsetDateTime类型本身带时区信息，需注意转换逻辑与timeZone参数的对齐。

正确用法 #

1. 使用标准时区标识符 #

替换UTC-8为对应的标准时区名称，比如美国太平洋时区可使用America/Los_Angeles（IANA标识符）或Pacific Standard Time（Windows标识符）。

示例代码：

new ScheduleTriggerRecurrence()
        .withFrequency(RecurrenceFrequency.MINUTE)
        .withInterval(4)
        // 将本地时间转换为对应时区的OffsetDateTime
        .withStartTime(LocalDateTime.parse("2018-06-16T00:39:13.8441801")
                .atZone(ZoneId.of("America/Los_Angeles"))
                .toOffsetDateTime())
        .withEndTime(LocalDateTime.parse("2018-06-16T00:55:13.8441801")
                .atZone(ZoneId.of("America/Los_Angeles"))
                .toOffsetDateTime())
        .withTimeZone("America/Los_Angeles")
        .withAdditionalProperties(mapOf())

2. 对齐起止时间与时区参数 #

指定非UTC时区时，起止时间需为该时区的本地时间，转换为OffsetDateTime时绑定对应时区，同时timeZone参数传入相同的标准时区名称，确保ADF能正确解析时区配置，门户显示也会符合预期。

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