Analisador de Expressões Cron

No que cada campo se expande

Um campo não é um valor, é um conjunto. Saber o tamanho desse conjunto costuma responder à pergunta que trouxe você até aqui.

Operadores dentro de um campo: * todos os valores, 1,5,10 uma lista, 1-5 um intervalo, */15 um passo contado a partir do início do intervalo e 0-45/15 um passo dentro de um intervalo.

Nomes e atalhos são aceitos

Nomes de mês e de dia da semana são interpretados e expandidos para os números que representam, então 30 3 * JAN,JUL 1 informa mês 1, 7 e dia da semana 1. Os atalhos nomeados são expandidos para a forma de 5 campos antes de qualquer outra coisa:

@reboot também é reconhecido, mas não tem agendamento para expandir: ele é executado uma vez quando a máquina inicia, então não há horários de execução para prever.

Avisos que vale a pena ler

• Os dois campos de dia restritos. 0 0 1 * MON não significa “no dia 1º, mas só se for uma segunda-feira”. O cron padrão trata os dois campos de dia como um OU lógico quando ambos estão restritos, então essa linha dispara no dia 1º de todo mês e em toda segunda-feira. O analisador levanta esse aviso, e a prévia das execuções segue a regra do OU.
• Uma data que nunca acontece. 0 0 30 2 * pede 30 de fevereiro. A expressão é sintaticamente válida e o cron a aceita, mas ela nunca vai disparar. O analisador avisa isso em vez de mostrar uma lista vazia sem explicação.
• Operadores do Quartz. L (último), W (dia útil mais próximo), # (enésimo dia da semana) e ? são extensões do Quartz, não do crontab padrão. Dentro de uma linha de 5 campos eles são reconhecidos e sinalizados, e o campo mostra que se trata de um operador do Quartz em vez de uma lista de valores. Nenhum horário de execução é calculado, porque o cron padrão simplesmente não executaria essa linha.

O que é rejeitado de imediato

• O número errado de campos. Uma linha Quartz de 6 campos com segundos, ou de 7 campos com ano, é rejeitada pela contagem de campos.
• Valores fora do intervalo, por exemplo minuto 75 ou mês 13.
• Um intervalo decrescente como 5-1.
• Um passo igual a zero, como */0.

Toda rejeição nomeia o campo e o valor que a causou, então você corrige uma coisa só em vez de reescrever a linha inteira.

Fuso horário

A prévia das próximas execuções é calculada no seu navegador, no fuso horário configurado no seu dispositivo. Um crontab roda no fuso horário da máquina que o hospeda, então, se esse servidor estiver em UTC e você não estiver (o horário de Brasília é UTC-3), ajuste os horários antes de comparar.