Python

JavaScript

You are viewing Skygear v1 Documentation.Switch to Skygear v0 Documentation

Scheduled Tasks

    Skygear supports creating functions that run at specific time intervals using the method skygearCloud.every(). It works similar to the cron daemon in UNIX.

    // Cron job that runs every 2 minutes
skygearCloud.every('@every 2m', function() {
	// show 'Meow Meow!' every 2 minutes in Skygear Portal Production Log
	console.log('Meow Meow!');
});

    The method takes one argument, the interval, which specifies the time at which the function should be invoked and any tasks should be pass with a function in second argument.

    Some examples of interval values are shown below. For detailed specifications, you can refer to the cron library for go, which is the parser used in Skygear.

    skygearCloud.every('1 2 3 4 5 *') # Every 4th May at 03:02:01
skygearCloud.every('0 0 0 * * TUE') # Every Tuesday at 00:00:00
skygearCloud.every('0 15 */2 * * *') # Every 2 hours at 15th minute
skygearCloud.every('0 0 6,18 * * WED,SUN') # On 6am and 6pm of every Wed/Sun
skygearCloud.every('0 16-30 * * * *') # At 16-30 minute of every hour
skygearCloud.every('@daily') # Daily at 0:00:00
skygearCloud.every('@every 1h') # At 1-hour intervals since the server starts
skygearCloud.every('@every 1m30s') # At 90-second intervals since the server starts

    Note:

    1. If there are multiple functions to run at the same second, their execution order is not guaranteed.
    2. For intervals using @every (the last two examples above), the interval will be reset upon the re-deployment of cloud code. For instance, an existing scheduled task running at 1-hour interval skygearCloud.every('every 1h') will be run 1 hour after the re-deployment, meaning that the actual interval will be longer than 1 hour due to the re-deployment.