Noções básicas sobre expressões cron: escreva cronogramas como um desenvolvedor

As expressões Cron controlam quando tarefas automatizadas são executadas em servidores, plataformas de nuvem e ferramentas de agendamento – mas a maioria dos desenvolvedores recorre à cópia de exemplos e espera que funcionem. Compreender a sintaxe do cron significa que você pode escrever qualquer agendamento do zero com segurança, depurar tarefas com falha com mais rapidez e evitar erros dispendiosos, como backups que nunca são executados.

O que são expressões cron e por que são importantes

Uma expressão cron é uma sequência compacta de cinco ou seis campos que informa ao sistema exatamente quando executar uma tarefa. É o formato padrão em servidores Unix, Linux, GitHub Actions, AWS EventBridge, Kubernetes e plataformas CI/CD em todo o mundo. Em vez de escrever prosa como "execute isso toda terça-feira às 2 da manhã", você escreve 0 2 * * 2, e o daemon cron o interpreta instantaneamente. Aprender essa notação — que permaneceu praticamente inalterada por décadas — é um investimento único que compensa sempre que você programa alguma coisa.

Os cinco campos e seus intervalos

O cron padrão usa cinco campos obrigatórios separados por espaços. Leia-os da esquerda para a direita como minuto, hora, dia do mês, mês e dia da semana:

1. Minute (0–59) — qual minuto da hora executar
2. Hour (0–23) — qual hora do dia (relógio de 24 horas)
3. Day of month (1–31) – qual dia do calendário
4. Month (1–12) — qual mês do ano
5. Day of week (0–7) — qual dia da semana, onde 0 e 7 significam domingo

Cada campo aceita um valor específico, um intervalo como 1-5, uma lista como 1,3,5ou um curinga * significando "todos os valores nesse campo". O operador de barra divide intervalos: */15 no campo dos minutos significa a cada 15 minutos.

Padrões comuns que você escreverá

A maioria das programações do mundo real se repete apenas de algumas maneiras. As manhãs dos dias úteis às 9h são 0 9 * * 1-5. Cada hora é 0 * * * *. Primeiro dia do mês à meia-noite: 0 0 1 * *. A cada 15 minutos, durante todo o dia: */15 * * * *. Uma vez por dia, aos domingos, às 2h30: 30 2 * * 0. Se você não tiver certeza se sua expressão está correta, cole-a em um analisador cron para ver as próximas cinco execuções agendadas e verificar se elas correspondem à sua intenção antes da implantação.

Crie sua própria expressão cron

Comece em inglês e depois traduza para cron. Você quer "9h30 todos os dias da semana"? São 30 minutos, 9 horas, qualquer dia do mês, qualquer mês, de segunda a sexta. Os campos tornam-se 30 9 * * 1-5. Para "duas vezes por dia às 7h e às 18h": 0 7,18 * * * (vírgula separa horas). Meio-dia do dia 15 de cada mês: 0 12 15 * *. Depois de escrever qualquer expressão, sempre teste-a com o analisador para detectar erros de digitação antes de implantar.

Lidar com fusos horários e verificar horários exatos

As expressões cron são relativas ao servidor – elas são executadas no fuso horário do sistema, não no fuso horário local. Para verificar um carimbo de data/hora Unix ou ver a que hora local seu cron dispara em sua zona, use o conversor de carimbo de data/hora, que é executado em seu navegador e lida com conversões de fuso horário instantaneamente, sem enviar dados para qualquer lugar.

Transforme sua programação em um evento de calendário

Depois de ter uma expressão cron sólida, compartilhe-a ou adicione-a ao seu calendário para ver quando a tarefa é executada. O Gerador de ICS converte uma data de início e uma regra de recorrência em um arquivo de calendário que pode ser importado para o Apple Calendar, Google Calendar, Outlook ou qualquer aplicativo de calendário padrão. Como alternativa, crie um direto Link do Google Agenda que abre o evento pré-preenchido no Google Agenda com um único clique – sem downloads, sem gerenciamento de arquivos.

Suas programações cron permanecem privadas

Todas as ferramentas mencionadas aqui são executadas dentro do seu navegador; nada é carregado em um servidor. Análise de cron, conversão de carimbo de data/hora, geração de calendário e criação de link acontecem no seu dispositivo. Sem conta, sem rastreamento e as ferramentas funcionam offline após serem carregadas. Suas programações e detalhes de automação permanecem exclusivamente seus.