Spring Cron Expression

本文详细介绍了CRON表达式的组成及特殊字符的意义,包括星号(*)、问号(?)、减号(-)、逗号(,)、斜杠(/)、大写字母L、小写字母W和井号(#)等,并提供了多个配置示例帮助理解。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

一、简介

CRON表达式是由6个或7个由空格分隔的元素组成的字符串,这些元素可以包含任何允许的值,以及该元素所允许的特殊字符的不同组合。元素如下:

1-1  CRON表达式允许的元素和值

元素

是否必须

允许的值

允许的特殊字符

Y

0-59

, - * /

分钟

Y

0-59

, - * /

小时

Y

0-23

, - * /

日期

Y

1-31

, - * ? / L W

月份

Y

1-12 或者 JAN-DEC

, - * /

星期

Y

1-7 或者 SUN-SAT

, - * ? / L #

年份

N

空 或者 1970-2199

, - * /

二、特殊字符说明

*:用来指定所有值。例如,如果元素分钟为“*”,那么就表示每一分钟;

?:用来表示无指定值。只有日期和星期这两个元素可以使用“?”。当你想要指定这两个元素中的一个元素的值时非常有用,因为日期和星期不能同时设值。例如,如果想在某个月特定的一天(比如10号)触发,但是不管那一天是星期几,则可以将元素日期的值设置为“10”,元素星期的值设置为“?”;

-:用来指定范围内的值。例如,元素小时为“10-12”,则表示10点、11点、12点;

,: 用来分隔一个元素的多个值。例如,元素星期为"MON,WED,FRI",则表示周一、周三和周五;

/:用来表示增量。例如,元素秒为“0/15”,则表示第0, 15秒,30秒以及45秒。 元素秒为“5/15, 则表示5秒,20,35秒以及50。 在"/"前指定“*”等价于在"/"前指定0作为起始值。对于表达式的每个元素都有数字范围,具体参见表1-1,"/"只是在给定值范围内每隔N触发。因此请特别注意,月份为"7/6",表示仅在7月份触发,并不是每6个月触发一次。斜杠前的数字表示起始值,后面的数字表示增量

L:只能用于“日期”和“星期”这两个元素。这个字符是“last”的缩写,但是对于这两个不同的元素,有着不同的含义。例如,对于日期元素,值“L”代表“这个月的最后一天”——1月份是31号,闰年的二月份是28号。如果“L”用于星期元素,则简单的表示“7”或者“SAT”;但是如果它跟在数字后面用于星期元素,则表示“这个月最后的XXX天”——例如“6L”或者“FRIL”都表示“这个月最后一个星期五”。你也可以从某个月的最后一天指定一个偏移量,例如“L-3”表示历月的倒数第3天。 注意,当使用选项“L”时,不要指定列表值或者范围值,否则结果会让你比较困惑。

W:用来指定离给定日期最近的工作日(星期一至星期五),只能用于日期元素。例如,15W,则表示离这个月15号最近的工作日。如果15号是星期六,那么触发器将会在14号星期五触发。如果15号是星期天,那么触发器将会在16号星期一触发。如果15号是星期二,那么它将在15号星期二触发。然而如果你指定“日期”元素的值为“1W”,并且1号是星期六,触发器将在3号星期一触发,它不会跨跃一个月的天数边界。只有当日期是单一的一天才能指定“W”,而不能是一个日期范围或者列表

#:只能用于元素星期。该字符用来指定这个月第N个星期X。例如“6#3”,它表示这个月第三个星期五(6 =星期五,"#3" =这个月第三个)。再如,“2#1”表示这个月第一个星期一, "4#5"表示这个月第五个星期四。注意如果你指定"#5"并且这个月没有5个给定的星期,那么这个月将不会触发。如果使用字符'#',元素星期只能使用一个表达式("3#1,6#3" 是无效的,因为有两个表达式)。#前面的数字代表星期几,后面的数字表示是第几个

三、配置示例

下面是CRON表达式的一些配置示例:

表达式

含义

0 0 12 * * ?

每天中午12:00触发

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:002:59,每分钟触发一次

0 0/5 14 * * ?

每天,从下午2:002:55,每五分钟触发一次

0 0/5 14,18 * * ?

每天,从下午2:002:55,每五分钟触发一次,并且从下午6:006:55,每五分钟触发一次

0 0-5 14 * * ?

每天,从下午2:002:05,每分钟触发一次

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, 2003, 2004以及2005年的每个月最后一个星期五上午10:15触发

0 15 10 ? * 6#3

每个月第三个星期五的上午10:15触发

0 0 12 1/5 * ?

每个月从第一天中午12:00开始,每5天触发一次

0 11 11 11 11 ?

每年1111日上午11:11触发

0 0 23-7/2,8 * * ?

晚上11点到早上8点之间每两个小时触发一次,早上八点触发一次

 

四、注意事项

1、 本文档基于Quartz 2.2.X

2、 支持范围溢出,即左边的值比右边的值大。例如,可以使用“22-2”来表示当天

晚上10点到第二天凌晨2, 或者也可以使用“NOV-FEB”。过度使用范围溢出来创建范围没有任何意义。

转载于:https://my.oschina.net/jackieyeah/blog/182091

### Spring Boot 动态 Cron 表达式实现定时任务 在 Spring Boot 中,动态更新 Cron 表达式的功能可以通过多种方法实现。以下是基于 Quartz 和 `@Scheduled` 注解两种常见的方式。 #### 方法一:使用 Quartz 实现动态 Cron 定时任务 Quartz 提供了一个强大的任务调度机制,支持运行时修改 Cron 表达式。要实现这一目标,需完成以下操作: 1. **引入 Quartz 依赖** 在项目的 `pom.xml` 文件中添加 Quartz 的 Maven 依赖[^1]。 ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-quartz</artifactId> </dependency> ``` 2. **创建 Job 类** 创建一个继承自 `Job` 接口的类,并重写其 `execute` 方法定义具体逻辑。 ```java import org.quartz.Job; import org.quartz.JobExecutionContext; public class MyDynamicJob implements Job { @Override public void execute(JobExecutionContext context) { System.out.println("动态定时任务正在执行..."); } } ``` 3. **配置 Scheduler 工厂并动态设置 Cron 表达式** 使用 `Scheduler` 对象手动触发任务调度,并允许通过 API 修改 Cron 表达式。 ```java import org.quartz.*; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.ApplicationListener; import org.springframework.context.event.ContextRefreshedEvent; import org.springframework.stereotype.Component; @Component public class DynamicCronConfigurer implements ApplicationListener<ContextRefreshedEvent> { @Autowired private Scheduler scheduler; @Override public void onApplicationEvent(ContextRefreshedEvent event) { try { updateJobWithNewCronExpression("0/5 * * * * ?"); } catch (Exception e) { throw new RuntimeException(e); } } public void updateJobWithNewCronExpression(String cronExpression) throws Exception { TriggerKey triggerKey = TriggerKey.triggerKey("myTrigger", "group1"); // 获取现有的触发器 CronTrigger trigger = (CronTrigger) scheduler.getTrigger(triggerKey); if (trigger == null) { createInitialJob(cronExpression); return; } String oldTime = trigger.getCronExpression(); if (!oldTime.equalsIgnoreCase(cronExpression)) { TriggerBuilder<Trigger> triggerBuilder = TriggerBuilder.newTrigger() .withIdentity(triggerKey) .withSchedule(CronScheduleBuilder.cronSchedule(cronExpression)); scheduler.rescheduleJob(triggerKey, triggerBuilder.build()); System.out.println("已成功更新 Cron 表达式:" + cronExpression); } } private void createInitialJob(String cronExpression) throws Exception { JobDetail jobDetail = JobBuilder.newJob(MyDynamicJob.class).withIdentity("job1", "group1").build(); Trigger trigger = TriggerBuilder.newTrigger().withIdentity("myTrigger", "group1") .startNow() .withSchedule(CronScheduleBuilder.cronSchedule(cronExpression)) .build(); scheduler.scheduleJob(jobDetail, trigger); System.out.println("初始任务已创建,Cron 表达式:" + cronExpression); } } ``` --- #### 方法二:使用 `@Scheduled` 注解配合动态刷新策略 如果不想引入额外的库,可以利用 Spring 自带的 `@Scheduled` 注解结合动态刷新机制来实现类似的动态 Cron 调度效果[^3]。 1. **启用定时任务** 在主程序入口处添加 `@EnableScheduling` 注解以开启定时任务支持[^2]。 ```java import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.scheduling.annotation.EnableScheduling; @SpringBootApplication @EnableScheduling public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` 2. **编写可动态调整的定时任务** 利用外部化配置文件(如 application.properties 或数据库表),存储当前生效的 Cron 表达式,并周期性读取该值进行校验和更新。 ```java import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Value; import org.springframework.scheduling.annotation.Scheduled; import org.springframework.stereotype.Component; @Component public class DynamicCronTask { private final Logger logger = LoggerFactory.getLogger(DynamicCronTask.class); @Value("${dynamic.cron.expression}") private String dynamicCronExpression; /** * 周期性检测 Cron 表达式变化 */ @Scheduled(fixedRate = 5000L) public void refreshCron() { logger.info("当前 Cron 表达式为 {}", dynamicCronExpression); } /** * 执行实际业务逻辑的任务 */ @Scheduled(cron = "${dynamic.cron.expression}") // 绑定到属性中的 Cron 表达式 public void performTask() { logger.info("动态定时任务被触发!"); } } ``` 3. **动态更改 Cron 表达式** 可以通过 RESTful API 更新应用上下文中对应的属性值,或者重启服务加载最新的配置项。 --- ### 总结 上述两种方式分别适用于不同场景需求: - 如果需要更复杂的功能扩展以及更高的灵活性,则推荐采用 Quartz 方案; - 若仅满足简单的动态 Cron 更改诉求,内置的 `@Scheduled` 即足以胜任。 问题
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值