pressione ⌘K para trocar de ferramenta
TIME

Editor de Expressões Crontab

Analisa expressões Crontab e pré-visualiza próximas execuções.

local
§01 SOBRE ESTA FERRAMENTA

Visão geral

A maioria das ferramentas de cron diz se a expressão é analisável. A pergunta que as pessoas de fato têm é quando isto vai disparar, e se dispara mais vezes do que se pretendia.

Este editor devolve cada um dos cinco campos em palavras e depois mostra os próximos sete dias como um mapa de calor de disparos por hora. Um job que você queria noturno e que acende a cada hora fica óbvio de imediato — muito antes de encher os seus logs.

Como usar

  1. Digite uma expressão, ou comece por um dos presets.
  2. Leia os cinco cartões de campo — cada um mostra o token bruto, o que ele significa e quantos valores ele casa.
  3. Confira o mapa de calor. Cada linha é um dia, cada coluna uma hora; células mais claras significam mais disparos naquela hora.
  4. Leia ao lado os horários exatos das próximas execuções, com a distância de cada uma. Clique em qualquer linha para copiar o carimbo de tempo ISO 8601.
  5. Alterne o cabeçalho entre o seu fuso e UTC para ler a mesma agenda no relógio que o seu servidor realmente usa.

Exemplos

  • */15 9-17 * * 1-5 — a cada 15 minutos no horário comercial, em dias de semana. O mapa de calor mostra um bloco cheio de segunda a sexta e fins de semana vazios.
  • 0 3 * * * — 03:00 toda noite. Uma célula acesa por linha.
  • 0 0 13 * 5 — a pegadinha: isto dispara no dia 13 e em toda sexta-feira, não só na sexta-feira 13. A ferramenta avisa quando os dois campos de dia estão restritos.

Observações

Os campos são minuto, hora, dia do mês, mês e dia da semana. O dia da semana aceita 0–7, sendo que tanto 0 quanto 7 significam domingo.

A pré-visualização procura para frente por até dois anos. Uma expressão que nunca dispara nessa janela — 30 de fevereiro, por exemplo — é reportada como tal, em vez de mostrar uma lista vazia sem explicação.

FAQ
Os horários estão em qual fuso?
No que você escolher. O cron em si não tem fuso — ele dispara pelo relógio local da máquina que o executa, então o cabeçalho permite alternar entre o seu fuso e o UTC e ler a agenda inteira nesse relógio. Se o seu servidor roda em UTC e você não, esse botão é a diferença.
Por que a ferramenta avisa sobre dia do mês e dia da semana?
Porque o cron POSIX faz algo surpreendente aí: quando os dois campos estão restritos, ele dispara quando *qualquer um* dos dois casa, e não os dois. Então 0 0 13 * 5 roda no dia 13 e em toda sexta-feira. Quando um deles é *, vale o comportamento AND normal.
Tem suporte a @daily e a nomes de dias?
Sim — @yearly, @annually, @monthly, @weekly, @daily, @midnight e @hourly são expandidos, e nomes como mon-fri ou jan funcionam. @reboot é rejeitado de propósito: ele dispara na inicialização, então não há agenda para pré-visualizar.
E as expressões de seis campos?
Essas são o dialeto com precisão de segundos usado por Quartz e Spring, e não o cron POSIX. A ferramenta diz isso em vez de ler os campos errado silenciosamente.