Ferramenta para desenvolvedores

Explicador de expressões cron

Cole uma linha de cron e descubra quando ela realmente roda.

Explicador de expressões cron Executa no seu dispositivo
  • Executa no seu navegador — seu texto nunca é enviado a lugar nenhum
  • Sem cadastro, sem cotas, grátis para usar quantas vezes quiser

Como funciona

A sintaxe do cron são cinco campos enxutos, fáceis de escrever e muito mais difíceis de ler de volta, principalmente os de outra pessoa. A maioria dos erros não são erros de digitação, mas mal-entendidos sobre qual campo é qual ou sobre o que acontece quando dois deles são definidos ao mesmo tempo.

Os cinco campos

Minuto, hora, dia do mês, mês, dia da semana — nessa ordem. Um sexto campo no início, para segundos, é usado por alguns agendadores e é ignorado aqui, se presente. Intervalos, listas e passos são todos compreendidos.

Dia do mês e dia da semana juntos

Isto pega quase todo mundo. Se os dois campos forem definidos com algo diferente de “*”, o cron roda quando qualquer um corresponde, e não os dois. “0 0 1 * 1” roda no primeiro dia do mês e em toda segunda-feira, e não apenas nas segundas-feiras que caem no dia 1. A explicação diz isso de forma explícita quando se aplica.

Tanto 0 quanto 7 significam domingo

O campo de dia da semana aceita de 0 a 7, com os dois extremos significando domingo. É uma fonte frequente de confusão de diferença de um ao copiar um agendamento entre sistemas.

Ele valida enquanto explica

Valores fora do intervalo, intervalos malformados e passos zero são informados junto com o campo de onde vieram, em vez de produzir uma descrição confiante, mas errada.

Perguntas frequentes

Explicador de expressões cron — perguntas

O que significam os cinco campos?

Minuto, hora, dia do mês, mês e dia da semana, nessa ordem.

Por que meu agendamento roda com mais frequência do que o esperado?

Provavelmente porque o dia do mês e o dia da semana estão ambos definidos. O cron trata os dois como OU, então roda quando qualquer um deles corresponde.

O domingo é 0 ou 7?

Os dois. O campo de dia da semana aceita de 0 a 7 e trata cada extremo como domingo.

Ele é compatível com o campo de segundos?

Um campo de segundos no início é ignorado, se presente; os cinco campos padrão são explicados.