Pular para o conteúdo

Interpretador de expressões cron

  • Roda no seu dispositivo
  • Funciona offline depois de carregada

Digite um agendamento cron e leia o que ele significa; depois confira as próximas execuções no fuso horário que importa para você. Edite cada campo separadamente, teste predefinições como a cada 15 minutos ou em dias úteis às 8:30, e use o campo de segundos se o seu agendador tiver.

Como funciona

  1. Digite uma expressão cron ou escolha uma predefinição.
  2. Leia a descrição em linguagem simples.
  3. Confira as próximas execuções no seu fuso horário.

Por que usar

  • Explicação em linguagem simples.
  • De 5 a 50 próximas execuções.
  • Qualquer fuso horário IANA.
  • Expressões de cinco ou seis campos.

Ler expressões cron e conferir quando elas rodam

Os cinco campos

Uma expressão cron são cinco valores separados por espaços, lidos da esquerda para a direita: minuto, hora, dia do mês, mês e dia da semana. Um * significa qualquer valor. O crontab do Linux, o GitHub Actions, os CronJobs do Kubernetes e a maioria dos agendadores de tarefas usam esse formato.

CampoValores permitidosExemplo
MinutoDe 0 a 59*/15 a cada 15 minutos
HoraDe 0 a 239-17 das 9:00 às 17:00
Dia do mêsDe 1 a 311 no dia primeiro
MêsDe 1 a 12 ou de JAN a DEC*/3 a cada três meses
Dia da semanaDe 0 a 7 ou de SUN a SAT, 0 e 7 são ambos domingo1-5 de segunda a sexta

Vírgulas listam valores (1,15), hífens dão intervalos (9-17) e uma barra dá passos (*/10). O exemplo padrão, */15 9-17 * * 1-5, roda a cada 15 minutos das 9:00 às 17:45 em dias úteis. Alguns sistemas, como o Quartz e alguns agendadores em nuvem, acrescentam na frente um sexto campo para os segundos: */5 * * * * * roda a cada 5 segundos. O interpretador aceita os dois.

As armadilhas

  • Dia do mês e dia da semana juntos. 0 9 1 * 1 roda às 9:00 no dia primeiro do mês e toda segunda-feira, não só nas segundas que caem no dia primeiro. A lista de próximas execuções mostra isso na hora.
  • `9-17` inclui o 17. Com */15 no campo dos minutos, a última execução é às 17:45, não às 17:00.
  • Fusos horários. Servidores costumam rodar o cron em UTC. Uma tarefa marcada para as 9:00 roda às 9:00 UTC, que são 6:00 em São Paulo. Escolha o fuso horário do servidor na lista para ver os horários reais.
  • Horário de verão. Na noite em que os relógios mudam, uma tarefa às 2:30 pode rodar duas vezes ou nenhuma, dependendo do agendador. Evite agendar na hora em torno das 2:00, horário local.

Conferir uma expressão

Digite ou cole uma expressão e três coisas se atualizam: uma frase que a descreve, o detalhamento de cada campo e uma lista das próximas execuções como datas. Ver as datas reais é a conferência mais segura: se a lista mostrar uma execução que você não esperava, a expressão não significa o que você pensou. Aumente o número de execuções para 50 para conferir um mês inteiro de uma tarefa frequente, e troque o fuso horário para comparar como ela roda num servidor em outro lugar. Há um relógio de 24 horas e uma redação mais detalhada à disposição.

Ferramentas relacionadas

Logs do cron e sistemas de tarefas geralmente registram horários como timestamps Unix; o conversor de timestamp os transforma em datas em qualquer fuso horário. Timestamps Unix explicados cobre o formato e suas armadilhas.

Se algo der errado

  • Diz que a expressão é inválida. Conte os campos: cinco, ou seis com os segundos. Um valor está fora do intervalo, como 24 na hora ou 60 no minuto.
  • As próximas execuções não são as esperadas. Confira o fuso horário e depois os campos de dia do mês e dia da semana.
  • Seu agendador recusa uma expressão que funciona aqui. Os agendadores diferem: alguns não aceitam nomes como MON, um campo de segundos ou caracteres especiais como L e #.

Perguntas e respostas

O que significa */15?

Significa a cada 15 unidades daquele campo, então */15 no campo dos minutos roda nos minutos 0, 15, 30 e 45.

Aceita segundos?

Sim. Uma expressão de seis campos usa o primeiro campo para os segundos.

Os horários de execução são exatos?

Eles são calculados a partir da expressão e do fuso horário escolhido, incluindo as mudanças de horário de verão.

Guias relacionados

Dados5 min de leitura

Timestamps Unix explicados

Um timestamp Unix é só uma contagem de segundos, mas causa um fluxo constante de bugs. O que ele conta, como distinguir segundos de milissegundos num relance, o que acontece com fusos horários e segundos bissextos, e por que 2038 importa.

Esc