Gerador de Expressões Cron

O que é esta ferramenta?

Uma expressão cron é uma string de agendamento compacta, de cinco campos — `minuto hora dia-do-mês mês dia-da-semana` — usada pelo daemon `cron` do Unix e praticamente todo agendador de tarefas modelado a partir dele (crontab, Kubernetes CronJobs, `schedule:` do GitHub Actions, Airflow, Jenkins). Cada campo aceita um asterisco (`*`, significando "qualquer valor"), um número específico, uma lista separada por vírgulas (`1,15,30`), um intervalo (`9-17`), um passo (`*/15`, significando "a cada 15 unidades") ou — para mês e dia da semana — um nome de três letras (`JAN`, `MON`) em vez de um número.

A definição canônica dessa sintaxe é a página de manual crontab(5) do Linux, que documenta exatamente os mesmos cinco campos, caracteres especiais (`* , - /`) e as oito strings abreviadas com `@` (`@reboot`, `@yearly`/`@annually`, `@monthly`, `@weekly`, `@daily`/`@midnight`, `@hourly`) que a maioria das implementações de cron, incluindo o Vixie cron (a versão distribuída na maioria das distribuições Linux), suporta como apelidos para agendamentos comuns.

Esta ferramenta implementa exatamente esse formato padrão de 5 campos — o formato que você colocaria diretamente em `crontab -e` num servidor Linux ou macOS, ou no campo `schedule:` de um CronJob do Kubernetes. Ela não implementa a sintaxe cron do Quartz, que é um formato diferente, de 6 ou 7 campos, usado pelo Quartz Scheduler do Java e por algumas ferramentas de fornecedores (veja a seção de comparação abaixo para saber quando você precisa dele).

Por que usar?

• Você herdou o crontab de um colega que saiu da empresa e precisa entender o que uma expressão como `0 3 1,15 * *` realmente faz antes de mexer em produção.
• Está adicionando um `schedule:` a um workflow do GitHub Actions e quer evitar o erro clássico de trocar a ordem dos campos, o que faria o job rodar num horário completamente diferente do planejado.
• Está escrevendo o manifesto de um CronJob do Kubernetes e quer conferir, com a prévia dos próximos horários de execução, se o job de madrugada realmente vai rodar no horário certo (considerando o fuso) antes de fazer o deploy.
• Já caiu na pegadinha do cron em que "dia 8" e "toda segunda-feira" acabam rodando os dois, e agora sempre confere os próximos horários de execução antes de publicar uma expressão que combina dia do mês e dia da semana.
• Precisa transformar um requisito simples — "a cada 15 minutos, em dias úteis, das 9h às 17h" — numa expressão válida sem errar vírgula ou barra na hora de digitar manualmente.
• O agendamento dos jobs internos da empresa é informação sensível, então prefere uma ferramenta que roda inteiramente no navegador, sem enviar nada a um servidor externo.

Como usar

1. Para traduzir uma expressão: digite ou cole uma string cron de 5 campos (ou uma abreviação com @ como `@daily`) no campo de entrada.
2. Leia a descrição em português claro e os próximos 5 horários de execução calculados abaixo dela — ambos são atualizados em tempo real enquanto você digita.
3. Para montar uma em vez disso: abra a seção Construtor, escolha um modo (todo / a cada N / valor específico) para cada um dos cinco campos e clique em "Gerar expressão."
4. A expressão gerada preenche o campo de entrada acima e alimenta imediatamente os painéis de descrição e próximos horários.
5. Use a legenda de sintaxe na parte inferior como referência rápida para `*`, `,`, `-` e `/`.
6. Copie a expressão final com o botão Copiar e cole no seu crontab, config de CI ou agendador.

Exemplo

Entrada

*/15 9-17 * * MON-FRI

Resultado

Às 09:00, 09:15, 09:30, 09:45, 10:00 ... 17:45, na segunda, terça, quarta, quinta e sexta-feira

Esta expressão é executada a cada 15 minutos, mas apenas dentro do intervalo das 09:00 às 17:59, e apenas em dias úteis — um agendamento típico de verificação em "horário comercial".

Cron padrão vs. Quartz cron

"Sintaxe cron" não é um único padrão universal — os dois formatos que você mais vai encontrar diferem no número de campos e no significado de alguns caracteres especiais. Use esta tabela para confirmar que está usando o formato correto para o seu agendador de destino.

Ferramentas relacionadas

Trabalhando com configs, agendamentos ou timestamps? Estas ferramentas combinam bem com o gerador de cron.

→ Conversor de Timestamp · Conversor de Fuso Horário Mundial · Calculadora de Datas

Armadilhas comuns de fuso horário em produção

Uma expressão cron pode estar tecnicamente correta e ainda assim rodar num horário totalmente diferente do esperado em produção. É especialmente comum entre equipes no Brasil e em Portugal usar servidores em nuvem ou containers Docker configurados por padrão em UTC, sem perceber — o resultado é um job que deveria rodar de madrugada acabando disparado em plena tarde local. Confirmar sempre os "próximos horários de execução" ao gerar ou validar uma expressão ajuda a pegar esse tipo de erro antes que ele afete o ambiente de produção.

• Confira o fuso horário do servidor ou container com um comando como `date` antes de fazer o deploy do agendamento.
• Lembre-se que o cron do GitHub Actions e da maioria dos runners de CI é avaliado em UTC — sempre converta a partir do horário local antes de publicar.
• Não esqueça que definir dia do mês E dia da semana ao mesmo tempo faz o cron tratar como "OU", não "E" — confira os próximos horários para garantir que o job não vai rodar em dias extras sem querer.
• Em servidores de regiões com horário de verão, o agendamento pode escorregar uma hora duas vezes por ano — trabalhar com UTC internamente e converter na aplicação evita essa armadilha.

Perguntas frequentes