Os cinco campos
Uma expressão cron são cinco campos separados por espaços que dizem a um agendador quando rodar uma tarefa:
Na ordem, da esquerda para a direita:
| Minuto | 0-59 |
| Hora | 0-23 |
| Dia do mês | 1-31 |
| Mês | 1-12 |
| Dia da semana | 0-6 (domingo = 0) |
A tarefa roda sempre que o horário atual coincide com todos os campos.
Caracteres especiais
*qualquer valor.,uma lista:1,15é o dia 1 e o dia 15.-um intervalo:1-5é de segunda a sexta no último campo./um passo:*/10no campo de minutos é a cada 10 minutos.
Agendamentos comuns
*/5 * * * * | A cada 5 minutos |
0 * * * * | A cada hora cheia |
0 0 * * * | Todo dia à meia-noite |
30 8 * * 1-5 | Às 08:30 nos dias úteis |
0 0 1 * * | À meia-noite do dia 1 de cada mês |
0 3 * * 0 | Às 03:00 todo domingo |
Cole qualquer expressão no Explicador de expressões cron para ler em palavras e ver as próximas execuções.
O que costuma confundir
- Fuso horário: o cron usa o relógio do servidor, que muitas vezes está em UTC.
- Dia do mês e dia da semana juntos: se os dois estiverem definidos, a tarefa roda quando qualquer um coincidir, não os dois.
- Segundos: o cron padrão não tem campo de segundos. Alguns sistemas, como Quartz e Spring, acrescentam um no início, ficando com seis campos.