QuartZ Cron表達式

 

Cron Expressions

cron的表達式被用來配置CronTrigger實例。html

  cron的表達式是字符串,其實是由七子表達式,描述個別細節的時間表。java

  這些子表達式是分開的空白,表明:express

  1.         Seconds
  2.         Minutes
  3.         Hours
  4.         Day-of-Month
  5.         Month
  6.         Day-of-Week
  7.         Year (可選字段)

例  "0 0 12 ? * WED" 在每星期三下午12:00 執行,個別子表達式能夠包含範圍;dom

例如,在前面的例子裏("WED")能夠替換成 "MON-FRI", "MON, WED, FRI"甚至"MON-WED,SAT".「*」 表明整個時間段.socket

每個字段都有一套能夠指定有效值,如ide

Seconds (秒)         :能夠用數字0-59 表示,
Minutes(分)          :能夠用數字0-59 表示,
Hours(時)            :能夠用數字0-23表示,
Day-of-Month(天)    :能夠用數字1-31 中的任一一個值,但要注意一些特別的月份
Month(月)            :能夠用0-11 或用字符串  「JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV and DEC」 表示
Day-of-Week(每週)   :能夠用數字1-7表示(1 = 星期日)或用字符口串「SUN, MON, TUE, WED, THU, FRI and SAT」表示

 「*」:指定全部的值,好比,Minutes 設置爲 *,表示每分鐘ui

  「/」:爲特別單位,表示爲「每」如「0/15」表示每隔15分鐘執行一次,「0」表示爲從「0」分開始, 「3/20」表示表示每隔20分鐘執行一次,「3」表示從第3分鐘開始執行lua

 「?」:表示每個月的某一天,或第周的某一天spa

 「L」:用於每個月,或每週,表示爲每個月的最後一天,或每一個月的最後星期幾如「6L」表示「每個月的最後一個星期五」3d

 「W」:表示爲最近工做日,如「15W」放在每個月(day-of-month)字段上表示爲「到本月15日最近的工做日」

 「#」:是用來指定「的」每個月第n個工做日,例 在每週(day-of-week)這個字段中內容爲"6#3" or "FRI#3" 則表示「每個月第三個星期五」

注意:  Day-of-Month 和 Day-of-Week不可同時爲 * ,不然報錯:

 1 java.lang.RuntimeException: CronExpression '0/2 * * * * * *' is invalid.
 2 
 3     at org.quartz.CronScheduleBuilder.cronSchedule(CronScheduleBuilder.java:111)
 4     at quartz.QuartzExample.getTrigger(QuartzExample.java:110)
 5     at quartz.QuartzExample.run(QuartzExample.java:74)
 6     at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
 7     at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
 8     at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
 9     at java.lang.reflect.Method.invoke(Method.java:606)
10     at org.junit.runners.model.FrameworkMethod$1.runReflectiveCall(FrameworkMethod.java:50)
11     at org.junit.internal.runners.model.ReflectiveCallable.run(ReflectiveCallable.java:12)
12     at org.junit.runners.model.FrameworkMethod.invokeExplosively(FrameworkMethod.java:47)
13     at org.junit.internal.runners.statements.InvokeMethod.evaluate(InvokeMethod.java:17)
14     at org.junit.internal.runners.statements.RunBefores.evaluate(RunBefores.java:26)
15     at org.junit.runners.ParentRunner.runLeaf(ParentRunner.java:325)
16     at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:78)
17     at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:57)
18     at org.junit.runners.ParentRunner$3.run(ParentRunner.java:290)
19     at org.junit.runners.ParentRunner$1.schedule(ParentRunner.java:71)
20     at org.junit.runners.ParentRunner.runChildren(ParentRunner.java:288)
21     at org.junit.runners.ParentRunner.access$000(ParentRunner.java:58)
22     at org.junit.runners.ParentRunner$2.evaluate(ParentRunner.java:268)
23     at org.junit.runners.ParentRunner.run(ParentRunner.java:363)
24     at org.junit.runner.JUnitCore.run(JUnitCore.java:137)
25     at com.intellij.junit4.JUnit4IdeaTestRunner.startRunnerWithArgs(JUnit4IdeaTestRunner.java:68)
26     at com.intellij.rt.execution.junit.IdeaTestRunner$Repeater.startRunnerWithArgs(IdeaTestRunner.java:51)
27     at com.intellij.rt.execution.junit.JUnitStarter.prepareStreamsAndStart(JUnitStarter.java:242)
28     at com.intellij.rt.execution.junit.JUnitStarter.main(JUnitStarter.java:70)
29 Caused by: java.text.ParseException: Support for specifying both a day-of-week AND a day-of-month parameter is not implemented.
30     at org.quartz.CronExpression.buildExpression(CronExpression.java:511)
31     at org.quartz.CronExpression.<init>(CronExpression.java:276)
32     at org.quartz.CronScheduleBuilder.cronSchedule(CronScheduleBuilder.java:107)
33     ... 25 more
34 
35 Disconnected from the target VM, address: '127.0.0.1:61437', transport: 'socket'
36 
37 Process finished with exit code -1
RuntimeException

CronExpression 源碼:

protected void buildExpression(String expression) throws ParseException {
        expressionParsed = true;

        try {

            if (seconds == null) {
                seconds = new TreeSet<Integer>();
            }
            if (minutes == null) {
                minutes = new TreeSet<Integer>();
            }
            if (hours == null) {
                hours = new TreeSet<Integer>();
            }
            if (daysOfMonth == null) {
                daysOfMonth = new TreeSet<Integer>();
            }
            if (months == null) {
                months = new TreeSet<Integer>();
            }
            if (daysOfWeek == null) {
                daysOfWeek = new TreeSet<Integer>();
            }
            if (years == null) {
                years = new TreeSet<Integer>();
            }

            int exprOn = SECOND;

            StringTokenizer exprsTok = new StringTokenizer(expression, " \t",
                    false);

            while (exprsTok.hasMoreTokens() && exprOn <= YEAR) {
                String expr = exprsTok.nextToken().trim();

                // throw an exception if L is used with other days of the month
                if(exprOn == DAY_OF_MONTH && expr.indexOf('L') != -1 && expr.length() > 1 && expr.contains(",")) {
                    throw new ParseException("Support for specifying 'L' and 'LW' with other days of the month is not implemented", -1);
                }
                // throw an exception if L is used with other days of the week
                if(exprOn == DAY_OF_WEEK && expr.indexOf('L') != -1 && expr.length() > 1  && expr.contains(",")) {
                    throw new ParseException("Support for specifying 'L' with other days of the week is not implemented", -1);
                }
                if(exprOn == DAY_OF_WEEK && expr.indexOf('#') != -1 && expr.indexOf('#', expr.indexOf('#') +1) != -1) {
                    throw new ParseException("Support for specifying multiple \"nth\" days is not implemented.", -1);
                }
                
                StringTokenizer vTok = new StringTokenizer(expr, ",");
                while (vTok.hasMoreTokens()) {
                    String v = vTok.nextToken();
                    storeExpressionVals(0, v, exprOn);
                }

                exprOn++;
            }

            if (exprOn <= DAY_OF_WEEK) {
                throw new ParseException("Unexpected end of expression.",
                            expression.length());
            }

            if (exprOn <= YEAR) {
                storeExpressionVals(0, "*", YEAR);
            }

            TreeSet<Integer> dow = getSet(DAY_OF_WEEK);
            TreeSet<Integer> dom = getSet(DAY_OF_MONTH);

            // Copying the logic from the UnsupportedOperationException below
            boolean dayOfMSpec = !dom.contains(NO_SPEC);
            boolean dayOfWSpec = !dow.contains(NO_SPEC);

            if (!dayOfMSpec || dayOfWSpec) {
                if (!dayOfWSpec || dayOfMSpec) {
                    throw new ParseException(
                            "Support for specifying both a day-of-week AND a day-of-month parameter is not implemented.", 0);
                }
            }
        } catch (ParseException pe) {
            throw pe;
        } catch (Exception e) {
            throw new ParseException("Illegal cron expression format ("
                    + e.toString() + ")", 0);
        }
    }
CronExpression 部分代碼

1)Cron表達式的格式:秒 分 時 日 月 周 年(可選)。

     字段名                 容許的值                        容許的特殊字符  
     秒                         0-59                               , - * /  
     分                         0-59                               , - * /  
     小時                      0-23                               , - * /  
     日                         1-31                               , - * ? / L W C  
     月                         1-12 or JAN-DEC         , - * /  
     周幾                      1-7 or SUN-SAT           , - * ? / L C #  
     年 (可選字段)          empty, 1970-2099      , - * /

 

     「?」字符:表示不肯定的值

     「,」字符:指定數個值

   「-」字符:指定一個值的範圍

     「/」字符:指定一個值的增長幅度。n/m表示從n開始,每次增長m

     「L」字符:用在日表示一個月中的最後一天,用在周表示該月最後一個星期X

     「W」字符:指定離給定日期最近的工做日(週一到週五)

      「#」字符:表示該月第幾個周X。6#3表示該月第3個週五

 

2)Cron表達式範例:

 每隔5秒執行一次:*/5 * * * * ?
 每隔1分鐘執行一次:0 */1 * * * ?
 天天23點執行一次:0 0 23 * * ?
 天天凌晨1點執行一次:0 0 1 * * ?
 每個月1號凌晨1點執行一次:0 0 1 1 * ?
 每個月最後一天23點執行一次:0 0 23 L * ?
 每週星期天凌晨1點實行一次:0 0 1 ? * L
 在26分、29分、33分執行一次:0 26,29,33 * * * ?
 天天的0點、13點、18點、21點都執行一次:0 0 0,13,18,21 * * ?
天天的7點到21點都執行一次:0 0 7-21 * * ?

 

          

 

 轉載自:http://www.cnblogs.com/sunjie9606/archive/2012/03/15/2397626.html 

相關文章
相關標籤/搜索