Guia rápido de expressões cron com exemplos reais
A sintaxe do cron em uma página: os cinco campos, os quatro operadores, agendamentos prontos e as pegadinhas da lógica OU, do horário de verão e das variantes.
Atualizado
Uma expressão cron são cinco campos separados por espaços: minuto, hora, dia do mês, mês, dia da semana. 0 9 * * 1-5 significa 09:00 em todos os dias úteis. * significa qualquer valor, , lista valores, - define um intervalo e / define um passo. Isso é a maior parte da sintaxe; o resto desta página são exemplos e as pegadinhas.
Os cinco campos
Em ordem, com os intervalos permitidos:
- Minuto:
0-59 - Hora:
0-23(relógio de 24 horas) - Dia do mês:
1-31 - Mês:
1-12ouJAN-DEC - Dia da semana:
0-6, em que0é domingo (7também significa domingo na maioria dos sistemas), ouSUN-SAT
A expressão dispara quando o horário atual corresponde a todos os campos, com uma exceção explicada mais abaixo. Os horários são avaliados no fuso horário da máquina ou do serviço que executa o agendador, que normalmente é UTC em servidores e em contêineres.
Operadores
*qualquer valor.* * * * *é a cada minuto.,lista.0 9,17 * * *é 09:00 e 17:00.-intervalo.0 9-17 * * *é o início de cada hora das 09:00 às 17:00, nove execuções./passo.*/15 * * * *é a cada 15 minutos::00,:15,:30,:45.0 */6 * * *é a cada seis horas. Os passos podem começar de um deslocamento:5/15no campo de minuto significa:05,:20,:35,:50.
Os operadores se combinam: 0 8-18/2 * * 1-5 é a cada duas horas das 08:00 às 18:00 nos dias úteis.
Exemplos reais
* * * * *a cada minuto*/5 * * * *a cada 5 minutos0 * * * *a cada hora, na hora cheia30 * * * *a cada hora, aos :300 0 * * *diariamente à meia-noite0 3 * * *diariamente às 03:00, o horário clássico de backup0 9 * * 1-5dias úteis às 09:000 0 * * 0semanalmente, domingo à meia-noite0 0 * * 1semanalmente, segunda-feira à meia-noite0 0 1 * *primeiro dia de cada mês à meia-noite0 0 1 1 *uma vez por ano, em 1º de janeiro0 0 1 */3 *trimestralmente: 1º de jan., 1º de abr., 1º de jul., 1º de out.0 9,13,17 * * *três vezes por dia0 22 * * 1-5noites de dias úteis às 22:000 0 * * 6,0sábado e domingo à meia-noite15 2 * * *02:15 diariamente, deslocado da hora cheia0 0 */2 * *dia sim, dia não, aproximadamente; o passo reinicia no dia 1º, então um mês de 31 dias termina com execuções em dias seguidos
Montar uma dessas à mão é fácil. Conferir se ela faz o que você queria é onde o Construtor de Expressões Cron ajuda: ele transforma qualquer expressão em uma frase em linguagem simples e lista os próximos cinco horários de execução.
As pegadinhas
Dia do mês e dia da semana são OU, não E
Esta é a regra mais surpreendente do cron. Se os dois campos de dia estiverem restritos, o job roda quando qualquer um deles corresponder. 0 0 13 * 5 roda no dia 13 de todo mês e em toda sexta-feira, não apenas na sexta-feira 13. Não existe sintaxe de cron padrão para "o dia 13 somente se for uma sexta-feira"; faça essa verificação dentro do script.
Último dia do mês
O cron padrão não tem L. 0 0 28-31 * * dispara até quatro vezes. A solução mais comum é rodar diariamente e deixar o script verificar se date -d tomorrow +%d é igual a 01. O Quartz (Java) e alguns agendadores de nuvem estendem a sintaxe com L, W e #, mas essas expressões não rodam em um crontab do Linux.
Horário de verão
Um job em 0 2 * * * em um fuso com horário de verão será pulado na noite em que o relógio adianta e rodará duas vezes na noite em que o relógio atrasa. Agende os servidores em UTC ou escolha horas que nunca caiam na janela de transição.
Variantes fora do padrão
- O crontab do Linux aceita
@hourly,@daily,@weekly,@monthly,@yearlye@reboot. - Quartz, Spring e alguns serviços da AWS usam seis ou sete campos, acrescentando segundos no início e um ano opcional no final.
0 0 9 * * ?é a forma do Quartz para diariamente às 09:00; o?significa "nenhum valor específico" e é obrigatório em um dos dois campos de dia. - GitHub Actions e CronJobs do Kubernetes usam os cinco campos padrão em UTC. O GitHub também documenta que o menor intervalo permitido é de cinco minutos e que os jobs podem começar atrasados em horários de pico.
O cron não tem memória. Se a máquina estiver desligada ou o contêiner não estiver rodando no minuto agendado, aquela execução simplesmente se perde. Use uma fila de jobs ou um agendador com semântica de recuperação se cada execução for importante.
Conferindo o seu agendamento
A lista de próximas execuções é a verificação mais rápida. Se os cinco primeiros horários não forem o que você imaginou, a expressão está errada. Para um job que grava timestamps em logs ou em um banco de dados, converta os valores de epoch registrados com o conversor de timestamp Unix e compare-os com o agendamento pretendido; um desvio de uma hora depois de uma mudança de horário de verão é um achado comum.
Para medir a distância real entre duas execuções, a Calculadora de Duração dá o intervalo exato em dias, horas e minutos entre dois timestamps.
Outros utilitários de agendamento e formatação estão na categoria de desenvolvedor.
Experimente
Digite ou monte uma expressão no Construtor de Expressões Cron, leia o resumo em linguagem simples e confirme os próximos cinco horários de execução antes que ela vá para um crontab, um workflow de CI ou um manifesto de CronJob.