Interpretador de cron

Os cinco campos, na ordem

Uma expressão cron é uma linha com cinco campos separados por espaço: minuto (0 a 59), hora (0 a 23), dia do mês (1 a 31), mês (1 a 12) e dia da semana (0 a 6, com o domingo em 0). O asterisco em qualquer campo significa "todos os valores".

Lista, intervalo e passo

Cada campo aceita três formas de combinar valores. A vírgula faz uma lista (1,15,28). O hífen faz um intervalo (9-17). A barra faz um passo, que pode vir depois de um asterisco ou de um intervalo: */15 é de quinze em quinze a partir do zero, e 0-20/5 é de cinco em cinco dentro daquela faixa.

A pegadinha do dia do mês com dia da semana

Quando os dois campos de dia estão preenchidos, o cron dispara quandoqualquer um dos dois bate — não quando os dois batem juntos. A expressão 0 0 15 * 1 roda no dia 15 de todo mêse também em toda segunda-feira, o que dá cerca de cinco execuções por mês em vez de uma. É o erro mais comum com cron, e ele costuma aparecer só em produção.

Para rodar no dia 15 apenas quando for segunda, não existe sintaxe no cron padrão: a checagem precisa ser feita dentro do próprio script.

Os atalhos com arroba

Em vez dos cinco campos, o cron aceita alguns nomes prontos:@hourly, @daily (igual a@midnight), @weekly, @monthly e@yearly (igual a @annually). São legíveis, mas todos rodam no minuto zero — e se vários serviços usarem@daily, todos acordam exatamente à meia-noite ao mesmo tempo.

O fuso horário é do servidor, não o seu

As próximas execuções mostradas aqui usam o fuso do seu navegador, porque é o que ajuda a conferir mentalmente. O cron de verdade roda no fuso da máquina onde está — que em contêiner costuma ser UTC, três horas à frente do horário de Brasília. Um agendamento para as 22h local vira 1h da manhã do dia seguinte em UTC, e isso muda o dia da semana.

Nada sai do seu navegador

A interpretação e o cálculo das próximas datas acontecem na sua máquina. Nenhuma expressão é enviada a servidor algum.

Cron expression, crontab e os dialetos

Em inglês a busca é por cron expression oucrontab generator. O formato de cinco campos é o do cron do Unix; Quartz e o Spring usam seis ou sete, com segundos na frente e ano no fim, e a mesma expressão significa coisas diferentes nos dois. Antes de copiar uma expressão da internet, confira quantos campos ela tem.