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.

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.

| Campo | Valores permitidos | Exemplo | Significa |
|---|---|---|---|
| Minuto | 0–59 | 30 | aos 30 minutos da hora |
| Hora | 0–23 | 9 | às 9h (relógio de 24 horas) |
| Dia do mês | 1–31 | 1 | no dia 1.º do mês |
| Mês | 1–12 (ou JAN–DEC) | 6 | em junho |
| Dia da semana | 0–7 (ou SUN–SAT); 0 e 7 são domingo | 1 | à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
- Diga o agendamento primeiro em palavras normais, em voz alta se precisar: «todo dia útil às nove e meia da manhã».
- Preencha os campos em ordem: minuto 30, hora 9, dia do mês
*, mês*, dia da semana1-5. Você obtém30 9 * * 1-5. - 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.
- 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.
- 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.
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ê.
Ú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

Tire o fundo de uma foto sem enviar o arquivo: como a IA roda no seu próprio aparelho
O removedor que todo mundo conhece pede a foto primeiro e entrega o recorte depois. Dá para inverter a ordem: baixar a IA uma única vez e nunca tirar as suas imagens do seu aparelho.

Tamanhos de foto para passaporte e documento por país: mm, polegadas e pixels
Quatro tamanhos cobrem quase o mundo inteiro. O que pega todo mundo de surpresa é o da China — e o do Canadá é maior que o de todo o resto.

Artigo 50 da Lei de IA da UE: fornecedor ou responsável pela implantação? A versão de 10 minutos
O artigo 50 não começa perguntando qual é o risco da sua IA. Ele começa por quem a colocou no mercado, quem a utiliza — e se alguém contou isso para a pessoa do outro lado.