Expressões cron parecem números e asteriscos aleatórios, mas controlam quando milhões de tarefas agendadas são executadas em toda a internet. Seja para configurar um script de backup, agendar relatórios por e-mail ou configurar um pipeline de CI/CD, entender cron é essencial. Este tutorial torna isso fácil usando nosso Analisador Cron gratuito.
O que você precisa
- Uma expressão cron para decodificar, ou um agendamento que deseja expressar como cron
- Um navegador web (Chrome, Firefox, Safari ou Edge)
- Nenhuma conta ou instalação necessária
Guia passo a passo
Insira uma expressão cron
Abra a ferramenta Analisador Cron. Digite ou cole uma expressão cron no campo de entrada. Por exemplo, experimente 0 9 * * 1. A ferramenta analisa imediatamente e mostra o que significa em linguagem simples.
Leia o resultado em linguagem acessível
O analisador traduz a expressão em uma descrição clara. Para 0 9 * * 1, você verá algo como "Às 09:00 de segunda-feira." A ferramenta também mostra os próximos horários de execução agendados para que você possa verificar se o agendamento faz o que você espera.
Ajuste e experimente
Modifique a expressão e observe a descrição ser atualizada em tempo real. Mude um número, troque um asterisco por um valor ou adicione um intervalo. Esse ciclo de feedback instantâneo é a maneira mais rápida de aprender a sintaxe cron e construir exatamente o agendamento que você precisa.
Bom saber Expressões cron normalmente têm cinco campos: minuto, hora, dia do mês, mês e dia da semana. Alguns sistemas adicionam um sexto campo para segundos, mas cinco campos é o padrão.
Entendendo os cinco campos
Uma expressão cron é composta por cinco campos separados por espaços:
┌───────────── minuto (0-59)
│ ┌───────────── hora (0-23)
│ │ ┌───────────── dia do mês (1-31)
│ │ │ ┌───────────── mês (1-12)
│ │ │ │ ┌───────────── dia da semana (0-7, onde 0 e 7 são domingo)
│ │ │ │ │
* * * * *
Um asterisco * significa "todos." Um número significa "exatamente neste valor." Essa é a base — todo o resto é construído a partir disso.
Padrões cron comuns
Aqui estão os padrões que você usará com mais frequência. Digite qualquer um deles no Analisador Cron para vê-los explicados e verificados:
| Expressão | Significado |
|---|---|
* * * * * |
A cada minuto |
0 * * * * |
A cada hora (no minuto 0) |
0 9 * * * |
Todo dia às 9:00 |
0 9 * * 1 |
Toda segunda-feira às 9:00 |
0 9 * * 1-5 |
Dias úteis às 9:00 |
0 0 1 * * |
Primeiro dia de cada mês à meia-noite |
0 */6 * * * |
A cada 6 horas |
30 8 * * 1,3,5 |
Segunda, quarta e sexta às 8:30 |
0 0 * * 0 |
Todo domingo à meia-noite |
*/15 * * * * |
A cada 15 minutos |
Dica A sintaxe de passo */n significa "a cada n intervalos." Então */15 no campo de minuto significa a cada 15 minutos (nos minutos 0, 15, 30 e 45 de cada hora). A sintaxe de intervalo 1-5 no campo de dia da semana significa de segunda a sexta.
Caracteres especiais explicados
| Caractere | Significado | Exemplo |
|---|---|---|
* |
Todo valor | * * * * * = a cada minuto |
, |
Múltiplos valores | 0 9,17 * * * = às 9h e às 17h |
- |
Intervalo de valores | 0 9 * * 1-5 = dias úteis |
/ |
Intervalo de passo | */10 * * * * = a cada 10 minutos |
Construindo suas próprias expressões
Para criar uma expressão cron do zero, pense no seu agendamento como respostas a cinco perguntas:
- Em qual minuto? (0-59, ou
*para todo minuto) - Em qual hora? (0-23, ou
*para toda hora) - Em qual dia do mês? (1-31, ou
*para todo dia) - Em qual mês? (1-12, ou
*para todo mês) - Em qual dia da semana? (0-7, ou
*para todo dia)
Por exemplo, "Toda terça e quinta às 14:30" se torna: minuto=30, hora=14, dia=, mês=, dia da semana=2,4, resultando em 30 14 * * 2,4.
Importante Cron usa formato de 24 horas. 9h da manhã é 9, mas 9h da noite é 21. Note também que os fusos horários dependem do servidor que executa o cron job, não do seu horário local. Sempre confirme qual fuso horário seu sistema utiliza.
Perguntas frequentes
O que acontece se eu definir tanto dia-do-mês quanto dia-da-semana? No cron padrão, o job é executado quando qualquer uma das condições é atendida (é um OU, não um E). Isso pega muitas pessoas desprevenidas. Se precisar de ambas as condições, use um script wrapper que verifique a data.
Posso agendar algo para rodar a cada 2 horas?
Sim. Use 0 */2 * * * que executa no minuto 0 de cada segunda hora.
Qual é a diferença entre cron de 5 campos e 6 campos? Alguns sistemas (como Spring, Quartz) adicionam um campo de segundos no início. O cron Unix padrão usa cinco campos. O Analisador Cron suporta ambos os formatos.
Próximos passos
Agora que você consegue ler e escrever expressões cron, experimente construir agendamentos para seus projetos. Se trabalha com outras ferramentas de desenvolvimento, confira nosso Testador de Regex para correspondência de padrões ou o Formatador JSON para trabalhar com arquivos de configuração.