Expressão cron
Entenda expressões cron campo a campo e veja os próximos horários de execução programados
Explicação
Todo dia à meia-noite
Próximas execuções programadas
—
Exemplos comuns
Campos cron
| Campo | Valores permitidos | Descrição |
|---|---|---|
| Minuto | 0-59 | O minuto em que o comando será executado (0-59) |
| Hora | 0-23 | A hora em que o comando será executado (0-23) |
| Dia do mês | 1-31 | O dia do mês em que o comando será executado (1-31) |
| Mês | 1-12 | O mês em que o comando será executado (1-12) |
| Dia da semana | 0-6 | O dia da semana em que o comando será executado (0-6, Domingo=0) |
Caracteres especiais
Asterisco (*)
Corresponde a qualquer valor no campo
Vírgula (,)
Especifica uma lista de valores (ex: 1,3,5)
Hífen (-)
Especifica um intervalo de valores (ex: 1-5)
Barra (/)
Especifica valores de passo (ex: */15 para cada 15)
01
O que é uma expressão cron?
Uma expressão cron é um agendamento escrito em cinco campos separados por espaços: minuto, hora, dia do mês, mês e dia da semana. O cron e muitos agendadores de tarefas a usam para executar jobs em horários definidos, de minuto em minuto até uma vez por ano. Por exemplo, 30 2 * * * significa 02:30 todos os dias. A sintaxe é compacta, o que também facilita a leitura errada.
Esta ferramenta lê o formato padrão de 5 campos, explica a expressão campo a campo e lista as próximas 5 execuções no seu fuso horário local. Ela aceita números, asteriscos, listas, intervalos e passos. Quartz e Spring usam 6 campos, começando pelos segundos; remova esse primeiro campo antes de colar. Nomes como MON não são suportados.
02
Como ler uma expressão cron
- Digite ou cole uma expressão de cinco campos, ou escolha um exemplo comum.
- Leia a explicação para ver o que cada campo corresponde.
- Confira as próximas execuções programadas, no seu horário local.
- Mude um campo e veja a explicação e os horários se atualizarem.
- Copie a expressão quando ela fizer o que você precisa.
03
Perguntas frequentes sobre expressões cron
- O que significa */5 no cron?
- A barra define um passo. */5 no campo de minuto significa a cada 5 minutos, a partir do minuto 0: 0, 5, 10 e assim por diante até 55. Um passo também pode vir depois de um intervalo, então 0-30/10 significa os minutos 0, 10, 20 e 30. No campo de hora, */6 significa a cada 6 horas: 00:00, 06:00, 12:00 e 18:00.
- Como agendar um cron toda segunda-feira às 9:00?
- Use 0 9 * * 1. Os campos se leem assim: minuto 0, hora 9, qualquer dia do mês, qualquer mês e dia da semana 1, que é segunda-feira. Domingo é 0, e muitas versões do cron também aceitam 7 para domingo. Para todo dia útil às 9:00, use 0 9 * * 1-5.
- Qual fuso horário o cron usa?
- O cron clássico executa os jobs no fuso horário local do servidor, a não ser que esteja configurado de outro jeito, por exemplo com CRON_TZ em alguns sistemas. Muitos agendadores na nuvem usam UTC por padrão. As próximas execuções listadas aqui são calculadas no fuso horário do seu navegador, então compare com a configuração do seu servidor.
- Minha expressão cron é enviada a um servidor?
- Não. A expressão é analisada e as próximas execuções são calculadas no navegador, com o relógio e o fuso horário do seu dispositivo. Nada do que você digita é enviado a um servidor ou armazenado, então você pode colar agendamentos de crontabs e arquivos de configuração privados.
04