WebJobs schedule Job调度时间 设定 各个字段的含义

本文深入解析了Azure Functions中的NCRONTAB表达式,详细介绍了其六个字段的格式及其如何用于精确控制定时任务的触发频率。文章还提供了多个实例,帮助读者理解如何使用NCRONTAB表达式实现特定的触发条件。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

https://docs.microsoft.com/zh-cn/azure/azure-functions/functions-bindings-timer?tabs=csharp#ncrontab-expressions

NCRONTAB 表达式

Azure Functions 使用 NCronTab 库来解释 NCRONTAB 表达式。 NCRONTAB 表达式类似于 CRON 表达式,不同之处在于它在开头包含额外的第六个字段,用于以秒为单位的时间精度:

{second} {minute} {hour} {day} {month} {day-of-week}

每个字段可以具有下列类型之一的值:

表 2
类型示例何时触发
一个具体值"0 5 * * * *"在 hh:05:00,其中 hh 表示每小时(每小时一次)
所有值 (*)"0 * 5 * * *"在每天的 5:mm:00,其中 mm 表示该小时的每分钟(一天 60 次)
一个范围(- 运算符)"5-7 * * * * *"在 hh:mm:05、hh:mm:06 和 hh:mm:07,其中 hh:mm 表示每小时的每分钟(每分钟 3 次)
一组值(, 运算符)"5,8,10 * * * * *"在 hh:mm:05、hh:mm:08 和 hh:mm:10,其中 hh:mm 表示每小时的每分钟(每分钟 3 次)
一个间隔值(/ 运算符)"0 */5 * * * *"在 hh:00:00,hh:05:00,hh:10:00,依此类推,到 hh:55:00,其中 hh 为每小时(每小时12次)

若要指定月份或天,可以使用数字值、名称或名称的缩写:

  • 对于天,数字值为 0 到 6,其中 0 表示星期日。
  • 名称采用英语。 例如:MondayJanuary
  • 名称不区分大小写。
  • 名称可缩写。 三字母是建议的缩写长度。 例如:MonJan

NCRONTAB 示例

以下是一些可用于 Azure Functions 中计时器触发器的 NCRONTAB 表达式示例。

NCRONTAB 示例
示例何时触发
"0 */5 * * * *"每五分钟一次
"0 0 * * * *"每小时一次(在每小时的开头)
"0 0 */2 * * *"每两小时一次
"0 0 9-17 * * *"从上午 9 点到下午 5 点每小时一次
"0 30 9 * * *"每天上午 9:30
"0 30 9 * * 1-5"每个工作日的上午 9:30
"0 30 9 * Jan Mon"在一月份每星期一的上午 9:30

 备注

NCRONTAB 表达式需要 六个字段 格式。 Azure 中不支持五个字段 cron 表达式。

NCRONTAB 时区

CRON 表达式中的数字指的是时间和日期,而不是时间跨度。 例如,hour 字段中的 5 指的是 5:00 AM,而不是每 5 小时。

CRON 表达式使用的默认时区为协调世界时 (UTC)。 若要让 CRON 表达式基于其他时区,请为你的函数应用创建一个名为 WEBSITE_TIME_ZONE 的应用设置。

此设置的值取决于运行函数应用的操作系统和计划。

NCRONTAB 时区
操作系统计划
WindowsAll将值设置为所需时区的名称,如 Microsoft 时区索引中所示。
Linux高级
专用
将值设置为所需时区的名称,如 tz 数据库中所示。

 备注

Linux 消耗计划目前不支持 WEBSITE_TIME_ZONE

例如东部标准时间 (Windows) 或美国/纽约 (Linux) 为 UTC-05:00 。 若要让计时器触发器每天在美国东部时间上午 10:00 触发,可使用表示 UTC 时区的以下 NCRONTAB 表达式:

复制

"0 0 15 * * *"

或者为你的函数应用创建一个名为 WEBSITE_TIME_ZONE 的应用设置并将值设置为 Eastern Standard Time (Windows) 或 America/New_York (Linux),然后使用以下 NCRONTAB 表达式:

复制

"0 0 10 * * *"

当使用 WEBSITE_TIME_ZONE,时间将针对特定时区中的时间更改进行调整,例如夏令时。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值