Como funciona
- Digite uma expressão cron ou escolha uma predefinição.
- Leia a descrição em linguagem simples.
- Confira as próximas execuções no seu fuso horário.
Por que usar
- Explicação em linguagem simples.
- De 5 a 50 próximas execuções.
- Qualquer fuso horário IANA.
- Expressões de cinco ou seis campos.
Ler expressões cron e conferir quando elas rodam
Os cinco campos
Uma expressão cron são cinco valores separados por espaços, lidos da esquerda para a direita: minuto, hora, dia do mês, mês e dia da semana. Um * significa qualquer valor. O crontab do Linux, o GitHub Actions, os CronJobs do Kubernetes e a maioria dos agendadores de tarefas usam esse formato.
| Campo | Valores permitidos | Exemplo |
|---|---|---|
| Minuto | De 0 a 59 | */15 a cada 15 minutos |
| Hora | De 0 a 23 | 9-17 das 9:00 às 17:00 |
| Dia do mês | De 1 a 31 | 1 no dia primeiro |
| Mês | De 1 a 12 ou de JAN a DEC | */3 a cada três meses |
| Dia da semana | De 0 a 7 ou de SUN a SAT, 0 e 7 são ambos domingo | 1-5 de segunda a sexta |
Vírgulas listam valores (1,15), hífens dão intervalos (9-17) e uma barra dá passos (*/10). O exemplo padrão, */15 9-17 * * 1-5, roda a cada 15 minutos das 9:00 às 17:45 em dias úteis. Alguns sistemas, como o Quartz e alguns agendadores em nuvem, acrescentam na frente um sexto campo para os segundos: */5 * * * * * roda a cada 5 segundos. O interpretador aceita os dois.
As armadilhas
- Dia do mês e dia da semana juntos.
0 9 1 * 1roda às 9:00 no dia primeiro do mês e toda segunda-feira, não só nas segundas que caem no dia primeiro. A lista de próximas execuções mostra isso na hora. - `9-17` inclui o 17. Com
*/15no campo dos minutos, a última execução é às 17:45, não às 17:00. - Fusos horários. Servidores costumam rodar o cron em UTC. Uma tarefa marcada para as 9:00 roda às 9:00 UTC, que são 6:00 em São Paulo. Escolha o fuso horário do servidor na lista para ver os horários reais.
- Horário de verão. Na noite em que os relógios mudam, uma tarefa às 2:30 pode rodar duas vezes ou nenhuma, dependendo do agendador. Evite agendar na hora em torno das 2:00, horário local.
Conferir uma expressão
Digite ou cole uma expressão e três coisas se atualizam: uma frase que a descreve, o detalhamento de cada campo e uma lista das próximas execuções como datas. Ver as datas reais é a conferência mais segura: se a lista mostrar uma execução que você não esperava, a expressão não significa o que você pensou. Aumente o número de execuções para 50 para conferir um mês inteiro de uma tarefa frequente, e troque o fuso horário para comparar como ela roda num servidor em outro lugar. Há um relógio de 24 horas e uma redação mais detalhada à disposição.
Ferramentas relacionadas
Logs do cron e sistemas de tarefas geralmente registram horários como timestamps Unix; o conversor de timestamp os transforma em datas em qualquer fuso horário. Timestamps Unix explicados cobre o formato e suas armadilhas.
Se algo der errado
- Diz que a expressão é inválida. Conte os campos: cinco, ou seis com os segundos. Um valor está fora do intervalo, como 24 na hora ou 60 no minuto.
- As próximas execuções não são as esperadas. Confira o fuso horário e depois os campos de dia do mês e dia da semana.
- Seu agendador recusa uma expressão que funciona aqui. Os agendadores diferem: alguns não aceitam nomes como MON, um campo de segundos ou caracteres especiais como L e #.
Perguntas e respostas
O que significa */15?
Significa a cada 15 unidades daquele campo, então */15 no campo dos minutos roda nos minutos 0, 15, 30 e 45.
Aceita segundos?
Sim. Uma expressão de seis campos usa o primeiro campo para os segundos.
Os horários de execução são exatos?
Eles são calculados a partir da expressão e do fuso horário escolhido, incluindo as mudanças de horário de verão.
Guias relacionados
Timestamps Unix explicados
Um timestamp Unix é só uma contagem de segundos, mas causa um fluxo constante de bugs. O que ele conta, como distinguir segundos de milissegundos num relance, o que acontece com fusos horários e segundos bissextos, e por que 2038 importa.