modal.Cron

class Cron(modal.schedule.Schedule)

Cron jobs are a type of schedule, specified using the Unix cron tab syntax.

The alternative schedule type is the modal.Period.

__init__(self, cron_string, timezone="UTC")

Construct a schedule that runs according to a cron expression string.

Parameters

cron_string str

Cron expression (see crontab.guru).

timezone str

IANA timezone name; defaults to UTC. (Default is "UTC")

Usage

import modal
app = modal.App()


@app.function(schedule=modal.Cron("* * * * *"))
def f():
    print("This function will run every minute")

We can specify different schedules with cron strings, for example:

modal.Cron("5 4 * * *")  # run at 4:05am UTC every night
modal.Cron("0 9 * * 4")  # runs every Thursday at 9am UTC

We can also optionally specify a timezone, for example:

modal.Cron("0 6 * * *", timezone="America/New_York")

If no timezone is specified, the default is UTC.