| cron 表达式详解和转换成中文 | 您所在的位置：网站首页 › gojogging翻译成中文 › 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”表示这个月的倒数第６天，“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 实验室设备网 版权所有 |