manual:config:items:item:custom_intervals

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:config:items:item:custom_intervals [2017/01/03 10:56]
martins-v matching rules for empty higher/lower level filters
manual:config:items:item:custom_intervals [2020/03/12 11:58] (current)
martins-v contrasting frontend and API syntax
Line 1: Line 1:
-==== - #2 Custom intervals ====+==== 2 Custom intervals ====
  
 === Overview === === Overview ===
Line 39: Line 39:
 While the filter definitions are optional, at least one filter must be used. A filter must either have a range or the //<​step>//​ value defined. While the filter definitions are optional, at least one filter must be used. A filter must either have a range or the //<​step>//​ value defined.
  
-If a higher-level filter is empty, ​all values ​are matched. If a lower-level filter is empty, only '​0'​ is matched. For example, if the filter ​level is minutes - m30, then all hours are matched in the hour filter, but in the second filter ​only '​0' ​is matched.+An empty filter matches either '​0'​ if no lower-level filter is defined or all possible ​values ​otherwise. For example, if the hour filter is omitted ​then only '​0' ​hour will match, provided minute and seconds filters are omitted too, otherwise an empty hour filter will match all hour values.
  
 Valid ''<​from>''​ and ''<​to>''​ values for their respective filter prefix are:  Valid ''<​from>''​ and ''<​to>''​ values for their respective filter prefix are: 
Line 59: Line 59:
 Examples: Examples:
  
-^Interval^Description+^Interval^Will be executed
-|m0-59|execute ​every minute| +|m0-59|every minute| 
-|h9-17/2|execute ​every 2 hours starting with 9:00 (9:00, 11:00 ...)| +|h9-17/​2|every 2 hours starting with 9:00 (9:00, 11:00 ...)| 
-|m0,30 or m/30|execute ​hourly at hh:00 and hh:30|+|m0,30 or m/30|hourly at hh:00 and hh:30|
 |m0,​5,​10,​15,​20,​25,​30,​35,​40,​45,​50,​55 or m/5|every five minutes| |m0,​5,​10,​15,​20,​25,​30,​35,​40,​45,​50,​55 or m/5|every five minutes|
 |wd1-5h9|every Monday till Friday at 9:00| |wd1-5h9|every Monday till Friday at 9:00|
Line 69: Line 69:
 |md1h9m30|every 1st day of each month at 9:30| |md1h9m30|every 1st day of each month at 9:30|
 |md1wd1h9m30|every 1st day of each month at 9:30 if it is Monday| |md1wd1h9m30|every 1st day of each month at 9:30 if it is Monday|
-|h9m/30|execute ​at 9:00, 9:30| +|h9m/30|every day at 9:00, 9:30| 
-|h9m0-59/​30|execute ​at 9:00, 9:30| +|h9m0-59/​30|every day at 9:00, 9:30| 
-|h9,10m/30|execute ​at 9:00, 9:30, 10:00, 10:30| +|h9,10m/30|every day at 9:00, 9:30, 10:00, 10:30| 
-|h9-10m30|execute ​at 9:30, 10:30| +|h9-10m30|every day at 9:30, 10:30| 
-|h9m10-40/​30|execute ​at 9:10, 9:40| +|h9m10-40/​30|every day at 9:10, 9:40| 
-|h9,​10m10-40/​30|execute ​at 9:10, 9:40, 10:10, 10:40| +|h9,​10m10-40/​30|every day at 9:10, 9:40, 10:10, 10:40| 
-|h9-10m10-40/​30|execute ​at 9:10, 9:40, 10:10, 10:40| +|h9-10m10-40/​30|every day at 9:10, 9:40, 10:10, 10:40| 
-|h9m10-40|execute ​at 9:10, 9:11, 9:12, ... 9:40| +|h9m10-40|every day at 9:10, 9:11, 9:12, ... 9:40| 
-|h9m10-40/​1|execute ​at 9:10, 9:11, 9:12, ... 9:40| +|h9m10-40/​1|every day at 9:10, 9:11, 9:12, ... 9:40| 
-|h9-12,15|execute ​at 9:00, 10:00, 11:00, 12:00, 15:00| +|h9-12,15|every day at 9:00, 10:00, 11:00, 12:00, 15:00| 
-|h9-12,​15m0|execute ​at 9:00, 10:00, 11:00, 12:00, 15:00| +|h9-12,​15m0|every day at 9:00, 10:00, 11:00, 12:00, 15:00| 
-|h9-12,​15m0s30|execute ​at 9:00:30, 10:00:30, 11:00:30, 12:00:30, 15:00:30| +|h9-12,​15m0s30|every day at 9:00:30, 10:00:30, 11:00:30, 12:00:30, 15:00:30| 
-|h9-12s30|execute ​at 9:00:30, 9:01:30, 9:02:30 ... 12:58:30, 12:59:30| +|h9-12s30|every day at 9:00:30, 9:01:30, 9:02:30 ... 12:58:30, 12:59:30| 
-|h9m/​30;​h10|execute ​at 9:00, 9:30, 10:00|+|h9m/​30;​h10 ​(//​API-specific syntax//​)|every day at 9:00, 9:30, 10:00| 
 +|h9m/30\\ h10 (//add this as another row in frontend//)|every day at 9:00, 9:30, 10:00|