Última atualização: 2026-06-28

O que é uma expressão cron?

Uma expressão cron é uma string de cinco campos que agenda tarefas recorrentes em sistemas Unix e similares. O agendador dispara o job sempre que todos os cinco campos coincidem com o horário atual. O formato é:

Caracteres especiais

• * – corresponde a qualquer valor no campo ("toda hora", "todo dia")
• */n – passo; corresponde a cada n-ésimo valor (ex.: */15 no campo de minuto = a cada 15 minutos)
• a-b – intervalo; corresponde a todos os valores de a até b inclusive (ex.: 1-5 no campo de dia da semana = segunda a sexta)
• a,b,c – lista; corresponde a cada valor listado (ex.: 1,15 no campo de dia do mês = dias 1 e 15)
• a-b/n – intervalo com passo; ex.: 10-50/10 corresponde a 10, 20, 30, 40, 50

Padrões mais usados

Atalhos

A maioria das implementações de cron aceita atalhos convenientes:

Interação entre dia-do-mês e dia-da-semana

Quando os campos dia-do-mês e dia-da-semana estão ambos restritos (nenhum deles é *), o cron aplica semântica OR: o job é disparado se qualquer uma das condições for verdadeira. Por exemplo:

0 0 1 * 1

Isso dispara à meia-noite no dia 1 de cada mês E em toda segunda-feira — não apenas nas segundas que caem no dia 1. Esse comportamento é especificado pelo POSIX e implementado pelo Vixie cron, a implementação mais amplamente utilizada.

Se apenas um dos dois campos estiver restrito, o outro não tem efeito e o job roda em todo dia que corresponde ao campo restrito.

Como o agendamento cron funciona

A cada minuto, o agendador verifica se o horário atual coincide com os cinco campos. Se sim, o job é disparado. Como a granularidade é de um minuto, o menor intervalo possível entre duas execuções é um minuto.

Por padrão, o agendador não "recupera" execuções perdidas. Se o servidor estiver offline no momento de uma execução agendada, aquele disparo é simplesmente ignorado. Alguns agendadores — como os Kubernetes CronJobs — possuem a configuração startingDeadlineSeconds para recuperar execuções perdidas dentro de uma janela de tempo.

Considerações sobre fuso horário

A maioria das implementações de cron interpreta as expressões no fuso horário local do servidor. Servidores configurados em UTC dispararão exatamente nos horários indicados pelas expressões baseadas em UTC. Servidores em outros fusos deslocarão o horário de disparo de acordo com a diferença.

Os Kubernetes CronJobs e os agendamentos do GitHub Actions interpretam as expressões cron em UTC. Esta calculadora exibe os próximos horários de execução em UTC; se o seu sistema usar um fuso diferente, ajuste adicionando ou subtraindo o deslocamento UTC correspondente.