Como validar uma expressão cron e ver as próximas execuções

O que pode verificar

O Cron Expression Parser serve para verificar uma expressão cron com cinco campos e calcular as cinco próximas ocorrências do calendário. É útil quando precisa de confirmar se uma agenda está bem formada e perceber as execuções seguintes a partir da hora UTC atual.

A ordem dos campos é fixa: minuto, hora, dia do mês, mês e dia da semana. Se não introduzir uma expressão, é usada */5 * * * *, que representa uma execução a cada cinco minutos. Espaços no início e no fim são removidos e sequências de espaços são normalizadas antes da validação.

Como validar uma expressão cron

1. Introduza a expressão cron no campo disponível. Use cinco campos separados por espaços, pela ordem minuto, hora, dia do mês, mês e dia da semana. Se deixar o campo sem expressão, a ferramenta aplica a expressão predefinida.

2. Reveja a separação dos campos antes de submeter. Uma expressão com mais ou menos de cinco campos falha antes de ser calculada. Espaços repetidos não alteram a separação, porque são normalizados durante a validação.

3. Execute a validação e o cálculo. A referência temporal é a hora UTC atual, sem as frações de segundo. Quando existirem ocorrências futuras dentro do limite de pesquisa, o resultado apresenta cinco datas e horas em formato ISO, identificadas como UTC.

4. Compare o resultado com o objetivo da agenda. Para confirmar uma execução mensal, por exemplo, verifique se os campos de dia, mês e hora correspondem ao calendário que pretende. Quando houver restrições simultâneas para dia do mês e dia da semana, basta que uma delas corresponda para a ocorrência ser considerada.

Como interpretar o resultado

Um resultado com cinco datas e horas ISO indica que a sintaxe foi aceite e que foram encontradas cinco ocorrências futuras dentro do período de pesquisa. As datas devem ser lidas em UTC, não necessariamente na hora local do seu país.

Uma falha não significa apenas que a expressão tem sintaxe inválida. Também pode ocorrer quando há um erro de data, valor ou chave, ou quando uma expressão válida não tem uma ocorrência futura encontrada no limite de pesquisa de dez anos. Por isso, reveja tanto a estrutura dos campos como a frequência prevista pela agenda.

A ferramenta trabalha com expressões de cinco campos. O número de campos, por si só, não confirma compatibilidade com variantes cron de seis campos, outros dialetos ou todas as implementações existentes.

Exemplo prático

Precisa de confirmar uma agenda que ocorre à meia-noite no primeiro dia de cada mês.

Introduza 0 0 1 * * e execute o cálculo para consultar as próximas ocorrências mensais.

O resultado esperado, quando a pesquisa tem sucesso, é uma lista de cinco datas e horas em formato ISO, identificadas como UTC, correspondentes ao primeiro dia de meses futuros à meia-noite.

Limitações

• Uma expressão válida pode falhar se não for encontrada uma ocorrência futura no limite de pesquisa de dez anos.
• A validação de cinco campos não confirma compatibilidade com expressões de seis campos, outros dialetos ou todas as implementações cron.

Erros comuns

• Causa: a expressão tem um número de campos diferente de cinco ou usa uma ordem diferente da esperada. Ação: separe cinco campos e reveja a sequência minuto, hora, dia do mês, mês e dia da semana antes de submeter.

Perguntas frequentes

O que acontece se eu deixar a expressão cron vazia?

Se não introduzir uma expressão, é usada */5 * * * *. Depois da validação, a ferramenta calcula as cinco ocorrências seguintes a partir da hora UTC atual.

Posso usar uma expressão cron com seis campos?

Não. O resultado usa cinco campos: minuto, hora, dia do mês, mês e dia da semana. Uma quantidade diferente de campos devolve falha antes do cálculo.

Uma expressão cron válida pode apresentar falha?

Pode devolver falha. Isso acontece quando não é encontrada uma ocorrência futura dentro do limite de pesquisa de dez anos, mesmo que a sintaxe seja válida.