NavigationContentFooter
Suggest an edit

Cron schedules reference

Reviewed on 03 July 2024Published 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.

Was this page helpful?
API DocsScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCareers
© 2023-2024 – Scaleway