Desenvolvedor

Analisador de Expressões Cron

Cole qualquer expressão cron de 5 campos e veja instantaneamente o que ela significa em português simples — chega de forçar a vista com asteriscos e barras para descobrir quando uma tarefa roda.

Esta ferramenta te ajudou?

O que é Analisador de Expressões Cron?

Cron é a sintaxe de agendamento padrão usada por tarefas cron do Unix/Linux, pipelines de CI/CD, CronJobs do Kubernetes e inúmeros agendadores de tarefas. Uma expressão cron condensa todo um agendamento recorrente em cinco campos compactos, o que é poderoso mas notoriamente difícil de ler rapidamente — será que "0 */4 * * 1-5" significa a cada 4 horas nos dias úteis, ou outra coisa? Este analisador decompõe uma expressão cron campo por campo e a traduz para uma frase em português simples, para que você possa confirmar que um agendamento está correto antes de implantá-lo, ou entender rapidamente um agendamento que outra pessoa escreveu sem precisar consultar uma tabela de sintaxe cron.

Quando Usar Esta Calculadora

  • Ao verificar um cronograma cron antes de implantar uma tarefa agendada ou pipeline CI/CD
  • Ao depurar por que uma tarefa agendada foi executada (ou não) em um horário inesperado
  • Ao revisar um CronJob Kubernetes ou cronograma GitHub Actions escrito por um colega
  • Ao aprender sintaxe cron para um curso de certificação de administração de sistemas ou DevOps
  • Ao auditar entradas crontab existentes durante uma migração de servidor
  • Ao projetar um padrão de cronograma complexo que combina múltiplas restrições de tempo

Passos:

  1. Cole ou digite uma expressão cron de 5 campos no campo de entrada.
  2. Veja cada campo detalhado individualmente com seu significado.
  3. Leia a tradução em português simples do agendamento completo.
  4. Experimente um botão de predefinição para agendamentos comuns como "a cada hora" ou "dias úteis às 9h".

Fórmula

┌───────────── minuto (0-59) │ ┌───────────── hora (0-23) │ │ ┌───────────── dia do mês (1-31) │ │ │ ┌───────────── mês (1-12) │ │ │ │ ┌───────────── dia da semana (0-6, domingo=0) │ │ │ │ │ * * * * *

Casos de uso

  • Verificar um agendamento cron antes de implantar uma tarefa agendada ou pipeline de CI/CD
  • Entender um CronJob do Kubernetes ou função serverless agendada escrita por um colega
  • Depurar por que uma tarefa agendada rodou (ou não rodou) em um horário inesperado
  • Aprender a sintaxe cron para um curso de sysadmin ou DevOps
  • Auditar entradas existentes de crontab durante uma migração de servidor

Benefícios Principais

  • Traduz instantaneamente a sintaxe cron críptica para português simples
  • Detalha cada um dos 5 campos individualmente para maior clareza
  • Predefinições de um clique para os padrões de agendamento mais comuns
  • Sem cadastro, roda inteiramente no seu navegador

Dicas Profissionais

  • Em caso de dúvida, teste primeiro com um horário bem próximo para confirmar que o agendamento dispara conforme esperado
  • Use intervalos (1-5) em vez de listar cada valor com vírgulas sempre que possível, para maior legibilidade
  • Verifique novamente o fuso horário do seu servidor ou agendador — esta é a fonte mais comum de bugs de "horário errado" em cron
  • Para qualquer coisa mais complexa que um agendamento diário/semanal simples, escreva a descrição em português simples e compare com sua intenção antes de implantar

Erros Comuns a Evitar

  • Esquecer que dia-do-mês e dia-da-semana são combinados com OR, não com AND
  • Confundir a indexação do dia-da-semana começando em 0 (0=domingo) com convenções que começam em 1 de outros sistemas
  • Assumir que */7 no campo dia-do-mês significa "a cada 7 dias" — na verdade significa os dias 1, 8, 15, 22, 29, reiniciando a cada mês
  • Esquecer que a maioria das implementações de cron roda no fuso horário local do servidor, não em UTC ou no fuso do usuário

Termos Chave Explicados

Cron: Um agendador de tarefas baseado em tempo usado em sistemas operacionais do tipo Unix
Crontab: O arquivo ou comando usado para definir uma lista de tarefas cron
Valor de passo (step): A sintaxe "/N" significando "a cada N unidades" começando pelo valor mínimo de um campo
CronJob: O recurso nativo do Kubernetes para executar tarefas agendadas por cron

Conceitos relacionados

Exemplo

A expressão "0 9 * * 1-5" se decompõe em: minuto=0, hora=9, todo dia do mês, todo mês, de segunda a sexta — significando "Às 09:00, de segunda a sexta-feira."

Interpretação dos seus resultados

O analisador decompõe uma expressão cron de 5 campos em seus componentes individuais e traduz cada um para linguagem simples. Os cinco campos são: minuto (0–59), hora (0–23), dia do mês (1–31), mês (1–12) e dia da semana (0–6, onde 0 é domingo). Um job é executado quando TODOS os cinco campos correspondem ao horário atual — esta é a lógica AND entre campos. Preste atenção especial à interação entre o dia do mês e o dia da semana, que usa lógica OR (não AND). Um job agendado com dia 15 E dia da semana 5 será executado no dia 15 de cada mês E toda sexta-feira — não apenas sextas-feiras que caem no dia 15.

Perguntas Frequentes

Quais são os 5 campos de uma expressão cron?
Em ordem: minuto (0-59), hora (0-23), dia do mês (1-31), mês (1-12) e dia da semana (0-6, onde 0 é domingo). Uma tarefa roda quando todos os cinco campos correspondem ao horário atual.
O que significa um asterisco (*) na sintaxe cron?
Um asterisco significa "qualquer valor é permitido" para aquele campo. Por exemplo, * no campo da hora significa que a tarefa pode rodar em qualquer hora, ou seja, esse campo não restringe o agendamento.
O que significa */5?
A barra denota um valor de passo (step). */5 no campo dos minutos significa "a cada 5 minutos" — começando pelo valor mínimo do campo e repetindo a cada 5 unidades.
Como agendo uma tarefa apenas para dias úteis?
Use um intervalo no campo dia-da-semana: 1-5 representa de segunda a sexta. Combinado com uma hora e minuto específicos, por exemplo "0 9 * * 1-5" roda às 9h de segunda a sexta.
O que significa a vírgula na sintaxe cron?
Uma vírgula separa múltiplos valores em um único campo. Por exemplo, 0,15,30,45 no campo de minuto significa que a tarefa é executada nos minutos 0, 15, 30 e 45. A vírgula é um simples OU: a tarefa é executada em qualquer um dos valores listados.
O que é o hífen (intervalo) na sintaxe cron?
Um hífen define um intervalo de valores. Por exemplo, 1-5 no campo de dia da semana significa de segunda a sexta-feira (dias 1 a 5). Intervalos são inclusivos de ambos os extremos. Você pode combinar intervalos com outra sintaxe: 1-5,0 significa de segunda a sexta-feira mais domingo.
Como agendo uma tarefa para executar a cada 2 semanas?
O cron padrão não suporta agendamento quinzenal de forma nativa. Você tem duas opções: (1) Use um script auxiliar que verifica a data e só executa a cada duas semanas, ou (2) Use um agendador de tarefas que suporte expressões mais complexas como AWS EventBridge ou timers do sistema com gatilhos baseados em calendário.
Que fuso horário o cron usa?
O cron padrão usa o fuso horário local do servidor. Se seu servidor está configurado para UTC, todos os jobs cron são executados em UTC independente do seu fuso horário local. Sempre verifique a configuração de fuso horário do servidor, especialmente em ambientes de nuvem.
Qual é a diferença entre cron e crontab?
Cron é o daemon (serviço em segundo plano) que executa tarefas agendadas. Crontab é o arquivo de configuração (ou comando) que define a lista de jobs cron. Quando você edita seu crontab, está escrevendo as definições de horário que o daemon cron lê e executa.
Como lido com horário de verão com cron?
A maioria das implementações de cron não se ajusta automaticamente para horário de verão. Quando os relógios avançam, um job agendado para 2:00 da manhã pode ser completamente pulado. Quando os relógios voltam, um job pode ser executado duas vezes. Para evitar problemas, agende jobs fora das horas de transição (2:00–3:00 da manhã) ou use agendamento baseado em UTC.
Posso usar cron para intervalos subminutais?
O cron padrão tem granularidade de minuto e não pode agendar tarefas com mais frequência do que uma vez por minuto. Para intervalos subminutais, use alternativas como timers do systemd, Kubernetes CronJobs com intervalos mais curtos ou agendadores no nível da aplicação (node-cron com suporte a milissegundos).

Descubra Mais Ferramentas

Seleção de novas ferramentas em toda a nossa biblioteca.