Gerador de Crontab
Digite uma expressão cron e veja na hora o que ela significa em linguagem simples, ou comece a partir de um preset comum e ajuste. Tudo roda no seu navegador — nada é enviado.
Como usar o gerador de crontab
- Digite uma expressão cron, ou clique em um preset para começar a partir de um agendamento comum.
- Leia a descrição em linguagem simples que se atualiza conforme você digita.
- Copie a expressão para o seu crontab, configuração de CI ou agendador.
Sobre expressões cron
Cron é o agendador de tarefas baseado em tempo dos sistemas tipo Unix, e a mesma sintaxe de cinco campos é usada por pipelines de CI, agendadores de containers e muitos serviços de nuvem. Cada campo controla uma unidade de tempo, e caracteres especiais — * (todos), intervalos, /passos e ,listas — se combinam para expressar agendamentos de "a cada minuto" a "09:00 nos dias úteis".
Como a sintaxe é concisa, um pequeno erro muda silenciosamente quando uma tarefa é executada. Esta ferramenta traduz uma expressão em uma frase para que você possa confirmar que ela faz o que pretende antes de implantá-la. Ela analisa tudo localmente no seu navegador, então seus agendamentos nunca saem do seu dispositivo.
Existem dois detalhes que podem confundir até mesmo usuários experientes. Primeiro, quando você restringe tanto o dia do mês quanto o dia da semana — por exemplo, "0 0 1 * 1" —, a maioria das implementações do cron executa a tarefa quando qualquer um dos campos corresponde, de modo que a tarefa é executada no dia 1 e em todas as segundas-feiras, e não apenas nas segundas-feiras que caem no dia 1. Segundo, o domingo pode ser escrito como 0 ou 7; ambos são aceitos pela maioria dos crons, mas escolha um e mantenha a consistência para que seus agendamentos permaneçam fáceis de entender.
Uma expressão cron não especifica nada sobre fusos horários — a programação é executada no fuso horário utilizado pelo servidor ou serviço, e as plataformas de CI geralmente usam o UTC como padrão. Se o seu relatório com a programação "0 9 * * 1-5" chegar no horário errado, essa é geralmente a razão. As mudanças para o horário de verão adicionam mais uma complicação: tarefas programadas entre 1h e 3h da manhã, no horário local, podem ser ignoradas ou executadas duas vezes nas noites de mudança de horário. Portanto, programe as tarefas críticas fora desse intervalo ou em um servidor que utilize o UTC.
Perguntas frequentes
O que é uma expressão cron?
Uma expressão cron são cinco campos — minuto, hora, dia do mês, mês e dia da semana — que definem um agendamento repetitivo para uma tarefa agendada (um "cron job") em sistemas tipo Unix.
Como leio uma linha de crontab?
Cole acima e a ferramenta descreve em linguagem simples, por exemplo "30 9 * * 1-5" vira "Às 09:30, de segunda a sexta". Use os presets para agendamentos comuns.
Ela suporta intervalos, passos e listas?
Sim — intervalos (1-5), passos (*/15), listas (1,15,30) e nomes (JAN, MON) são todos entendidos e explicados.
Algo é enviado?
Não. A expressão é analisada inteiramente no seu navegador; nada é enviado a um servidor.
Por que meu agendamento de tarefa (cron job) é executado a cada minuto, em vez de apenas uma vez?
Quase sempre porque o campo de minutos ainda é um asterisco. * significa "todos", então "* 9 * * *" corresponde a todos os minutos da hora das 9h — sessenta execuções — enquanto "0 9 * * *" executa uma única vez às 09:00. Cole sua expressão acima e leia a descrição: se começar com "todos os minutos", defina o campo de minutos para um valor específico.