Cron表达式是一个字符串,字符串以 ٥ أو ٦ 个空格隔开,分为 ٦ أو ٧ 个域,每一个域代表一个含义,Cron有如下两种语法格式:
(1) Seconds Minutes Hours DayofMonth Month DayofWeek Year
(2) Seconds Minutes Hours DayofMonth Month DayofWeek
أولاً، الهيكل
ذرة من اليسار إلى اليمين (مفصولة بمسافات): ثانية دقيقة ساعة يوم من الشهر شهر يوم من الأسبوع سنة
ثانياً، معاني الحقول
حقل | القيم المسموح بها | الأحرف الخاصة المسموح بها |
ثواني | الأعداد الصحيحة من 0 إلى 59 | , - * / 四个字符 |
分( Minutes ) | الأعداد الصحيحة من 0 إلى 59 | , - * / 四个字符 |
小时( Hours ) | الأعداد الصحيحة من 0 إلى 23 | , - * / 四个字符 |
日期( DayofMonth ) | الأعداد الصحيحة من 1 إلى 31 (لكن يجب أن تأخذ في اعتبارك عدد الأيام في شهرك) | ,- * ? / L W C 八个字符 |
月份( Month ) | من 1 إلى 12 أو يناير - ديسمبر | , - * / 四个字符 |
星期( DayofWeek ) | الأعداد الصحيحة من 1 إلى 7 أو SUN-SAT (1=SUN) | , - * ? / L C # 八个字符 |
年(可选,留空)( 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分钟触发一次,而25,45等分别触发一次.
(5): يُستخدم للإشارة إلى سرد القيم. 例如:在Minutes域使用5,20,则意味着在5和20分每分钟触发一次。
(6) L: يشير إلى النهاية، ويمكن أن يظهر فقط في مجالات يوم الأسبوع ويوم الشهر. 如果在DayofWeek域使用5L,意味着在最后的一个星期四触发。
(7) W: تعني أيام العمل الفعالة (من الإثنين إلى الجمعة)، ويمكن أن تظهر فقط في حقل DayofMonth، حيث سيقوم النظام بتفعيل الحدث في أقرب يوم عمل فعال من التاريخ المحدد. 例如:在 DayofMonth使用5W,如果5日是星期六,则将在最近的工作日:星期五,即4日触发。如果5日是星期天,则在6日(周一)触发;如果5日在星期一到星期五中的一天,则就在5日触发。另外一点,W的最近寻找不会跨过月份 。
(8) LW: يمكن استخدام هذين الحرفين معًا للدلالة على آخر يوم عمل في شهر معين، وهو آخر يوم جمعة.
(9) #: تُستخدم لتحديد أي يوم من أيام الأسبوع في كل شهر، ولا يمكن أن تظهر إلا في مجال DayofWeek. 例如在4#2,表示某月的第二个星期三。
ثالثاً، أمثلة على التعبيرات الشائعة
(0) 0/20 * * * * ? 表示每20秒 调整任务
(1) 0 0 2 1 * ? 表示在每月的1日的凌晨2点调整任务
(2) 0 15 10 ? * MON-FRI 表示周一到周五每天上午10:15执行作业
(3) 0 15 10 ? 6L 2002-2006 表示2002-2006年的每个月的最后一个星期五上午10:15执行作
(4) 0 0 10,14,16 * * ? 每天上午10点,下午2点,4点
(5) 0 0/30 9-17 * * ? 朝九晚五工作时间内每半小时
(6) 0 0 12 ? * WED 表示每个星期三中午12点
(7) 0 0 12 * * ? 每天中午12点触发
(8) 0 15 10 ? * * 每天上午10:15触发
(9) 0 15 10 * * ? 每天上午10:15触发
(10) 0 15 10 * * ? * 每天上午10:15触发
(11) 0 15 10 * * ? 2005 2005年的每天上午10:15触发
(12) 0 * 14 * * ? 在每天下午2点到下午2:59期间的每1分钟触发
(13) 0 0/5 14 * * ? 在每天下午2点到下午2:55期间的每5分钟触发
(14) 0 0/5 14,18 * * ? 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
(15) 0 0-5 14 * * ? 在每天下午2点到下午2:05期间的每1分钟触发
(16) 0 10,44 14 ? 3 WED 每年三月的星期三的下午2:10和2:44触发
(17) 0 15 10 ? * MON-FRI 周一至周五的上午10:15触发
(18) 0 15 10 15 * ? 每月15日上午10:15触发
(19) 0 15 10 L * ? 每月最后一日的上午10:15触发
(20) 0 15 10 ? * 6L 每月的最后一个星期五上午10:15触发
(21) 0 15 10 ? * 6L 2002-2005 2002年至2005年的每月的最后一个星期五上午10:15触发
(22) 0 15 10 ? * 6#3 每月的第三个星期五上午10:15触发
ملاحظة:
بعض التعبيرات الفرعية يمكن أن تحتوي على بعض النطاقات أو القوائم.
على سبيل المثال: يمكن أن يكون التعبير الفرعي (اليوم (الأسبوع)) "الاثنين-الجمعة"، "الاثنين، الأربعاء، الجمعة"، "الاثنين-الأربعاء، السبت"
يُمثل الرمز "*" جميع القيم الممكنة.
لذا، فإن "*" في التعبير الفرعي (الشهر) تعني كل شهر، و "*" في التعبير الفرعي (اليوم (الأسبوع)) تعني كل يوم من أيام الأسبوع.
“/”字符用来指定数值的增量
例如:在子表达式(分钟)里的“0/15”表示从第0分钟开始,每15分钟
在子表达式(分钟)里的“3/20”表示从第3分钟开始,每20分钟(它和“3,23,43”)的含义一样
“?”字符仅被用于天(月)和天(星期)两个子表达式,表示不指定值
当2个子表达式其中之一被指定了值以后,为了避免冲突,需要将另一个子表达式的值设为“?”
“L” 字符仅被用于天(月)和天(星期)两个子表达式,它是单词“last”的缩写
但是它在两个子表达式里的含义是不同的。
在天(月)子表达式中,“L”表示一个月的最后一天
在天(星期)自表达式中,“L”表示一个星期的最后一天,也就是SAT
إذا كان هناك محتوى محدد قبل "L"، فإنه سيكتسب معاني أخرى.
例如:“6L”表示这个月的倒数第6天,“FRIL”表示这个月的最一个星期五
注意:在使用“L”参数时,不要指定列表或范围,因为这会导致问题
لقد استخدمت مؤخرًا: