Ajuda on-line ESET

Pesquisar English
Selecionar categoria
Selecionar tópico

Intervalo de Expressão CRON

Uma expressão CRON é usada para configurar instâncias específicas de um acionador. Principalmente para o acionamento repetitivo agendado. É uma string composta de 6 ou 7 campos que representam valores individuais da agenda. Esses campos são separados por um espaço e contém qualquer um dos valores permitidos com várias combinações.

A expressão CRON pode ser tão simples quanto: * * * * ? * ou mais complexa, como: 0/5 14,18,3-39,52 * ? JAN,MAR,SEP MON-FRI 2012-2020

Lista de valores que você pode usar na expressão CRON:

Nome

Requerido

Valor

Caracteres especiais permitidos

Segundos

Sim

0-59

, - * / R

Minutos

Sim

0-59

, - * / R

Horas

Sim

0-23

, - * / R

Dia do mês

Sim

1-31

, - * / ? L W

Mês

Sim

1-12 ou JAN-DEC

, - */

Dia da semana

Sim

0-6 ou SUN-SAT

, - / ? L #

Ano

Sim

1970-2099

, - * /

A sintaxe da expressão CRON é a seguinte:

 

┌────────── segundos (0-59)

│ ┌────────── minutos (0-59)

│ │ ┌────────── horas (0-23)

│ │ │ ┌────────── Dia do mês (1 - 31)

│ │ │ │ ┌────────── mês (1 a 12 ou JAN-DEC)

│  │  │  │  │  ┌────────── Dia da semana (0 - 6 ou SUNSAT)(por exemplo, 0 é o mesmo que SUN)

│ │ │ │ │ │ ┌────────── Ano

│  │  │  │  │  │  │

*  *  *  *  *  ?  *

O 0 0 0 significa meia-noite (segundos, minutos, horas).

Use ? quando um valor não pode ser definido porque foi definido em outro campo (dia do mês ou dia da semana).

O * significa todos (segundos, minutos, horas, dia do mês, mês, dia da semana, ano).

O SUN significa no domingo.


note

Os nomes dos meses e dias da semana não diferenciam maiúsculas e minúsculas. Por exemplo, MON é igual a mon, ou JAN é igual a jan.

Caracteres especiais:

Vírgula (,)

Vírgulas são usadas para separar os itens de uma lista. Por exemplo, usar "MON,WED,FRI" no 6º campo (dia da semana) dignifica segundas, quartas e sextas-feiras.

Hífen (-)

Define intervalos. Por exemplo, 2012-2020 indica cada ano entre 2012 e 2020, inclusive.

Coringa (*)

Usado para selecionar todos os valores possíveis dentro de um campo. Por exemplo, * no campo minuto significa a cada minuto. O curinga não pode ser usado no campo dia da semana.

Ponto de interrogação (?)

Ao escolher um dia específico, você pode especificar um dia do mês ou dia da semana. Não é possível especificar ambos. Se você especificar dia do mês, você deve usar ? para dia da semana e vice versa. Por exemplo, se quiser que o acionador seja acionado em um determinado dia do mês (digamos que no dia 10), mas se não faz diferença qual dia da semana vai ser, coloque 10 no campo dia do mês e ? no campo dia da semana.

Hash (#)

Usado para especificar “o º” dia do mês. Por exemplo, o valor de 4#3 no campo dia da semana significa a terceira quinta-feira do mês (dia 4 = quinta-feira e #3 = a 3ª quinta-feira do mês). Se você especificar #5 e não houver um 5º do dia da semana determinado no mês, o acionador não será acionado naquele mês.

Barra (/)

Descreve aumentos de um intervalo. Por exemplo 3-59/15 no 2º campo (minutos) indica o terceiro minuto da hora e a cada 15 minutos depois disso.

Último (L)

Quando usado no campo dia da semana, ele permite que você especifique construções como a última sexta-feira (5L) de um determinado mês. No campo dia do mês, ele especifica o último dia do mês. Por exemplo, dia 31 para janeiro, dia 28 para fevereiro em anos que não são bissextos.

Dia da semana (W)

O caractere W é permitido para o campo dia do mês. Este caractere é usado para especificar o dia da semana (segunda a sexta-feira) mais próximo de um determinado dia. Por exemplo, se você especificar 15W como o valor para o campo dia do mês, o significado é o dia de semana mais próximo do dia 15 do mês. Então, se o dia 15 for um sábado, o acionador é acionado na sexta-feira, dia 14. Se o dia 15 for um domingo, o acionador é acionado na segunda-feira, dia 16. Porém, se você especificar 1W como o valor para o dia do mês, e o dia 1º for um sábado, o acionador é acionado na segunda-feira, dia 3, pois ele não ignora o limite dos dias de um mês.


note

Os caracteres L e W também podem ser combinados no campo dia do mês para resultar em LW, que é traduzido como último dia da semana do mês.

Aleatório (R)

O R é um caractere especial de expressão ESET PROTECT On-Prem CRON que permite a você especificar momentos aleatórios no tempo. Por exemplo, o acionador R 0 0 * * ? * é acionado todo dia as 00:00 mas em um segundo aleatório (0-59).


important

Recomendamos usar momentos no tempo aleatórios para impedir que todos os Agentes ESET Management se conectem ao mesmo tempo ao seu Servidor ESET PROTECT.

Exemplos reais que ilustram algumas variações da Expressão CRON:

Expressão CRON

Significado

0 0 12 * * ? *

Acionar as 12:00 PM (meio dia) todos os dias.

R 0 0 * * ? *

Aciona as 00:00 mas em um segundo aleatório (0-59) todos os dias.

R R R 15W * ? *

Aciona no dia 15 de cada mês em uma hora aleatória (segundos, minutos, horas). Se o dia 15 for um sábado, o acionador é acionado na sexta-feira, dia 14. Se o dia 15 for um domingo, o acionador é acionado na segunda-feira, dia 16.

0 15 10 * * ? 2016

Acionar as 10:15 AM todos os dias durante o ano de 2016.

0 * 14 * * ? *

Iniciar a cada minuto a partir das 2:00 PM e terminando às 2:59 PM, todos os dias.

0 0/5 14 * * ? *

Acionar a cada 5 minutos a partir das 2:00 PM e terminando às 2:55 PM, todos os dias.

0 0/5 14,18 * * ? *

Acionar a cada 5 minutos a partir das 2:00 PM e terminando às 2:55 PM, e iniciar a cada 5 minutos a partir das 6:00 PM e terminando às 6:55 PM, todos os dias.

0 0-5 14 * * ? *

Iniciar a cada minuto a partir das 2:00 PM e terminando às 2:05 PM, todos os dias.

0 10,44 14 ? 3 WED *

Iniciar às 2:10 PM e às 2:44 PM a cada quarta-feira em março.

0 15 10 ? * MON-FRI *

Acionar às 10:15 AM todos os dias da semana (segunda-feira, terça-feira, quarta-feira, quinta-feira e sexta-feira).

0 15 10 15 * ? *

Acionar às 10:15 AM no dia 15 de cada mês.

0 15 10 ? * 5L *

Acionar às 10:15 AM na última sexta-feira de cada mês.

0 15 10 ? * 5L 2016-2020

Acionar às 10:15 AM em cada última sexta-feira de cada mês durante os anos de 2016 a 2020, inclusive.

0 15 10 ? * 5#3 *

Acionar às 10:15 AM na terceira sexta-feira de cada mês.

0 0 * * * ? *

Acionar a cada hora, todos os dias.