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.
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
- O que é cron
- Anatomia: os cinco campos
- Strings especiais: os atalhos
- Os dez agendamentos de que todos precisam
- Fuso horário, horário de verão e o ambiente
- Erros comuns
- Experimente: Cron Explainer
- 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
| Campo | Valores | Exemplos |
|---|---|---|
| Minuto | 0–59 | 0 = início da hora |
| Hora | 0–23 | 2 = 2h |
| Dia do mês | 1–31 | 1 = dia 1º |
| Mês | 1–12 ou JAN–DEZ | 1 = janeiro |
| Dia da semana | 0–7 ou DOM–SÁB | 1 = 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
| String | Significado | Equivalente |
|---|---|---|
@reboot | Uma vez, na inicialização | — |
@yearly / @annually | Uma vez por ano | 0 0 1 1 * |
@monthly | Uma vez por mês | 0 0 1 * * |
@weekly | Uma vez por semana | 0 0 * * 0 |
@daily / @midnight | Uma vez por dia | 0 0 * * * |
@hourly | Uma vez por hora | 0 * * * * |
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 * 1executa 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. */5vs.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á.
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.