Skip to main content

Agendamento (Timer) - Trigger Scheduler   

Durante a configuração do Trigger Scheduler, caso seja selecionado o tipo de agendamento Avançado, será necessário o preenchimento do campo Expressão Cron utilizando o formato Cron.

Formato Cron​

Cron são expressões usadas para agendamento de tarefas. É definida por uma string composta por cinco campos separados por um espaço em branco. Os campos podem conter qualquer um dos valores permitidos, juntamente com diversas combinações de caracteres especiais permitidos para esse campo. Os campos estão descritos na tabela abaixo.

CAMPO OBRIGATORIEDADE VALORES CARACTERES ESPECIAIS

                                                                                                    **PERMITIDOS                             PERMITIDOS**        _________________________________________________________________________________________________________________________
SegundosSIM0-59, - * /
MinutosSIM0-59, - * /
HorasSIM0-23, - * /
Dia do MêsSIM1-31, - * ? / L W
MêsSIM1-12 ou JAN-DEC, - * /
Dias da semanaSIM1-7 ou SUN-SAT, - * ? / L #

Caracteres Especias​

  • ***** ("todos os valores") Usado para selecionar todos os valores em um campo. Exemplo: “*” no campo Minutos significa a cada minuto.

  • ? ("nenhum valor específico") Usado para especificar algo em um dos dois campos nos quais o caractere é permitido, mas não no outro. Exemplo: A tarefa será executada em um determinado dia do mês (dia 8), independente do dia da semana, para isso "8" é preenchido no campo Dia do Mês e "?" no campo Dia da Semana.

  • - Usado para especificar intervalos. Exemplo: “14-17” no campo Horas refere-se às horas entre 14 e 17 (14,15,16,17).

  • , Usado para especificar valores adicionais. Exemplo: "MON,WED,FRI" no campo Dia da Semana refere-se aos dias segunda, quarta e sexta.

  • / Usado para especificar incrementos. Exemplo: "0/15" no campo Segundos refere-se aos segundos 0, 15, 30 e 45". Já "5/15" refere-se aos segundos 5, 20, 35 e 50". É permitido especificar '/' (barra) após ''(aspa). Neste caso, '' é equivalente a ter '0' antes de '/'. Exemplo: "1/3" no campo do Dia do Mês refere-se a execução da tarefa a cada 3 dias, iniciando-a no primeiro dia do mês.

  • L ("last" ou último) possui significados diferentes em cada um dos dois campos em que é permitido. O valor "L" no campo Dia do Mês refere-se ao último dia do mês. Quando usado sozinho no campo Dia da Semana, refere-se a a "7" ou "SAT".

  • Outros casos:

    • Se usado no campo do Dia da Semana após outro valor, significa o último dia mês. Exemplo: "6L" é igual à última sexta-feira do mês;
    • Permite especificar um deslocamento a partir do último dia do mês. Exemplo: "L-3" é igual ao penúltimo dia do mês;

Ao usar a opção 'L', é importante não especificar listas ou intervalos de valores, já que pode-se obter resultados confusos e/ou inesperados.

  • W ("weekday" ou Dia da Semana) Usado para especificar o dia da semana (segunda a sexta) mais próximo do dia determinado. Exemplo: Ao especificar "13W" como o valor para o campo Dia do Mês, o significado será descrito como o dia da semana mais próximo do dia 13 do mês. Portanto, se o dia 13 for sábado, o trigger será executado na sexta-feira, dia 12. Se o dia 13 for um domingo, o trigger será executado na segunda-feira, dia 14. Se o dia 13 for uma terça-feira, a execução acontecerá neste mesmo dia (13).
    • Outros casos:
      • Se a especificação for "1W" como o valor para o dia do mês e o primeiro dia for um sábado, o trigger será executado na segunda-feira, dia 3, pois não é permitido 'pular' o limite dos dias de um mês;
      • O carácter 'W' só pode ser especificado quando o dia do mês for um único dia, não podendo ser intervalos ou lista de dias;
      • Os caracteres 'L' e 'W' também podem ser combinados no campo Dia do Mês para produzir 'LW', que se traduz em último dia da semana do mês.
  • # Usado para especificar um dia D do mês. Exemplo: o valor “6#3” no campo Dia da Semana refere-se a terceira sexta-feira do mês (dia 6 = sexta-feira e “#3” = 3º do mês).

Lembrete: Ao especificar "#5" e não houver 5 dias da semana neste mês, nenhum disparo ocorrerá.

Os caracteres legais e os nomes dos meses e dias da semana não diferenciam maiúsculas de minúsculas. Exemplo: MON (SEGUNDA) é o mesmo que mon (segunda).

Exemplos​

CRON Agendamento (Timer)