Scheduled
You can schedule code to run repeatedly on Val Town. Want to check an RSS feed every hour, or send a reminder email every day? This is how to do it: just create a scheduled function and specify when it should run.
- Scheduled functions can be configured with cron syntax, or simple intervals like “once an hour”
- Functions can run up to once every 15 minutes, or once a minute, with the Pro plan.
Type Signature
Scheduled functions should take an Interval
object as a parameter, and can return anything as a result. The return value is ignored.
The interval type has the following shape:
Schedule types
There are two kinds of schedules: either simple intervals, like “run every two hours”, or you can use cron syntax to define more complex schedules.
You can consult crontab.guru for help on writing cron expressions. Using cron, you can write expressions like
Which will run the val At minute 0 past every 2nd hour on day-of-month 1. It’s a powerful syntax.
Cron expressions are evaluated in the UTC timezone, so if you want to specify a certain hour in your local timezone, you may need to adjust the cron expression.
Example
Scheduled Vals can optionally accept one argument, which includes some metadata about the interval. For example, you can get the most recent time the interval was run to filter out data that was already seen: