(Quick Reference)

cron

Purpose

Declares a trigger that fires according to a cron expression.

Examples

class MyJob {

    static triggers = {
        cron(
            name: 'cronTrigger',
            startDelay: 10000,
            cronExpression: '0/6 * 15 * * ?',
            timeZone: TimeZone.getTimeZone('GMT-8') // optional
        )
    }

    void execute() {
        println 'Job run!'
    }
}

Description

Accepted attributes:

  • name — uniquely identifies the trigger; must be unique across the whole application. Defaults to the job name followed by a counter.

  • group — the trigger group. Defaults to GRAILS_TRIGGERS.

  • startDelay — delay in milliseconds between scheduler startup and the first execution. Defaults to 0.

  • cronExpression — the cron expression determining the firing schedule. Defaults to 0 0 6 * * ? (6:00am every day). An invalid expression fails at startup.

  • timeZone — the java.util.TimeZone the expression is evaluated in. Defaults to the system time zone.

The fields of a cron expression are, in order: seconds, minutes, hours, day-of-month, month, day-of-week, and an optional year. Either day-of-month or day-of-week must be ?.

Refer to the user guide topic on Triggers for more information.