Como funciona o Analisador de Expressão Cron
O Analisador de Expressão Cron é uma ferramenta prática projetada para traduzir a sintaxe complexa de agendamentos cron em uma explicação simples e legível. Ao inserir uma expressão, a ferramenta realiza duas funções principais: ela decompõe a expressão em seus componentes individuais para mostrar o significado de cada parte do agendamento e calcula uma lista com as próximas execuções configuradas, apresentadas no fuso horário local do seu navegador.
A ferramenta possui um campo de texto de linha única para a inserção da Expressão cron. Ela aceita o formato padrão de 5 campos, que engloba minuto, hora, dia do mês, mês e dia da semana. Além disso, há um ajuste numérico chamado Contagem, que permite definir a quantidade de próximas execuções exibidas na tela, variando de 1 a 20.
Se o campo de entrada estiver vazio, a ferramenta retorna para o estado "Insira uma expressão cron para analisá-la.". Caso a sintaxe fornecida esteja incorreta, a interface exibirá a mensagem de erro "Expressão cron inválida.".
Sintaxe suportada e regras de conversão
Para garantir uma análise precisa, a ferramenta suporta uma variedade de formatos tradicionais dentro da estrutura de 5 campos:
- Intervalos e Listas: É possível utilizar intervalos (como
1-5) e listas de valores separados por vírgulas (como1,15). - Passos: A sintaxe de passos (como
*/15) é totalmente suportada. - Nomes: Você pode usar nomes para meses (por exemplo,
JAN) e dias da semana (por exemplo,MON). - Atalhos: Atalhos comuns do sistema cron também são aceitos, incluindo
@yearly,@monthly,@weekly,@dailye@hourly.
Durante a decomposição dos campos, a ferramenta traduz os caracteres especiais para facilitar a leitura:
- O caractere curinga
*é exibido no detalhamento como "Qualquer". - Anotações de passos no formato
*/nsão traduzidas de acordo com o campo correspondente, exibindo "A cada{n}minutos", "A cada{n}horas", "A cada{n}dias" (para o dia do mês ou dia da semana) ou "A cada{n}meses".
É importante destacar que esta ferramenta não oferece suporte para um sexto campo de segundos, nem para extensões específicas do Quartz, como os caracteres L, W ou #.
O detalhamento do agendamento e as próximas execuções
Assim que uma expressão válida é inserida, a ferramenta gera o Detalhamento do agendamento, dividindo as informações nos seguintes campos estruturados:
- Minuto: O valor analisado para o campo de minutos.
- Hora: O valor analisado para o campo de horas.
- Dia do mês: O valor analisado para o dia do mês.
- Mês: O valor analisado para o campo de meses.
- Dia da semana: O valor analisado para o dia da semana.
Logo abaixo, a seção Próximas execuções exibe a lista de datas e horários futuros em que a tarefa será executada. Esses horários são calculados e mostrados com base no fuso horário local do seu navegador, acompanhados pelo aviso "(seu horário local)". A interface também exibe o indicador de "Execuções exibidas" para confirmar a quantidade de itens listados de acordo com o ajuste de contagem selecionado.
Comportamentos específicos e casos limite
Ao configurar agendamentos cron, existem regras de comportamento e casos limite importantes que a ferramenta ajuda a identificar:
- Restrição dupla de dias: Quando você restringe tanto o dia do mês quanto o dia da semana (ou seja, nenhum dos dois campos está definido como
*), o agendamento é acionado se qualquer um dos dois campos for correspondido. Não é necessário que ambos coincidam simultaneamente para que a execução ocorra. - Agendamentos impossíveis: Se você inserir uma expressão que seja sintaticamente correta, mas que represente um agendamento que nunca poderá acontecer, a ferramenta exibirá o erro: "Este agendamento nunca ocorrerá — verifique se há um dia do mês que não existe em todos os meses selecionados.". Isso costuma acontecer ao definir o dia do mês como 31 em agendamentos que incluem meses com menos dias, como abril, junho, setembro ou novembro.
Privacidade e segurança dos dados
A privacidade dos seus dados de infraestrutura é respeitada integralmente durante o uso desta ferramenta. Todo o processamento e a análise da expressão cron inserida ocorrem diretamente no seu navegador de internet. Absolutamente nenhuma informação ou dado de agendamento é enviado para os servidores do BroBroGo.
Perguntas Frequentes
Qual sintaxe de cron esta ferramenta suporta?
A ferramenta suporta o cron padrão de 5 campos — minuto, hora, dia do mês, mês e dia da semana — incluindo intervalos (1-5), passos (*/15), listas (1,15), meses e dias da semana por nome (JAN, MON) e os atalhos @yearly/@monthly/@weekly/@daily/@hourly. Uma regra fácil de esquecer: quando tanto o dia do mês quanto o dia da semana estão restritos (diferentes de *), a correspondência em qualquer um deles é suficiente — eles não precisam coincidir.
Em qual fuso horário as próximas execuções são exibidas?
No fuso horário local do seu navegador — o mesmo usado pelo relógio do seu sistema. O cron padrão não carrega informações de fuso horário; o agendador que o executa é quem define isso, portanto, encare esses horários como uma prévia do seu agendamento local, não necessariamente do servidor.
Por que diz que este agendamento nunca ocorrerá?
Geralmente é um valor de dia do mês que não existe em todos os meses selecionados — por exemplo, o dia 31 com abril, junho, setembro ou novembro no campo do mês. Escolha um dia que exista em todos os meses listados ou divida o agendamento em expressões separadas.