Categorias

Visualizador de Expressoes Cron

Analisa agendamentos cron, valida sintaxe cron padrao ou Quartz e visualiza as proximas execucoes em uma linha do tempo e calendario agrupado

Exemplos de resultados

2 Exemplos

Visualizar um agendamento matinal de dias uteis

Mostra as proximas dez execucoes das 9h30 em dias uteis em uma linha do tempo e calendario agrupado

Standard cron timeline with 10 future runs grouped by calendar day.
Ver parâmetros de entrada
{ "cronExpression": "30 9 * * 1-5", "cronFormat": "standard", "occurrences": 10, "startDate": "2026-03-22T08:00:00+08:00" }

Inspecionar um gatilho Quartz a cada quinze minutos

Analisa uma expressao Quartz de seis campos e mostra as proximas dez execucoes a cada quinze minutos

Quartz cron timeline with 10 quarter-hour execution slots.
Ver parâmetros de entrada
{ "cronExpression": "0 0/15 * * * ?", "cronFormat": "quartz", "occurrences": 10, "startDate": "2026-03-22T00:00:00Z" }

Fatos principais

Categoria
Development
Tipos de entrada
text, select, number
Tipo de saída
html
Cobertura de amostras
2
API disponível
Yes

Visão geral

O Visualizador de Expressões Cron é uma ferramenta essencial para desenvolvedores e administradores de sistemas que precisam validar e entender agendamentos de tarefas. Ele analisa expressões cron nos formatos padrão ou Quartz, exibindo as próximas execuções de forma clara em uma linha do tempo e em um calendário agrupado, facilitando a depuração e evitando erros de configuração em rotinas automatizadas.

Quando usar

  • Quando precisar validar se uma expressão cron complexa executará exatamente nos dias e horários esperados.
  • Ao migrar agendamentos entre sistemas que utilizam o formato cron padrão e o formato Quartz.
  • Para documentar ou explicar rotinas de automação para equipes não técnicas usando uma visualização de calendário.

Como funciona

  • Insira a sua expressão cron (por exemplo, 30 9 * * 1-5) no campo principal.
  • Selecione o formato desejado (Detecção Automática, Padrão ou Quartz) e defina a data de início e o número de ocorrências.
  • A ferramenta processa a sintaxe e gera uma linha do tempo interativa e um calendário agrupado com as próximas execuções.

Casos de uso

Configuração de backups de banco de dados que devem ocorrer em horários de baixo tráfego, como madrugadas de finais de semana.
Agendamento de disparos de e-mail marketing ou relatórios semanais para clientes em dias úteis específicos.
Depuração de jobs de CI/CD (como GitHub Actions ou GitLab CI) para garantir que as pipelines rodem nos intervalos corretos.

Exemplos

1. Agendamento de Relatórios em Dias Úteis

Analista de Dados
Contexto
A equipe precisa receber um relatório de vendas todos os dias úteis às 09:30 da manhã.
Problema
Garantir que a expressão cron não execute o envio de relatórios aos sábados e domingos.
Como usar
Insira a expressão '30 9 * * 1-5', selecione o formato 'Standard cron' e defina 10 ocorrências.
Configuração de exemplo
cronExpression: "30 9 * * 1-5", cronFormat: "standard", occurrences: 10
Resultado
A linha do tempo exibirá as próximas 10 execuções agrupadas por dia, confirmando que os finais de semana são ignorados.

2. Sincronização de API a cada 15 minutos

Desenvolvedor Backend
Contexto
Um serviço de integração precisa buscar dados de uma API externa a cada 15 minutos, começando no início da hora.
Problema
Validar a sintaxe Quartz de 6 campos para garantir que os intervalos de 15 minutos estejam corretos.
Como usar
Insira a expressão '0 0/15 * * * ?', escolha o formato 'Quartz cron' e defina uma data inicial.
Configuração de exemplo
cronExpression: "0 0/15 * * * ?", cronFormat: "quartz", occurrences: 10, startDate: "2026-03-22T00:00:00Z"
Resultado
O calendário mostrará execuções exatas nos minutos 00, 15, 30 e 45 de cada hora a partir da data estipulada.

Testar com amostras

development

Hubs relacionados

FAQ

Qual a diferença entre o formato cron padrão e o Quartz?

O cron padrão usa 5 campos (minuto, hora, dia, mês, dia da semana), enquanto o Quartz geralmente usa 6 ou 7 campos, incluindo segundos e suporte a caracteres especiais como '?' e 'L'.

Quantas ocorrências futuras posso visualizar?

Você pode configurar a ferramenta para exibir entre 1 e 20 ocorrências futuras a partir da data inicial definida.

Posso definir um fuso horário específico para a data inicial?

Sim, basta incluir o offset de fuso horário na data inicial (por exemplo, 2026-03-22T08:00:00-03:00 para o horário de Brasília).

A ferramenta detecta automaticamente o formato da expressão?

Sim, ao deixar a opção de formato como 'Auto detect', a ferramenta analisa a quantidade de campos e os caracteres utilizados para identificar se é padrão ou Quartz.

O que acontece se a expressão cron for inválida?

A ferramenta não gerará a linha do tempo e indicará que a sintaxe fornecida não corresponde a um agendamento válido nos formatos suportados.

Documentação da API

Ponto final da solicitação

POST /pt/api/tools/cron-expression-visualizer

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
cronExpression text Sim -
cronFormat select Não -
occurrences number Não -
startDate text Não -

Formato de resposta

{
  "result": "
Processed HTML content
", "error": "Error message (optional)", "message": "Notification message (optional)", "metadata": { "key": "value" } }
HTML: HTML

Documentação de MCP

Adicione este ferramenta à sua configuração de servidor MCP:

{
  "mcpServers": {
    "elysiatools-cron-expression-visualizer": {
      "name": "cron-expression-visualizer",
      "description": "Analisa agendamentos cron, valida sintaxe cron padrao ou Quartz e visualiza as proximas execucoes em uma linha do tempo e calendario agrupado",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=cron-expression-visualizer",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.

Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]