As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Referência de expressão Cron
<a name="cron-expression-reference"></a>

Essa solução usa um subconjunto do formato cron padrão do Linux de 5 campos para programações de testes recorrentes. A expressão cron consiste em cinco campos separados por espaços.

```
┌───────── minute (0-59)
│ ┌─────── hour (0-23, *, */N, or comma list)
│ │ ┌───── day of month (1-31 or *)
│ │ │ ┌─── month (1-12 or *)
│ │ │ │ ┌─ day of week (0-6, *, range, or list)
│ │ │ │ │
0 9 * * 1-5
```

## Valores aceitos
<a name="cron-accepted-values"></a>

A tabela a seguir descreve o que cada campo aceita.


| Campo | Valores aceitos | Exemplos | 
| --- | --- | --- | 
| Minuto | Um valor único de 0 a 59. |  `0`, `30`, `45`  | 
| Hora |  ` `(a cada hora), um valor de etapa``, um valor único de 0 a 23 ou uma lista de valores separados por vírgula. |  ` `, ``, `9`, `9,17`  | 
| Dia do mês |  `*`(todos os dias) ou um valor único de 1 a 31. |  `*`, `1`, `15`, `31`  | 
| Mês |  `*`(todo mês) ou um valor único de 1 a 12. |  `*`, `1`, `6`, `12`  | 
| Dia da semana |  `*`(todos os dias), um único valor de 0 a 6, um intervalo usando um hífen ou uma lista separada por vírgulas. |  `*`, `0`, `1-5`, `0,6`  | 

Os valores do dia da semana usam o seguinte mapeamento: 0 = domingo, 1 = segunda-feira, 2 = terça-feira, 3 = quarta-feira, 4 = quinta-feira, 5 = sexta-feira, 6 = sábado.

## Padrões não suportados
<a name="cron-unsupported-patterns"></a>

Os padrões a seguir são uma sintaxe cron válida do Linux, mas não são suportados por essa solução.


| Padrão | Exemplo | Motivo | 
| --- | --- | --- | 
| Valores minuciosos da etapa |  `*/15 * * * *`  | O intervalo mínimo de agendamento é de uma hora. | 
| Listas de minutos |  `0,30 * * * *`  | O intervalo mínimo de agendamento é de uma hora. | 
| Intervalos de dias do mês |  `0 9 1-15 * *`  | Somente o valor de um único dia ou curinga é aceito. | 
| Listas de dias do mês |  `0 9 1,15 * *`  | Somente o valor de um único dia ou curinga é aceito. | 
| Intervalos de meses |  `0 9 * 3-9 *`  | Somente o valor de um único mês ou curinga é aceito. | 
| Listas de meses |  `0 9 1 1,6,12 *`  | Somente o valor de um único mês ou curinga é aceito. | 
| ponto de interrogação |  `0 9 ? * ?`  | O caractere de ponto de interrogação não é válido no cron padrão do Linux. Use `*` em vez disso. | 

## Padrões predefinidos
<a name="cron-preset-patterns"></a>

O console web fornece os seguintes padrões predefinidos que você pode selecionar diretamente.


| Nome do padrão | Expressão | Description | 
| --- | --- | --- | 
| A cada hora |  `0 * * * *`  | Funciona no minuto 0 de cada hora. | 
| Diariamente às 9h |  `0 9 * * *`  | Funciona uma vez por dia às 9h no fuso horário selecionado. | 
| Dias úteis às 8:00 da manhã |  `0 8 * * 1-5`  | Funciona de segunda a sexta-feira às 8h. | 
| Todos os domingos às 17h |  `0 17 * * 0`  | Funciona todos os domingos às 17h. | 
| 1º dia do mês às 11h |  `0 11 1 * *`  | Funciona no primeiro dia de cada mês às 11h. | 

## Restrições de agendamento
<a name="cron-scheduling-constraints"></a>
+ O intervalo mínimo entre os testes programados é de uma hora. O sistema valida que o intervalo entre execuções consecutivas é maior do que a duração estimada do teste.
+ É necessária uma data de expiração para todos os agendamentos recorrentes. Os testes não serão executados após o final da data de expiração (UTC).
+ O fuso horário programado determina quando o cron é acionado. As transições do horário de verão são tratadas automaticamente. Se um horário agendado não existir devido a uma transição para o horário de verão, essa ocorrência será ignorada.
+ O sistema valida a expressão cron no console da web e na API. Se a expressão não corresponder ao formato aceito, o teste não poderá ser criado.