java 构造 Quartz Cron 表达式

最新推荐文章于 2025-09-28 11:59:53 发布
原创 最新推荐文章于 2025-09-28 11:59:53 发布 · 251 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#java #开发语言

java 构造 Quartz Cron 表达式

构造 Quartz Cron 表达式

Quartz Cron 表达式由 6 或 7 个字段组成，分别代表：

字段允许值允许的特殊字符
秒0-59, - * /
分0-59, - * /
时0-23, - * /
日1-31, - * ? / L W C
月1-12 或 JAN-DEC, - * /
周几1-7 或 SUN-SAT, - * ? / L C #
年（可选）
  • 关键说明和注意事项​
  • 在 ​Linux Crontab​ 中，0代表星期日，1代表星期一，2代表星期二，依此类推。
  • 在 ​Quartz​ 中，1代表星期日，2代表星期一，3代表星期二，依此类推。​这是最常见的混淆点！​​
  • 参考： https://www.cnblogs.com/knqiufan/p/18952882

代码实现


import java.util.HashMap;
import java.util.Map;
import java.util.Scanner;

/**
 * 构造 Quartz Cron 表达式
 * Quartz Cron 表达式由 6 或 7 个字段组成，分别代表：
 * <p>
 * 字段         允许值           允许的特殊字符
 * •秒           0-59             , - * /
 * •分           0-59             , - * /
 * •时           0-23             , - * /
 * •日           1-31             , - * ? / L W C
 * •月           1-12 或 JAN-DEC  , - * /
 * •周几         1-7 或 SUN-SAT    , - * ? / L C #
 * •年（可选）
 * <p>
 * 关键说明和注意事项​
 * 在 ​Linux Crontab​ 中，0代表星期日，1代表星期一，2代表星期二，依此类推。
 * 在 ​Quartz​ 中，1代表星期日，2代表星期一，3代表星期二，依此类推。​这是最常见的混淆点！​​
 * 参考： https://www.cnblogs.com/knqiufan/p/18952882
 */

public class CronExpressionGenerator {

    // 星期名称到Cron表达式数字的映射
    private static final Map<String, Integer> DAY_OF_WEEK_MAP = new HashMap<>();

    static {
        DAY_OF_WEEK_MAP.put("周一", 2);
        DAY_OF_WEEK_MAP.put("周二", 3);
        DAY_OF_WEEK_MAP.put("周三", 4);
        DAY_OF_WEEK_MAP.put("周四", 5);
        DAY_OF_WEEK_MAP.put("周五", 6);
        DAY_OF_WEEK_MAP.put("周六", 7);
        DAY_OF_WEEK_MAP.put("周日", 1);

        DAY_OF_WEEK_MAP.put("星期一", 2);
        DAY_OF_WEEK_MAP.put("星期二", 3);
        DAY_OF_WEEK_MAP.put("星期三", 4);
        DAY_OF_WEEK_MAP.put("星期四", 5);
        DAY_OF_WEEK_MAP.put("星期五", 6);
        DAY_OF_WEEK_MAP.put("星期六", 7);
        DAY_OF_WEEK_MAP.put("星期日", 1);
    }

    public static void main(String[] args) {
        // scanner();

        int choice = 3;
        String time = "11:11";
        String dayInput = "10";
        //String dayInput = "10";
        generateCronExpression(choice, dayInput, time);
    }

    public static String generateCronExpression(int choice, String dayInput, String time) {
        String cronExpression = "";
        switch (choice) {
            case 1:
                cronExpression = generateDailyCron(time);
                break;
            case 2:
                cronExpression = generateWeeklyCron(dayInput, time);
                break;
            case 3:
                cronExpression = generateMonthlyCron(dayInput, "y", time);
                break;
            default:
                throw new IllegalArgumentException("无效的choice类型");
        }
        return cronExpression;
    }

    private static void scanner() {
        Scanner scanner = new Scanner(System.in);

        System.out.println("请选择定时类型:");
        System.out.println("1. 按日执行");
        System.out.println("2. 按周执行");
        System.out.println("3. 按月执行");

        int choice = scanner.nextInt();
        scanner.nextLine(); // 消耗换行符

        String cronExpression = "";

        switch (choice) {
            case 1:
                cronExpression = scannerDailyCron(scanner);
                break;
            case 2:
                cronExpression = scannerWeeklyCron(scanner);
                break;
            case 3:
                cronExpression = scannerMonthlyCron(scanner);
                break;
            default:
                System.out.println("无效选择");
                return;
        }

        System.out.println("生成的Quartz Cron表达式: " + cronExpression);
        scanner.close();
    }

    /**
     * 生成按日执行的Cron表达式
     */
    private static String scannerDailyCron(Scanner scanner) {
        System.out.println("请输入执行时间 (格式: HH:mm，如 12:00):");
        String time = scanner.nextLine();
        return generateDailyCron(time);
    }

    /**
     * 生成按日执行的Cron表达式
     */
    private static String generateDailyCron(String time) {
        String[] parts = splitTime(time);
        int hour = Integer.parseInt(parts[0]);
        int minute = Integer.parseInt(parts[1]);
        validateTime(hour, minute);
        // Cron格式: 秒 分 时 日 月 星期
        return String.format("0 %d %d * * ?", minute, hour);
    }

    /**
     * 生成按周执行的Cron表达式
     */
    private static String scannerWeeklyCron(Scanner scanner) {
        System.out.println("请输入星期几 (如: 周一):");
        String dayOfWeekInput = scanner.nextLine();

        System.out.println("请输入执行时间 (格式: HH:mm，如 02:00):");
        String time = scanner.nextLine();

        return generateWeeklyCron(dayOfWeekInput, time);
    }

    /**
     * 生成按周执行的Cron表达式
     */
    private static String generateWeeklyCron(String dayOfWeekInput, String time) {
        String[] parts = splitTime(time);

        int hour = Integer.parseInt(parts[0]);
        int minute = Integer.parseInt(parts[1]);

        validateTime(hour, minute);

        Integer dayOfWeek = DAY_OF_WEEK_MAP.get(dayOfWeekInput);
        if (dayOfWeek == null) {
            throw new IllegalArgumentException("无效的星期输入");
        }
        // Cron格式: 秒 分 时 日 月 星期
        return String.format("0 %d %d ? * %d", minute, hour, dayOfWeek);
    }

    /**
     * 生成按月执行的Cron表达式
     */
    private static String scannerMonthlyCron(Scanner scanner) {
        System.out.println("请输入每月的第几天 (1-31)，或输入 'L' 表示最后一天:");
        String dayInput = scanner.nextLine().trim();
        String response = "";
        int dayOfMonth;
        if (!"L".equalsIgnoreCase(dayInput)) {
            try {
                dayOfMonth = Integer.parseInt(dayInput);
                if (dayOfMonth < 1 || dayOfMonth > 31) {
                    throw new IllegalArgumentException("日期必须在1-31之间");
                }
                // 对于29、30、31日，提示用户可能的问题
                if (dayOfMonth >= 29) {
                    System.out.println("注意: 选择" + dayOfMonth + "日可能导致在某些月份（如2月）不执行任务。");
                    System.out.println("是否希望使用当月最后一天代替? (y/n)");
                    response = scanner.nextLine().trim();
                }
            } catch (NumberFormatException e) {
                throw new IllegalArgumentException("请输入有效的数字(1-31)或'L'表示最后一天");
            }
        }
        System.out.println("请输入执行时间 (格式: HH:mm，如 02:00):");
        String time = scanner.nextLine();
        return generateMonthlyCron(dayInput, response, time);
    }

    /**
     * 生成按月执行的Cron表达式
     *
     * @param dayInput 请输入有效的数字(1-31)或'L'表示最后一天
     * @param response 对于29、30、31日 是否进行转换为最后一天 'L'
     * @param time     执行时间 HH:mm 格式
     */
    private static String generateMonthlyCron(String dayInput, String response, String time) {

        boolean useLastDay = false;
        int dayOfMonth = 1;

        if ("L".equalsIgnoreCase(dayInput)) {
            useLastDay = true;
        } else {
            try {
                dayOfMonth = Integer.parseInt(dayInput);
                if (dayOfMonth < 1 || dayOfMonth > 31) {
                    throw new IllegalArgumentException("日期必须在1-31之间");
                }
                // 对于29、30、31日，提示用户可能的问题
                if (dayOfMonth >= 29) {
                    if ("y".equalsIgnoreCase(response) || "是".equalsIgnoreCase(response)) {
                        useLastDay = true;
                    }
                }
            } catch (NumberFormatException e) {
                throw new IllegalArgumentException("请输入有效的数字(1-31)或'L'表示最后一天");
            }
        }

        String[] parts = splitTime(time);

        int hour = Integer.parseInt(parts[0]);
        int minute = Integer.parseInt(parts[1]);

        validateTime(hour, minute);

        // Cron格式: 秒 分 时 日 月 星期
        if (useLastDay) {
            return String.format("0 %d %d L * ?", minute, hour);
        } else {
            return String.format("0 %d %d %d * ?", minute, hour, dayOfMonth);
        }
    }

    private static String[] splitTime(String time) {
        String[] parts = time.split(":");
        if (parts.length != 2) {
            throw new IllegalArgumentException("时间格式不正确，请使用 HH:mm 格式");
        }
        return parts;
    }

    /**
     * 验证时间格式是否正确
     */
    private static void validateTime(int hour, int minute) {
        if (hour < 0 || hour > 23) {
            throw new IllegalArgumentException("小时必须在0-23之间");
        }
        if (minute < 0 || minute > 59) {
            throw new IllegalArgumentException("分钟必须在0-59之间");
        }
    }

}
Cron表达式与CronTrigger
Top5软件工程硕士，先后在京东、字节从事多年Java后端开发、实时和离线大数据开发
05-21 3237
如果你需要的是基于日历表示法的调度，而不是基于指定间隔的简单调度，那么CronTrigger比SimpleTrigger更合适。 使用CronTrigger，你可以配置这样的调度：“每周五的中午”，或者“每个工作日的上午9:30”，或者“在一月的每个周一、周三和周五的上午9点到10点之间每隔5分钟”。 与SimpleTrigger一样，CronTrigger需要设置startT
quartz表达式cron_测试Quartz Cron表达式
04-24 490
quartz表达式cron 声明复杂的Cron表达式仍然让我有些头疼，尤其是在使用一些更高级的构造时。 毕竟，您能否确定以下触发器何时触发'0 0 17 L-3W 6-9 ? *' '0 0 17 L-3W 6-9 ? *' ？ 由于触发器通常打算在将来运行，因此需要事先对其进行测试，并确保它们会在我们认为会触发时真正触发。 Quartz Scheduler （我正在测试版本2.1.6）不提...
测试Quartz Cron表达式
03-30 526
声明复杂的Cron表达式仍然让我有些头疼，尤其是当使用一些更高级的构造时。 毕竟，您能否确定以下触发器何时触发'0 0 17 L-3W 6-9 ? *' '0 0 17 L-3W 6-9 ? *' ？ 由于触发器通常打算在将来运行，因此需要预先对其进行测试，并确保它们会在我们认为会触发的情况下真正触发。 Quartz Scheduler （我正在测试版本2.1.6）不提供对此的直接支持，但是...
掌握Quartz框架中cron表达式的时间调度
weixin_35749796的博客
05-20 1192
在现代的IT行业，任务调度是一项不可或缺的服务，它能够在预定的时间自动执行任务，从数据备份到定时的系统报告生成，任务调度器为各种定时操作提供了解决方案。Quartz作为一个功能丰富的任务调度器，已经成为众多Java应用程序的首选工具。本章节将对Quartz框架进行基础性介绍，包括其定义、核心组件及其在应用程序中的作用。Quartz框架是一个开源的作业调度库，可以集成到几乎任何Java应用程序中——从最简单的独立应用程序到大型电子商务系统。
Quartz及Cron表达式
weiruoao的专栏
07-02 1万+
Quartz     Quartz是一个完全由java编写的开源作业调度框架.     Quartz最主要的功能就是调度器(完成定时任务)，可以与javaEE或者javaSE应用程序相结合也可以单独使用。     Quartz能借助关系数据库和JDBC作业存储支持集群，负载均衡。   Spring Quartz     Spring中继承并简化了Quartz, 我们可以通过配置Spri
SpringBoot定时任务：@Scheduled注解与Cron表达式
程序媛学姐的博客
03-12 3420
SpringBoot的定时任务框架提供了强大而灵活的调度能力，通过@Scheduled注解和Cron表达式，开发者可以轻松实现从简单到复杂的各种定时任务需求。合理配置线程池和任务调度器是构建高效可靠定时任务系统的基础，而动态任务管理机制则为系统提供了更大的灵活性。在实际应用中，应遵循定时任务的最佳实践，确保任务的幂等性、高效性和可靠性。通过本文介绍的技术和实践，开发者可以构建出稳定可靠的定时任务系统，满足企业级应用的各种调度需求，包括数据维护、报表生成、系统监控等场景，为用户提供更加优质的服务体验。
Quartz定时器CRON表达式自动生成工具实战应用
最新发布
weixin_42453228的博客
09-28 685
Quartz是一个功能强大且广泛使用的开源作业调度框架，专为Java应用程序提供灵活、可靠的定时任务管理能力。它通过JobTrigger和Scheduler三大核心组件的协同工作，实现了任务定义与执行时机的解耦。相较于Java内置的Timer和，Quartz支持持久化存储、分布式集群部署、丰富的触发策略（如CRON表达式），并具备强大的容错机制（如Misfire处理），适用于高可用的企业级调度场景。// 示例：最简单的Quartz调度逻辑")).build();
cron表达式验证
热门推荐
lisheng19870305的专栏
09-25 2万+
写完cron表达式后，要验证下正确性在提交到配置文件中，下面发个简单的测试验证代码（含quartz包的项目就可以执行），如下： 需要下载 quartz-all-1.6.0.jar package com.cron.test; import java.text.ParseException; import java.text.SimpleDateFormat; import j...
掌握cron表达式：定时任务调度的利器
weixin_31749299的博客
06-07 1803
cron表达式是UNIX/Linux系统中用于安排计划任务的一种标准格式。它由6或7个空格分隔的时间字段组成，可以精确地定义任务的执行时间点或执行频率。在众多领域中，如系统维护、数据备份、日志轮转、定时报告等场景都有广泛应用。Cron表达式是一种基于时间的作业调度器，用于编写复杂的调度计划。一个标准的cron表达式由六或七个空格分隔的字段组成，每个字段代表时间的一个特定部分。如下所示，左至右分别是：分钟（0-59）小时（0-23）日（1-31）
Quartz Cron表达式生成器(.NET) 附上源码
07-21
`CronTrigger`类就是用来创建基于Cron表达式的触发器，你可以将生成的Cron表达式传递给`CronTrigger`的构造函数来创建触发器。 了解并使用Quartz Cron表达式生成器，可以帮助我们更高效地使用Quartz.NET进行定时...
quartz定时任务cron表达式
05-09
`CronTrigger`的构造函数通常接受cron表达式字符串作为参数。 在实际应用中，理解并熟练掌握cron表达式对于有效地配置和管理Quartz定时任务至关重要。它可以让你精确控制任务的执行时间，从而实现复杂的调度需求。...
深入理解Quartz Cron表达式：实例解析与源码分析
实例源码文件展示了如何构建一个直观的Web工具来解析和测试Cron表达式，同时也能使开发者更好地理解Cron表达式的构造和应用。掌握了这些知识点，就能高效地在项目中实施作业调度功能，使作业按照预定时间准确执行。
java 怎样校验cron表达式是否合法
06-06
在Java中，可以使用Quartz框架提供的CronExpression类来校验Cron表达式是否合法。该类是Quartz框架中的一个重要类，用于解析和管理Cron表达式。 下面是一个简单的Java方法，用于校验Cron表达式是否合法： ```java ...
IDEA-EasyYapi的使用（快速生成接口文档）
qq_41604890的博客
05-26 1万+
链接: EasyYapi官方文档. 下载插件 下载EasyYapi插件 重启IDEA，配置EasyYapi 获取token 使用 快捷键 Alt+insert 自定义参数，如 额外要求header中携带token 链接: demo. 文件名称为：.easy.api.config .不能少 #额外要求header中携带token method.additional.header[groovy:!it.hasAnn("com.xxx.xxx.Public")]={name: "token",
java集合构建成树形集合TreeUtil
qq_41604890的博客
03-13 4727
定义树形结构接口 import java.util.List; /** * 树形结构基础类 * @param <T> */ public interface BaseTree<T> { String getId(); void setId(String id); String getPid(); void setPid(String pid); List<T> getChildren(); void se
poi导出excel产生大量临时文件的问题
qq_41604890的博客
02-08 4171
参考链接: 生成excel时，SXSSFWorkbook POI 临时文件夹“poifiles”问题处理. poi3-9以下版本导出excel产生大量xml临时文件 方式一：通过升级POI版本，利用dispose释放资源删除临时文件 方式二：手动清除临时文件 临时文件目录 Windows ：C:\Windows\Temp\poifiles Linux: /tmp/poifiles 生成excel时，SXSSFWorkbook POI 临时文件夹“poifiles”问题处理 POI 生成文件时会根据“jav
PDManer数据库建模工具介绍
qq_41604890的博客
10-08 2342
PDManer元数建模，是一款多操作系统开源免费的桌面版关系数据库模型建模工具，相对于PowerDesigner，他具备界面简洁美观，操作简单，上手容易等特点。MySQL,PostgreSQL,Oracle,SQLServer等常见数据库。支持Hive，MaxCompute等大数据方向的数据库。支持达梦，GuassDB等国产数据库。用户还可以自行添加更多的数据库扩展。
java（注解+自定义参数校验） 实现敏感词汇过滤
qq_41604890的博客
01-26 2310
敏感词汇代码来自: https://github.com/elulis/sensitive-words. 导入依赖 <!-- hibernate校验依赖包--> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-validator</artifactId> <version>6.1.0.Final</version>
kkFileView
qq_41604890的博客
03-26 2286
kkFileView为文件文档在线预览解决方案
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值