Expressões cron explicadas: agendamentos, strings especiais e armadilhas

Cinco pequenos campos rodam metade dos trabalhos em segundo plano da internet: backups às 2h, relatórios às segundas, limpeza de cache a cada cinco minutos. Aprenda a ler e escrever cron e evite a armadilha do dia do mês.

📂 Fundamentos para desenvolvedores ⏱ Cerca de 9 minutos 📶 Iniciante 🛠️ Combina com: Cron Explainer

O que você vai aprender

  • Ler qualquer expressão cron de cinco campos em voz alta
  • Usar listas, intervalos, passos e nomes corretamente
  • Escrever os dez agendamentos de que todos precisam
  • Usar @daily, @weekly e as outras strings especiais
  • Evitar a armadilha dia do mês vs dia da semana, saltos do horário de verão e bugs de fuso horário
Neste guia
  1. O que é cron
  2. Anatomia: os cinco campos
  3. Strings especiais: os atalhos
  4. Os dez agendamentos de que todos precisam
  5. Fuso horário, horário de verão e o ambiente
  6. Erros comuns
  7. Experimente: Cron Explainer
  8. Perguntas frequentes

O que é cron

Cron é o agendador de tarefas baseado em tempo embutido em sistemas do tipo Unix desde os anos 1970. Você escreve uma linha em um crontab — um agendamento mais um comando — e o daemon do cron executa esse comando sempre que o agendamento corresponde. Backups, rotação de logs, renovação de certificados, e-mails de relatórios: a maioria das tarefas chatas e essenciais da internet são linhas de cron que alguém escreveu uma vez e esqueceu.

A ideia é deliberadamente simples: sem programação, sem fila, sem lógica de repetição — apenas “quando o relógio estiver assim, execute isso”. Essa simplicidade é o motivo de ele sobreviver, e de suas peculiaridades valerem a pena aprender em vez de contornar.

Anatomia: os cinco campos

┌───────── minute (0–59)
│ ┌─────── hour (0–23)
│ │ ┌───── day of month (1–31)
│ │ │ ┌─── month (1–12)
│ │ │ │ ┌─ day of week (0–7, both 0 and 7 are Sunday)
│ │ │ │ │
* * * * *  command to run
CampoValoresExemplos
Minuto0–590 = início da hora
Hora0–232 = 2h
Dia do mês1–311 = dia 1º
Mês1–12 ou JAN–DEZ1 = janeiro
Dia da semana0–7 ou DOM–SÁB1 = segunda-feira

Cada campo aceita quatro notações: um único valor (2), uma lista (1,15), um intervalo (1-5), e um passo (*/5 = a cada 5, 2-30/10 = 2, 12, 22). Nomes também funcionam — MON-FRI é mais legível que 1-5 — mas misturar nomes e números em um campo é pedir problema.

Strings especiais: os atalhos

StringSignificadoEquivalente
@rebootUma vez, na inicialização—
@yearly / @annuallyUma vez por ano0 0 1 1 *
@monthlyUma vez por mês0 0 1 * *
@weeklyUma vez por semana0 0 * * 0
@daily / @midnightUma vez por dia0 0 * * *
@hourlyUma vez por hora0 * * * *

Elas são suportadas pelo Vixie cron (o padrão no Linux) e pela maioria dos agendadores em nuvem, mas não por todas as implementações — verifique antes de depender delas em @reboot algum lugar incomum.

Os dez agendamentos de que todos precisam

0 2 * * *        every day at 2:00am (the classic backup slot)
*/5 * * * *      every 5 minutes
0 9 * * 1-5      weekdays at 9:00am
0 0 1 * *        the 1st of every month at midnight
0 0 * * 0        Sundays at midnight
30 4 1,15 * *   1st and 15th at 4:30am
0 8-18 * * *    every hour from 8am to 6pm
0 0 * * 6       Saturdays at midnight
15 3 * * *      every day at 3:15am
0 12 25 12 *    Christmas Day at noon

Por que 2h para backups? É a hora em que menos pessoas estão usando o sistema — e quando uma tarefa atrasa, restam mais horas antes que alguém perceba. A tradição é mais antiga que a maioria dos engenheiros que a seguem.

Fuso horário, horário de verão e o ambiente

O cron é executado no horário local do sistema, não em UTC, a menos que o daemon esteja configurado de outra forma — e em um servidor, pode não ser o fuso horário que você imagina. Uma tarefa agendada para 2h que executa às 10h geralmente é uma incompatibilidade de fuso horário, não um agendamento quebrado. Verifique sempre date na própria máquina.

O horário de verão adiciona dois casos extremos por ano: na primavera, 2:00–2:59 não existe, então uma tarefa das 2:30 simplesmente não executa naquele dia; no outono, acontece duas vezes, então a tarefa executa duas vezes. Agendar tarefas críticas às 2:30 é como você descobre isso da pior maneira — 3h é o horário mais seguro.

Lembre-se também de que o cron executa com um ambiente mínimo: o PATH, variáveis e aliases não estão lá. Use caminhos absolutos (/usr/bin/python3 /opt/backup.py), e redirecione a saída para um arquivo de log — caso contrário, as falhas desaparecem silenciosamente. Uma tarefa de cron que falha em silêncio é pior que uma que nunca executou.

Erros comuns

  • A armadilha do dia do mês. No Vixie cron, quando o dia do mês e o dia da semana são ambos restritos, a tarefa executa quando qualquer um dos dois corresponder (OU), não ambos. 0 0 1 * 1 executa no dia 1º do mês e toda segunda-feira — não “segundas-feiras que caem no dia 1º”. Esta é a regra de cron mais incompreendida.
  • */5 vs. 5. A primeira é a cada cinco minutos; a segunda é uma vez por hora, no minuto 5. Um */ transforma uma tarefa frequente em uma rara.
  • Esquecer a nova linha no final do crontab. Algumas versões do cron ignoram silenciosamente a última linha se o arquivo não terminar com uma nova linha.
  • % no comando. Em um crontab, % significa nova linha — ele divide seu comando. Escape-o como \% ou mova a lógica para um script.
  • Supor que existe um campo de segundos. O cron clássico tem cinco campos, sem segundos. O Quartz e alguns agendadores em nuvem usam seis ou sete (segundos primeiro). Copiar uma expressão de seis campos para um crontab de cinco campos desloca todos os campos e agenda algo completamente diferente.
  • Sem registro de log. * * * * * /opt/job.sh >> /var/log/job.log 2>&1 — sempre.

Experimente: Cron Explainer

Digite qualquer expressão no Cron Explainer e ele dirá em linguagem simples quando ela executa — além das próximas dez execuções. Experimente primeiro os exemplos complicados deste guia lá.

Abrir o Cron Explainer →

Continue aprendendo

Perguntas frequentes

Como executo algo a cada 2 horas?

0 */2 * * * — minuto 0, a cada duas horas. Para cada 90 minutos, não há uma expressão cron limpa; execute a cada 30 minutos e deixe o script verificar se 90 minutos se passaram, ou use um systemd timer.

Como executo uma tarefa somente em dias úteis?

0 9 * * 1-5 — o campo dia da semana 1-5 é de segunda a sexta-feira. Nomes também funcionam: 0 9 * * MON-FRI. Lembre-se: 0 e 7 são ambos domingo.

O cron executa se o computador estiver desligado?

Não — o cron só dispara enquanto a máquina está ligada. Um laptop que estava em suspensão às 2h simplesmente perde a tarefa. Para laptops, use uma ferramenta que compensa ao acordar (anacron no Linux, launchd no macOS) ou agende conforme o tempo ligado.

Como edito meu crontab?

crontab -e abre seu agendamento em um editor; crontab -l o lista; crontab -r o exclui (cuidado — não há como desfazer). Tarefas de todo o sistema ficam em /etc/crontab e /etc/cron.d/, com um campo extra de usuário em cada linha.

Como testo uma expressão cron sem esperar?

Cole-a na ferramenta Cron Explainer: ela traduz a expressão para linguagem simples e lista as próximas dez execuções, para que um campo errado apareça imediatamente em vez de na próxima terça-feira.