一个Cron-表达式是一个由六至七个字段组成由空格分隔的字符串,其中6个字段是必须的而一个是可选的,如下:
--------------------------------------------------------------------------------
字段名 允许的值 允许的特殊字符
--------------------------------------------------------------------------------
秒 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 , - * /
--------------------------------------------------------------------------------
写时从左到右分别表示秒分时日月周年
'*' 字符可以用于所有字段,在“分”字段中设为"*"表示"每一分钟"的含义。
'?' 字符可以用在“日”和“周几”字段. 它用来指定 '不明确的值'. 这在你需要指定这两个字段中的某一个值而不是另外一个的时候会被用到。在后面的例子中可以看到其含义。
'-' 字符被用来指定一个值的范围,比如在“小时”字段中设为"10-12"表示"10点到12点".
',' 字符指定数个值。比如在“周几”字段中设为"MON,WED,FRI"表示"the days Monday, Wednesday, and Friday".
'/' 字符用来指定一个值的的增加幅度. 比如在“秒”字段中设置为"0/15"表示"第0, 15, 30, 和 45秒"。而 "5/15"则表示"第5, 20, 35, 和 50". 在'/'前加"*"字符相当于指定从0秒开始. 每个字段都有一系列可以开始或结束的数值。对于“秒”和“分”字段来说,其数值范围为0到59,对于“小时”字段来说其为0到23, 对于“日”字段来说为0到31, 而对于“月”字段来说为1到12。"/"字段仅仅只是帮助你在允许的数值范围内从开始"第n"的值。 因此 对于“月”字段来说"7/6"只是表示7月被开启而不是“每六个月”, 请注意其中微妙的差别。
'L'字符可用在“日”和“周几”这两个字段。它是"last"的缩写, 但是在这两个字段中有不同的含义。例如,“日”字段中的"L"表示"一个月中的最后一天" —— 对于一月就是31号对于二月来说就是28号(非闰年)。而在“周几”字段中, 它简单的表示"7" or "SAT",但是如果在“周几”字段中使用时跟在某个数字之后, 它表示"该月最后一个星期×" —— 比如"6L"表示"该月最后一个周五"。当使用'L'选项时,指定确定的列表或者范围非常重要,否则你会被结果搞糊涂的。
'W'字符可用于“日”字段。用来指定离给定日期最近的工作日(周一到周五) 。比如你将“日”字段设为"15W",意为: "离该月15号最近的工作日"。因此如果15号为周六,触发器会在14号即周五调用。如果15号为周日, 触发器会在16号也就是周一触发。如果15号为周二,那么当天就会触发。然而如果你将“日”字段设为"1W", 而一号又是周六, 触发器会于下周一也就是当月的3号触发,因为它不会越过当月的值的范围边界。'W'字符只能用于“日”字段的值为单独的一天而不是一系列值的时候。
'L'和'W'可以组合用于“日”字段表示为'LW',意为"该月最后一个工作日"。
'#' 字符可用于“周几”字段。该字符表示“该月第几个周×”,比如"6#3"表示该月第三个周五( 6表示周五而"#3"该月第三个)。再比如: "2#1" = 表示该月第一个周一而 "4#5" = 该月第五个周三。注意如果你指定"#5"该月没有第五个“周×”,该月是不会触发的。
'C' 字符可用于“日”和“周几”字段,它是"calendar"的缩写。 它表示为基于相关的日历所计算出的值(如果有的话)。如果没有关联的日历, 那它等同于包含全部日历。“日”字段值为"5C"表示"日历中的第一天或者5号以后",“周几”字段值为"1C"则表示"日历中的第一天或者周日以后"。
对于“月份”字段和“周几”字段来说合法的字符都不是大小写敏感的。
下面是一些完整的例子:
------------------------------------------------------------------------------------------
表达式 含义
------------------------------------------------------------------------------------------
"0 0 12 * * ?" 每天中午十二点触发
"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点开始到2点59分每分钟一次触发
"0 0/5 14 * * ?" 每天从下午2点开始到2:55分结束每5分钟一次触发
"0 0/5 14,18 * * ?" 每天的下午2点至2:55和6点至6点55分两个时间段内每5分钟一次触发
"0 0-5 14 * * ?" 每天14:00至14:05每分钟一次触发
"0 10,44 14 ? 3 WED" 三月的每周三的14:10和14: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" 每月最后一个周五的10:15触发
"0 15 10 ? * 6L 2002-2005" 2002年至2005年的每月最后一个周五的10:15触发
"0 15 10 ? * 6#3" 每月的第三个周五的10:15触发
------------------------------------------------------------------------------------------
文章出处:http://wenku.baidu.com/view/1c2d1f1ec5da50e2524d7f7e.html
后续部分是我自己写的JS验证Cron表达式的代码,其中有些不太严格
1,“,”表示枚举某些值,这里没有验证重复
2,"-"前后其实是有大小关系的,没有验证
检验函数,js正则进行验证!
this.checkCron = function(element, hasFrame, hasTitle){ var value=element.value; //传递过来真正要验证的字符串 if(value!=""){ value=value.replace(/(^\s*)|(\s*$)/g, ""); //去掉前后空白 var arr=value.split(/\s+/); //用空白分割 if(arr.length!=6 && arr.length!=7){ showError(element, "表达式必须是 由5个或者6个空格隔开,如 0 0 12 * * ?", hasFrame, hasTitle); return false; } else{ // 为了清晰起见,我将规则拆分来写 var reg1=/^([0-5]?\d)([\/\-][0-5]?\d)?$/; //形如23 23/34 45-59 var reg2=/^[0-5]?\d(,[0-5]?\d)*$/ ; //形如 12,43,56 var reg3=/^\*$/; //匹配 * if(!(reg1.test(arr[0])||reg2.test(arr[0])||reg3.test(arr[0]))){ showError(element, "第1位是秒,允许的值(0-59 ,-*/)如 (2,47,23-45,5/6)", hasFrame, hasTitle); return false; } if(!(reg1.test(arr[1])||reg2.test(arr[1])||reg3.test(arr[1]))){ showError(element, "第2位是分,允许的值(0-59 ,-*/)如 (2,47,23-45,5/6)", hasFrame, hasTitle); return false; } //reg1=/^(([0-1]?\d)|(2[0-3]))$/; //ok的 0-23 注意最外层有一个括号 reg1=/^(([0-1]?\d)|(2[0-3]))([\/\-](([0-1]?\d)|(2[0-3])))?$/; //形如23 12/18 7-19 reg2=/^(([0-1]?\d)|(2[0-3]))(,(([0-1]?\d)|(2[0-3])))*$/; //形如12,15,20 if(!(reg1.test(arr[2])||reg2.test(arr[2])||reg3.test(arr[2]))){ showError(element, "第3位是小时,允许的值(0-23 ,-*/)如 (3,8,21-23,4/7,*)", hasFrame, hasTitle); return false; } //reg1=/^(([1-9])|([12]\d)|(3[01]))$/; ok 1-31 reg1=/^(([1-9])|([12]\d)|(3[01]))([\/\-](([1-9])|([12]\d)|(3[01])))?$/; //形如1 12/18 7-26 reg2=/^(([1-9])|([12]\d)|(3[01]))(,(([1-9])|([12]\d)|(3[01])))*$/; //形如23,25,30 reg3=/^(\*|\?)$/; //形如 * ? var reg4=/^(((([1-9])|([12]\d)|(3[01]))[WC])|(LW?))$/; //形如12W 13C L LW if(!(reg1.test(arr[3])||reg2.test(arr[3])||reg3.test(arr[3])||reg4.test(arr[3]))){ showError(element, "第4位是日,允许的值(1-31 ,-*/?L W C)如 (1,20,4-8,3/5,2C,8W,L,LW等)", hasFrame, hasTitle); return false; } //reg1=/^(([1-9])|(1[0-2]))$/; ok 1-12 reg1=/^(([1-9])|(1[0-2]))([\/\-](([1-9])|(1[0-2])))?$/; //形如1 3/6 7-10 reg2=/^(([1-9])|(1[0-2]))(,(([1-9])|(1[0-2])))*$/ ; //形如3,5,8 reg3=/^\*$/; //形如 * reg4=/^((JAN)|(FEB)|(MAR)|(APR)|(MAY)|(JUN)|(JUL)|(AUG)|(SEPT)|(OCT)|(NOV)|(DEC))(\-((JAN)|(FEB)|(MAR)|(APR)|(MAY)|(JUN)|(JUL)|(AUG)|(SEPT)|(OCT)|(NOV)|(DEC)))?$/i; //12个月份 var reg5=/^((JAN)|(FEB)|(MAR)|(APR)|(MAY)|(JUN)|(JUL)|(AUG)|(SEPT)|(OCT)|(NOV)|(DEC))(,((JAN)|(FEB)|(MAR)|(APR)|(MAY)|(JUN)|(JUL)|(AUG)|(SEPT)|(OCT)|(NOV)|(DEC)))*$/i; //12个月份 if(!(reg1.test(arr[4])||reg2.test(arr[4])||reg3.test(arr[4])||reg4.test(arr[4])||reg5.test(arr[4]))){ showError(element, "第5位是月,允许的值(1-12 ,-*/ JAN-DEC)如 (1,10,2-6,JAN,MAY-JUN等)", hasFrame, hasTitle); return false; } reg1=/^[1-7]([\/\-][1-7])?$/; //形如1 3/6 2-5 reg2=/^[1-7](,[1-7])*$/; //形如3,5,6 reg3=/^(\*|\?|L)$/; //形如 * ? L reg4=/^((MON)|(TUES)|(WED)|(THUR)|(FRI)|(SAT)|(SUN))([\-]((MON)|(TUES)|(WED)|(THUR)|(FRI)|(SAT)|(SUN)))?$/i; //形如 7个星期 -连接 reg5=/^((MON)|(TUES)|(WED)|(THUR)|(FRI)|(SAT)|(SUN))(,((MON)|(TUES)|(WED)|(THUR)|(FRI)|(SAT)|(SUN)))*$/i; //形如 7个星期 ,枚举 var reg6=/^[1-7][LC]$/; //形如 3L 4C var reg7=/^[1-7]?#[1-5]$/; //形如 #4 6#3 if(!(reg1.test(arr[5])||reg2.test(arr[5])||reg3.test(arr[5])||reg4.test(arr[5])||reg5.test(arr[5])||reg6.test(arr[5])||reg7.test(arr[5]))){ showError(element, "第6位是周儿,允许的值(1-7 ,-*/? L C # SUN-SAT)如 (1,2,1-5,?,3C,4L,4#2,SUN等)", hasFrame, hasTitle); return false; } if(arr.length==7){ //reg1=/^((19[7-9]\d)|(20\d\d))$/; // 1979-2099 reg1=/^((19[7-9]\d)|(20\d\d))([\/\-]((19[7-9]\d)|(20\d\d)))?$/; reg2=/^((19[7-9]\d)|(20\d\d))(,((19[7-9]\d)|(20\d\d)))*$/; reg3=/^(\*|(empty))$/i; if(!(reg1.test(arr[6])||reg2.test(arr[6])||reg3.test(arr[6]))){ showError(element, "第7位是年(可选字段),允许的值(empty,1979-2099 ,-*/)如 (2013,empty,2012,2013 2012-2013等)", hasFrame, hasTitle); return false; } } closeError(element); return element; } } else{ closeError(element); return element; } }
下面有一段代码是showError(),closeError()方法,其实这两个方法没有必要深究
showError = function(element, message, hasFrame, hasTitle){ var tdNode = closeError(element); var errorDiv = new Element("div", {id:'errorDiv'}); if(hasTitle==undefined||hasTitle){ errorDiv.innerHTML = getTitle(tdNode) + message; } else{ errorDiv.innerHTML = message; } tdNode.appendChild(errorDiv); if(hasFrame){ var errorFrame = new Element("iframe", {id:'errorFrame', scrolling:'no', width:errorDiv.offsetWidth, height:errorDiv.offsetHeight}); tdNode.appendChild(errorFrame); } } closeError = function(element){ var tdNode = getTdNode(element); var length = tdNode.childNodes.length; for(var i=length-1; i>=0; i--){ var node = tdNode.childNodes[i]; if(node.id=='errorFrame'){ tdNode.removeChild(node); i--; tdNode.removeChild(tdNode.childNodes[i]); } else if(node.id=='errorDiv'){ tdNode.removeChild(node); } } return tdNode; } getTdNode = function(element){ var tdNode = element.parentNode; while(tdNode.tagName.toLowerCase() != "td"){ tdNode = tdNode.parentNode; } return tdNode; }