O que faz
O interpretador de expressões cron explica um agendamento cron em linguagem simples e lista os próximos horários em que ele vai rodar. A sintaxe do cron é compacta, mas fácil de errar: 0 9 * * 1-5 é às nove horas em dias úteis ou a cada minuto das nove horas? Cole a expressão aqui antes de fazer o deploy e confira exatamente quando ela dispara.
Cada um dos cinco campos também é detalhado com os valores exatos que ele permite, o que torna fácil identificar erros em intervalos e passos.
Como usar
- Digite uma expressão cron na entrada ou clique em Exemplo.
- Leia a descrição e a tabela de campos. Os erros apontam o campo e a coluna incorretos, por exemplo uma hora igual a 24.
- Escolha horário Local ou UTC para as próximas execuções e quantas execuções mostrar.
Sintaxe do cron
Uma expressão cron tem cinco campos separados por espaços:
┌───────────── minute (0–59)
│ ┌─────────── hour (0–23)
│ │ ┌───────── day of month (1–31)
│ │ │ ┌─────── month (1–12 or JAN–DEC)
│ │ │ │ ┌───── day of week (0–7 or SUN–SAT, 0 and 7 are Sunday)
│ │ │ │ │
* * * * *| Símbolo | Significado | Exemplo |
|---|---|---|
* | todos os valores | * no campo hora = toda hora |
, | uma lista | 1,15 = nos dias 1 e 15 |
- | um intervalo | MON-FRI = de segunda a sexta |
/ | um passo | */15 = a cada 15 minutos |
Atalhos também são aceitos: @hourly, @daily (ou @midnight), @weekly, @monthly e @yearly (ou @annually).
Exemplos
| Expressão | Executa |
|---|---|
*/5 * * * * | a cada 5 minutos |
0 * * * * | no início de cada hora |
0 9 * * 1-5 | às 09:00 em dias úteis |
30 2 1 * * | às 02:30 do primeiro dia de cada mês |
0 0 * * 0 | à meia-noite de todo domingo |
Perguntas frequentes
› Qual formato de cron esta ferramenta usa?
O formato cron padrão do Unix (Vixie), com cinco campos, usado pelo crontab, CronJobs do Kubernetes, GitHub Actions e pela maioria dos agendadores. Formatos de seis campos com segundos (Quartz, Spring) não são suportados.
› O que acontece quando o dia do mês e o dia da semana estão definidos ao mesmo tempo?
O cron padrão executa a tarefa quando qualquer um dos dois bate. Por exemplo, 0 0 1,15 * 5 roda nos dias 1 e 15 de todo mês e em toda sexta-feira.
› Por que os horários de execução são diferentes no meu servidor?
O cron usa o fuso horário da máquina ou do serviço que o executa. O GitHub Actions e a maioria dos agendadores na nuvem usam UTC, então mude o Fuso horário para UTC para ver o que eles vão fazer.
› Nomes como MON ou JAN são aceitos?
Sim. Os meses aceitam JAN–DEC e os dias da semana aceitam SUN–SAT, em maiúsculas ou minúsculas. O domingo pode ser escrito como 0 ou 7.