〇、 需求
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块"