Skip to main content

Interval

Maximum number of Interval actions: 2 basic, 5 prime.

Fires an action on a schedule. The schedule can follow multiple formats, including cron-like expressions and regular text input, such as every minute or every hour on monday between 6am and 6pm. If the input is invalid and cannot be parsed, you will not be able to save the action. All schedules are calculated in UTC.

Runs must be at minimum a minute apart. If an action is scheduled to run every second, it will only be invoked every minute at most. Additionally, if an action is set to run every minute of 2022, once the year is over the action will be disabled and you will have to configure a new schedule.

An action set to run every hour will be scheduled to run on the hour every hour. There is no guarantee the action will run at the exact time it is scheduled, as priority may be given to actions that run less frequently, or there may be a lot of actions to run at that specific moment which will delay others. Actions set to run at midnight every day will be competing with thousands of others to run, so they may be delayed by a couple of seconds or minutes. You can configure this by setting a grace period. If the action does not run within the grace period of the target time, that run will be scrapped and the action will be rescheduled to run at the next scheduled date. For example, an action set to run every day at 5pm with a grace period of 30 minutes will not run if the bot is down from 5pm to 5:30pm.

Actions with this trigger will run with the user who last updated the action in context, which also means the action will inherit that user's permissions in the server.

The format for cron expressions is as follows:

# ┌───────────── minute (0 - 59)
# │ ┌───────────── hour (0 - 23)
# │ │ ┌───────────── day of the month (1 - 31)
# │ │ │ ┌───────────── month (1 - 12)
# │ │ │ │ ┌───────────── day of the week (0 - 6) (Sunday to Saturday;
# │ │ │ │ │                                   7 is also Sunday on some systems)
# │ │ │ │ │
# │ │ │ │ │
# * * * * *

Some examples of valid schedules:

  • 0/5 14 * * * is a cron expression that fires every 5 minutes starting at 2pm and ending at 2:55pm, every day.
  • at 10:15am
  • every 5 minutes
  • at 10:15 am also at 5:15pm except on Tuesday
  • every 20 mins starting on the 7th min fires on the 7th, 27th, and 47th minute every hour.
  • after 12th hour fires every hour after noon every day.
  • at 5:00 pm on Weds,Thurs and Fri fires at 5:00pm on Wednesday, Thursday, and Friday.
  • at 5:00 pm every 1 day of March in 2014 fires at 5:00pm every day of March in 2014.

Use this tool to quickly write a cron expression.