Apêndice: expressões Cron para um gatilho de Timer de função
- @todos os formatos
O formato é "@cada unidade N". N é um inteiro positivo. unit pode ser ns, μs, ms, s, m ou h. Uma expressão @every significa invocar uma função a cada N unidades de tempo, como mostrado em Tabela 1.
- Formato padrão
O formato é "segundos minutos horas dia-do-mês mês dia-da-semana". dia-da-semana é opcional. Os campos devem ser separados uns dos outros usando um espaço. Tabela 2 descreve os campos em uma expressão cron padrão.
Tabela 2 Descrição do parâmetro Parâmetro
Descrição
Intervalo de valores
Caracteres especiais permitidos
Seconds
Sim
0-59
, - * /
Minutes
Sim
0-59
, - * /
Hours
Sim
0-23
, - * /
Day-of-month
Sim
1-31
, - * ? /
Month
Sim
1–12 ou jan–dez. O valor não diferencia maiúsculas de minúsculas, como mostrado na Tabela 3.
, - * /
Day-of-week
Não
0–6 ou Dom–Sáb. O valor não diferencia maiúsculas de minúsculas, como mostrado na Tabela 4. 0 significa domingo.
Comentários – *? /
Tabela 3 Descrição do valor do campo do mês Mês
Dígito
Abreviação
Janeiro
1
Jan
Fevereiro
2
Fev
Março
3
Mar
Abril
4
Abr
Maio
5
Mai
Junho
6
Jun
Julho
7
Jul
Agosto
8
Ago
Setembro
9
Set
Outubro
10
Out
Novembro
11
Nov
Dezembro
12
Dez
Tabela 4 Descrição do valor do campo dia da semana Dia da semana
Dígito
Abreviação
Segunda-feira
1
Seg
Terça-feira
2
Ter
Quarta-feira
3
Qua
Quinta-feira
4
Qui
Sexta-feira
5
Sex
Sábado
6
Sáb
Domingo
0
Dom
Tabela 5 descreve os caracteres especiais que podem ser usados em uma expressão cron.
Tabela 5 Descrição de caracteres especiais Caractere especial
Significado
Descrição
*
Usado para especificar todos os valores dentro de um campo.
* no campo minutos significa cada minuto.
,
Usado para especificar vários valores, que podem ser descontínuos.
Por exemplo, "Jan,Abr,Jul,Outubro" ou "1,4,7,10" no campo mês e "Sat,Sun" ou "6,0" no campo dia da semana.
-
Usado para especificar um intervalo.
Por exemplo, "0-3" no campo minutos.
?
Usado para especificar algo em um dos dois campos em que o caractere é permitido, mas não o outro.
Você pode especificar algo apenas no campo dia do mês ou dia da semana. Por exemplo, se você quiser que sua função seja executada em um dia específico (como o dia 10) do mês, mas não se importar com qual dia da semana é, em seguida, coloque "10" no campo dia-do-mês e "?" no campo dia-da-semana.
/
Usado para especificar incrementos. O caractere antes da barra indica quando iniciar e o caractere após a barra representa o incremento.
Por exemplo, "1/3" no campo minutos significa acionar a função a cada 3 minutos a partir das 00:01:00 da hora.
Tabela 6 descreve vários exemplos de expressões cron.
Tabela 6 Exemplo de expressões cron Expressão Cron
Exemplo
0 15 2 * * ?
Executa uma função às 02:15:00 todos os dias.
0 30 8? * Seg-Sex
Executa uma função às 08:30:00 todas as segundas a sextas-feiras.
0 45 7 1-3 * ?
Executa uma função às 07:45:00 nos primeiros três dias de cada mês.
*? 0 0/3 * Seg, quarta, sexta-feira, domingo
Executa uma função a cada 3 minutos em todas as segundas, quartas, sextas e domingos.
0 0/3 9-18? * Seg-Sex
Executa uma função a cada 3 minutos entre as 09:00 e as 18:00 de segunda a sexta-feira.
0 0/30 * * * ?
Executa uma função a cada 30 minutos.