Appearance

cron 表达式使用说明 ​

Cron 语法详解 ​

node-cron 支持 5~6 个占位符，分别对应：

秒 (可选) | 分 | 时 | 日 | 月 | 周

字段取值范围特殊字符
秒0-59* , - /
分0-59* , - /
时0-23* , - /
日1-31* , - /
月1-12* , - /
周0-7* , - / (0和7均指周日)

核心代码示例 ​

基础任务

javascript
// 每分钟执行一次
cron.schedule('* * * * *', () => {
  console.log('任务运行中：' + new Date().toLocaleString());
});

进阶配置（时区与手动控制）

javascript
const task = cron.schedule('0 12 * * *', () => {
  console.log('中午12点定时任务启动');
}, {
  scheduled: false,      // 初始化时不启动
  timezone: "Asia/Shanghai" // 指定上海时区
});

// 手动启动
task.start();
// 手动停止
// task.stop();

常用场景速查 ​

  • 每 5 分钟执行一次：*/5 * * * *
  • 每小时整点执行：0 * * * *
  • 每天凌晨 1 点执行：0 1 * * *
  • 每周一至周五早上 9 点：0 9 * * 1-5