Sobre Gerador de expressões cron

Um gerador de cron monta uma expressão crontab padrão de 5 campos a partir de escolhas simples, para você agendar uma tarefa sem decorar a ordem dos campos.

Ele cobre o formato clássico usado pelo cron do Linux, pelo CronJob do Kubernetes e pela maioria dos agendadores de CI: minuto, hora, dia do mês, mês e dia da semana. Não existe campo de segundos, portanto expressões de 6 ou 7 campos no estilo Quartz estão fora do escopo.

Como usar o Cron Expression Generator

Comece por um preset como a cada 5 minutos, a cada hora, diariamente à meia-noite, dias úteis às 09:00 ou mensalmente no dia 1. O preset preenche os controles de campo abaixo, e você segue ajustando a partir dali.
Ajuste qualquer campo com um dos cinco modos: Todos para um asterisco simples, A cada N para um passo como */15, Intervalo para uma faixa como 9-17, Lista para valores como 1,15,30 e Exato para um número único.
Leia a expressão enquanto ela se atualiza ao vivo e depois copie para o seu crontab, para a configuração de CI ou para o manifesto do CronJob.
Confira os próximos 6 horários de execução exibidos logo abaixo. Essa previsão é a forma mais rápida de pegar um valor colocado no campo errado.

Quando usar

Agendar um backup noturno do banco de dados que precisa terminar antes do início do horário comercial.
Rotacionar ou arquivar logs em uma cadência fixa semanal ou mensal.
Aquecer um cache ou reconstruir um índice de busca antes do pico diário de tráfego.
Enviar um relatório toda segunda-feira de manhã, ou no primeiro dia de cada mês para faturamento.
Disparar um build noturno de CI e uma verificação periódica de renovação de certificado.

Regras de sintaxe do cron que causam a maioria dos erros

Os cinco campos são minuto, hora, dia do mês, mês e dia da semana, nessa ordem. A maior parte dos agendamentos incorretos vem de algumas semânticas fáceis de ler errado.

Quando dia do mês e dia da semana estão ambos definidos com algo diferente de asterisco, o cron combina os dois com OR, e não com AND. Ou seja, 0 0 13 * FRI significa todo dia 13 de cada mês ou toda sexta-feira, e não apenas uma sexta-feira 13.
Um passo como */15 começa em 0 e se repete a cada 15 unidades, gerando 0, 15, 30, 45. Um passo escrito como 5/15 começa em 5 e vai até o máximo, gerando 5, 20, 35, 50.
No campo de dia da semana, tanto 0 quanto 7 significam domingo, então o mesmo agendamento pode ser escrito de duas formas.
Mês e dia da semana aceitam nomes de três letras, como JAN até DEC e MON até SUN.
O cron roda no fuso horário local da máquina que guarda o agendamento, então confirme esse fuso antes de implantar. Transições de horário de verão podem pular ou repetir um intervalo de uma hora.

Perguntas frequentes sobre Gerador de cron

Esta ferramenta suporta campo de segundos?: Não. Ela produz apenas o formato crontab padrão de 5 campos. O Quartz e alguns agendadores Java usam 6 ou 7 campos com segundos e um ano opcional, que não são gerados aqui.
Por que meu agendamento com dia do mês e dia da semana dispara mais vezes do que eu esperava?: Porque o cron trata esses dois campos como OR quando nenhum deles é asterisco. Para uma condição estrita de AND, agende o cron mais amplo e acrescente uma verificação de data dentro da própria tarefa.
É seguro rodar uma tarefa a cada minuto?: Só se uma execução terminar bem abaixo de um minuto. Caso contrário as execuções se sobrepõem e se acumulam, então use um arquivo de trava ou uma proteção de instância única, ou aumente o intervalo.
Qual fuso horário os próximos horários de execução usam?: A previsão usa o fuso horário do seu navegador. A máquina que executa o agendamento usa o dela, então verifique se os dois coincidem antes de contar com um horário exato.
Meu agendamento é enviado para algum lugar?: Não. Toda expressão em wetool.site é montada e prevista inteiramente no seu navegador, e nada do que você digita vai para um servidor.

Gerador de cron x interpretador de cron

O interpretador de cron deste site resolve o problema inverso: você já tem uma expressão e quer saber o que ela significa e quando dispara a próxima vez. Este gerador vai no outro sentido, transformando um agendamento que você consegue descrever em palavras na sintaxe correta. Os dois são complementares, então depois de gerar uma expressão você pode colá-la no interpretador como uma segunda conferência independente.

Verificações antes de implantar um agendamento

Uma expressão que parece certa ainda pode disparar no momento errado em um servidor real. Uma revisão curta pega a maior parte dos casos.

Compare os próximos 6 horários de execução com o que você pretendia, especialmente o primeiro, que expõe imediatamente erros de campo deslocado.
Confirme o fuso horário da máquina ou do contêiner que executa a tarefa, e prefira UTC em sistemas que atendem várias regiões.
Distribua tarefas pesadas por minutos diferentes em vez de empilhar tudo no minuto 0.
Defina o que deve acontecer se uma execução for perdida enquanto o host está fora do ar, já que o cron padrão não recupera execuções puladas.