Gerador de expressão Cron
Crie e explique expressões Cron comuns.
Como usar
Uma expressão Cron padrão tem cinco campos separados por espaços, nesta ordem: minuto (0–59), hora (0–23), dia do mês (1–31), mês (1–12) e dia da semana (0–7, em que tanto 0 quanto 7 significam domingo). Escolha uma predefinição ou digite uma expressão, e “Explicar” a valida e mostra em uma tabela o que cada campo significa.
Cada campo aceita * para todos os valores, um único número, um intervalo como 1-5, uma lista como 1,15 e um passo como */15 ou 0-30/10. Os passos contam a partir do início do intervalo, então */15 no campo dos minutos significa os minutos 0, 15, 30 e 45, e */7 no campo do dia do mês significa os dias 1, 8, 15, 22 e 29, recomeçando a cada mês.
Quando o dia do mês e o dia da semana estão definidos com algo diferente de *, o Cron padrão executa a tarefa quando qualquer um dos dois coincide, e não só quando os dois coincidem. 0 9 13 * 5 executa às 09:00 em todo dia 13 do mês e em toda sexta-feira, e não apenas nas sextas-feiras 13.
O Cron usa o fuso horário da máquina ou do serviço que o executa. Muitos agendadores hospedados usam UTC por padrão (o GitHub Actions usa, a menos que o agendamento defina um fuso horário), então 0 9 * * * dispara às 10:00 ou às 11:00 em Paris ou Berlim, e às 09:00 ou às 10:00 em Lisboa ou Londres. Nas mudanças de horário de verão, uma tarefa agendada na hora que é pulada ou repetida pode não ser executada, ou pode ser executada duas vezes, dependendo da implementação.
Esta ferramenta valida o formato numérico portátil. Ela não aceita nomes de meses ou de dias (JAN, MON), os caracteres especiais L, W, # e ?, atalhos como @daily nem um campo de segundos ou de ano, e não lista os próximos horários de execução. Consulte a documentação do seu agendador para ver o que ele acrescenta.
Exemplo
*/15 * * * * significa a cada 15 minutos. O agendador define o fuso horário; esta ferramenta não agenda tarefas.
0 9 * * *Todos os dias às 09:00.0 9 * * 1-5Às 09:00, de segunda a sexta.*/15 * * * *A cada 15 minutos: nos minutos 0, 15, 30 e 45 de cada hora.0 0 1 * *À meia-noite do primeiro dia de cada mês.30 18 * * 0,6Às 18:30 aos sábados e domingos.
Perguntas frequentes
Aceita Cron com seis campos e segundos?
Não. A ferramenta usa o formato portátil de cinco campos. Algumas plataformas, como Quartz e Spring, colocam um campo de segundos no início, e outras acrescentam um ano no fim.
Posso usar nomes como MON ou JAN?
Não. Use valores numéricos: 0–7 para os dias da semana e 1–12 para os meses.
Como executo uma tarefa no último dia do mês?
O Cron padrão de cinco campos não consegue expressar isso diretamente. As soluções mais comuns são executar nos dias 28–31 e deixar a tarefa verificar se amanhã é dia 1º, ou usar um agendador que aceite L.
Por que minha tarefa foi executada na hora errada?
Geralmente porque o agendador usa UTC ou um fuso horário diferente do seu. Converta a hora ou defina o fuso horário do agendador, se ele permitir.