Quartz时间格式配置说明

本文详细解析了CRON表达式的各个字段含义及其允许的特殊字符,并通过具体示例介绍了如何使用这些字段来精确地安排任务执行的时间。

字段      允许值         允许的特殊字符  

             0-59        , - * /  

             0-59        , - * /  

小时        0-23        , - * /  

日期        1-31        , - * ? / L W C  

月份        1-12 或者 JAN-DEC         , - * /  

星期        1-7 或者 SUN-SAT      , - * ? / L C #  

年(可选)       留空, 1970-2099       , - * /  

 

通配符说明:

* 表示所有值. 例如:在分的字段上设置 "*",表示每一分钟都会触发。

? 表示不指定值。使用的场景为不需要关心当前设置这个字段的值。例如:要在每月的10号触发一个操作,但不关心是周几,所以需要周位置的那个字段设置为"?" 具体设置为 0 0 0 10 * ?

- 表示区间。例如 在小时上设置 "10-12",表示 10,11,12点都会触发。

, 表示指定多个值,例如在周字段上设置 "MON,WED,FRI" 表示周一,周三和周五触发

/ 用于递增触发。如在秒上面设置"5/15" 表示从5秒开始,每增15秒触发(5,20,35,50)。在月字段上设置'1/3'所示每月1号开始,每隔三天触发一次。

L 表示最后的意思。在日字段设置上,表示当月的最后一天(依据当前月份,如果是二月还会依据是否是润年[leap]), 在周字段上表示星期六,相当于"7""SAT"。如果在"L"前加上数字,则表示该数据的最后一个。例如在周字段上设置"6L"这样的格式,则表示“本月最后一个星期五"

W 表示离指定日期的最近那个工作日(周一至周五). 例如在日字段上设置"15W",表示离每月15号最近的那个工作日触发。如果15号正好是周六,则找最近的周五(14)触发, 如果15号是周未,则找最近的下周一(16)触发.如果15号正好在工作日(周一至周五),则就在该天触发。如果指定格式为 "1W",它则表示每月1号往后最近的工作日触发。如果1号正是周六,则将在3号下周一触发。(注,"W"前只能设置具体的数字,不允许区间"-").

 

小提示

'L' 'W'可以一组合使用。如果在日字段上设置"LW",则表示在本月的最后一个工作日触发(一般指发工资 )

 

 

# 序号(表示每月的第几个周几),例如在周字段上设置"6#3"表示在每月的第三个周六.注意如果指定"#5",正好第五周没有周六,则不会触发该配置(用在母亲节和父亲节再合适不过了)

 

小提示

周字段的设置,若使用英文字母是不区分大小写的 MON mon相同.

 

 

 

     

常用示例:

 

 

0 0 12 * * ? 每天12点触发

0 15 10 ? * * 每天1015分触发

0 15 10 * * ? 每天1015分触发

0 15 10 * * ? * 每天1015分触发

0 15 10 * * ? 2005 2005年每天1015分触发

0 * 14 * * ? 每天下午的 2点到259分每分触发

0 0/5 14 * * ? 每天下午的 2点到259(整点开始,每隔5分触发)

0 0/5 14,18 * * ? 每天下午的 2点到259(整点开始,每隔5分触发)

每天下午的 18点到1859(整点开始,每隔5分触发)

 

0 0-5 14 * * ? 每天下午的 2点到205分每分触发

0 10,44 14 ? 3 WED     3月分每周三下午的 210分和244分触发 (特殊情况,在一个时间设置里,执行两次或                                                             两次以上的情况)

0 59 2 ? * FRI    每周5凌晨259分触发;

0 15 10 ? * MON-FRI 从周一到周五每天上午的1015分触发

0 15 10 15 * ? 每月15号上午1015分触发

0 15 10 L * ? 每月最后一天的1015分触发

0 15 10 ? * 6L 每月最后一周的星期五的1015分触发

0 15 10 ? * 6L 2002-2005 2002年到2005年每月最后一周的星期五的1015分触发

0 15 10 ? * 6#3 每月的第三周的星期五开始触发

0 0 12 1/5 * ? 每月的第一个中午开始每隔5天触发一次

0 11 11 11 11 ? 每年的1111 1111分触发(光棍节


转载于:https://my.oschina.net/swchenml/blog/487640

Quartz 框架中,`CronTrigger` 是用于定义基于 cron 表达式触发任务的机制。`CronTrigger` 提供了灵活的时间调度方式,允许开发者通过 cron 表达式精确控制任务的执行时间。 `CronTrigger` 的核心配置主要通过 `CronScheduleBuilder` 来完成,该类提供了多种方法用于构建 cron 调度策略。常见的配置包括指定 cron 表达式、时区、是否可错过触发(misfire handling)等。以下是一个典型的 `CronTrigger` 构建示例: ```java CronTrigger cronTrigger = TriggerBuilder.newTrigger() .withIdentity("trigger1", "group1") .withSchedule(CronScheduleBuilder.cronSchedule("0 0/5 * * * ?")) .build(); ``` 在上述代码中,`CronScheduleBuilder.cronSchedule("0 0/5 * * * ?")` 指定了一个每 5 分钟执行一次的任务调度规则。此 cron 表达式由六个或七个字段组成(可选年份),分别表示秒、分、小时、日、月、周几和年(可选)[^2]。 此外,`CronTrigger` 还支持配置时区,以确保任务在指定的地理区域时间执行。例如: ```java CronScheduleBuilder.cronSchedule(TimeZone.getTimeZone("America/New_York"), "0 0/5 * * * ?") ``` 对于 misfire 情况的处理,Quartz 提供了多种策略,如 `MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY`、`MISFIRE_INSTRUCTION_FIRE_ONCE_NOW` 等。这些策略可以通过 `withMisfireHandlingInstruction` 方法应用到 `CronTrigger` 上。 ### Cron 表达式语法 Quartz 的 cron 表达式语法支持多个特殊字符,包括星号(*)、问号(?)、连字符(-)、斜杠(/)、逗号(,)和 L、W、# 等特定字符。这些特殊字符允许定义复杂的调度逻辑,例如: - 星号(*)表示任意值。 - 问号(?)表示不指定值,通常用于日和周几字段中,以避免冲突。 - 连字符(-)定义一个值的范围。 - 斜杠(/)定义递增的步长。 - 逗号(,)列出多个值。 - L 表示最后一天或最后一个星期几。 - W 表示最近的工作日。 - # 用于指定第几个星期几。 例如,表达式 `0 0 12 ? * SUN#2` 表示“每个月的第二个星期日的中午 12:00”执行任务。 ### 在线 Cron 表达式生成器 为了简化 cron 表达式的编写过程,可以使用在线 cron 表达式生成器工具。这些工具通常提供图形界面,让用户选择时间参数,然后自动生成相应的 cron 表达式。这有助于减少手动编写时可能出现的错误,并提高开发效率。 ### Quartz 与 Spring Boot 整合 当 Quartz 与 Spring Boot 整合时,可以通过配置类来定义 `CronTrigger`。在 Spring Boot 中,通常会创建一个配置类,使用 `@Bean` 注解来声明 `CronTrigger` 实例。例如: ```java @Configuration public class QuartzConfig { @Bean public CronTrigger cronTrigger(JobDetail jobDetail) { return TriggerBuilder.newTrigger() .forJob(jobDetail) .withIdentity("cronTrigger", "group1") .withSchedule(CronScheduleBuilder.cronSchedule("0 0/5 * * * ?")) .build(); } } ``` 在上述配置中,`jobDetail` 是一个已经定义好的 `JobDetail` 对象,它指定了要执行的任务类。通过这种方式,可以将 `CronTrigger` 与具体的任务关联起来,并在 Spring Boot 应用程序启动时自动注册到 Quartz 调度器中。 ### 数据库支持 Quartz 支持将任务和触发器的信息存储在数据库中,以便在应用程序重启后仍然能够保留任务状态。为此,需要预先创建一系列数据库表,这些表共同支撑了 Quartz 的任务调度功能,既支持单机调度,也支持分布式集群环境。[^3] 在 Spring Boot 项目中,除了需要添加 Quartz 的 Maven 依赖外,还需要配置数据源和 Quartz 的相关属性。通常会在 `application.properties` 文件中配置数据源信息,并在 `quartz.properties` 文件中设置 Quartz 的调度器参数。例如: ```properties # application.properties spring.datasource.url=jdbc:mysql://localhost:3306/quartz_db spring.datasource.username=root spring.datasource.password=root spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver # quartz.properties org.quartz.scheduler.instanceName=MyScheduler org.quartz.threadPool.threadCount=10 org.quartz.jobStore.class=org.quartz.impl.jdbcjobstore.JobStoreTX org.quartz.jobStore.driverDelegateClass=org.quartz.impl.jdbcjobstore.StdJDBCDelegate org.quartz.jobStore.dataSource=myDS org.quartz.jobStore.tablePrefix=QRTZ_ org.quartz.dataSource.myDS.driver=com.mysql.cj.jdbc.Driver org.quartz.dataSource.myDS.URL=jdbc:mysql://localhost:3306/quartz_db org.quartz.dataSource.myDS.user=root org.quartz.dataSource.myDS.password=root org.quartz.dataSource.myDS.maxConnections=5 ``` 通过上述配置Quartz 将使用 MySQL 数据库来持久化任务和触发器信息,从而实现任务状态的持久化存储。 ### 示例输出日志 当 Quartz 调度器成功启动并开始执行任务时,控制台会输出类似以下的日志信息: ``` [main] INFO org.quartz.impl.StdSchedulerFactory - Quartz scheduler version: 2.3.0 1633149326723 任务执行。。。 Sat Oct 02 12:35:26 CST 2021 Sat Oct 02 12:36:26 CST 2021 [main] INFO org.quartz.core.QuartzScheduler - Scheduler DefaultQuartzScheduler_$_NON_CLUSTERED started. ``` 这些日志信息表明调度器已经正确启动,并且任务正在按照预定的时间表执行。 ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值