rails sidekiq-scheduler cron 写法

〇、 需求

rails sidekiq-scheduler cron 写法

sidekiq-scheduler 中 cron 的写法和大部分的定时任务组件的 cron 写法基本一样

sidekiq-scheduler 的官方 git : https://github.com/moove-it/sidekiq-scheduler ,里面还有一系列的介绍,和执行时间有关的还可以使用 every 、 at 、 in 等参数,具体看原文。

修改:

重要:试用了之后,发现在 rails 中的 cron 写法却是用了另外一个 git 中的内容 :

 https://github.com/ondrejbartas/sidekiq-cron

总的来说,常用的两种就是 : 

'cron'  => '1 * * * *',  # execute at 1 minute of every hour, ex: 12:01, 13:01, 14:01, 15:01...etc(HH:MM)
cron: '*/5 * * * *', # execute at every 5 minutes, ex: 12:05, 12:10, 12:15...etc

所以,在 rails 中使用 sidekiq-scheduler cron 就不要被下面的误导了,下面是基于  spring 的 Schedule 写的。

 

一、 cron 中的元素

cron 中的元素是指使用空格隔开的每个部分,如下所示,下面的表达式中有六个元素

一个cron表达式有至少6个(也可能7个, 7个的时候第7个是年,很少这样用吧)有空格分隔的时间元素。

cron: "* * * * * *"

其中每个间隔的含义如下

"秒 分 时 天 月 天 年"

# 用英文表达更清楚

"second minute hour day month date year"

秒(0~59)

分钟(0~59)

小时(0~23)

天(月)(0~31,但是你需要考虑你月的天数)

月(0~11)

天(星期)(1~7 1=SUN 或 SUN,MON,TUE,WED,THU,FRI,SAT)

年份

 

二、 cron 中元素的含义

1、 基本含义

其中每个元素可以是一个值(如6),一个连续区间(9-12),一个间隔时间(8-18/4)(/表示每隔4小时),一个列表(1,3,5),通配符。由于"月份中的日期"和"星期中的日期"这两个元素互斥的,必须要对其中一个设置?。但是,sidekiq-scheduler 的官方 git 中并没有设置这个,而且亲测可以。

以下是在网上找来的一些使用例子,基本能满足各种需求,如非必要用下面 例子中的写法就好。

"0 0 10,14,16 * * ?" #每天上午10点,下午2点,4点
"0 0/30 9-17 * * ?"   #朝九晚五工作时间内每半小时
"0 0 12 ? * WED" #表示每个星期三中午12点 
"0 0 12 * * ?" #每天中午12点触发 
"0 15 10 ? * *" #每天上午10:15触发 
"0 15 10 * * ?" #每天上午10:15触发 
"0 15 10 * * ? *" #每天上午10:15触发 
"0 15 10 * * ? 2005" #2005年的每天上午10:15触发 
"0 * 14 * * ?" #在每天下午2点到下午2:59期间的每1分钟触发 
"0 0/5 14 * * ?" #在每天下午2点到下午2:55期间的每5分钟触发 
"0 0/5 14,18 * * ?" #在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发 
"0 0-5 14 * * ?" #在每天下午2点到下午2:05期间的每1分钟触发 
"0 10,44 14 ? 3 WED" #每年三月的星期三的下午2:10和2:44触发 
"0 15 10 ? * MON-FRI" #周一至周五的上午10:15触发 
"0 15 10 15 * ?" #每月15日上午10:15触发 
"0 15 10 L * ?" #每月最后一日的上午10:15触发 
"0 15 10 ? * 6L" #每月的最后一个星期五上午10:15触发 
"0 15 10 ? * 6L 2002-2005" #2002年至2005年的每月的最后一个星期五上午10:15触发 
"0 15 10 ? * 6#3" #每月的第三个星期五上午10:15触发 

2、 有些子表达式能包含一些范围或列表

下面这部分没有在 sidekiq-scheduler 中使用过,只是一般的 cron 表达式可以这样干

例如:子表达式(天(星期))可以为 “MON-FRI”,“MON,WED,FRI”,“MON-WED,SAT”

(1)“*”字符代表所有可能的值

因此,“*”在子表达式(月)里表示每个月的含义,“*”在子表达式(天(星期))表示星期的每一天

(2)“/”字符用来指定数值的增量

例如:在子表达式(分钟)里的“0/15”表示从第0分钟开始,每15分钟

         在子表达式(分钟)里的“3/20”表示从第3分钟开始,每20分钟(它和“3,23,43”)的含义一样

(3)“?”字符仅被用于天(月)和天(星期)两个子表达式,表示不指定值

当2个子表达式其中之一被指定了值以后,为了避免冲突,需要将另一个子表达式的值设为“?”

(4)“L” 字符仅被用于天(月)和天(星期)两个子表达式,它是单词“last”的缩写

但是它在两个子表达式里的含义是不同的。

在天(月)子表达式中,“L”表示一个月的最后一天

在天(星期)自表达式中,“L”表示一个星期的最后一天,也就是SAT

如果在“L”前有具体的内容,它就具有其他的含义了

例如:“6L”表示这个月的倒数第6天,“FRIL”表示这个月的最一个星期五

注意:在使用“L”参数时,不要指定列表或范围,因为这会导致问题

三、 一个完整例子

schedule_remit_money_to_YuDong:
  cron: "0 0 */2 * * *"
  class: RemitMoneyToYuDong
  queue: "remit_money_to_YuDong"
  args:
  description: "每两个小时给 YuDong 汇款200块"
相关文章

相关标签/搜索