# Executar código segundo um agendamento com CRON

> Registe uma função com CRON() e uma linha cron de cinco campos, e saiba quando a verificação corre e como remover uma tarefa.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: pt
Content-SHA256: 4d3b0086947e6d86e7ca9c4194a519976bfadc7cc3b89499ee3001979cbbb3f0
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

`CRON(line, fn)` executa `fn(date)` sempre que a hora atual corresponde a `line`. A linha tem cinco campos, como no cron do Unix: `minute hour day-of-month month day-of-week`. Cada campo aceita `*` (qualquer valor), `1,5,9` (uma lista), `1-5` (um intervalo) ou um número exato. Os nomes de dia como `mon` ou `fri` funcionam no último campo.

**Escreva os valores como uma lista**, `0,15,30,45`: corresponde exatamente às horas que indica.

O Total.js verifica as tarefas registadas uma vez por minuto, pelo que a resolução mais fina é um minuto. `CRON()` devolve um objeto: `job.remove()` cancela o registo e `job.check(date)` diz-lhe se uma data corresponde à linha, o que é também a forma mais fácil de testar um agendamento sem esperar.

```js controllers/cron.js
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);
}
```