Analisador e gerador de expressões Cron

Uma expressão cron padrão tem cinco campos separados por espaço: minuto (0–59), hora (0–23), dia do mês (1–31), mês (1–12) e dia da semana (0–6, em que 0 é domingo; a maioria das implementações também aceita 7). Cada campo aceita * para qualquer valor, vírgulas para listas (1,15), hífen para intervalos (1-5) e barra para passos (*/10 significa a cada 10 unidades). Assim, 0 9 * * 1-5 é às 9:00 em dias úteis, */5 * * * * é a cada cinco minutos e 0 0 1 * * é meia-noite do dia 1 de cada mês. Com seis campos, o primeiro é tratado como segundos, formato comum em agendadores Node.js.

A ferramenta traduz a expressão para linguagem natural e lista as próximas cinco execuções reais, para você confirmar o agendamento antes do deploy. O erro clássico é inverter minuto e hora: para rodar todo dia às 2:30, use 30 2 * * *, não 2 30 * * * (inválido, pois a hora vai só até 23). Outra armadilha é que os passos recomeçam dentro da unidade: */45 * * * * roda no minuto 0 e no minuto 45 de cada hora, então o intervalo não é sempre de 45 minutos.

Cuidado ao restringir dia do mês e dia da semana ao mesmo tempo. No cron padrão (Vixie), se nenhum dos dois for *, a tarefa roda quando qualquer um coincide, não ambos. Por isso 0 0 13 * 5 dispara todo dia 13 e toda sexta-feira, não apenas na sexta-feira 13. Plataformas com sintaxe Quartz (Java e alguns serviços de nuvem) usam sete campos e ? para "sem valor específico", diferente da sintaxe Unix usada aqui.

Fusos horários causam mais bugs de agendamento que qualquer outra coisa. A ferramenta mostra as próximas execuções no fuso do seu navegador, mas servidores, GitHub Actions e muitos agendadores em nuvem usam UTC por padrão. Para 9:00 em Brasília (UTC−3), um agendador em UTC precisa de 0 12 * * *. Sempre confira o fuso da plataforma de destino.