Sintaxe Cron e exemplos de expressões
Entenda os campos, curingas e operadores Cron com exemplos de agendamentos por hora, dia, semana e mês.
Os cinco campos
minuto hora dia-do-mês mês dia-da-semana
| Agendamento | Expressão |
|---|---|
| A cada minuto | * * * * * |
| A cada 5 minutos | */5 * * * * |
| A cada hora | 0 * * * * |
| Todos os dias à meia-noite | 0 0 * * * |
| Dias úteis às 09:00 | 0 9 * * 1-5 |
| Primeiro dia do mês às 07:00 | 0 7 1 * * |
Os operadores *, ,, - e / representam todos os valores, uma lista, um intervalo e um passo.
Mais exemplos úteis
| Objetivo | Expressão | Observação |
|---|---|---|
| A cada 15 minutos | */15 * * * * | Nos minutos 0, 15, 30 e 45 |
| Todos os dias às 06:30 | 30 6 * * * | Usa o fuso horário do servidor |
| Toda segunda-feira às 09:00 | 0 9 * * 1 | Confira a numeração do domingo |
| Dias úteis às 18:00 | 0 18 * * 1-5 | De segunda a sexta-feira |
| A cada três horas | 0 */3 * * * | Às 00:00, 03:00, 06:00 e assim por diante |
O Cron compara cada campo com o horário atual. */15 não significa quinze minutos depois da execução anterior. A expressão corresponde a pontos fixos dentro da hora.
Fusos horários e execuções perdidas
Uma expressão Cron não contém um fuso horário. O Cron tradicional geralmente usa o fuso da máquina, enquanto alguns contêineres e serviços gerenciados usam UTC. Mudanças no horário de verão podem eliminar ou repetir um horário local.
O Cron também não recupera automaticamente uma tarefa perdida enquanto a máquina estava desligada. Se isso for necessário, use um agendador com tratamento de execuções perdidas ou prepare a tarefa para identificar trabalho pendente.
Validação antes da produção
Confira várias execuções futuras, teste o comando separadamente e identifique o dialeto Cron usado pela plataforma. Verifique principalmente meia-noite, mudanças de mês, dias úteis e horário de verão. Em produção, registre falhas e impeça sobreposições quando uma tarefa puder demorar mais do que o intervalo.
Use o decodificador Cron para receber uma explicação e conferir as próximas execuções.