跳到主要内容

定时触发器节点#

使用定时触发器节点可在固定时间间隔和特定时间运行工作流。其工作原理类似于类Unix系统中的Cron软件工具。

必须激活工作流

如果工作流使用定时节点作为触发器,请确保保存并激活该工作流。

时区设置

该节点依赖时区设置。n8n会按以下顺序使用时区:

  1. 若已设置工作流时区,则使用工作流时区。更多信息请参阅工作流设置
  2. 若未设置工作流时区,则使用n8n实例时区。自托管实例默认为America/New_York。n8n云平台会在用户注册时尝试检测实例所有者的时区,默认回退到GMT时区。自托管用户可通过环境变量更改实例设置。云管理员可在管理面板中修改实例时区。

节点参数#

添加触发规则以确定触发器运行时机。

通过触发间隔选择触发器调度的时间间隔单位。所有其他参数取决于您选择的间隔单位。可选选项包括:

可添加多个触发规则使节点按不同计划运行。

触发间隔的详细配置请参阅下方章节,更多示例请参见模板与示例

秒级触发间隔#

  • 触发间隔秒数:输入每次触发工作流之间的秒数。例如输入30,触发器将每30秒运行一次。

分钟级触发间隔#

  • 触发间隔分钟数:输入每次触发工作流之间的分钟数。例如输入5,触发器将每5分钟运行一次。

小时级触发间隔#

  • 触发间隔小时数:输入每次触发工作流之间的小时数
  • 触发分钟:输入每小时中触发节点的具体分钟数,取值范围为059

例如:设置触发间隔小时数6触发分钟30,节点将每6小时在30分时刻运行。

天级触发间隔#

  • 触发间隔天数:输入每次触发工作流之间的天数
  • 触发小时:选择每天触发节点的具体小时
  • 触发分钟:输入每小时中触发节点的具体分钟数,取值范围为059

例如:设置触发间隔天数2触发小时上午9点触发分钟15,节点将每两天在上午9:15运行。

周级触发间隔#

  • 触发间隔周数:输入每次触发工作流之间的周数
  • 触发星期:选择每周中触发节点的具体日期
  • 触发小时:选择每天触发节点的具体小时
  • 触发分钟:输入每小时中触发节点的具体分钟数,取值范围为059

例如:设置触发间隔周数2触发星期星期一触发小时下午3点触发分钟30,节点将每两周在星期一下午3:30运行。

月级触发间隔#

  • 触发间隔月数:输入每次触发工作流之间的月数
  • 触发日期:输入每月中触发节点的具体日期,取值范围为131。若某个月份不存在该日期,节点将不会触发(例如设置30时,节点在二月份不会触发)
  • 触发小时:选择每天触发节点的具体小时
  • 触发分钟:输入每小时中触发节点的具体分钟数,取值范围为059

例如:设置触发间隔月数3触发日期28触发小时上午9点触发分钟0,节点将每季度在当月28日上午9:00运行。

自定义(Cron)间隔#

输入自定义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至17:00每小时执行
每季度0 0 1 1,4,7,10 *1月、4月、7月、10月的1日午夜执行

在Cron表达式中使用变量

虽然定时触发器支持使用变量,但这些变量的值仅在工作流激活时被评估。如果在工作流激活后修改变量值,更改不会影响cron调度计划。需要重新评估变量时,请将工作流设置为未激活状态后再重新设为激活状态。

Cron表达式中六个星号的含义#

Cron表达式中的第六个星号代表秒。此设置是可选的,即使不设置秒值,节点仍会执行。

(*)*****
(秒)分钟小时日期月份星期(日-六)

模板与示例#

浏览定时触发器集成模板,或搜索所有模板

常见问题#

常见问题及建议解决方案请参阅常见问题