Azure Function(Python)：Timer Trigger时区配置问题求助

核心问题原因 #

Linux环境下的Azure Functions，WEBSITE_TIME_ZONE配置对Python定时器触发器不直接生效——Python触发器默认基于UTC解析CRON表达式，该环境变量仅适配Windows环境或部分其他技术栈。

修复步骤 #

1. 在触发器配置中显式指定时区
   直接修改function.json的定时器绑定配置，添加timeZone字段指定目标时区，无需依赖WEBSITE_TIME_ZONE。示例配置：

   {
     "scriptFile": "__init__.py",
     "bindings": [
       {
         "name": "timer",
         "type": "timerTrigger",
         "direction": "in",
         "schedule": "30 8 * * *",
         "timeZone": "America/New_York"
       }
     ]
   }
   

   这里CRON表达式30 8 * * *会严格按照America/New_York时区的每天08:30触发，自动适配EDT（对应UTC 04:30）和EST（对应UTC 03:30）的夏令时切换。

2. 环境变量可按需处理
   已在触发器中指定时区后，WEBSITE_TIME_ZONE可保留（无负面影响）或删除，Python触发器不会读取该变量解析CRON。

3. 验证时区生效状态
   在函数代码中添加日志输出，确认触发时间是否符合预期：

   import datetime
   import pytz
   import azure.functions as func
   
   def main(timer: func.TimerRequest) -> None:
       est_tz = pytz.timezone('America/New_York')
       current_est = datetime.datetime.now(est_tz)
       current_utc = datetime.datetime.utcnow()
       print(f"当前EST/EDT时间: {current_est.strftime('%Y-%m-%d %H:%M:%S')}")
       print(f"当前UTC时间: {current_utc.strftime('%Y-%m-%d %H:%M:%S')}")
   

关键注意点 #

• Linux环境的Python定时器必须通过function.json的timeZone字段指定时区，WEBSITE_TIME_ZONE不适用于该场景。
• CRON表达式格式为分 时 日 月 周，注意顺序不要混淆。

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