Exécuter du code selon un calendrier avec CRON
CRON(line, fn) exécute fn(date) chaque fois que l'heure actuelle correspond à line. La ligne comporte cinq champs, comme dans le cron d'Unix : minute hour day-of-month month day-of-week. Chaque champ accepte * (n'importe quelle valeur), 1,5,9 (une liste), 1-5 (une plage) ou un nombre exact. Les noms de jour comme mon ou fri fonctionnent dans le dernier champ.
Écrivez les valeurs sous forme de liste, 0,15,30,45 : elle correspond exactement aux heures que vous nommez.
Total.js vérifie les tâches enregistrées une fois par minute, donc la résolution la plus fine est la minute. CRON() renvoie un objet : job.remove() désinscrit la tâche et job.check(date) indique si une date correspond à la ligne, ce qui est aussi le moyen le plus simple de tester un calendrier sans attendre.
exports.install = function() {
ROUTE('GET /cron/matches/', matches);
ROUTE('GET /cron/runs/', runs);
};
var counter = { runs: 0 };
// Every 15 minutes, from Monday to Friday, between 09:00 and 17:59
var job = CRON('0,15,30,45 9-17 * * 1-5', function(date) {
counter.runs++;
});
function matches($) {
var dates = {
monday_0930: new Date(2026, 0, 5, 9, 30),
monday_0931: new Date(2026, 0, 5, 9, 31),
monday_1830: new Date(2026, 0, 5, 18, 30),
sunday_0930: new Date(2026, 0, 4, 9, 30)
};
var output = {};
for (var key in dates)
output[key] = job.check(dates[key]);
$.json(output);
}
function runs($) {
$.json(counter);
}