Como escrever uma expressão Cron (guia para iniciantes)

Desenvolvedor

Aprenda a sintaxe cron de 5 campos com exemplos, padrões comuns e dicas para agendar qualquer tarefa recorrente corretamente.

Guia passo a passo

1

Entenda os 5 campos

Uma expressão cron tem 5 campos separados por espaço: minuto (0–59), hora (0–23), dia-do-mês (1–31), mês (1–12), dia-da-semana (0–7, onde 0 e 7 são domingo). Exemplo: `30 9 * * 1` significa "toda segunda-feira às 9h30".

2

Use o asterisco (*) para "cada"

O asterisco significa "cada valor válido". `* * * * *` executa a cada minuto. `0 * * * *` executa no início de cada hora. `0 0 * * *` executa à meia-noite todos os dias.

3

Use vírgulas para múltiplos valores

Vírgulas listam valores específicos. `0 9 * * 1,3,5` executa às 9h nas segundas, quartas e sextas. `0 0 1,15 * *` executa à meia-noite no dia 1 e 15 de cada mês.

4

Use barras para intervalos

Barras definem intervalos de passo. `*/15 * * * *` executa a cada 15 minutos. `0 */6 * * *` a cada 6 horas. `*/5 9-17 * * *` a cada 5 minutos entre 9h e 17h.

5

Use hífens para intervalos de valor

Hífens especificam um intervalo. `0 9-17 * * 1-5` executa toda hora das 9h às 17h nos dias úteis. Combine com vírgulas e barras para agendamentos complexos.

Usar nossa ferramenta

Gerador Cron

Perguntas frequentes

Q: Como executar uma tarefa a cada 30 minutos?

A: `*/30 * * * *` ou `0,30 * * * *` — ambas as expressões executam a tarefa no início e na metade de cada hora.

Q: Qual fuso horário o cron usa?

A: O cron tradicional usa o fuso horário do sistema do servidor. Agendadores em nuvem (AWS EventBridge, GitHub Actions) geralmente usam UTC por padrão. Sempre verifique a configuração de fuso horário da sua plataforma.

Q: Qual é a diferença entre dia-do-mês e dia-da-semana?

A: Se ambos os campos têm valores diferentes de asterisco, a maioria das implementações cron executa o trabalho quando QUALQUER condição for atendida (OR lógico). Use `*` para o campo que não deseja restringir.

Guias relacionados