CronTrigger 構造器
String name, //觸發器名稱
String group, //觸發器的組名
String jobName, //job名稱
String jobGroup, //job的組名
Date startTime, //開始時間
Date endTime, //結束時間
String cronExpression, //克隆表達式
TimeZone timeZone)//時區
還有一些其它參數少一些的構造器,參考JavaDoc。通常我們如下簡單地使用CronTrigger;
Trigger trigger = new CronTrigger("trigger1", "group1");//設置觸發器名稱和組名
trigger.setCronExpression("0 0 15 * * ?");//設置克隆表達式
克隆表達式
一個克隆表達式是一個由空白間隔6個或者7個字段的字符串。
格式:
字段名 | 必須有 | 值范圍 | 允許的特殊字符 |
---|---|---|---|
Seconds | YES | 0-59 | , - * / |
Minutes | YES | 0-59 | , - * / |
Hours | YES | 0-23 | , - * / |
Day of month | YES | 1-31 | , - * ? / L W C |
Month | YES | 1-12 or JAN-DEC | , - * / |
Day of week | YES | 1-7 or SUN-SAT | , - * ? / L C # |
Year | NO | empty, 1970-2099 | , - * / |
例子:
* * * * ? *
0 0/5 14,18,3-39,52 ? JAN,MAR,SEP MON-FRI 2002-2010
特殊字符
- * 表示所有值 ;
- ? 表示未說明的值,即不關心它為何值;
- - 表示一個指定的范圍;
- , 表示附加一個可能值;
- / 符號前表示開始時間,符號后表示每次遞增的值;
- L ("last") "L" 用在day-of-month字段意思是 "這個月最后一天";用在 day-of-week字段, 它簡單意思是"7" or "SAT"。 如果在day-of-week字段里和數字聯合使用,它的意思就是 "這個月的最后一個星期幾"– 例如: "6L" means "這個月的最后一個星期五". 當我們用“L”時,不指明一個列表值或者范圍是很重要的,不然的話,我們會得到一些意想不到的結果。
- W ("weekday") –只能用在day-of-month字段。用來描敘最接近指定天的工作日(周一到周五)。例如:在day-of-month字段用“15W”指“最接近這個月第15天的工作日”,即如果這個月第15天是周六,那么觸發器將會在這個月第14天即周五觸發;如果這個月第15天是周日,那么觸發器將會在這個月第16天即周一觸發;如果這個月第15天是周二,那么就在觸發器這天觸發。注意一點:這個用法只會在當前月計算值,不會越過當前月。“W”字符僅能在day-of-month指明一天,不能是一個范圍或列表。
也可以用“LW”來指定這個月的最后一個工作日。 - # -只能用在day-of-week字段。用來指定這個月的第幾個周幾。例:在day-of-week字段用"6#3"指這個月第3個周五(6指周五,3指第3個)。如果指定的日期不存在,觸發器就不會觸發。
- C ("calendar") – 指和calendar聯系后計算過的值。例:在day-of-month 字段用“5C”指在這個月第5天或之后包括calendar的第一天;在day-of-week字段用“1C”指在這周日或之后包括calendar的第一天。
在MONTH和Day of week字段里對字母大小寫不敏感。
實例
表達式 | 意思(觸發時刻) |
---|---|
0 0 12 * * ? | 每天中午12點 |
0 15 10 * * ? 2005 | 在2005年的每天10:25 |
0 10,44 14 ? 3 WED | 在3月里每個周三的14:10和14:44 |
0 15 10 ? * 6L 2002-2005 | 從2002年到2005年里,每個月的最后一個星期五的10:15 |
0 0 12 1/5 * ? | 從當月的第一天開始,然后在每個月每隔5天的12:00 |
0 15 10 ? * 6#3 | 每個月第3個周五的10:15 |
注意在day-of-week和day-of-month字段里使用“?”和“*”的效果。
注意對“C”的支持並不很完全。
對在day-of-week字段 和在day-of-month字段同時使用也不是很完全(目前你必須在這兩個字段中的一個用“?”指定)。
當設置在午夜和凌晨1點之間觸發時要仔細。
不觸發指令:
MISFIRE_INSTRUCTION_FIRE_ONCE_NOW
MISFIRE_INSTRUCTION_DO_NOTHING