Ir para o conteúdo

Criar e explicar expressões cron

Monte um agendamento cron de forma visual, leia o que ele significa em português claro e veja os próximos horários de execução em qualquer fuso horário, com sintaxe padrão, Quartz e AWS, no navegador.

Em linguagem simples

At 09:30, on Monday through Friday

Predefinições

Montar visualmente

Próximas 10 execuções

Calculando…

Horários pulados por mudança de horário de verão não são executados; uma hora repetida é executada uma vez. Daemons de cron reais diferem um pouco nesse ponto.

Guia rápido — Padrão
CampoValores permitidos
Minuto0–59
Hora0–23
Dia do mês1–31
Mês1–12 ou JAN–DEC
Dia da semana0–7 (0 e 7 = domingo) ou SUN–SAT
SímboloSignificado
*qualquer valor
,lista: 1,15 = os dias 1 e 15
-intervalo: 1-5 = de 1 a 5
/passo: */15 = a cada 15; 5/15 = 5, 20, 35, 50
@dailymacros: @yearly @monthly @weekly @daily @hourly (e @reboot)

Quando dia do mês e dia da semana são restritos ao mesmo tempo, o cron padrão executa nos dias que correspondem a um deles.

Roda no seu navegador · sem uploadComo funciona

Como usar: Gerador de expressão cron

  1. 1

    Escolha o dialeto

    Escolha cron padrão, cron com segundos, Quartz ou AWS EventBridge — ou apenas cole a expressão e deixe o número de campos decidir.

  2. 2

    Escreva ou monte o agendamento

    Digite uma expressão, comece por uma predefinição ou defina cada campo no editor visual.

  3. 3

    Leia o resultado

    Confira a descrição em linguagem simples e os campos destacados para ter certeza de que ela significa o que você queria.

  4. 4

    Confira as próximas execuções

    Escolha um fuso horário, confirme as próximas 10 execuções e copie a expressão.

Limites e Pro

Grátis e sem cadastro: 4 dialetos, 12 predefinições e as próximas 10 execuções em qualquer um de mais de 400 fusos horários, buscando até 30 anos à frente (ou até o último ano da expressão).

O Pro remove os anúncios; o construtor funciona igual em todos os planos. Ver o Pro

Sobre: Gerador de expressão cron

Uma expressão cron resume um agendamento em alguns campos separados por espaço, e um único número fora do lugar pode transformar “todo dia útil às 9” em “a cada minuto da hora 9”. Este construtor permite escrever ou colar uma expressão e ver na hora a descrição em linguagem simples, com cada campo identificado, além de listar os próximos dez horários em que ela será executada.

São quatro dialetos, porque eles realmente são diferentes. O cron padrão tem cinco campos (minuto, hora, dia do mês, mês e dia da semana) e é o usado pelo crontab, pelos daemons de cron do Linux, pelos CronJobs do Kubernetes e pelo GitHub Actions; ele também aceita macros como @daily. O dialeto com segundos acrescenta um campo de segundos no início, como em node-cron e croner. O Quartz usa seis ou sete campos, com segundos e um ano opcional, numera o domingo como 1, exige um ? em um dos campos de dia e acrescenta L para “último”, W para “dia útil mais próximo” e # para “terceira sexta-feira”. O AWS EventBridge tem seis campos terminados em ano, usa as mesmas regras de dia do Quartz e é escrito como cron(…). Ao colar uma expressão, o dialeto muda sozinho quando o número de campos deixa isso óbvio, e, ao trocar de dialeto, o que você já escreveu é convertido sempre que possível.

O editor visual define cada campo com os controles A cada, valores específicos e Intervalo, e as predefinições cobrem tarefas comuns. Os horários de execução são calculados em qualquer fuso horário IANA, respeitando as lacunas do horário de verão, e as regras do EventBridge usam UTC por padrão, como a AWS as avalia.

O construtor verifica apenas a sintaxe e os horários: ele não conhece o relógio do seu servidor, as execuções perdidas enquanto uma máquina estava desligada nem limites específicos de cada agendador, como o intervalo mínimo do GitHub.

Privacidade

As expressões são analisadas e os horários de execução calculados por código desta página, usando os dados de fuso horário do seu navegador; nada é enviado a um servidor. O dialeto e o fuso horário escolhidos ficam salvos no armazenamento local para a sua próxima visita.

Recursos

Explicações em linguagem simples

“Às 09:30, de segunda-feira a sexta-feira” em vez de ficar adivinhando o que 30 9 * * 1-5 faz.

Próximas 10 execuções, em qualquer fuso

Horários em UTC ou em qualquer fuso horário IANA, com as mudanças do horário de verão tratadas.

Sintaxe Quartz e AWS

Segundos, anos, ?, L, W e # para os agendadores que os suportam.

Gerador de expressão cron: perguntas frequentes

Por que minha tarefa roda em mais dias do que eu esperava?
No cron padrão, se os campos de dia do mês e de dia da semana estiverem ambos restritos, a tarefa roda quando qualquer um deles coincidir. Assim, 0 9 13 * 5 roda todo dia 13 e também toda sexta-feira, não só na sexta-feira 13. A descrição aqui deixa isso claro. Quartz e AWS evitam a ambiguidade exigindo um ? em um dos dois campos.
O que significa */15 em uma expressão cron?
A barra indica um passo: */15 no campo de minuto significa a cada 15 minutos a partir do 0, ou seja, em :00, :15, :30 e :45. Um valor inicial desloca isso: 5/15 roda em :05, :20, :35 e :50. Combinado com um intervalo, 9-17/2 no campo de hora significa a cada duas horas, das 9 às 17.
Qual fuso horário o cron usa?
Um daemon de cron clássico usa o fuso horário local do servidor, a menos que o crontab defina CRON_TZ ou TZ. Os CronJobs do Kubernetes usam por padrão o fuso do controlador, mas aceitam o campo timeZone; o GitHub Actions agenda em UTC, e as regras do EventBridge sempre usam UTC, enquanto o EventBridge Scheduler permite escolher um fuso. Escolha aqui o fuso correspondente para ver os horários reais.
O que acontece nas mudanças do horário de verão?
Quando o relógio adianta, os horários locais da hora pulada não existem, e quando ele atrasa, uma hora acontece duas vezes. Esta pré-visualização ignora horários inexistentes e executa os repetidos uma só vez. Os daemons reais variam: Vixie cron e cronie tentam rodar tarefas puladas. Para tarefas entre 01:00 e 03:00 no horário local, prefira UTC ou consulte a documentação do seu agendador.
Como converto uma linha de crontab para o formato Quartz ou AWS?
Escolha o novo dialeto na lista e a expressão é convertida: um campo de segundos é adicionado para o Quartz, um campo de ano para a AWS, os números do dia da semana passam de 0–6 para 1–7 e um ? é colocado no campo de dia não usado. Se a original define dia do mês e dia da semana ao mesmo tempo, você é avisado de que o destino não consegue expressar essa combinação.