Use expressões cron para agendar comandos do Cloud Assistant com gatilhos flexíveis baseados em tempo.
Sintaxe básica das expressões cron
Uma expressão cron é uma string composta por seis ou sete campos que define o agendamento de um job.
Formato:
Seconds Minutes Hours Day-of-month Month Day-of-week [Year]
<Year> é opcional.
-
Para um único campo:
Cada campo aceita valores específicos, intervalos, incrementos ou caracteres especiais.
Separe vários valores com vírgula (
,).Cada campo permite no máximo um zero à esquerda. Por exemplo, 01 é válido, mas 001 não é.
Consulte Valores válidos dos campos e Exemplos para faixas de valores e caracteres especiais.
Valores válidos dos campos
A tabela a seguir lista a faixa de valores e os caracteres especiais para cada campo.
|
Campo |
Obrigatório |
Faixa de valores |
Caracteres especiais |
|
Seconds |
Sim |
[0, 59] |
* , - / |
|
Minutes |
Sim |
[0, 59] |
* , - / |
|
Hours |
Sim |
[0, 23] |
* , - / |
|
Date |
Sim |
[1, 31] |
* , - / ? L W |
|
Month |
Sim |
[1, 12] ou [JAN, DEC] |
* , - / |
|
Day-of-week |
Sim |
[1, 7] ou [MON, SUN]. Nos comandos do Cloud Assistant, ao usar o formato [1, 7], Importante
A semântica das expressões cron varia conforme o sistema. Fora do Cloud Assistant, 1 pode indicar domingo e 7 pode indicar sábado. |
* , - / ? L # |
|
Year |
Não |
[Ano atual, 2099] |
* , - / |
Caracteres especiais
A tabela a seguir descreve cada caractere especial e seu significado.
|
Caractere especial |
Significado |
Exemplo |
|
|
Todos os valores. |
Em |
|
|
Lista de valores enumerados. |
Em |
|
|
Intervalo de valores. |
Em |
|
|
Incremento a partir de um valor inicial. |
Em |
|
|
Valor não especificado. Usado apenas nos campos Day-of-month e Day-of-week. |
Ao especificar um valor em |
|
|
Último dia. Compatível apenas com os campos Importante
Não combine |
|
|
|
Dia útil mais próximo (segunda a sexta) da data especificada. Não ultrapassa os limites do mês. |
Em |
|
|
N-ésima ocorrência de um dia da semana no mês. Importante
Compatível apenas com o campo |
Em |
Exemplos
|
Cenário |
Valor |
|
|
Execução diária em horário específico. |
Execute a tarefa às 10:15 diariamente. |
|
|
Execute a tarefa às 12:00 diariamente. |
|
|
|
Execução diária em múltiplos horários. |
Execute a tarefa às 10:00, 14:00 e 16:00 diariamente. |
|
|
Execução em intervalo fixo. |
Execute a tarefa a cada 30 minutos, das 09:00 às 17:00, diariamente. |
|
|
Execute a tarefa a cada minuto, das 14:00 às 14:59, diariamente. |
|
|
|
Execute a tarefa a cada minuto, das 14:00 às 14:05, diariamente. |
|
|
|
Execute a tarefa a cada 5 minutos, das 14:00 às 14:55, diariamente. |
|
|
|
Execute a tarefa a cada 5 minutos, das 14:00 às 14:55 e das 18:00 às 18:55, diariamente. |
|
|
|
Execução em dias específicos do mês ou da semana. |
Execute a tarefa às 12:00 toda quarta-feira. |
|
|
Execute a tarefa às 10:15 no dia 15 de cada mês. |
|
|
|
Execute a tarefa às 10:15 no último dia de cada mês. |
|
|
|
Execute a tarefa às 10:15 no último sábado de cada mês. |
|
|
|
Execute a tarefa às 10:15 no terceiro sábado de cada mês. |
|
|
|
Execução em datas e anos específicos. |
Execute a tarefa às 14:10 e 14:44 em todas as quartas-feiras de março, anualmente. |
|
|
Execute a tarefa às 10:15 diariamente durante o ano de 2022. |
|
|
|
Execute a tarefa às 10:15 diariamente, todos os anos. |
|
|
|
Execute a tarefa a cada 5 minutos, das 14:00 às 14:55 e das 18:00 às 18:55, diariamente em 2022. |
|
|
|
Execute a tarefa às 10:15 no terceiro sábado de cada mês, em 2022 e 2023. |
|
|
|
Execute a tarefa a cada 30 minutos, das 9:00 às 17:30, diariamente de 2022 a 2025. |
|
|
|
Execute a tarefa às 14:10 e 14:44 em todas as quartas-feiras de março, a cada dois anos, a partir de 2022. |
|
|