Um gerador de expressões cron que você pode entender
Este gerador gratuito de expressões cron transforma uma programação nos cinco ou seis campos curtos esperados pelo cron, Kubernetes, GitHub Actions e Quartz, e transforma qualquer expressão novamente em linguagem simples. Digite uma expressão e o construtor a acompanha; clique no construtor e a expressão será atualizada. Você também vê os próximos 10 horários de execução no fuso horário escolhido, para confirmar que "todos os dias úteis às 9" realmente significa o que você pensa antes de colocar uma tarefa em produção.
A ferramenta oferece suporte à sintaxe padrão do crontab com 5 campos e à sintaxe do Quartz usada pelos agendadores do Java, com segundos e um ano opcional. Tudo é calculado no seu navegador.
Sintaxe do Cron em uma tabela
| Campo | Padrão | Quartz | Especiais permitidos |
|---|---|---|---|
| Segundo | - | 0-59 | * , - / |
| Minuto | 0-59 | 0-59 | * , - / |
| Hora | 0-23 | 0-23 | * , - / |
| Dia do mês | 1-31 | 1-31 | * , - / (Quartz também ? L W) |
| Mês | 1-12 ou JAN-DEZ | 1-12 ou JAN-DEZ | * , - / |
| Dia da semana | 0-7 (0 e 7 = domingo) ou SUN-SAT | 1-7 (1 = domingo) ou SUN-SAT | * , - / (o Quartz também aceita ? L #) |
| Ano | - | opcional, 1970-2099 | * , - / |
* significa todos os valores, , separa uma lista (1,15), - é um intervalo (9-17) e / é um passo (*/15 é cada 15º valor começando pelo menor. O cron padrão também aceita atalhos: @hourly, @daily (o mesmo que @midnight), @weekly, @monthly, @yearly (o mesmo que @annually) e @reboot, que é executado uma vez na inicialização.
Exemplos comuns de expressões cron
-
*/5 * * * *- a cada 5 minutos. -
0 * * * *- no início de cada hora. -
30 9 * * 1-5- às 09:30, de segunda a sexta-feira. -
0 0 1 * *- à meia-noite do primeiro dia de cada mês. -
0 6,18 * * *- às 06:00 e às 18:00 todos os dias. -
0 0 12 L * ?(Quartz) - ao meio-dia do último dia de cada mês. -
0 0 9 ? * 2#1(Quartz) - às 09:00 na primeira segunda-feira de cada mês.
Cron padrão versus cron do Quartz
O crontab do Linux, os CronJobs do Kubernetes e o GitHub Actions usam 5 campos com precisão de minutos. O Quartz, o Spring e muitos agendadores Java e .NET adicionam um campo de segundos no início e um ano opcional no final. O Quartz também conta os dias da semana a partir de 1 (domingo) em vez de 0, e exige um ? no dia do mês ou no dia da semana, pois ele não combinará os dois. Em compensação, oferece atalhos úteis: L para o último dia do mês ou a última sexta-feira (6L), W para o dia da semana mais próximo (15W) e # para o enésimo dia da semana (2#2 é a segunda-feira de ordem n). O AWS EventBridge usa um formato de 6 campos semelhante ao Quartz, sem segundos. Use o botão Converter para alternar entre os dialetos; a ferramenta informa quando uma programação não pode ser expressa na outra sintaxe.
A armadilha do dia do mês e do dia da semana
No cron padrão, se você restringir os dois campos de dia, a tarefa será executada quando qualquer um deles corresponder. 0 0 1 * 1 é executado no dia 1 de todos os meses e em todas as segundas-feiras, não apenas nas segundas-feiras que caem no dia 1. O gerador avisa você sobre isso e mostra as datas reais de execução.
Fusos horários e horário de verão
O Cron é executado no fuso horário da máquina ou do serviço que o executa. As programações do GitHub Actions são sempre em UTC, e o Kubernetes aceita um fusoHorário campo, e muitos agendadores de nuvem usam UTC por padrão. Escolha um fuso horário no painel de próximas execuções para ver a programação exatamente como ela será executada. O horário de verão exige atenção especial: quando os relógios avançam, um horário local como 02:30 não existe nesse dia, e quando eles atrasam, 01:30 acontece duas vezes. As implementações de cron lidam com isso de maneiras diferentes, então evite agendar tarefas importantes entre 01:00 e 03:00 no horário local ou execute-as em UTC.
Dicas para jobs do cron confiáveis
- Use caminhos absolutos e defina o ambiente dentro do script. O cron começa com um PATH mínimo.
- Registre a saída: adicione
>> /var/log/job.log 2>&1para que as falhas deixem um registro. - Torne os jobs idempotentes e evite sobreposições (por exemplo, com
flock) se uma execução puder levar mais tempo do que o intervalo. - Distribua os jobs pesados para longe do minuto 0, quando todo mundo agenda os seus.
- Adicione um comentário acima de cada linha informando o que o job faz e quem é o responsável por ele.
Escreva os scripts chamados pelos seus jobs do cron com a ajuda do criador de consultas SQL e do gerador de README, ou navegue por todos os geradores e ferramentas de AI gratuitos.
Perguntas frequentes
O que é uma expressão cron?
Uma expressão cron é uma sequência curta de campos que descreve uma programação recorrente. O cron padrão usa cinco campos: minuto, hora, dia do mês, mês e dia da semana. Por exemplo, 30 9 * * 1-5 significa 09:30 nos dias úteis.
Qual é a diferença entre o cron padrão e o cron do Quartz?
O Quartz adiciona um campo de segundos no início e um ano opcional no final, numera os dias da semana de 1 (domingo) em vez de 0 e exige um ponto de interrogação em dia do mês ou dia da semana. Ele também aceita L, W e # para último dia, dia útil mais próximo e enésimo dia da semana.
Qual fuso horário o cron usa?
O cron usa o fuso horário da máquina ou do serviço que o executa. O GitHub Actions sempre usa UTC, os CronJobs do Kubernetes aceitam um campo timeZone e muitos agendadores de nuvem usam UTC por padrão. Selecione um fuso horário nesta ferramenta para ver os horários exatos de execução local.
Como executo um job do cron a cada 5 minutos?
Use */5 * * * * no cron padrão ou 0 0/5 * * * ? no Quartz. O valor de passo após a barra define o intervalo, começando pelo menor valor do campo.
Este gerador de cron é gratuito e privado?
Sim. É gratuito e não exige cadastro. A expressão é analisada e os horários de execução são calculados no seu navegador, portanto nada é enviado a um servidor.
