Sobre a ferramenta: Interpretador de expressões cron
Cron é o agendador do Unix e do Linux que executa tarefas em horários fixos, e um texto como 30 9 * * 1 é uma expressão cron. A mesma sintaxe de cinco campos é usada pelo crontab, GitHub Actions, CronJobs do Kubernetes, AWS EventBridge, Google Cloud Scheduler e pelo @Scheduled do Spring.
Enquanto você digita, esta ferramenta explica o agendamento em português, lista as próximas execuções e, se houver erro, mostra qual campo é inválido e por quê. Tudo é processado no seu navegador.
Como usar
- Digite uma expressão cron ou escolha uma em Agendamentos comuns.
- Leia a explicação em português e a próxima execução no quadro de resultado.
- No Gerador, escolha minuto, hora, dia, mês e dia da semana — a expressão é atualizada automaticamente.
- Confira abaixo as 10 próximas execuções no fuso horário do seu navegador.
Estrutura de uma expressão cron
| Nº | Campo | Valores permitidos |
|---|---|---|
| 1 | Minuto | 0–59 |
| 2 | Hora | 0–23 |
| 3 | Dia do mês | 1–31 |
| 4 | Mês | 1–12 ou JAN–DEC |
| 5 | Dia da semana | 0–7 (0 e 7 = domingo) ou SUN–SAT |
Com 6 campos, o primeiro é lido como segundos (0–59), como no Spring e no Quartz. Macros como @daily, @weekly e @hourly também são aceitas.
Caracteres especiais
| Símbolo | Significado | Exemplo | Resultado |
|---|---|---|---|
| * | qualquer valor | * * * * * | a cada minuto |
| , | lista de valores | 0 9,18 * * * | às 9h e às 18h |
| - | intervalo | 0 9 * * 1-5 | de segunda a sexta às 9h |
| / | passo | */10 * * * * | a cada 10 minutos |
Se você restringir o dia do mês e o dia da semana ao mesmo tempo (por exemplo, 0 0 13 * 5), o cron padrão executa quando qualquer um dos dois coincide: no dia 13 de cada mês e em toda sexta-feira, não só na sexta-feira 13.
Perguntas frequentes
Por que meu cron roda no horário errado?
O cron usa o fuso horário da máquina. Muitos servidores, o GitHub Actions e o AWS EventBridge funcionam em UTC: converta o horário local para UTC (o horário de Brasília é UTC−3) ou defina TZ / CRON_TZ se o seu sistema permitir.
L, W e # são aceitos?
Não. Último dia do mês (L), dia útil mais próximo (W) e n-ésimo dia da semana (#) são extensões do Quartz que o crontab padrão não entende, por isso a ferramenta as indica como erro.
Em qual fuso horário aparecem as próximas execuções?
No fuso do seu navegador (mostrado ao lado da lista), considerando mudanças de horário de verão onde houver.
O que acontece com uma data que não existe, como 30 de fevereiro?
A sintaxe é válida, mas a tarefa nunca é executada. A ferramenta avisa que não há execuções nos próximos 8 anos.