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
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
developmentHubs 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.