For the complete documentation index, see llms.txt. This page is also available as Markdown.

Cron

Visão Geral

O Cron é um utilitário de sistema baseado em tempo (time-based job scheduler) amplamente utilizado em sistemas operacionais e plataformas de automação. Sua função principal é permitir o agendamento de tarefas para serem executadas de forma automática, em segundo plano, em datas, horários ou intervalos de tempo específicos. Ele funciona como um gatilho temporal contínuo que monitora o relógio do sistema para disparar rotinas sempre que os critérios de tempo são correspondidos.

Parâmetros de Configuração

A configuração de um agendamento Cron tradicional é feita por meio de uma string de texto composta por 5 campos obrigatórios, separados por espaços. Cada posição representa uma unidade de medida de tempo:

Plaintext

 .---------------- minuto (0 - 59)
 |  .------------- hora (0 - 23)
 |  |  .---------- dia do mês (1 - 31)
 |  |  |  .------- mês (1 - 12)
 |  |  |  |  .---- dia da semana (0 - 6) (Domingo a Sábado)
 |  |  |  |  |
 * * * * *
  • Minutos (0 - 59): O minuto exato em que a tarefa será executada.

  • Horas (0 - 23): A hora do dia em formato 24 horas.

  • Dias (1 - 31): O dia numérico do mês.

  • Meses (1 - 12 ou JAN-DEC): O mês do ano em que a tarefa deve rodar.

  • Dias da Semana (0 - 6 ou SUN-SAT): O dia da semana específico (onde 0 ou 7 costumam representar o Domingo).

Construtor Visual de Cron

Para abstrair a complexidade da sintaxe textual, as interfaces modernas utilizam um construtor visual baseado em menus suspensos (dropdowns) que mapeiam os parâmetros do Cron:

  • Seletores de Valores Fixos: Permitem escolher minutos, horas ou dias específicos (ex: selecionar apenas o minuto 30 ou apenas o mês de Janeiro).

  • Seletores de Intervalos (Passos): Facilitam a configuração de recorrências (ex: selecionar para rodar a cada 5 minutos ou a cada 3 meses).

  • Seletores de Faixas (Ranges): Permitem delimitar períodos contínuos visualmente, como configurar uma automação para operar apenas de Segunda a Sexta-feira.

Operadores Especiais

Os operadores especiais são caracteres curingas utilizados para criar regras de agendamento avançadas dentro dos campos do Cron:

  • * (Asterisco) - Qualquer valor: Indica que a tarefa deve ser executada em todas as unidades daquele campo (ex: * no campo de horas significa "todas as horas").

  • , (Vírgula) - Lista de valores: Permite definir múltiplos valores explícitos em um único campo (ex: 1,15 no campo de dias executa nos dias 1 e 15).

  • - (Hífen) - Intervalo contínuo: Define uma faixa de valores inclusivos (ex: 1-5 no campo de dias da semana executa de segunda a sexta-feira).

  • / (Barra) - Passos / Incrementos: Especifica a taxa de repetição dentro de um campo, combinado com o asterisco (ex: */15 no campo de minutos significa "a cada 15 minutos").

Exemplos Práticos

Abaixo estão os padrões de agendamento mais comuns traduzidos em expressões Cron:

Frequência da Execução

Expressão Cron

Executar a cada minuto, todos os dias

* * * * *

Executar a cada 5 minutos

*/5 * * * *

Executar no minuto zero de cada hora (de hora em hora)

0 * * * *

Executar uma vez por dia, exatamente à meia-noite

0 0 * * *

Executar todos os dias às 08:30 da manhã

30 8 * * *

Executar ao meio-dia, apenas de segunda a sexta-feira

0 12 * * 1-5

Executar à meia-noite apenas nos dias 1 e 15 de cada mês

0 0 1,15 * *

Atualizado

Isto foi útil?