使用node-schedule時的注意點

原文鏈接:http://ju.outofmemory.cn/entry/267740

備註

 // corn = `0 0 15/8 * * *`;  已驗證例如15點開始,間隔8小時,如此寫法不可行,因此改用如下寫法
 // corn = `0 0 15,23,7 * * *`;

最近做一個項目需要定時發送一些郵件,網上搜索了下選用了Node.js的node-schedule包來進行定時操作。
看了下npm上的文檔,node-schedule用的是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)

官方的介紹裏的用法也是很簡單:

var schedule = require('node-schedule');
 
var j = schedule.scheduleJob('42 * * * *', function(){
  console.log('The answer to life, the universe, and everything!');
});

項目的要求是每天8點發送一封郵件,我便把Cron表達式寫了「* * 8 * * *」,結果在某天,我的郵箱收到了大量的退信,查看Log是定時任務被反覆的觸發,似乎是以每隔一秒的頻率在執行定時任務,於是便想到是不是隻在小時部分設定爲8,表示在8點到9點的每一秒都觸發呢?

於是又仔細看了下Cron表達式相關的介紹:

Cron表達式是一個字符串,字符串以56個空格隔開,分爲67個域,每一個域代表一個含義,Cron有如下兩種語法格式:

Seconds Minutes Hours DayofMonth Month DayofWeek Year或 
Seconds Minutes Hours DayofMonth Month DayofWeek

每一個域可出現的字符如下: 
Seconds:可出現”,* /”四個字符,有效範圍爲0-59的整數 
Minutes:可出現”,* /”四個字符,有效範圍爲0-59的整數 
Hours:可出現”,* /”四個字符,有效範圍爲0-23的整數 
DayofMonth:可出現”,* / ? L W C”八個字符,有效範圍爲0-31的整數 
Month:可出現”,* /”四個字符,有效範圍爲1-12的整數或JAN-DEc 
DayofWeek:可出現”,* / ? L C #”四個字符,有效範圍爲1-7的整數或SUN-SAT兩個範圍。1表示星期天,2表示星期一, 依次類推 
Year:可出現”,* /”四個字符,有效範圍爲1970-2099年

每一個域都使用數字,但還可以出現如下特殊字符,它們的含義是: 
(1)*:表示匹配該域的任意值,假如在Minutes域使用*, 即表示每分鐘都會觸發事件。

(2)?:只能用在DayofMonth和DayofWeek兩個域。它也匹配域的任意值,但實際不會。因爲DayofMonth和DayofWeek會相互影響。例如想在每月的20日觸發調度,不管20日到底是星期幾,則只能使用如下寫法: 13 13 15 20 * ?, 其中最後一位只能用?,而不能使用*,如果使用*表示不管星期幾都會觸發,實際上並不是這樣。

(3)-:表示範圍,例如在Minutes域使用5-20,表示從5分到20分鐘每分鐘觸發一次

(4)/:表示起始時間開始觸發,然後每隔固定時間觸發一次,例如在Minutes域使用5/20,則意味着5分鐘觸發一次,而2545等分別觸發一次.

(5),:表示列出枚舉值值。例如:在Minutes域使用5,20,則意味着在520分每分鐘觸發一次。

(6)L:表示最後,只能出現在DayofWeek和DayofMonth域,如果在DayofWeek域使用5L,意味着在最後的一個星期四觸發。

(7)W:表示有效工作日(週一到週五),只能出現在DayofMonth域,系統將在離指定日期的最近的有效工作日觸發事件。例如:在 DayofMonth使用5W,如果5日是星期六,則將在最近的工作日:星期五,即4日觸發。如果5日是星期天,則在6(週一)觸發;如果5日在星期一到星期五中的一天,則就在5日觸發。另外一點,W的最近尋找不會跨過月份

(8)LW:這兩個字符可以連用,表示在某個月最後一個工作日,即最後一個星期五。

(9)#:用於確定每個月第幾個星期幾,只能出現在DayofMonth域。例如在4#2,表示某月的第二個星期三。

果然,如果某個設定值設爲「」,則表示匹配任意值,在秒和分鐘上則體現爲每分每秒都觸發。後將Cron表達式改爲「0 0 8 * * 」,問題解決。仔細一想,這也很好理解,「」一般作爲全匹配用,像天,月,年這樣的我們如果設做「」,會認爲是 是每天每月每年都執行,同理 在秒和分鐘也應該如此。

*node-schedule暫時不支持「L」、「W」和「#」這三種設定值。

(完)

參考
原文鏈接:http://ju.outofmemory.cn/entry/267740

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章