📖 Guias do Verystep

Expressões cron explicadas: leia e escreva qualquer agendamento

Cinco campos, quatro símbolos, uma armadilha famosa. Isso é tudo o que cron é — e a armadilha é justamente a parte sobre a qual ninguém avisa.

Publicado em 15 de novembro de 2026 · Um guia do Verystep

Ilustração de um grande relógio de bolso sobre uma grade de calendário com alguns dias destacados em âmbar, cercado por engrenagens

Uma expressão cron são cinco campos numa ordem fixa — minuto (0–59), hora (0–23), dia do mês (1–31), mês (1–12) e dia da semana (0–7, com 0 e 7 valendo domingo) — lidos da esquerda para a direita, da menor unidade para a maior. Quatro símbolos fazem o trabalho: * para todos os valores, vírgulas para listas, hífens para intervalos e barras para passos; assim, */15 9-17 * * 1-5 significa a cada 15 minutos em horário comercial, de segunda a sexta. E a regra que surpreende todo mundo: se o dia do mês e o dia da semana estiverem os dois restritos, a tarefa roda quando qualquer um dos dois coincide — não quando os dois coincidem.

Cinco campos, lidos da esquerda para a direita

Uma expressão cron é um agendamento escrito como cinco campos numa ordem fixa: minuto, hora, dia do mês, mês e dia da semana. O daemon confere a linha a cada minuto e, quando o horário atual coincide com todos os campos, executa o seu comando. Essa é a máquina inteira. O resto é notação.

Ilustração de cinco segmentos verticais crescendo do menor para o maior, com um relógio, o sol e a lua acima
Do menor para o maior: minuto, hora, dia do mês, mês, dia da semana.
CampoValores permitidosExemploSignifica
Minuto0–5930aos 30 minutos da hora
Hora0–239às 9h (relógio de 24 horas)
Dia do mês1–311no dia 1.º do mês
Mês1–12 (ou JAN–DEC)6em junho
Dia da semana0–7 (ou SUN–SAT); 0 e 7 são domingo1às segundas-feiras

Então 30 9 * * 1 se lê assim: minuto 30, hora 9, qualquer dia do mês, qualquer mês, às segundas — ou seja, toda segunda-feira às 09:30. O pessoal tropeça na ordem porque estamos acostumados a escrever datas começando por outras partes; o cron começa pelo horário. Leia como um relógio que vai se afastando: primeiro o detalhe fino, depois o panorama.

Os quatro símbolos que fazem todo o trabalho

Você só precisa de quatro operadores. O asterisco (*) significa «todos os valores permitidos» — todo minuto, todo mês, o que o campo admitir. A vírgula monta listas: 1,15 no dia do mês significa os dias 1 e 15. O hífen monta intervalos: 9-17 na hora significa das 9 às 17. E a barra acrescenta um passo: */15 no minuto significa a cada 15 minutos, enquanto 9-17/2 significa a cada duas horas, das 9 às 17.

Combine os quatro e quase todo agendamento real aparece. */15 9-17 * * 1-5 é a clássica tarefa de horário comercial: a cada 15 minutos, entre 09:00 e 17:45, de segunda a sexta. Quando você conseguir ler essa sem parar no meio, consegue ler quase qualquer expressão que encontrar por aí. Teste você: o que 0 0 29 2 * faz? Roda à meia-noite de 29 de fevereiro — ou seja, só em anos bissextos.

A armadilha: quando o dia do mês encontra o dia da semana

Aqui está a que morde todo mundo. Quando os dois campos — dia do mês e dia da semana — estão restritos, ou seja, nenhum dos dois é asterisco, o cron padrão não exige que os dois coincidam: ele roda a tarefa quando qualquer um deles coincide. Então 0 9 1 * 1 não significa «às 09:00 numa segunda que também seja dia 1». Significa às 09:00 no dia 1 de cada mês e também às 09:00 em toda segunda-feira. Umas cinco execuções por mês onde você esperava uma.

Não é um bug: foi assim que o Vixie cron, o ancestral da maioria dos daemons cron em uso hoje, definiu a regra, e a página de manual dele documenta isso. O problema é que ninguém lê o manual antes de as faturas saírem em duplicidade. Se você precisa de «a primeira segunda-feira do mês», o cron sozinho não sabe dizer isso: agende para as segundas e deixe o próprio comando conferir se a data cai entre os dias 1 e 7.

Escreva uma do zero

  1. Diga o agendamento primeiro em palavras normais, em voz alta se precisar: «todo dia útil às nove e meia da manhã».
  2. Preencha os campos em ordem: minuto 30, hora 9, dia do mês *, mês *, dia da semana 1-5. Você obtém 30 9 * * 1-5.
  3. Confira os dois campos da armadilha: aqui só o dia da semana está restrito, então a regra do «qualquer um dos dois» não se aplica. Ótimo.
  4. Veja as próximas execuções antes de salvar qualquer coisa. Os seus olhos pescam o que o cérebro deixou passar — a ferramenta abaixo faz isso com um único colar.
  5. Pergunte o que acontece nos dias ruins do agendamento: o dia 31 que fevereiro não tem, a mudança do horário de verão, a execução que ainda está rodando quando a próxima começa.

Apelidos e dialetos

A maioria dos daemons cron também aceita apelidos no lugar dos cinco campos: @hourly é 0 * * * *; @daily (e seu alias @midnight) é 0 0 * * *; @weekly é 0 0 * * 0; @monthly é 0 0 1 * *; @yearly (alias @annually) é 0 0 1 1 *; e @reboot roda uma vez na inicialização do daemon, sem depender de horário nenhum.

Passando disso, os dialetos se afastam. Alguns sistemas acrescentam um sexto campo de segundos no início; agendadores no estilo Quartz colocam os segundos primeiro, podem somar um campo de ano e usam ? e outros caracteres especiais que o cron clássico não entende. GitHub Actions, CronJobs do Kubernetes e agendadores em nuvem seguem de perto os cinco campos clássicos, mas não em cada detalhe — o Kubernetes, por exemplo, aplica o mesmo comportamento de «qualquer um dos dois» para dia do mês e dia da semana. Não cole uma expressão de um dialeto em outro presumindo que funciona. Consulte a documentação do sistema de destino e depois confira as próximas execuções.

E uma última coisa que o cron não conta: qual relógio ele está lendo. Um servidor configurado em UTC executa o seu «relatório das 9h» às 9h UTC, e mudanças de horário de verão podem pular uma execução ou dispará-la duas vezes em sistemas que usam a hora local. A expressão pode estar perfeita e o fuso, errado. As duas metades formam o agendamento.

Um hábito de padrões se transfere direto: um campo cron é uma pequena linguagem de padrões por si só, e quando você precisar testar uma expressão regular de verdade contra um texto real, o verificador de expressões regulares a executa ao vivo no seu navegador, com as correspondências destacadas.

Cole uma expressão e veja-a em linguagem simples

O Gerador e Analisador de Cron do Verystep traduz qualquer expressão para linguagem simples, valida os intervalos e mostra os próximos cinco horários de execução — ou monte o agendamento visualmente e copie a expressão que ele escreve. É o jeito mais rápido de detectar a armadilha do dia do mês antes que o seu agendador a encontre por você.

Abrir Gerador de expressões cron →

Última verificação em 24 de outubro de 2026 — intervalos dos campos, comportamento dos operadores e a regra de dia do mês / dia da semana conferidos com a documentação padrão de crontab (Vixie cron) refletida na ferramenta abaixo.

Perguntas frequentes

O que significa */15 * * * *?

A cada 15 minutos, o dia inteiro. O */15 fica no campo do minuto e significa «a cada 15 minutos» — em :00, :15, :30 e :45 — enquanto os asteriscos nos outros quatro campos deixam hora, dia, mês e dia da semana sem restrição.

Domingo é 0 ou 7?

Os dois. No cron padrão, o campo do dia da semana aceita 0–7, e tanto 0 quanto 7 significam domingo. Os nomes de três letras (SUN, MON e assim por diante) também funcionam na maioria dos daemons. Cuidado com ferramentas que só aceitam 0–6: nelas, 7 é um erro, não um segundo domingo.

Por que minha tarefa rodou no dia 1 e também em toda segunda?

Porque os campos de dia do mês e dia da semana estavam restritos ao mesmo tempo, e o cron padrão trata essa combinação como OU, não como E: a tarefa dispara quando qualquer um dos campos coincide. Por isso 0 9 1 * 1 roda às 09:00 no dia 1 de cada mês e às 09:00 em toda segunda-feira. Para um comportamento de E, deixe um dos dois campos como * e filtre dentro do próprio comando.

Qual é a diferença entre @daily e 0 0 * * *?

Nenhuma, na maioria dos daemons — @daily é o apelido de exatamente essa expressão, e @midnight é o alias dele. A família inclui ainda @hourly (0 * * * *), @weekly (0 0 * * 0), @monthly (0 0 1 * *) e @yearly (0 0 1 1 *). O esquisito é o @reboot: ele roda na inicialização do daemon, não num horário do relógio.

O cron consegue rodar algo a cada 30 segundos?

O cron clássico de cinco campos, não — o grão mais fino dele é um minuto. Alguns agendadores acrescentam um campo de segundos (seis campos no total), o que muda o dialeto por completo, então não cole uma expressão de seis campos num crontab de cinco. A saída habitual são duas entradas deslocadas de 30 segundos, com o próprio comando dormindo o deslocamento.

Mais guias