Sintaxe para a expressão de agendamento
A expressão de agendamento é usada para definir o agendamento do trabalho a ser executado. Ela é definida com o uso da sintaxe CRON.
A sintaxe para o comando do agendador de trabalhos consiste nestes cinco campos obrigatórios e em um campo opcional separados por um espaço:
Nome de campo | Valores permitidos | Caracteres especiais permitidos |
---|---|---|
Minutos | 0-59 | , - * / |
Horas | 0-24 | , - * / |
Dia do mês | 0-31 | , - * ? / L W |
Mês | 0-12 ou JAN-DEZ | , - * / |
Dia da semana | 1-7 ou DOM-SÁB | , - * ? L # |
Ano (opcional) | NULO ou 1970 - 2199 | , - * / |
Os caracteres especiais que podem ser usados na sintaxe da expressão de programação:
Caracteres especiais | Uso |
---|---|
Vírgula (,) | Este caractere é usado para especificar os valores adicionais. Por exemplo, se "SEG,QUA,SEX" for especificado no campo Dia da semana, os dias serão Segunda-feira, Quarta-feira e Sexta-feira, respectivamente. |
Hífen (-) | Este caractere é usado para especificar o intervalo. Por exemplo, se "10-12" for especificado no campo de hora, as horas serão 10, 11 e 12, respectivamente. |
Asterisco (*) | Este caractere é usado para especificar todos os valores. Por exemplo, se "*" for especificado no campo de minutos, todos os minutos serão considerados. |
Barra (/) | Este caractere é usado para especificar incrementos. Por exemplo, se "0/15" for especificado no campo de segundos, os segundos serão 0, 15, 30, 45 e 60. Se "5/15" for especificado no campo de segundos, os segundos serão 5, 20, 35 e 50, respectivamente. O formato "*/..." é igual ao formato "primeiro-último/...", ou seja, um incremento no maior intervalo possível do campo. |
Ponto de interrogação (?) | Este caractere é usado nos campos Dia do mês e Dia da semana. Serve para determinar 'Nenhum valor específico' e quando um dos dois campos deve ser especificado, mas não o outro. Por exemplo, para executar a sintaxe em um determinado dia do mês (10º), mas não em um dia específico da semana, defina "10" no campo Dia do mês e "?" no campo Dia da semana. |
L (Último) | Este caractere é usado nos campos Dia do mês e Dia da semana. Por exemplo, se você especificar "L" no campo Dia do mês, o dia será o último dia do mês. Caso "L" seja especificado no campo Dia da semana, o dia será "7" ou "SÁB". Contudo, se "L" for especificado no campo Dia da semana após outro valor, o dia será "o último xxx dia do mês". Por exemplo, "6L" significa "a última sexta-feira do mês". Ao usar a opção 'L', as listas ou intervalos de valores não devem ser especificados. |
W | É usado no campo Dia do mês para determinar o dia da semana mais próximo do dia especificado. Por exemplo, se você especificar 5W no campo Dia do mês, o dia será "o dia mais próximo do 15º do mês". Caso o 15º dia do mês seja Sábado, o 14º será o Dia do mês. Se o 15º for Domingo, o 16º será o Dia do mês. |