Analisador de Cron
Analisa, valida e depura expressões cron.
Exemplos de uso
Verificar quando um trabalho em lote realmente vai rodar antes de publicá-lo
Antes de escrever uma expressão cron em um arquivo de configuração, pré-visualize a lista das próximas execuções para confirmar que ela dispara exatamente quando você pretendia.
Traduzir uma expressão densa para linguagem simples
Se algo como */15 8-20 * * 1-5 não estiver imediatamente claro, a descrição em linguagem simples explica exatamente o que significa.
Depurar um job cron que silenciosamente não roda
Se um trabalho agendado nunca parece disparar, cole a expressão para verificar na hora se há um erro de sintaxe.
Escolher entre uma lista com vírgulas e um intervalo para agendar dias da semana
Não tem certeza se 1,3,5 e 1-5 significam a mesma coisa no campo de dia da semana? Teste os dois e compare lado a lado a descrição em linguagem simples e os horários das próximas execuções para ver exatamente como eles diferem.
Transformar um requisito vago em uma expressão que funciona
Pediram para executar algo "a cada 15 minutos em horário comercial nos dias úteis"? Comece por um padrão, ajuste-o até algo como */15 9-17 * * 1-5 e confirme que os horários das próximas execuções batem com o que foi pedido.
Migrar um agendamento de um executor de tarefas para outro
Vai mover uma tarefa agendada de um sistema legado para algo como um CronJob do Kubernetes ou um workflow do GitHub Actions? Cole a expressão antiga para obter uma explicação em linguagem simples que você pode conferir na documentação da nova plataforma antes de copiá-la.
Verificar se uma expressão com precisão de segundos é interpretada como esperado
Trabalhando com uma biblioteca de agendamento que aceita um campo opcional de segundos no início, como 0 */30 * * * *? Cole-a para confirmar que ela está sendo lida como uma expressão de 6 campos, e não interpretada de forma errada como o formato padrão de 5 campos.
Referência rápida
| Expressão cron | Descrição |
|---|---|
| * * * * * | A cada minuto |
| */2 * * * * | A cada 2 minutos |
| */5 * * * * | A cada 5 minutos |
| */10 * * * * | A cada 10 minutos |
| */15 * * * * | A cada 15 minutos |
| */30 * * * * | A cada 30 minutos |
| 0 * * * * | A cada hora |
| 0 */2 * * * | À hora certa, a cada 2 horas |
| 0 */3 * * * | À hora certa, a cada 3 horas |
| 0 */6 * * * | À hora certa, a cada 6 horas |
| 0 */12 * * * | À hora certa, a cada 12 horas |
| 0 0 * * * | Às 00:00 |
| 30 2 * * * | Às 02:30 |
| 0 9 * * * | Às 09:00 |
| 0 9,17 * * * | Às 09:00 e 17:00 |
| 0 9 * * 1-5 | Às 09:00, de segunda-feira a sexta-feira |
| */15 9-17 * * 1-5 | A cada 15 minutos, entre 09:00 e 17:59, de segunda-feira a sexta-feira |
| 0 9 * * 1 | Às 09:00, somente de segunda-feira |
| 0 0 * * 0 | Às 00:00, somente de domingo |
| 0 10 * * 6,0 | Às 10:00, somente de domingo e sábado |
| 0 0 1 * * | Às 00:00, no dia 1 do mês |
| 0 0 15 * * | Às 00:00, no dia 15 do mês |
| 0 0 1,15 * * | Às 00:00, no dia 1 e 15 do mês |
| 0 0 1 */3 * | Às 00:00, no dia 1 do mês, a cada 3 meses |
| 0 0 1 1 * | Às 00:00, no dia 1 do mês, somente em janeiro |
Perguntas frequentes
A expressão que eu digito é enviada para um servidor?
Não. A análise e o cálculo acontecem inteiramente no seu navegador, e o que você digita nunca é enviado a um servidor.
Isso suporta expressões com segundos (6 campos)?
Sim. Tanto o formato cron padrão de 5 campos (minuto, hora, dia, mês, dia da semana) quanto o formato de 6 campos com um campo de segundos no início são detectados automaticamente.
Em qual fuso horário se baseiam as próximas execuções?
Elas são calculadas usando o fuso horário atual do seu dispositivo (navegador), sem nenhuma configuração separada. Se o servidor real rodar em outro fuso horário, os horários exibidos serão diferentes.
Posso usar aliases como @daily ou @hourly?
Sim. Aliases comuns como @yearly, @monthly, @weekly, @daily e @hourly são todos suportados.
Se os horários das próximas execuções estão errados, a expressão está com problema?
Não necessariamente — a causa mais comum é uma diferença de fuso horário, e não uma expressão errada. Como os horários das próximas execuções são calculados no fuso horário local do seu navegador, uma expressão perfeitamente correta para um servidor rodando em UTC (ou em qualquer outro fuso) mostrará horários diferentes aqui. Antes de supor que a expressão está errada, verifique em que fuso horário o agendador real é executado e faça o deslocamento, mentalmente ou manualmente.
O que significam *, ,, -, e / em um campo?
* significa "todos os valores" daquele campo. Uma lista separada por vírgulas, como 1,15,30, corresponde exatamente a esses valores. Um intervalo com hífen, como 9-17, corresponde a todos os valores entre eles, inclusive. Uma barra, como */15 ou 9-17/2, significa "a cada N valores", a partir do início do campo (ou do início de um intervalo) — então */15 no campo dos minutos dispara em :00, :15, :30 e :45. Eles podem ser combinados, por exemplo 0,30 9-17 * * 1-5.
Qual é a diferença entre dia do mês e dia da semana, e o que acontece se eu definir os dois?
O 5º campo é o dia da semana (0–6 ou nomes, em que 0 e 7 normalmente significam domingo) e o 3º campo é o dia do mês (1–31). Se você restringir os dois, afastando-os de *, ao mesmo tempo, a maioria das implementações de cron (incluindo a usada aqui) os trata com OU — a tarefa é executada quando qualquer uma das condições é atendida, e não apenas quando ambas são. Isso confunde muita gente, então, se você só quer um dos dois, deixe o outro como *.
Esta ferramenta suporta campos não padrão, como um campo de ano ou os caracteres L/W?
O cron padrão de 5 campos e o de 6 campos com segundos na frente são totalmente suportados, incluindo *, intervalos, listas e passos. Algumas extensões específicas de fornecedores, menos comuns (como um campo de ano no final, ou L para "último dia do mês" e W para "dia útil mais próximo", usados por ferramentas como o Quartz), podem não ser reconhecidas — se você vir um erro de análise inesperado com uma delas, vale verificar se o seu agendador de destino realmente precisa dessa extensão ou se um equivalente padrão serve.