Converta um cron em uma lista das próximas execuções

Uma expressão cron é compacta, mas essa sintaxe nem sempre é simples de revisar. Esta capacidade transforma uma expressão cron padrão de cinco campos em uma lista concreta dos próximos horários UTC, começando estritamente depois do instante informado por você. Escolha quantas ocorrências deseja receber e obtenha valores ISO 8601 exatos para copiar em testes, runbooks, chamados ou revisões de implantação. Campos malformados geram um erro de entrada claro, em vez de produzirem uma programação aparentemente plausível, porém incorreta.

Transforme a sintaxe cron compacta em datas verificáveis

Uma expressão cron de cinco campos descreve minutos, horas, dias do mês, meses e dias da semana. A notação é eficiente para máquinas, mas quem revisa uma programação geralmente precisa ver datas reais antes de confiar nela. Informe a expressão, um horário inicial ISO 8601 UTC exclusivo e uma quantidade de 1 a 100.

O resultado repete a solicitação normalizada e retorna os próximos instantes correspondentes em uma lista legível de horários terminados em Z. O início é exclusivo: se ele for exatamente 09:00 e a expressão executar às 09:00, o primeiro resultado será a ocorrência seguinte. Cron tem resolução de um minuto; por isso, todos os horários retornados têm zero segundos.

Listas, intervalos inclusivos, curingas e passos positivos funcionam em todos os campos. Por exemplo, */15 no campo de minutos seleciona quatro momentos por hora, enquanto 9-17/2 seleciona horas alternadas dentro desse intervalo. Os valores numéricos de dia da semana aceitam domingo como 0 ou 7.

Entenda as regras de calendário usadas no resultado

Todos os cálculos usam o calendário gregoriano proléptico e UTC. Exigir um horário terminado em Z evita conversões ocultas de fuso que poderiam deslocar uma execução para outra data ou para uma transição de horário de verão. A duração dos meses e os anos bissextos são calculados diretamente, inclusive a regra dos séculos: anos divisíveis por 100 não são bissextos, exceto quando também são divisíveis por 400.

A correspondência do dia da semana segue o comportamento cron convencional. Quando o dia do mês ou o dia da semana é um curinga, o campo restrito controla a correspondência. Quando ambos são restritos, a data corresponde se qualquer um deles corresponder.

Isso importa em 0 9 1 * 1, que significa 09:00 no primeiro dia de cada mês e também nas segundas-feiras; não significa somente segundas-feiras que sejam dia 1. As ocorrências são ordenadas cronologicamente e geradas com aritmética inteira determinística. Assim, a mesma entrada produz a mesma saída em qualquer máquina, fuso local, relógio atual ou localidade.

Valide programações antes de colocá-las em produção

Use a lista como um teste de aceitação pequeno e concreto para automações. A pessoa que revisa uma implantação pode confirmar que um trabalho de dias úteis não invade o fim de semana; uma pessoa operadora pode copiar as próximas janelas de manutenção para um runbook; e quem desenvolve pode transformar os horários em dados de teste do agendador. O analisador rejeita expressões que não tenham exatamente cinco campos.

Ele também rejeita itens vazios em listas, intervalos invertidos, passos zero ou malformados e números fora dos limites. Os intervalos aceitos são 0–59 para minutos, 0–23 para horas, 1–31 para dias do mês, 1–12 para meses e 0–7 para dias da semana. Esta capacidade não aceita nomes de meses ou dias, campos de segundos ou anos, macros como @daily nem extensões específicas de uma implementação.

Essas construções variam entre mecanismos cron; presumir o significado silenciosamente prejudicaria a prévia.