Como rodar um job a cada 5 minutos?

Use */5 * * * *. No Quartz, 0 */5 * * * ?. No GitHub Actions, 5 minutos é o menor intervalo aceito.

Por que meu cron com dia do mês e dia da semana roda mais do que eu esperava?

Quando os dois campos estão preenchidos, o cron roda se qualquer um deles bater. 0 0 13 * 5 roda todo dia 13 e toda sexta-feira. Para rodar só na sexta-feira 13, agende 0 0 * * 5 e teste a data no comando, por exemplo com [ "$(date +\%d)" = 13 ] && ... (no crontab, o % precisa de barra antes).

Em qual fuso horário o cron roda?

Depende do agendador. O crontab usa o fuso do servidor. O GitHub Actions usa UTC por padrão, então 0 12 * * * roda às 9h em Brasília. O CronJob do Kubernetes usa o fuso do kube-controller-manager, a não ser que você defina spec.timeZone, como America/Sao_Paulo.

Como agendar no último dia do mês?

No Quartz, use L no dia do mês: 0 0 23 L * ?. O cron padrão não tem esse recurso. O jeito comum é agendar 0 23 28-31 * * e rodar o comando só quando amanhã for dia 1: [ "$(date -d tomorrow +\%d)" = 01 ] && ... (date -d é do GNU, presente na maioria das distribuições Linux).

No crontab do Linux, os dois. O Kubernetes e o GitHub Actions aceitam de 0 a 6, então 0 é o que funciona em todos. No Quartz a numeração é outra: domingo é 1 e sábado é 7. Com nomes (SUN, MON...) não há essa confusão.

Qual a diferença entre o cron do Linux e o do Quartz?

O Quartz tem um campo de segundos no começo e um ano opcional no fim, conta o domingo como 1 e exige ? em um dos campos de dia. Ele também aceita L, W e #, que o cron padrão não conhece. Por isso 0 0 12 * * ? é Quartz e não funciona no crontab.

Por que meu workflow agendado no GitHub Actions rodou atrasado?

O GitHub avisa que execuções agendadas podem atrasar nos horários de carga alta, principalmente no começo de cada hora. Agendar num minuto quebrado, como 17 * * * *, costuma ajudar. Confira também se o horário está em UTC.

A expressão que eu digito é enviada para algum lugar?

Não. A explicação e as próximas execuções são calculadas no seu navegador. A expressão não vai para servidor nenhum nem para as métricas de uso.

Gerador e explicador de expressão cron

Cole uma expressão cron e veja o que ela faz em português, campo por campo, e as próximas execuções no fuso que você escolher. Funciona com crontab, Kubernetes, GitHub Actions e Quartz. Também dá para montar a expressão a partir do horário que você quer.

Expressão cron

Formato

Exemplos comuns

Digite ou cole uma expressão

Ou escolha um dos exemplos. A explicação e as próximas execuções aparecem aqui.

Montar uma expressão

Escolha a frequência e o horário. A expressão sai no formato selecionado acima.

Frequência

Horário

Dias

0 9 * * 1-5Às 09:00, de segunda-feira a sexta-feira

O que é uma expressão cron

É uma linha de campos separados por espaço que diz quando um job roda. No crontab do Linux, no CronJob do Kubernetes e no schedule do GitHub Actions são 5 campos. O Quartz, agendador usado em Java, acrescenta os segundos no começo e um ano opcional no fim.

Os 5 campos do cron padrão

A ordem é sempre minuto, hora, dia do mês, mês e dia da semana. 30 9 * * 1 quer dizer minuto 30, hora 9, qualquer dia do mês, qualquer mês, segunda-feira.

Campo	Valores
Minuto	0 a 59
Hora	0 a 23
Dia do mês	1 a 31
Mês	1 a 12 ou JAN a DEC
Dia da semana	0 a 6 ou SUN a SAT (0 é domingo)

Asterisco, vírgula, hífen e barra

* aceita qualquer valor do campo.
Vírgula separa valores: 0,30 no minuto roda nos minutos 0 e 30.
Hífen marca um intervalo: 1-5 no dia da semana vai de segunda a sexta.
Barra define o passo: */15 no minuto roda a cada 15 minutos, e 9-17/2 na hora roda às 9, 11, 13, 15 e 17.

O que muda no Quartz

O primeiro campo são os segundos, e o domingo vale 1 (sábado é 7). Um dos campos de dia precisa ser ?, que quer dizer sem valor. O Quartz também aceita L para o último dia do mês, LW para o último dia útil, 15W para o dia útil mais próximo do dia 15, 6L para a última sexta-feira e 6#3 para a terceira sexta-feira do mês.

Fuso horário e horário de verão

A expressão não diz o fuso. O crontab usa o fuso do servidor, o GitHub Actions usa UTC e o Kubernetes usa o fuso do controller, a não ser que spec.timeZone esteja definido. Para rodar às 9h de Brasília num agendador em UTC, a hora é 12. Nos fusos com horário de verão, um horário pode não existir no dia em que o relógio adianta, ou acontecer duas vezes quando ele atrasa. A lista de execuções marca esses casos.

Perguntas frequentes sobre expressão cron

As dúvidas de quem agenda job no crontab, no Kubernetes, no GitHub Actions e no Quartz.