cron 表达式详解和转换成中文 |
您所在的位置:网站首页 › date中文在线翻译 › cron 表达式详解和转换成中文 |
目录 1,cron表达式生成器 2,cron表达式 一,结构 二、各字段的含义 三、常用表达式例子 3,转换成中文: 1,CronExpParserUtil 2,WeekEnum 3,测试: 4,测试输出: 总结: 1,cron表达式生成器 在线cron表达式生成器: https://www.bejson.com/othertools/cron/ 使用生成器,即时测试,便于理解和解析cron表达式 2,cron表达式 一,结构 Cron表达式是一个表示时间周期的字符串。分为6或7个域,每一个域代表一个含义。 corn从左到右(用空格隔开) 格式:{秒} {分} {时} {日} {月} {周} {年(可选)}
(1) Seconds Minutes Hours DayofMonth Month DayofWeek Year (2)Seconds Minutes Hours DayofMonth Month DayofWeek
DayofMonth 就是day 每天 DayofWeek 周几 二、各字段的含义 字段 允许值 允许的特殊字符 秒(Seconds) 0~59的整数 , - * / 四个字符 分(Minutes) 0~59的整数 , - * / 四个字符 小时(Hours) 0~23的整数 , - * / 四个字符 日期(DayofMonth) 1~31的整数(但是你需要考虑你月的天数) ,- * ? / L W C 八个字符 月份(Month) 1~12的整数或者 JAN-DEC , - * / 四个字符 星期(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和DayofMonth域。如果在DayofMonth,L就是月份的最后一天。 如果在DayofWeek域使用5L,意味着在最后的一个星期四触发。 (7)W:表示有效工作日(周一到周五),只能出现在DayofMonth域,系统将在离指定日期的最近的有效工作日触发事件。例如:在 DayofMonth使用5W,如果5日是星期六,则将在最近的工作日:星期五,即4日触发。如果5日是星期天,则在6日(周一)触发;如果5日在星期一到星期五中的一天,则就在5日触发。另外一点,W的最近寻找不会跨过月份 。(PS:这个理解不过来,在线上cron表达式生成器中输入,0 0 12 3W * ? , 0 0 12 4W * ? 等) (8)LW:这两个字符可以连用,表示在某个月最后一个工作日,即最后一个星期五。 (9)#:用于确定每个月第几个星期几,只能出现在DayofMonth域。例如在4#2,表示某月的第二个星期三。 (10)C:只在日期和星期字段中使用,代表“Calendar”的意思。它的意思是计划所关联的日期,如果日期没有被关联,则相当于日历中所有日期。例如 5C 在日期字段中就相当于日历 5 日以后的第一天。1C 在星期字段中相当于星期日后的第一天; 三、常用表达式例子(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触发 注: (1)有些子表达式能包含一些范围或列表 例如:子表达式(天(星期))可以为 “MON-FRI”,“MON,WED,FRI”,“MON-WED,SAT”,“*”字符代表所有可能的值 因此,“*”在子表达式(月)里表示每个月的含义,“*”在子表达式(天(星期))表示星期的每一天 “/”字符用来指定数值的增量 。 例如:在子表达式(分钟)里的“0/15”表示从第0分钟开始,每15分钟 在子表达式(分钟)里的“3/20”表示从第3分钟开始,每20分钟(它和“3,23,43”)的含义一样 “?”字符仅被用于天(月)和天(星期)两个子表达式,表示不指定值 当2个子表达式其中之一被指定了值以后,为了避免冲突,需要将另一个子表达式的值设为“?” “L” 字符仅被用于天(月)和天(星期)两个子表达式,它是单词“last”的缩写 但是它在两个子表达式里的含义是不同的。 在天(DayofMonth)子表达式中,“L”表示一个月的最后一天 在天(DayofWeek)自表达式中,“L”表示一个星期的最后一天,也就是SAT,等同于于数字7 如果在“L”前有具体的内容,它就具有其他的含义了 例如:“6L”表示这个月的倒数第6天,“FRIL”表示这个月的最一个星期五 注意:在使用“L”参数时,不要指定列表或范围,因为这会导致问题 3,转换成中文: 了解到cron表达式后,开始把cron表达式转换成中文,便于理解
处理思路: 主要解析字符“/”,“L”,“#”, 对于 “*”,“?” 就太多可以解析的;对于“,”,“-”,这个直接沿用,也好理解 对于“W”,“LW”,“C” 这个要真的理解,才好处理,用cron表达式在线编译器,0 0 12 3W * ? , 0 0 12 4W * ? 等,也没搞明白C和W的含义,就先搁置。如果后面真的遇到了,再完善 还有周带英文的 “0 15 10 ? * MON-FRI 周一至周五的上午10:15触发”,英文的解析起来比较麻烦,数字的好解析,英文的没有处理。 1,CronExpParserUtil protected final static String[] CRON_TIME_CN = new String[]{"秒", "分钟", "小时", "天", "月","周", "年"}; private final static Integer HOURS = 24; private final static Integer TIMESCALE = 60; /** * 主要解析 斜杆 /:表示起始时间开始触发,然后每隔固定时间触发一次。 * 范围值+开始值 - 间隔值 = 范围内最后执行的值; * 例如在Hourss域使用3/4,则意味着从第3小时到24+3-4:23小时范围内,第3小时开始触发第一次,然后每隔4小时,即7,11,15,19,23小时等分别触发一次。 * 例如在Minutes域使用5/20,则意味着从第5分钟到60+5-20:45分范围内,第5分钟开始触发第一次,然后每隔20分钟,即25,45分钟等分别触发一次。 * 例如在Seconds域使用8/10,则意味着从第8秒到60+8-10:58秒范围内,第8秒开始触发第一次,然后每隔10秒,即18,28,38,48,58秒等分别触发一次。 * * * 对于 *:表示匹配该域的任意值。例如在Minutes域使用*, 即表示每分钟都会触发事件。 * 对于问号 ?:只能用在DayofMonth和DayofWeek两个域,其作用为不指定 * 对于 -:表示范围。例如在Minutes域使用5-20,表示从5分到20分钟每分钟触发一次。直接进行拼接 * 对于逗号 ,:表示列出枚举值。例如在Minutes域使用5,20 , 则意味着在5和20分每分钟触发一次。 * 对于L:表示最后,只能出现在DayofWeek和DayofMonth域。 * 如果出现在DayofMonth域,只能使用L,表示当月最后一天 * 如果在DayofWeek域 * 使用数字(1-7)或L(和7的作用一样表示每周的最后一天周六),比如数字"5"表示每周4, "7"或"L"表示每周六 * 使用数字(1-7)结合L,表示当月最后一周的周几,比如"5L" 表示在最后的一周的周四; "3L" 表示最后一周的周二 * 对于#: 用于确定每个月第几个星期几,只能出现在DayofMonth域。 * 例如 "4#2" 表示某月的第二个星期三(4表示星期三,2表示第二周); * “6#3”表示本月第三周的星期五(6表示星期五,3表示第三周); * “2#1”表示本月第一周的星期一; * “4#5”表示第五周的星期三。 * * @param cronExp * @param cronTimeArr * @return */ public static String translateToChinese(String cronExp, String[] cronTimeArr) { if (cronExp == null || cronExp.length() < 1) { return "cron表达式为空"; } String[] tmpCorns = cronExp.split(" "); StringBuffer sBuffer = new StringBuffer(); if (tmpCorns.length == 6 || tmpCorns.length == 7) { if (tmpCorns.length == 7) { //解析年 Year String year = tmpCorns[6]; if((!year.equals("*") && !year.equals("?"))){ sBuffer.append(year).append(cronTimeArr[6]); } } //解析月 Month 主要解析 / String months = tmpCorns[4]; if (!months.equals("*") && !months.equals("?")) { if (months.contains("/")) { sBuffer.append("从").append(months.split("/")[0]).append("号开始").append(",每") .append(months.split("/")[1]).append(cronTimeArr[4]); } else { sBuffer.append("每年").append(months).append(cronTimeArr[4]); } } //解析周 DayofWeek 主要解析 , - 1~7/L 1L~7L String dayofWeek = tmpCorns[5]; if (!dayofWeek.equals("*") && !dayofWeek.equals("?")) { if (dayofWeek.contains(",")) {// 多个数字,逗号隔开 sBuffer.append("每周的第").append(dayofWeek).append(cronTimeArr[3]); } else if (dayofWeek.contains("L") && dayofWeek.length() > NumberUtils.INTEGER_ONE) {// 1L-7L String weekNum = dayofWeek.split("L")[0]; String weekName = judgeWeek(weekNum); sBuffer.append("每月的最后一周的"); sBuffer.append(weekName); } else if(dayofWeek.contains("-")) { String[] splitWeek = dayofWeek.split("-"); String weekOne = judgeWeek(splitWeek[0]); String weekTwo = judgeWeek(splitWeek[1]); sBuffer.append("每周的").append(weekOne).append("到").append(weekTwo); } else { // 1-7/L if("L".equals(dayofWeek)){ // L 转换为7,便于识别 dayofWeek = "7"; } int weekNums = Integer.parseInt(dayofWeek); if(weekNums < 0 || weekNums > 7 ){ return "cron表达式有误,dayofWeek数字应为1-7"; } sBuffer.append("每周的"); String weekName = judgeWeek(dayofWeek); sBuffer.append(weekName); } } //解析日 days -- DayofMonth 需要解析的 / # L W // * “6#3”表示本月第三周的星期五(6表示星期五,3表示第三周); // * “2#1”表示本月第一周的星期一; // * “4#5”表示第五周的星期三。 String days = tmpCorns[3]; if (!days.equals("?")&& !days.equals("*")) { if (days.contains("/")) { sBuffer.append("每周从第").append(days.split("/")[0]).append("天开始").append(",每") .append(days.split("/")[1]).append(cronTimeArr[3]); } else if ("L".equals(days)) { // 处理L 每月的最后一天 sBuffer.append("每月最后一天"); } else if ("W".equals(days)) { // 处理W 暂时不懂怎么处理 sBuffer.append(days); } else if (days.contains("#")) { String[] splitDays = days.split("#"); String weekNum = splitDays[0]; // 前面数字表示周几 String weekOfMonth = splitDays[1]; // 后面的数字表示第几周 范围1-4 一个月最多4周 String weekName = judgeWeek(weekNum); sBuffer.append("每月第").append(weekOfMonth).append(cronTimeArr[5]).append(weekName); } else { sBuffer.append("每月第").append(days).append(cronTimeArr[3]); } } else { if (sBuffer.toString().length() == 0 || tmpCorns.length == 7) { // 前面没有内容的话,拼接下 sBuffer.append("每").append(cronTimeArr[3]); } } //解析时 Hours 主要解析 / String hours = tmpCorns[2]; if (!hours.equals("*")) { if (hours.contains("/")) { // sBuffer.append("内,从").append(hours.split("/")[0]).append("时开始").append(",每") // .append(hours.split("/")[1]).append(cronTimeArr[2]); sBuffer.append(appendGapInfo(hours, HOURS, 2)); } else { if (!(sBuffer.toString().length() > 0)) { // 对于 , 的情况,直接拼接 sBuffer.append("每天").append(hours).append(cronTimeArr[2]); } else { sBuffer.append(hours).append(cronTimeArr[2]); } } } //解析分 Minutes 主要解析 / String minutes = tmpCorns[1]; if (!minutes.equals("*")) { if (minutes.contains("/")) { // sBuffer.append("内,从第").append(minutes.split("/")[0]).append("分开始").append(",每") // .append(minutes.split("/")[1]).append(cronTimeArr[1]); sBuffer.append(appendGapInfo(minutes, TIMESCALE, 1)); } else if (minutes.equals("0")) { } else if (minutes.contains("-")) { String[] splitMinute = minutes.split("-"); sBuffer.append(splitMinute[0]).append(cronTimeArr[1]).append("到").append(splitMinute[1]) .append(cronTimeArr[1]).append("每分钟"); } else { sBuffer.append(minutes).append(cronTimeArr[1]); } } //解析秒 Seconds 主要解析 / String seconds = tmpCorns[0]; if (!seconds.equals("*")) { if (seconds.contains("/")) { // sBuffer.append("内,从第").append(seconds.split("/")[0]).append("秒开始").append(",每") // .append(seconds.split("/")[0]).append(cronTimeArr[0]); sBuffer.append(appendGapInfo(seconds, TIMESCALE, 0)); } else if (!seconds.equals("0")) { sBuffer.append(seconds).append(cronTimeArr[0]); } } if (sBuffer.toString().length() > 0) { sBuffer.append("执行一次"); } else { sBuffer.append("表达式中文转换异常"); } } return sBuffer.toString(); } public static String judgeWeek(String weekNum){ String weekName = WeekEnum.matchNameCn(String.valueOf(weekNum)); int weekNums = Integer.parseInt(weekNum); if(weekNums < 0 || weekNums > 7 ){ return "cron表达式有误,dayofWeek 数字应为1-7"; } return StringUtils.isNotEmpty(weekName) ? weekName : String.valueOf(weekNum); } private static String appendGapInfo(String time, int rangeNum, int index){ StringBuffer sBufferTemp = new StringBuffer(); String[] splitTime = time.split("/"); String startNum = splitTime[0]; String gapNum = splitTime[1]; int endNum = rangeNum + Integer.parseInt(startNum) - Integer.parseInt(gapNum); String endStr = String.valueOf(endNum); String timeUnit = CRON_TIME_CN[index]; sBufferTemp.append("从").append(startNum).append(timeUnit).append("开始") .append("到").append(endStr).append(timeUnit).append("范围内") .append(",每隔").append(gapNum).append(timeUnit); return sBufferTemp.toString(); }
2,WeekEnum 日期按英文的,星期天是开始的第一天。 public enum WeekEnum { SECONDS("1", "星期天", "Sunday "), MONDAY("2", "星期一", "Monday "), TUESDAY("3", "星期二", "Tuesday "), WEDNESDAY("4", "星期三", "Wednesday "), THURSDAY("5", "星期四", "Thursday "), FRIDAY("6", "星期五", "Friday "), SATURDAY("7", "星期六", "Saturday "); private String key; private String nameCn; private String nameEn; WeekEnum(String key, String nameCn, String nameEn) { this.key = key; this.nameCn = nameCn; this.nameEn = nameEn; } public static String matchNameCn(String code) { for (WeekEnum m : WeekEnum.values()) { if (m.getKey().equals(code)) { return m.getNameCn(); } } return ""; } public static String matchNameEn(String code) { for (WeekEnum m : WeekEnum.values()) { if (m.getKey().equals(code)) { return m.getNameEn(); } } return ""; } public String getKey() { return key; } public void setKey(String key) { this.key = key; } public String getNameCn() { return nameCn; } public void setNameCn(String nameCn) { this.nameCn = nameCn; } public String getNameEn() { return nameEn; } public void setNameEn(String nameEn) { this.nameEn = nameEn; } }
3,测试: 把上面的cron表达式的例子拿来测试: //测试方法 public static void main(String[] args) { testCronExpression(); } private static void testCronExpression() { String cronExpression = ""; // 0 0 2 1 * ? * 表示在每月的1日的凌晨2点 cronExpression = "0 0 2 1 * ? *"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // 0 15 10 ? * 2-6 表示周一到周五每天上午10:15执行作业 cronExpression = "0 15 10 ? * 2-6"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // 每天上午10点,下午2点,4点 cronExpression = "0 0 10,14,16 * * ?"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // 在每天下午2点到下午2:05期间的每1分钟触发 cronExpression = "0 5 14-16 * * ?"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // 每月最后一日的上午10:15触发 cronExpression = "0 15 10 L * ? "; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // 每月的第三个星期五上午10:15触发 cronExpression = "0 15 10 ? * 6"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // 2002 每天中午12点触发 cronExpression = "0 0 12 * * ? 2002"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // 2002-2005年 每天中午12点触发 cronExpression = "0 15 10 ? * ? 2002-2005"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // 0 15 10 ? * 6L 每月的最后一个星期五上午10:15触发 cronExpression = "0 15 10 ? * 6L"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); cronExpression = "0 15 10 6#4 * ?"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // 0 15 10 * * ? * 每天上午10:15触发 cronExpression = "0 15 10 * * ? *"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // 0 15 10 * * ? 2005 2005年的每天上午10:15触发 cronExpression = " 0 15 10 * * ? 2005"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // 0 * 14 * * ? 在每天下午2点到下午2:59期间的每1分钟触发 cronExpression = "0 * 14 * * ?"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // 0 0/5 14 * * ? 在每天下午2点到下午2:55期间的每5分钟触发 cronExpression = "0 0/5 14 * * ?"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); // "0 0/5 14,18 * * ?" 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发 cronExpression = "0 0/5 14,18 * * ?"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); cronExpression = "8/10 0/5 3/4 * * ?"; System.out.println(cronExpression); System.out.println(translateToChinese(cronExpression, CRON_TIME_CN)); }4,测试输出: 0 0 2 1 * ? * 每月第1天2小时执行一次 0 15 10 ? * 2-6 每周的星期一到星期五10小时15分钟执行一次 0 0 10,14,16 * * ? 每天10,14,16小时执行一次 0 5 14-16 * * ? 每天14-16小时5分钟执行一次 0 15 10 L * ? 每月最后一天10小时15分钟执行一次 0 15 10 ? * 6 每周的星期五10小时15分钟执行一次 0 0 12 * * ? 2002 2002年每天12小时执行一次 0 15 10 ? * ? 2002-2005 2002-2005年每天10小时15分钟执行一次 0 15 10 ? * 6L 每月的最后一周的星期五10小时15分钟执行一次 0 15 10 6#4 * ? 每月第4周星期五10小时15分钟执行一次 0 15 10 * * ? * 每天10小时15分钟执行一次 0 15 10 * * ? 2005 0 * 14 * * ? 每天14小时执行一次 0 0/5 14 * * ? 每天14小时从0分钟开始到55分钟范围内,每隔5分钟执行一次 8/10 0/5 3/4 * * ? 每天从3小时开始到23小时范围内,每隔4小时从0分钟开始到55分钟范围内,每隔5分钟从8秒开始到58秒范围内,每隔10秒执行一次 总结: cron表达式的规则并不简单,对于常见常用的进行解析基本就够了,不然解析起来也是很麻烦的。先理解表达式的含义,再进行解析,使用在线工具去测试,即时获得反馈,再修改,再调整。
|
今日新闻 |
推荐新闻 |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |