表达式详解和转换成中文"/>
cron 表达式详解和转换成中文
目录
1，cron表达式生成器
2，cron表达式
一，结构
二、各字段的含义
三、常用表达式例子
3，转换成中文：
1，CronExpParserUtil
2，WeekEnum
3，测试：
4，测试输出：
总结：
1，cron表达式生成器
在线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) {//解析年 YearString 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~7LString 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-7LString 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/Lif("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 * * ? 20022002年每天12小时执行一次0 15 10 ? * ? 2002-20052002-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 * * ? 20050 * 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表达式的规则并不简单，对于常见常用的进行解析基本就够了，不然解析起来也是很麻烦的。先理解表达式的含义，再进行解析，使用在线工具去测试，即时获得反馈，再修改，再调整。
更多推荐
cron 表达式详解和转换成中文
发布评论