Node-Schedule 定时任务库详解

Node-Schedule 是 Node.js 平台最流行的定时任务调度库之一，它基于 JavaScript 的定时器功能，但提供了更强大、更灵活的调度功能。下面我将详细讲解 Node-Schedule 的核心概念、使用方法和最佳实践。

安装 Node-Schedule

npm install node-schedule

基本概念

1. Cron 风格调度

Node-Schedule 使用 cron 格式的语法来定义任务执行时间，格式如下：

*    *    *    *    *    *
┬    ┬    ┬    ┬    ┬    ┬
│    │    │    │    │    │
│    │    │    │    │    └ 星期几 (0 - 7) (0 或 7 是星期日)
│    │    │    │    └───── 月份 (1 - 12)
│    │    │    └────────── 日期 (1 - 31)
│    │    └─────────────── 小时 (0 - 23)
│    └──────────────────── 分钟 (0 - 59)
└───────────────────────── 秒 (0 - 59, 可选)

核心 API 和使用方法

1. 基本调度方法

const schedule = require('node-schedule');

// 方法1: 使用 Cron 表达式
const job = schedule.scheduleJob('42 * * * *', function() {
    console.log('每小时的第42分钟执行!');
});

// 方法2: 使用 Date 对象
const date = new Date(2023, 11, 31, 23, 59, 59);
const newYearJob = schedule.scheduleJob(date, function() {
    console.log('新年快乐!');
});

// 方法3: 使用 RecurrenceRule 对象
const rule = new schedule.RecurrenceRule();
rule.hour = 14;
rule.minute = 30;
rule.dayOfWeek = [0, new schedule.Range(1, 5)]; // 周日和周一至周五

const dailyJob = schedule.scheduleJob(rule, function() {
    console.log('每天14:30执行，但仅在周日和工作日!');
});

2. 任务