NavigationContentFooter
Suggest an edit

Cron schedules reference

Reviewed on 12 December 2023Published on 12 December 2023

Adding a cron schedule to a specific task allows you to run it automatically at fixed times and dates. Cron jobs are specified using a unix-cron format. You can run a task as often as every minute, or as infrequently as once a year.

Cron schedule format

Cron jobs are expressed using the * * * * * format, which corresponds to the fields below.

# ┌───────────── minute
# │ ┌───────────── hour
# │ │ ┌───────────── day of the month
# │ │ │ ┌───────────── month
# │ │ │ │ ┌───────────── day of the week
# │ │ │ │ │
# │ │ │ │ │
# │ │ │ │ │
# * * * * *

Each field supports a specific range of values.

FieldValues
Minute0-59
Hour0-23
Day of the month1-31
Month1-12 (or JAN-DEC)
Day of the week0-6 (or SUN-SAT, and 7 for Sunday)
Note
  • The month and the day of the week can be both expressed using numerical or alphabetical values
  • The days of the week 0 and 7 both stand for Sunday

Cron schedule operators

Several operators can be added to each field to further refine your schedule.

ValueDescriptionExample
*Specifies all possible values* * * * * runs every minute of every hour of every day of every month.
-Specifies a range of values50-59 * * * * runs every minute during the last 10 minutes of each hour.
,Specifies a list of values0 9,17 * * * runs at 9:00 and 17:00 every day.
/Specifies the pace to skip values0 */2 * */3 * runs every 2 hours for a day, once every 3 months.

Cron schedule examples

Cron expressionDescription
0 12 * * *Runs at 12:00 (noon) every day
30 9 * * *Runs at 9:30 every day
*/5 14-23 * * *Runs every five minutes starting from 14:00 to 23:55 every day
0-5 16 * * *Runs every minute from 16:00 to 16:05 every day
15,45 12-17 * * WEDRuns at minutes 15 and 45 from 12:15 to 17:45 every Wednesday
30 9,17 * * MON-FRIRuns at 9:30 and 17:30 from Monday to Friday
1 0 5 * *Runs the 5th of each month at 00:01
0 9 1-24 DEC *Runs at 9:00 every day during the first 24 days of December
30 17 * * 5Runs at 17:30 every Friday
0 0 * 8 *Runs at 00:00 (midnight) every day in August
1 1 1 1 1Runs every January 1st, at 01:01 and on Mondays in January

Time zones

  • Serverless Functions and Serverless Containers CRON triggers use the UTC time zone. This parameter cannot be modified.

  • Serverless Jobs allow modifying the time zone of their schedules via the Job Settings tab. Refer to the job scheduling documentation for more information.

Docs APIScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCarreer
© 2023-2024 – Scaleway