./prontouso.com

FERRAMENTAS DE DESENVOLVIMENTO

Gerador e Validador de Expressão Cron

Crie e valide expressões cron para agendamento de tarefas (crontab). Converta expressões de 5 campos em explicações em português, detecte conflitos de data e simule as próximas execuções.

Status da ferramentaRoda no seu navegador
Prévia
prontouso://dev/cron-expression-helper
5 CAMPOSFUSO DO NAVEGADOR

Como funciona

  1. Informe os dados

    Preencha os valores, cole o texto ou envie o arquivo que esta ferramenta usa.

  2. Veja o resultado na hora

    A maioria das ferramentas atualiza enquanto você digita; algumas usam um único botão. De qualquer forma, o resultado aparece aqui mesmo.

  3. Use o resultado

    Copie, baixe ou compartilhe o que a ferramenta gerar — o controle é sempre seu.

Privacidade e processamento — Roda localmente no seu navegador. Esta ferramenta não faz upload da sua entrada.

O que é Gerador e Validador de Expressão Cron?

Uma expressão cron de 5 campos define o agendamento de tarefas automáticas (cron jobs) em sistemas Unix e servidores, especificando minuto, hora, dia do mês, mês e dia da semana para execução periódica.

ENTENDA A FERRAMENTA

Como montar, validar e decodificar expressões cron

Aprenda a estruturar expressões cron de cinco campos, utilizar operadores de intervalo e passo, evitar a armadilha lógica entre dias do mês e da semana e simular execuções no fuso horário local.

Anatomia dos 5 campos do cron padrão

O padrão POSIX/Unix clássico divide a expressão em exatamente cinco posições separadas por espaço, avaliadas da menor para a maior unidade temporal:

  • Minuto (0 a 59): define o minuto exato da hora em que a execução ocorre.
  • Hora (0 a 23): define a hora do dia em formato de 24 horas (0 = meia-noite).
  • Dia do Mês (1 a 31): define o dia do calendário no qual o job é acionado.
  • Mês (1 a 12): representa os meses do ano (1 = janeiro, 12 = dezembro).
  • Dia da Semana (0 a 7): indica o dia da semana, onde tanto 0 quanto 7 representam o Domingo, 1 é Segunda-feira e 6 é Sábado.

Operadores e caracteres especiais

Você pode combinar diferentes operadores para criar padrões de repetição flexíveis:

  • Asterisco (*): curinga que representa todos os valores possíveis daquele campo.
  • Vírgula (,): permite listar valores específicos e múltiplos (ex.: '1,15,30' no campo de minutos).
  • Hífen (-): define intervalos contínuos inclusivos (ex.: '1-5' para dias úteis ou '9-18' para horário comercial).
  • Barra (/): estabelece intervalos de passo ou repetição (ex.: '*/15' para executar a cada 15 minutos ou '0/2' para horas pares).

Armadilha clássica: Dia do Mês vs Dia da Semana (Lógica OR)

No padrão Unix cron, quando tanto o 'Dia do Mês' quanto o 'Dia da Semana' possuem restrições (nenhum deles é '*'), o agendador aplica uma lógica OU (OR), e não E (AND). Isso significa que a tarefa será executada se a data coincidir com o dia do mês OU com o dia da semana especificado, o que frequentemente duplica a frequência pretendida. Para restringir a um dia específico da semana dentro do mês, recomenda-se validar a condição no próprio script executado.

Construtor visual e simulação de execuções

Use o modo guiado para gerar expressões sem precisar memorizar os limites numéricos ou digite a expressão diretamente no modo de sintaxe para validar cada campo em tempo real. A ferramenta traduz o agendamento para português claro e projeta as próximas 8 execuções calculadas no fuso horário do seu navegador, com indicação do horário em UTC.

Tarefas em dias úteis e horários comerciais

Exemplos comuns de expressões cron utilizadas em ambientes de produção:

*/15 8-18 * * 1-5 -> A cada 15 minutos, das 08:00 às 18:59, de segunda a sexta 0 3 * * 0 -> Todos os domingos às 03:00 da madrugada (rotina de backup) 0 0 1 * * -> No dia 1º de cada mês à meia-noite (fechamento mensal)

Processamento 100% no navegador

Toda a validação de sintaxe, decodificação textual e cálculo das próximas execuções acontecem exclusivamente no seu navegador via JavaScript. Nenhuma expressão ou dado do seu servidor é enviado para a internet.

Perguntas frequentes

A ferramenta suporta expressões cron com segundos (6 ou 7 campos)?

Não. A ferramenta segue o padrão universal Unix/Crontab de 5 campos (minuto, hora, dia do mês, mês e dia da semana). Formatos de 6 campos (como Spring, Quartz ou AWS CloudWatch) utilizam segundos ou ano e precisam de adaptação.

Por que o domingo pode ser representado tanto por 0 quanto por 7?

Esta é uma convenção histórica do padrão POSIX e do utilitário Vixie Cron para manter compatibilidade com sistemas legados, onde 0 (padrão em linguagens como C e JS) e 7 (padrão em alguns calendários) referem-se ao domingo.

Como funciona o operador de barra (/) em expressões como */15 ou 5/20?

A barra define o passo de incremento. A expressão '*/15' no campo de minutos executa nos minutos 0, 15, 30 e 45. Já '5/20' inicia no minuto 5 e repete a cada 20 minutos (minutos 5, 25 e 45).

O que acontece se eu preencher dia do mês e dia da semana ao mesmo tempo?

No padrão do cron, a tarefa roda quando QUALQUER UMA das duas condições for verdadeira (lógica OR). Por exemplo, '0 0 15 * 5' executa no dia 15 de cada mês E também em todas as sextas-feiras do mês.

Em qual fuso horário as próximas execuções são simuladas?

O cálculo utiliza o fuso horário local configurado no seu dispositivo/navegador para facilitar a conferência do relógio, apresentando adicionalmente a data no padrão universal ISO UTC.

Como agendar uma rotina para rodar apenas de segunda a sexta-feira?

Utilize o intervalo '1-5' no quinto campo (dia da semana). Por exemplo, '0 9 * * 1-5' disparará a tarefa pontualmente às 09:00 de segunda a sexta-feira.

Ferramentas relacionadas