Gerador de expressão cron
Crie um agendamento cron de cinco campos, leia-o em linguagem simples e veja as próximas 10 execuções.
Expressão cron
Expressão cron
-
Próximas 10 execuções
| Data e hora | A partir de agora |
|---|
Como funciona
Uma expressão cron agenda uma tarefa recorrente com cinco campos: minuto, hora, dia do mês, mês e dia da semana. Este gerador cria uma expressão válida conforme você edita cada campo, explica-a em linguagem simples e lista os próximos horários em que ela seria realmente executada.
- Defina os campos
Digite um valor, uma lista, um intervalo ou um passo em cada campo, ou comece com um modelo predefinido.
- Leia a explicação
A frase em linguagem simples e a expressão montada são atualizadas conforme você digita.
- Verificar as próximas execuções
A tabela abaixo mostra quando o agendamento seria acionado a partir de agora.
Intervalos e sintaxe dos campos
| Campo | Valores permitidos | Exemplo |
|---|---|---|
| Minuto | 0 a 59 | */15 significa a cada 15 minutos |
| Hora | 0 a 23 | 9-17 significa das 9h às 17h |
| Dia do mês | 1 a 31 | 1,15 significa dia 1 e dia 15 |
| Mês | 1 a 12 | 6-8 significa de junho a agosto |
| Dia da semana | 0 a 6, domingo é 0 | 1-5 significa de segunda a sexta-feira |
Lendo uma expressão cron
Cada expressão cron possui cinco campos em uma ordem fixa: minuto, hora, dia do mês, mês e dia da semana. Um asterisco significa todos os valores, uma vírgula separa uma lista, um traço marca um intervalo e uma barra marca um passo, então */15 no campo de minutos significa a cada 15 minutos.
A pegadinha do dia do mês e dia da semana
Quando os campos de dia do mês e dia da semana são ambos restritos, a maioria das implementações de cron, incluindo este gerador, executa a tarefa quando qualquer uma das condições for verdadeira, não apenas quando ambas coincidem. Por exemplo, 0 0 1 * 1 é executado à meia-noite do dia 1º do mês e toda segunda-feira, o que ocorre com mais frequência do que muitas pessoas esperam.
O que este gerador não cobre
Esta ferramenta implementa a sintaxe padrão de cron Unix de cinco campos. Ela não adiciona o campo de segundos usado pelo Quartz Scheduler, os atalhos @yearly ou @weekly, nem o formato cron de seis campos do AWS EventBridge. Toda a análise e os cálculos das próximas execuções ocorrem no seu navegador usando o relógio local, e nada é enviado para um servidor.
Fuso horário
Os próximos horários de execução usam o fuso horário e o relógio locais do seu dispositivo. Se o servidor que executa sua tarefa cron estiver configurado para um fuso horário diferente, os horários reais de execução serão diferentes do que esta página mostra.
Perguntas frequentes
Como leio uma expressão cron como 0 9 * * 1-5?
Uma expressão cron padrão tem cinco campos nesta ordem: minuto, hora, dia do mês, mês e dia da semana. A expressão 0 9 * * 1-5 significa no minuto 0, hora 9, todo dia do mês, todo mês, apenas nos dias úteis de segunda a sexta-feira: 9h00 nos dias úteis. Este gerador mostra a mesma explicação em linguagem simples enquanto você edita cada campo.
Como agendo uma tarefa para executar a cada 5 minutos?
Use a expressão */5 * * * *. O */5 no campo de minuto significa a cada 5 minutos usando a sintaxe de passo. Clique na predefinição A cada 5 minutos para carregá-la automaticamente e verifique a tabela Próximas 10 execuções para confirmar o agendamento antes de implantá-lo.
Qual é a diferença entre os campos dia do mês e dia da semana?
O dia do mês refere-se a uma data específica do calendário, como o dia 1º ou o dia 15. O dia da semana refere-se a um dia da semana, onde 0 é domingo e 6 é sábado. Quando ambos os campos estão definidos com algo diferente de um asterisco, a maioria das implementações de cron executa a tarefa quando qualquer uma das condições é verdadeira, não apenas quando ambas correspondem, o que é uma causa comum de execuções extras inesperadas.
Este gerador oferece suporte a segundos ou ao formato cron do AWS EventBridge?
Esta ferramenta implementa a sintaxe padrão de cron Unix de cinco campos, do minuto ao dia da semana. Ela não oferece suporte a um campo inicial de segundos, usado pelo Quartz Scheduler, aos atalhos @yearly ou @weekly, nem ao formato de cron de seis campos do AWS EventBridge. Consulte a documentação do seu agendador se precisar de precisão em nível de segundos.
Minha expressão cron é enviada para um servidor?
Não. Toda a análise e os cálculos das próximas execuções ocorrem no seu navegador com JavaScript, e a página continua funcionando offline após o carregamento. Os horários das próximas execuções usam o relógio local e o fuso horário do seu dispositivo, portanto podem diferir de um servidor configurado em um fuso horário diferente.