GameParticles
Desenvolvimento

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:

  1. Minuto: 0-59
  2. Hora: 0-23 (relógio de 24 horas)
  3. Dia do mês: 1-31
  4. Mês: 1-12 ou JAN-DEC
  5. Dia da semana: 0-6, em que 0 é domingo (7 também significa domingo na maioria dos sistemas), ou SUN-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/15 no 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 minutos
  • 0 * * * * a cada hora, na hora cheia
  • 30 * * * * a cada hora, aos :30
  • 0 0 * * * diariamente à meia-noite
  • 0 3 * * * diariamente às 03:00, o horário clássico de backup
  • 0 9 * * 1-5 dias úteis às 09:00
  • 0 0 * * 0 semanalmente, domingo à meia-noite
  • 0 0 * * 1 semanalmente, segunda-feira à meia-noite
  • 0 0 1 * * primeiro dia de cada mês à meia-noite
  • 0 0 1 1 * uma vez por ano, em 1º de janeiro
  • 0 0 1 */3 * trimestralmente: 1º de jan., 1º de abr., 1º de jul., 1º de out.
  • 0 9,13,17 * * * três vezes por dia
  • 0 22 * * 1-5 noites de dias úteis às 22:00
  • 0 0 * * 6,0 sábado e domingo à meia-noite
  • 15 2 * * * 02:15 diariamente, deslocado da hora cheia
  • 0 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, @yearly e @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.

Ferramentas deste guia

Perguntas frequentes

O que significa 0 0 * * * no cron?

Minuto 0 da hora 0 em todos os dias, todos os meses, todos os dias da semana: em outras palavras, diariamente à meia-noite no fuso horário do agendador.

Como executar um cron job a cada 5 minutos?

Use */5 no campo de minuto: */5 * * * *. O operador de passo começa em 0, então ele dispara em :00, :05, :10 e assim por diante.

Por que meu cron job roda em dias extras quando defino os dois campos de dia?

No cron padrão, dia do mês e dia da semana são combinados com OU, não com E. 0 0 13 * 5 roda no dia 13 de todo mês e também em toda sexta-feira.

Qual fuso horário o cron usa?

O fuso horário do host ou do serviço que executa o agendador. Servidores, contêineres, GitHub Actions e CronJobs do Kubernetes usam UTC por padrão, a menos que sejam configurados de outra forma.

Mais guias para desenvolvedores

Formatador de JSON
Desenvolvimento · Formate, valide e minifique JSON com realce de sintaxe.
↵
Codificar / decodificar Base64
Desenvolvimento · Codifique texto em Base64 ou decodifique Base64 para texto simples.
↵
Codificador / Decodificador de URL
Desenvolvimento · Codifique ou decodifique componentes de URL e query strings.
↵
Gerador de hash
Desenvolvimento · Gere hashes MD5, SHA-1, SHA-256 e SHA-512.
↵
Gerador de UUID
Desenvolvimento · Gere UUIDs v4 (aleatórios) em massa com um clique.
↵
Testador de regex
Desenvolvimento · Teste expressões regulares em um texto com destaque das correspondências ao vivo.
↵
Contador de palavras
Texto · Conte palavras, caracteres, frases, parágrafos e tempo de leitura.
↵
Conversor de maiúsculas e minúsculas
Texto · Converta texto para MAIÚSCULAS, minúsculas, Título, camelCase, snake_case e mais.
↵
Ordenador de listas
Texto · Ordene, inverta, embaralhe e remova duplicatas de listas de texto.
↵
Prévia de Markdown
Texto · Escreva em Markdown e veja a prévia renderizada ao vivo, lado a lado.
↵
Calculadora de porcentagem
Números · Calcule porcentagens, aumentos, reduções e quantos % um número é de outro.
↵
Conversor de cores
Cores · Converta cores entre HEX, RGB, HSL e HSV na hora.
↵
Snake
Arcade · Coma, cresça e não bata nas paredes. Um clássico atemporal.
↵
2048
Quebra-cabeça · Deslize e combine as peças até chegar à lendária peça 2048.
↵
Word Grid
Quebra-cabeça · Adivinhe a palavra oculta de cinco letras em seis tentativas com pistas de cores.
↵
Sudoku
Quebra-cabeça · Preencha a grade 9x9 com lógica. Quatro níveis, do fácil ao especialista.
↵
Campo Minado
Estratégia · Use as pistas numéricas para limpar o campo minado. Lógica clássica, três níveis.
↵
Breakout
Arcade · Quebre todos os tijolos com raquete e bola. Power-ups, combos e níveis sem fim.
↵
Treino de digitação
Casual · Melhore seu PPM e sua precisão com treinos de 30 segundos a 5 minutos. Descubra suas teclas fracas.
↵
TypeRunner
Arcade · Corrida de digitação multiplayer. Desafie amigos por link, vença o computador ou persiga o seu fantasma.
↵
Typing Blocks
Arcade · Digite cada palavra antes que o bloco de madeira pouse. Se errar, a pilha sobe em direção à linha.
↵
Bubble Shooter
Arcade · Mire, rebata nas paredes e estoure grupos de três ou mais bolhas.
↵
Road Rush
Arcade · Corra contra sete rivais no trânsito e abra caminho no soco.
↵