计划触发器节点#
使用计划触发器节点可以在固定的时间间隔和时间点运行工作流。其工作原理类似于类 Unix 系统中的 Cron 软件工具。
必须激活工作流
如果工作流使用计划触发器节点作为触发器,请确保保存并激活该工作流。
时区设置
该节点依赖于时区设置。n8n 会按以下顺序使用时区:
- 若设置了工作流时区,则使用工作流时区。更多信息请参考工作流设置
- 若未设置工作流时区,则使用 n8n 实例时区:
- 自托管实例默认为
America/New_York - n8n Cloud 会在用户注册时尝试检测其实例所属时区,默认回退到 GMT
- 自托管用户可通过环境变量修改实例设置
- 云管理员可在管理面板中修改实例时区
- 自托管实例默认为
节点参数#
添加触发规则以确定触发器应在何时运行。 通过触发间隔选择触发器调度的时间间隔单位,其他参数将根据所选间隔类型动态变化。可选选项包括:
- 秒级触发间隔
- 分钟级触发间隔
- 小时级触发间隔
- 天级触发间隔
- 周级触发间隔
- 月级触发间隔
- 自定义(Cron)间隔
您可以为节点添加多个触发器规则(Trigger Rules),使其按不同的时间表运行。 请参阅以下章节了解如何配置每个**触发间隔(Trigger Interval)**的详细信息。更多示例请参考模板与示例。
秒级触发间隔#
- 触发间隔秒数(Seconds Between Triggers):输入每次触发工作流之间的秒数。例如,如果在此输入
30,触发器将每30秒运行一次。
分钟级触发间隔#
- 触发间隔分钟数(Minutes Between Triggers):输入每次触发工作流之间的分钟数。例如,如果在此输入
5,触发器将每5分钟运行一次。
小时级触发间隔#
- 触发间隔小时数(Hours Between Triggers):输入每次触发工作流之间的小时数。
- 触发分钟位(Trigger at Minute):输入整点后触发节点的分钟数,取值范围为
0到59。
例如,如果您设置触发间隔小时数为6,触发分钟位为30,节点将每6小时在整点过30分钟时运行。
天级触发间隔#
- 触发间隔天数(Days Between Triggers):输入每次触发工作流之间的天数。
- 触发小时位(Trigger at Hour):选择每天触发节点的具体小时。
- 触发分钟位(Trigger at Minute):输入整点后触发节点的分钟数,取值范围为
0到59。
例如,如果您设置触发间隔天数为2,触发小时位为上午9点,触发分钟位为15,节点将每两天在上午9:15运行。
周级触发间隔#
- 触发间隔周数(Weeks Between Triggers):输入每次触发工作流之间的周数。
- 触发星期位(Trigger on Weekdays):选择每周中需要触发节点的日期。
- 触发小时位(Trigger at Hour):选择每天触发节点的具体小时。
- 触发分钟位(Trigger at Minute):输入整点后触发节点的分钟数,取值范围为
0到59。
例如,如果您输入 2 触发周期间隔、选择 周一 作为 触发工作日、下午3点 作为 触发小时、以及 30 作为 触发分钟,那么该节点将每隔两周在周一下午3:30运行。
月份触发间隔#
- 触发月数间隔:输入每次工作流触发之间的月数。
- 触发月份日期:输入每月触发节点的日期,从
1到31。如果某个月份没有该日期,节点将不会触发。例如,如果您在此输入30,节点将不会在二月份触发。 - 触发小时:选择一天中触发节点的小时。
- 触发分钟:输入节点运行时触发节点的分钟数,从
0到59。
例如,如果您输入触发间隔为 3 个月,28 作为 月触发日,9:00 作为 触发小时,0 作为 触发分钟,那么该节点将在每个季度的第 28 天上午 9:00 运行。
自定义(Cron)间隔#
输入自定义的 cron 表达式 来设置触发器的调度计划。 您可以使用 crontab guru 生成 Cron 表达式。将使用 crontab guru 生成的 Cron 表达式粘贴到 n8n 的 表达式 字段中。
示例#
| 类型 | Cron 表达式 | 描述 |
|---|---|---|
| 每 X 秒 | */10 * * * * * | 每 10 秒。 |
| 每 X 分钟 | */5 * * * * | 每 5 分钟。 |
| 每小时 | 0 * * * * | 每小时整点。 |
| 每天 | 0 6 * * * | 每天上午 6:00。 |
| 每周 | 0 12 * * 1 | 每周一中午 12:00。 |
| 每月 | 0 0 1 * * | 每月 1 日午夜。 |
| 每 X 天 | 0 0 */3 * * | 每 3 天午夜。 |
| 仅工作日 | 0 9 * * 1-5 | 周一至周五上午 9:00。 |
| 自定义小时范围 | 0 9-17 * * * | 每天从上午 9:00 到下午 5:00 每小时。 |
| 每季度 | 0 0 1 1,4,7,10 * | 1 月、4 月、7 月和 10 月的 1 日午夜。 |
在 Cron 表达式中使用变量 虽然可以在计划触发器中使用变量,但它们的值仅在工作流激活时被计算。如果在工作流激活后更改了变量的值,这些更改不会影响 Cron 调度计划。要重新计算变量,请将工作流设置为 非活动 状态,然后再设置为 活动 状态。
为什么 Cron 表达式中有六个星号#
Cron 表达式中的第六个星号表示秒。设置此项是可选的。即使您没有设置秒的值,节点仍会执行。
| (_) | _ | _ | _ | _ | _ |
|---|---|---|---|---|---|
| (秒) | 分钟 | 小时 | 月份中的日期 | 月份 | 星期几(周日-周六) |
模板和示例#
浏览 Schedule Trigger 集成模板,或搜索所有模板
常见问题#
有关常见问题或疑问及建议的解决方案,请参阅常见问题。 与文档交流 本页面 !点赞 有帮助 !点踩 没有帮助 感谢您的反馈! 提交 上一页 RSS Feed Trigger 下一页 常见问题 基于 Material for MkDocs Insiders 构建