Editing Cron (section)

==Cron expression==
A cron expression is a string comprising five or six fields separated by white space<ref>{{cite web|url=http://help.ubuntu.com/community/CronHowto |title=Ubuntu Cron Howto |publisher=Help.ubuntu.com |date=2013-05-04 |access-date=2013-11-06}}</ref> that represents a set of times, normally as a schedule to execute some routine.

Comments begin with a comment mark #, and must be on a line by themselves.

{| class="wikitable"
|-
! Field
! Required
! Allowed values
! Allowed special characters
! Remarks
|-
| Minutes
| {{Yes}}
| 0–59
| <code>*</code> <code>,</code> <code>-</code>
|
|-
| Hours
| {{Yes}}
| 0–23
| <code>*</code> <code>,</code> <code>-</code>
|
|-
| Day of month
| {{Yes}}
| 1–31
| <code>*</code> <code>,</code> <code>-</code> <code>?</code> <code>L</code> <code>W</code>
| <code>?</code> <code>L</code> <code>W</code> only in some implementations
|-
| Month
| {{Yes}}
| 1–12 or JAN–DEC
| <code>*</code> <code>,</code> <code>-</code>
|
|-
| Day of week
| {{Yes}}
| 0–6 or SUN–SAT
| <code>*</code> <code>,</code> <code>-</code> <code>?</code> <code>L</code> <code>#</code>
| <code>?</code> <code>L</code> <code>#</code> only in some implementations
|-
| Year
| {{No}}
| 1970–2099
| <code>*</code> <code>,</code> <code>-</code>
| This field is not supported in standard/default implementations.
|}

The month and weekday abbreviations are not case-sensitive.

In the particular case of the system crontab file (/etc/crontab), a ''user'' field inserts itself before the ''command''. It is generally set to 'root'.

In some uses of the cron format there is also a ''seconds'' field at the beginning of the pattern. In that case, the cron expression is a string comprising 6 or 7 fields.<ref>{{cite web |title=CronTrigger Tutorial |url=http://www.quartz-scheduler.org/documentation/quartz-1.x/tutorials/crontrigger |work=Quartz Scheduler Website |access-date=24 October 2011 |archive-url=https://web.archive.org/web/20111025080042/http://www.quartz-scheduler.org/documentation/quartz-1.x/tutorials/crontrigger |archive-date=25 October 2011 |url-status=dead }}</ref>

;Asterisk {{as written||( <code>*</code> )}}
: Asterisks (also known as wildcard) represents "all". For example, using "* * * * *" will run every minute. Using "* * * * 1" will run every minute only on Monday. Using six asterisks means every second when seconds are supported.

;Comma {{as written||( <code>,</code> )}}: Commas are used to separate items of a list. For example, using "MON,WED,FRI" in the 5th field (day of week) means Mondays, Wednesdays and Fridays.

;[[Hyphen-minus|Hyphen]] ( <code>-</code> ): Hyphen defines ranges. For example, "2000-2010" indicates every year between 2000 and 2010, inclusive.

;Percent ( <code>%</code> ): Percent-signs (%) in the command, unless escaped with backslash (\), are changed into newline characters, and all data after the first % are sent to the command  as standard input.<ref>{{cite web|url=https://www.gnu.org/software/mcron/manual/html_node/Crontab-file.html |title=mcron crontab reference |publisher=Gnu.org |access-date=2013-11-06}}</ref>

=== Non-standard characters ===
The following are non-standard characters and exist only in some cron implementations, such as the [[Quartz_(scheduler)|Quartz Java scheduler]].
;{{code|L}}
: 'L' stands for "last". When used in the day-of-week field, it allows specifying constructs such as "the last Friday" ("{{tt|5L}}") of a given month. In the day-of-month field, it specifies the last day of the month.
;{{code|W}}
: The 'W' character is allowed for the day-of-month field. This character is used to specify the weekday (Monday-Friday) nearest the given day. As an example, if "{{tt|15W}}" is specified as the value for the day-of-month field, the meaning is: "the nearest weekday to the 15th of the month." So, if the 15th is a Saturday, the trigger fires on Friday the 14th. If the 15th is a Sunday, the trigger fires on Monday the 16th. If the 15th is a Tuesday, then it fires on Tuesday the 15th. However, if "1W" is specified as the value for day-of-month, and the 1st is a Saturday, the trigger fires on Monday the 3rd, as it does not 'jump' over the boundary of a month's days. The 'W' character can be specified only when the day-of-month is a single day, not a range or list of days.
;Hash ({{code|#}})
: '#' is allowed for the day-of-week field, and must be followed by a number between one and five. It allows specifying constructs such as "the second Friday" of a given month.<ref>{{cite web|url=http://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.htm |title=Oracle® Role Manager Integration Guide |publisher=Docs.oracle.com |access-date=2013-11-06}}</ref> For example, entering "5#3" in the day-of-week field corresponds to the third Friday of every month.
;Question mark ({{code|?}})
: In some implementations, used instead of '{{tt|*}}' for leaving either day-of-month or day-of-week blank. Other cron implementations substitute "?" with the start-up time of the cron daemon, so that {{code|? ? * * * *}} would be updated to {{code|25 8 * * * *}} if cron started-up on 8:25am, and would run at this time every day until restarted again.<ref>{{cite web|url=http://www.nncron.ru/help/EN/working/cron-format.htm#STARTTIME |title=Cron format |publisher= nnBackup |access-date=2014-05-27}}</ref>
;Slash (<code>/</code>)
: In vixie-cron, slashes can be combined with ranges to specify step values.<ref name="freebsd"/> For example, {{mono|*/5}} in the minutes field indicates every 5 minutes (see note below about frequencies). It is shorthand for the more verbose POSIX form {{mono|5,10,15,20,25,30,35,40,45,50,55,00}}. POSIX does not define a use for slashes; its rationale (commenting on a BSD extension) notes that the definition is based on System V format but does not exclude the possibility of extensions.<ref name="posix"/>
:<p>Note that frequencies in general cannot be expressed; only step values which evenly divide their range express accurate frequencies (for minutes and seconds, that's {{tt|/2, /3, /4, /5, /6, /10, /12, /15, /20}} and {{tt|/30}}  because 60 is evenly divisible by those numbers; for hours, that's {{tt|/2, /3, /4, /6, /8}} and {{tt|/12}}); all other possible "steps" and all other fields yield inconsistent "short" periods at the end of the time-unit before it "resets" to the next minute, second, or day; for example, entering {{tt|*/5}} for the day field sometimes executes after 1, 2, or 3 days, depending on the month and leap year; this is because cron is stateless (it does not remember the time of the last execution nor count the difference between it and now, required for accurate frequency counting—instead, cron is a mere pattern-matcher).</p>
:<p>Some language-specific libraries offering crontab scheduling ability do not require "strict" ranges {{mono|15-59/XX}} to the left of the slash when ranges are used.<ref>{{cite web|url=https://github.com/josiahcarlson/parse-crontab#sample-individual-crontab-fields |title=Python Crontab |website=[[GitHub]] |access-date=2023-04-05}}</ref> In these cases, {{mono|15/XX}} is the same as a vixie-cron schedule of {{mono|15-59/10}} in the minutes section. Similarly, you can remove the extra {{mono|-23}} from {{mono|0-23/XX}}, {{mono|-31}} from {{mono|1-31/XX}}, and {{mono|-12}} from {{mono|1-12/XX}} for hours, days, and months; respectively.</p>
;{{code|H}}
: 'H' is used in the [[Jenkins (software)|Jenkins]] continuous integration system to indicate that a "hashed" value is substituted. Thus instead of a fixed number such as '{{code|20 * * * *}}' which means at 20 minutes after the hour every hour, '{{code|H * * * *}}' indicates that the task is performed every hour at an unspecified but invariant time for each task. This allows spreading out tasks over time, rather than having all of them start at the same time and compete for resources.<ref name="jenkins">{{cite web|url=https://github.com/jenkinsci/jenkins/blob/master/core/src/main/resources/hudson/triggers/TimerTrigger/help-spec.jelly|title=Timer Trigger Syntax|publisher= jenkins.com| access-date=2018-02-16}}</ref>