Expressoes Cron Explicadas: Agende como um Pro

O Que E Cron?

Cron e o agendador de tarefas baseado em tempo encontrado em sistemas Unix e Linux. Ele executa tarefas (chamadas cron jobs) em intervalos especificos — backups a meia-noite, rotacao de logs todo domingo, emails de relatorios toda segunda as 9h. O agendamento e definido usando uma expressao cron, uma string compacta de cinco campos que descreve quando o job deve ser executado.

O formato vem dos anos 1970, mas continua sendo o padrao para tarefas agendadas. Seja usando Kubernetes CronJobs, GitHub Actions, pipelines CI/CD ou funcoes cloud — a sintaxe e a mesma em todo lugar.

O Formato de Cinco Campos

Uma expressao cron padrao tem cinco campos separados por espacos:

Minuto(0-59) Hora(0-23) Dia-do-Mes(1-31) Mes(1-12) Dia-da-Semana(0-7)

• Asterisco (*): Corresponde a qualquer valor. * * * * * executa a cada minuto.
• Virgula (,): Lista de valores. 1,15 no campo de minutos significa minuto 1 e 15.
• Hifen (-): Intervalo. 1-5 no campo de dia da semana significa segunda a sexta.
• Barra (/): Incremento. */15 no campo de minutos significa a cada 15 minutos.

Expressoes Cron Comuns

• 0 0 * * * — Diariamente a meia-noite
• 0 9 * * 1 — Toda segunda as 9h
• */5 * * * * — A cada 5 minutos
• 0 0 1 * * — No primeiro dia de cada mes a meia-noite
• 30 14 * * 1-5 — Dias uteis as 14:30
• 0 0 * * 0 — Todo domingo a meia-noite

Muitos sistemas tambem suportam atalhos: @hourly, @daily, @weekly, @monthly, @yearly.

Armadilhas Comuns

• Fusos horarios: Cron usa o fuso do sistema. Se seu servidor esta em UTC e voce quer um job as 9h de Brasilia, precisa calcular UTC-3.
• Dia do mes e dia da semana: Se ambos estao definidos, sao combinados com OR, nao AND. 0 0 15 * 5 executa tanto no dia 15 quanto em toda sexta-feira.
• Execucoes sobrepostas: Se um job demora mais que seu intervalo, execucoes podem se sobrepor. Use arquivos de lock.
• Horario de verao: Mudancas de horario podem fazer jobs serem pulados ou executados duas vezes.

Sintaxe Avancada

Algumas implementacoes (como Quartz ou Spring) adicionam um sexto campo para segundos e suportam caracteres especiais adicionais:

• L: Ultimo dia do mes ou ultimo dia da semana especifico.
• W: Dia util mais proximo. 0 0 15W * * executa no dia util mais proximo ao 15.
• #: N-esimo dia da semana no mes. 0 0 * * 5#2 significa a segunda sexta do mes.

Testar Expressoes Cron

Nosso Gerador de Expressoes Cron permite criar expressoes cron visualmente e ver os proximos horarios de execucao. Tudo no navegador, sem instalacao.