A sintaxe do cron é compacta e fácil de ler errado, e o preço de ler errado é uma tarefa rodando na hora errada por meses antes de alguém notar. Esta página traduz a linha de volta para uma frase e, mais útil ainda, mostra as datas reais em que ela vai disparar.

Como usar

1. 1 Cole sua linha de cron ou comece por um dos exemplos.
2. 2 Leia a frase e confira cada campo um a um.
3. 3 Confira com a lista de próximas execuções: é ali que os erros aparecem.

Os cinco campos

Sempre nesta ordem, sempre separados por espaços. Cada um aceita um número, uma lista como 1,15, um intervalo como 9-17, um passo como */5 ou um asterisco que significa todos os valores.

A armadilha do dia do mês

Quando o campo do dia do mês e o do dia da semana valem algo diferente de um asterisco, o cron executa a tarefa se qualquer um dos dois bater, não os dois. Então «0 0 1 * MON» dispara no dia 1 de todo mês e em toda segunda-feira. Isso surpreende quase todo mundo na primeira vez, e o tradutor avisa quando é o caso.

Passos não significam «a cada N a partir de agora»

*/20 no campo dos minutos significa os minutos 0, 20 e 40 de cada hora, não «vinte minutos depois da última execução». Se uma execução leva 25 minutos, a seguinte começa mesmo assim no minuto 40. Os passos contam desde o início do intervalo, e 5-20/5 conta a partir do 5.

Fusos horários e as horas que somem

O cron segue o relógio do servidor, não o seu, então uma tarefa marcada para 02:30 pode disparar num horário local diferente do que você espera. Pior: em regiões com horário de verão essa hora não existe numa noite do ano e acontece duas vezes em outra. Para o que não pode ser pulado nem repetido, agende fora de 01:00-03:00.