rails sidekiq-scheduler cron 写法

最新推荐文章于 2024-05-09 09:44:11 发布

weixin_34402090

最新推荐文章于 2024-05-09 09:44:11 发布

阅读量334

点赞数

文章标签： git python java

原文链接：https://my.oschina.net/yudongyang/blog/1549691

版权

2019独角兽企业重金招聘Python工程师标准>>>

〇、需求

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”表示这个月的倒数第６天，“ＦＲＩＬ”表示这个月的最一个星期五

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

三、一个完整例子

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

转载于:https://my.oschina.net/yudongyang/blog/1549691