node定时任务——node-schedule模块使用说明
在实际开发项目中,会遇到很多定时任务的工作。比如:定时导出某些数据、定时发送消息或邮件给用户、定时备份什么类型的文件等等。
一般可以写个定时器,来完成相应的需求,在node.js中自已实现也非常容易,接下来要介绍的是node-schedule来完成定时任务。
下面就用示例来说明一下node-schedule的用法。
安装:
npm install node-schedule
Cron风格定时器
var schedule = require('node-schedule'); function scheduleCronstyle(){ schedule.scheduleJob('30 * * * * *', function(){ console.log('scheduleCronstyle:' + new Date()); }); } scheduleCronstyle();
schedule.scheduleJob的回调函数中写入要执行的任务代码,一个定时器就完成了!
Cron参数说明
* * * * * * ┬ ┬ ┬ ┬ ┬ ┬ │ │ │ │ │ | │ │ │ │ │ └ day of week (0 - 7) (0 or 7 is Sun) │ │ │ │ └───── month (1 - 12) │ │ │ └────────── day of month (1 - 31) │ │ └─────────────── hour (0 - 23) │ └──────────────────── minute (0 - 59) └───────────────────────── second (0 - 59, OPTIONAL)
6个占位符从左到右分别代表:秒、分、时、日、月/年、周几。
'*'表示通配符,匹配任意,当秒是'*'时,表示任意秒数都触发,其它类推。
下面可以看看以下传入参数分别代表的意思:
- 每分钟的第30秒触发: '30 * * * * *'
- 每小时的1分30秒触发 :'30 1 * * * *'
- 每天的凌晨1点1分30秒触发 :'30 1 1 * * *'
- 每月的1日1点1分30秒触发 :'30 1 1 1 * *'
- 2016年的1月1日1点1分30秒触发 :'30 1 1 1 2016 *'
- 每周1的1点1分30秒触发 :'30 1 1 * * 1'
这样很容易根据自已的需求用简短的代码去实现。
注意:六个值之间使用空格分隔;如某个位置上有多个值可以使用逗号(m,n)分隔;如某个位置值是一个区间可以使用中划线(m-n);如某个位置的时间含有间隔执行可以使用斜线(*/n);如只有五位则默认秒为0,
第一位从分钟开始计算。 '0 17 * * 1-5':表示每周一至周五下午五点整执行一次; '*/5 12,18,21 * * 0,6':表示周六周日的12时、18时和21时,每个小时内每隔5分钟执行一次;
对象规则定时器
为了更加方便,还支持直接使用对象作为规则:
var j = schedule.scheduleJob({hour: 14, minute: 30, dayOfWeek: 0}, function(){ console.log('Time for tea!'); });
设置开始时间和结束时间
let startTime = new Date(Date.now() + 5000); let endTime = new Date(startTime.getTime() + 5000); var j = schedule.scheduleJob({ start: startTime, end: endTime, rule: '*/1 * * * * *' }, function(){ console.log('Time for tea!'); });
上面代码中,任务将在5秒后开始,10秒后结束,期间每秒都将执行。
Date对象规则定时器
使用指定时间的Date对象作为第一个参数,任务将在指定的时间执行:
var schedule = require('node-schedule'); var date = new Date('2017-09-26 22:00:00'); var j = schedule.scheduleJob(date, function(){ console.log('The world is going to end today.'); });
RecurrenceRule实例规则定时器
你可以通过RecurrenceRule实例声明任务触发规则:
var schedule = require('node-schedule'); var rule = new schedule.RecurrenceRule(); rule.minute = 42; var j = schedule.scheduleJob(rule, function(){ console.log('The answer to life, the universe, and everything!'); });
上面代码中,任务将在每个小时第42分钟时执行。
我们还可以使用数组指定可接受的值列表,Range 指定起始值和结束值的范围,如下:
var rule = new schedule.RecurrenceRule(); rule.dayOfWeek = [0, new schedule.Range(4, 6)]; rule.hour = 17; rule.minute = 0; var j = schedule.scheduleJob(rule, function(){ console.log('Today is recognized by Rebecca Black!'); });
上面代码中,任务将在星期四、星期五、星期六和星期日17点整执行。
RecurrenceRule 实例属性:
- second
- minute
- hour
- date
- month
- year
- dayOfWeek
注意:实例属性中未显示设置的属性值将默认为null(除了second属性默认为0)。
上例中如果我们没有显示设置minute为0,那么任务将17:00、17:01、17:02...17:59执行,这可能不是我们想要的。
取消定时器
示例如下,定时器对象的cancl方法即可:
var schedule = require('node-schedule'); function scheduleCancel(){ var counter = 1; var j = schedule.scheduleJob('* * * * * *', function(){ console.log('定时器触发次数:' + counter); counter++; }); setTimeout(function() { console.log('定时器取消') j.cancel(); }, 5000); } scheduleCancel();
原理
利用setTimeOut和event事件进行管理,对所有加入的事件进行排序,并且计算当前时间和最近一个事件发生时间的时间间隔,然后调用setTimeOut设置回调。总的来说分两种事件,一种是一次性的,一种是周期性的,一次性任务调用完就结束,周期性的会不断地循环调用,当一个周期性事件被调用后,会根据周期生成下一个周期任务,并添加到任务列表中,重新排序。每个任务调用结束,都会计算并准备下一个任务。
值得注意的一点是,在循环任务中,每个任务需要单独new一个schedule.RecurrenceRule对象,不能公用。另外就是一点网上提的比较少的一点,如果我们对循环中的时间成员没有设置,说明我们对其不感兴趣。源代码中,未设置的时间成员为null,循环结构的匹配采用的是从分钟开始的逐步累加,如果发现某成员是null,那么就直接匹配,如果不是null,就从0开始,逐渐累加,知道完全匹配。
定时器功能大部分需求都可以借助node-schedule完成了,用它在项目中使用效果也不错,各种需求可以满足 了解更多请参见:https://github.com/node-schedule/node-schedule