As expressões cron definem agendamentos para tarefas recorrentes, manutenção de rotina e tarefas únicas.
Uma expressão cron é uma string baseada em tempo composta de seis campos separados por espaço, no formato X X X X X X, em que cada X representa um valor de campo. Para separar múltiplos valores em um único campo, use uma vírgula (,). Cada campo aceita um valor específico ou um caractere especial.
Campos e valores
A tabela a seguir descreve cada campo, seus valores permitidos e os caracteres especiais suportados.
|
Campo |
Obrigatório |
Intervalo de valores |
Caractere especial |
|
Segundo |
Sim |
[0, 59] |
Não suportado |
|
Minuto |
Sim |
[0, 59] |
Valores separados por vírgula devem ter intervalos de pelo menos 30 minutos. Incrementos com barra (/) devem ser iguais ou maiores que 30. |
|
Hora |
Sim |
[0, 23] |
* , - / |
|
dia-do-mês |
Sim |
[1, 31] |
* , - / ? L |
|
Mês |
Sim |
[1, 12] or [JAN, DEC] |
* , - / |
|
dia-da-semana |
Sim |
[1, 7] ou [SUN, SAT]. No formato [1, 7], |
* , ? |
Caracteres especiais
Os caracteres especiais a seguir são suportados nos campos de expressão cron.
|
Caractere especial |
Descrição |
Exemplo |
|
|
Corresponde a todos os valores do campo. |
No campo Mês, |
|
|
Lista múltiplos valores discretos. |
No campo Minuto, |
|
|
Define um intervalo contíguo de valores. |
No campo dia-do-mês, |
|
|
Define um intervalo de incremento. |
No campo dia-do-mês, |
|
|
Nenhum valor específico. Válido apenas nos campos dia-do-mês e dia-da-semana. |
Os campos dia-do-mês e dia-da-semana são mutuamente exclusivos. Se você especificar um valor em um desses campos, use |
|
|
Representa "último". Suportado apenas no campo dia-do-mês, indicando o último dia do mês. Observação: Não combine |
No campo dia-do-mês, |
Exemplos
A tabela a seguir mostra padrões comuns de expressão cron.
|
Exemplo |
Descrição |
|
|
Executa uma tarefa às 10:15 todos os dias. |
|
|
Executa uma tarefa às 10:15 todos os dias. |
|
|
Executa uma tarefa às 12:00 (meio-dia) todos os dias. |
|
|
Executa uma tarefa às 10:00, 14:00 e 16:00 todos os dias. |
|
|
Executa uma tarefa aos 0 e 40 minutos de cada hora, todos os dias, das 9:00 às 17:59. |
|
|
Executa uma tarefa às 12:00 (meio-dia) toda quarta-feira. |
|
|
Executa uma tarefa às 10:15 no dia 15 de cada mês. |
|
|
Executa uma tarefa às 10:15 no último dia de cada mês. |
|
|
Executa uma tarefa às 14:00 e às 14:30 em todas as quartas-feiras de março. |
|
|
Executa uma tarefa à 1:00 na primeira quarta-feira de cada mês. |