NCRONTAB 表达式
Azure Functions 使用 NCronTab 库来解释 NCRONTAB 表达式。 NCRONTAB 表达式类似于 CRON 表达式,不同之处在于它在开头包含额外的第六个字段,用于以秒为单位的时间精度:
{second} {minute} {hour} {day} {month} {day-of-week}
每个字段可以具有下列类型之一的值:
类型 | 示例 | 何时触发 |
---|---|---|
一个具体值 | "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 表示星期日。
- 名称采用英语。 例如:
Monday
、January
。 - 名称不区分大小写。
- 名称可缩写。 三字母是建议的缩写长度。 例如:
Mon
、Jan
。
NCRONTAB 示例
以下是一些可用于 Azure Functions 中计时器触发器的 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
的应用设置。
此设置的值取决于运行函数应用的操作系统和计划。
操作系统 | 计划 | 值 |
---|---|---|
Windows | All | 将值设置为所需时区的名称,如 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
,时间将针对特定时区中的时间更改进行调整,例如夏令时。