Frequencies and examples
Every frequency has Repeat every N (N is at least 1). N counts from the start date: days, ISO weeks (Monday to Sunday), months or years.
| Frequency | Options | Example |
|---|---|---|
| Daily | Optional: business days only | Every day at 08:00 |
| Weekly | One or more weekdays | Every 2 weeks on Monday and Thursday |
| Monthly, on a date | Day 1 to 31, or last day | The 15th of every month |
| Monthly, on a position | 1st to 4th or last of a weekday; 1st to 5th or last business day | The 2nd Tuesday; the last business day |
| Yearly | A month, then a date or a position | 1 March every year; the 1st business day of January |
| Advanced (cron or RRULE) | A cron expression or an RRULE line | Weekdays at 08:00 and 17:00 |
For anything the frequencies above cannot express, use an advanced rule.
In the Quick Start
The one-screen Quick Start offers the common presets and Custom: every X days, weeks, months or years:
- Days: every X days (1 to 365), counted from the start date.
- Weeks: every X weeks (1 to 52) on one weekday. Weeks are counted from the week of the start date.
- Months: every X months (1 to 24) on a day of the month; 29 to 31 use the last day of shorter months.
- Years: every X years (1 to 10) on the month and day of the start date.
The Quick Start also asks If it falls on a weekend: Keep the day (default), Move to the Friday before or Move to the Monday after. It is the wizard’s “When a date falls on a weekend or a holiday” policy (create anyway, previous business day, next business day), so public holidays of the holiday country move the same way, and a monthly move never leaves the month. More options opens the wizard with the same frequency, Repeat every value and policy.
Examples
- Every Monday: Weekly, Monday.
- Every 2 weeks: Weekly, repeat every 2, pick the weekday.
- Monthly report on the 1st business day: Monthly on a position, 1st, Business day.
- Month-end close: Monthly on a position, Last, Business day. Optionally create 5 days early.
- Quarterly: Monthly, repeat every 3, on a date or position.
- Every 3rd business day: Daily, tick “Business days only”, repeat every 3.
Days that do not exist
Monthly on the 31st: pick what happens in a month without that day.
- Use the last day of the month (default): 31 April becomes 30 April.
- Skip that month: no issue that month.
Yearly on 29 February follows the same choice in non-leap years.
Positions
- Weekday positions: 1st to 4th or last (for example “2nd Tuesday”, “last Friday”).
- Business-day positions: 1st to 5th or last business day of the month. A month with fewer business days than the position gives no issue that month.
- Business days depend on the holiday calendar.
Ending
Never, after N occurrences, or on a date. When a series ends the schedule status becomes Ended.
Advanced rules
Choose Advanced (cron or RRULE) as the frequency when the other frequencies are not enough, for example two issues a day or “the last weekday of the month”. You type a short rule in one of two common formats:
- Cron: five fields separated by spaces: minute, hour, day of the month, month, day of the week.
*means “every”,1-5is a range,8,17is a list and*/2means “every 2”. Days of the week are 0 to 7 (0 and 7 are Sunday) or MON to SUN; months are 1 to 12 or JAN to DEC. The times come from the expression, so the Time field is hidden. - RRULE: one line in the iCalendar format used by Google Calendar and Outlook, for example
FREQ=WEEKLY;BYDAY=MO. Leave outDTSTARTandTZID: the start date and the time zone are set in the wizard. WithoutBYHOURthe Time field gives the time; withBYHOURand noBYMINUTEthe minute is 00.
Examples (click them in the wizard to use them):
| You want | Cron | RRULE |
|---|---|---|
| Weekdays at 08:00 and 17:00 | 0 8,17 * * 1-5 |
FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR;BYHOUR=8,17 |
| The 2nd Tuesday every 3 months | not possible in cron | FREQ=MONTHLY;BYDAY=TU;BYSETPOS=2;INTERVAL=3 |
| Monday and Wednesday at 09:00 and 15:00 | 0 9,15 * * 1,3 |
FREQ=WEEKLY;BYDAY=MO,WE;BYHOUR=9,15 |
The wizard checks the rule as you type and shows the next runs below it. The Review step shows the next 10.
Limits, to protect your Jira site:
- At most 24 issues a day, and at least 60 minutes between two issues.
*/15 * * * *(every 15 minutes) is refused. A cron step larger than its field, such as*/90in the minute field, is refused too: cron cannot say “every 90 minutes”. - RRULE:
FREQmust beHOURLYor slower (noMINUTELYorSECONDLY).COUNTandUNTILwork only when Ends is Never; otherwise use Ends.BYYEARDAY,BYWEEKNOandBYSECONDare not supported. - Expressions are at most 200 characters.
Everything else works as for the other frequencies: the time zone and clock changes, holidays and business days, early creation and exceptions, the start date and Ends. Good to know:
- In cron, when both the day of the month and the day of the week are set (neither starts with
*), a day matching either one runs (standard cron).0 9 1 * MONruns on the 1st and on every Monday. - A day that does not exist is not run: cron
0 8 31 * *runs only in months with a 31st (use Monthly, on a date for “last day of the month”). - With a holiday policy that moves to a business day, each time keeps its time of day. Two runs that land on the same instant create one issue.