SpringBoot - 集成Quartz框架之CRON表达式

CRON是什么?

Quartz官网
CENTOS下的CRON服务及CRONTAB命令的区别

SpringBoot - 集成Quartz框架之Quartz简介(一)
SpringBoot - 集成Quartz框架之常用配置(二)
SpringBoot - 集成Quartz框架之具体步骤(三)
SpringBoot - 集成Quartz框架之独立数据源(四)
SpringBoot - 集成Quartz框架之常见问题(五)
SpringBoot - 集成Quartz框架之@DisallowConcurrentExecution注解详解(六)

CRON表达式

CRON表达式是一个字符串，字符串由5个或6个空格隔开，分为6个或7个域，每一个域代表一个含义，表达如如下：
秒 分 时 天(day-of-month) 月 周(day-of-week) 年[可选]

常用示例

*/5 * * * * ?：每隔 5 秒执行一次
0 */1 * * * ?：每隔 1 分钟执行一次
0 0 2 1 * ? *：每月 1 日的凌晨 2 点执行一次
0 15 10 ? * MON-FRI：周一到周五每天上午 10：15 执行一次
0 15 10 ? * 6L 2002-2006：2002 年至 2006 年的每个月的最后一个星期五上午 10:15 执行一次
0 0 23 * * ?：每天 23 点执行一次
0 0 1 * * ?：每天凌晨 1 点执行一次
0 0 1 1 * ?：每月 1 日凌晨 1 点执行一次
0 0 23 L * ?：每月最后一天 23 点执行一次
0 0 1 ? * L：每周星期天凌晨 1 点执行一次
0 26,29,33 * * * ?：在 26 分、29 分、33 分执行一次
0 0 0,13,18,21 * * ?：每天的 0 点、13 点、18 点、21 点都执行一次
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 执行一次

翻译CRON表达式

import java.text.ParseException;
import java.util.Date;
import org.quartz.CronExpression;

/**
 * CRON表达式工具类
 * @author ROCKY
 */
public class CronUtils {
    /**
     * 返回一个布尔值代表一个给定的CRON表达式是否有效
     */
    public static boolean isValid(String cronExpression) {
        return CronExpression.isValidExpression(cronExpression);
    }

    /**
     * 返回一个字符串值, 表示该消息无效CRON表达式给出有效性
     */
    public static String getInvalidMessage(String cronExpression) {
        try {
            new CronExpression(cronExpression);
            return null;
        } catch (ParseException pe) {
            return pe.getMessage();
        }
    }

    /**
     * 返回下一个执行时间根据给定的CRON表达式
     */
    public static Date getNextExecution(String cronExpression) {
        try {
            CronExpression cron = new CronExpression(cronExpression);
            return cron.getNextValidTimeAfter(new Date(System.currentTimeMillis()));
        } catch (ParseException e) {
            throw new IllegalArgumentException(e.getMessage());
        }
    }

    /**
     * 将一个给定的CRON表达式翻译成中文
     */
    private final static String[] CRON_EXPRESSION_DOMAIN = new String[]{"秒", "分", "时", "日", "月", "周", "年"};
    public static String translate(String expression) {

        if (StringUtils.isEmpty(expression)) {
            return expression;
        }

        String[] expressions = expression.split(" ");

        StringBuffer result = new StringBuffer();
        if (expressions.length == 6 || expressions.length == 7) {
            // 1. 年
            if (expressions.length == 7) {
                String year = expressions[6];
                if ((!year.equals("*") && !year.equals("?"))) {
                    result.append(year).append(CRON_EXPRESSION_DOMAIN[6]);
                }
            }

            // 2. 月
            String months = expressions[4];
            if (!months.equals("*") && !months.equals("?")) {
                if (months.contains("/")) {
                    result.append("从").append(months.split("/")[0]).append("日开始")
                            .append(",每").append(months.split("/")[1]).append(CRON_EXPRESSION_DOMAIN[4]);
                } else {
                    if (result.toString().contains("-")) {
                        result.append("每年");
                    }
                    result.append(months).append(CRON_EXPRESSION_DOMAIN[4]);
                }
            }

            // 3. 周
            String dayOfWeek = expressions[5];
            if (!dayOfWeek.equals("*") && !dayOfWeek.equals("?")) {
                if (dayOfWeek.contains(",")) {// 多个数字，逗号隔开
                    result.append("每周的第").append(dayOfWeek).append(CRON_EXPRESSION_DOMAIN[3]);
                } else if (dayOfWeek.contains("L") && dayOfWeek.length() > 1) {// 1L-7L
                    String index = dayOfWeek.split("L")[0];
                    String name = Weeks.name(index);
                    result.append("每月最后一周的");
                    result.append(name);
                } else if (dayOfWeek.contains("-")) {
                    String[] split = dayOfWeek.split("-");
                    String one = Weeks.name(split[0]);
                    String two = Weeks.name(split[1]);
                    result.append("每周").append(one).append("到").append(two);
                } else if (dayOfWeek.contains("#")) {
                    String[] split = dayOfWeek.split("#");
                    // 前面数字表示周几
                    String index = split[0];
                    // 后面的数字表示每月的第几周(1-4)
                    String weekOfMonth = split[1];
                    String name = Weeks.name(index);
                    result.append("每月第").append(weekOfMonth).append(CRON_EXPRESSION_DOMAIN[5]).append("的").append(name);
                } else {
                    if ("L".equals(dayOfWeek)) {
                        // L表示每周的最后一天
                        dayOfWeek = "7";
                    }
                    result.append("每周的");
                    result.append(Weeks.name(dayOfWeek));
                }
            }
            // 4. 日
            String days = expressions[3];
            if (!days.equals("*") && !days.equals("?")) {
                if (days.contains("/")) {
                    result.append("每周从第").append(days.split("/")[0]).append("天开始")
                            .append(",每").append(days.split("/")[1]).append(CRON_EXPRESSION_DOMAIN[3]);
                } else if ("L".equals(days)) {
                    // L表示每月的最后一天
                    result.append("每月最后一天");
                } else if ("W".equals(days)) {
                    // TODO 关于W的处理
                    result.append(days);
                } else {
                    result.append("每月").append(days).append("日");
                }
            } else {
                if ((result.toString().length() == 0 || expressions.length == 7) && !result.toString().contains("星期")) { // 前面没有内容的话，拼接下
                    result.append("每").append(CRON_EXPRESSION_DOMAIN[3]);
                }
            }
            // 5. 时
            String hours = expressions[2];
            if (!hours.equals("*")) {
                if (hours.contains("/")) {
                    result.append(getHourMinuteSecond(hours, 24, 2));
                } else {
                    if (!(result.toString().length() > 0)) { // 对于 , 的情况，直接拼接
                        result.append("每天").append(hours).append(CRON_EXPRESSION_DOMAIN[2]);
                    } else {
                        result.append(hours).append(CRON_EXPRESSION_DOMAIN[2]);
                    }
                }
            }

            // 6. 分
            String minutes = expressions[1];
            if (!minutes.equals("*")) {
                if (minutes.contains("/")) {
                    result.append(getHourMinuteSecond(minutes, 60, 1));
                } else if (minutes.equals("0")) {
                } else if (minutes.contains("-")) {
                    String[] splitMinute = minutes.split("-");
                    result.append(splitMinute[0]).append(CRON_EXPRESSION_DOMAIN[1]).append("到").append(splitMinute[1])
                            .append(CRON_EXPRESSION_DOMAIN[1]).append("每分钟");
                } else {
                    result.append(minutes).append(CRON_EXPRESSION_DOMAIN[1]);
                }
            }

            // 7. 秒
            String seconds = expressions[0];
            if (!seconds.equals("*")) {
                if (seconds.contains("/")) {
                    result.append(getHourMinuteSecond(seconds, 60, 0));
                } else if (!seconds.equals("0")) {
                    result.append(seconds).append(CRON_EXPRESSION_DOMAIN[0]);
                }
            }
            if (result.toString().length() > 0) {
                result.append("执行一次");
            }
        }
        return result.toString();
    }


    private static String getHourMinuteSecond(String time, int length, int index) {
        StringBuffer result = new StringBuffer();
        String[] split = time.split("/");
        String start = split[0];
        // 间隔
        String gap = split[1];
        String end = String.valueOf(length + (start.equals("*") ? 0 : Integer.parseInt(start)) - Integer.parseInt(gap));

        String unit1 = CRON_EXPRESSION_DOMAIN[index];
        String unit2 = CRON_EXPRESSION_DOMAIN[index];
        if (index == 1) {
            unit2 = "分钟";
        } else if (index == 2) {
            unit2 = "小时";
        }
        result.append("从").append(start.equals("*") ? 0 : Integer.parseInt(start)).append(unit1).append("开始").append("到").append(end)
                .append(unit1).append("范围内").append(",每隔").append(gap).append(unit2);
        return result.toString();
    }


    enum Weeks {
        SUN("1", "SUN", "星期天"),
        MON("2", "MON", "星期一"),
        TUE("3", "TUE", "星期二"),
        WED("4", "WED", "星期三"),
        THU("5", "THU", "星期四"),
        FRI("6", "FRI", "星期五"),
        SAT("7", "SAT", "星期六");

        private String index1;
        private String index2;
        private String name;

        Weeks(String index1, String index2, String name) {
            this.index1 = index1;
            this.index2 = index2;
            this.name = name;
        }

        public String getIndex1() {
            return index1;
        }

        public String getIndex2() {
            return index2;
        }

        public String getName() {
            return name;
        }

        public static String name(String index) {
            return Arrays.stream(Weeks.values()).filter(m -> m.getIndex1().equals(index) || m.getIndex2().equals(index)).map(m -> m.getName()).findFirst().get();
        }

    }


}

在线工具

1. CRON表达式在线生成工具
2. VUE-CRON在线生成工具

源码、示例及DEMO

源码、示例及DEMO