Ir para o conteúdo

Interpretador e Gerador de Expressões Cron

Cole uma expressão cron para traduzir em português e ver as próximas execuções, ou monte uma nova no construtor visual — os dois lados ficam sempre sincronizados.

Fuso horário: esta ferramenta assume que a expressão cron executa em UTC (o padrão de servidores, containers e ambientes cloud). As próximas execuções abaixo são o mesmo instante calculado em UTC, exibido também já convertido para horário de Brasília (America/Sao_Paulo). Se a sua expressão cron rodar num servidor configurado para outro fuso, confira essa configuração antes de confiar no horário mostrado aqui.

Expressão cron

Presets
Exemplos comuns

Tradução

Às 03:00, de segunda a sexta-feira.

Expressão válida. Às 03:00, de segunda a sexta-feira.

Construtor visual

Minuto
Hora
Dia do mês

Qualquer valor válido para este campo (*).

Mês

Qualquer valor válido para este campo (*).

Dia da semana

Próximas execuções

America/Sao_PauloUTC
19/11/2026, 00:0019/11/2026, 03:00
20/11/2026, 00:0020/11/2026, 03:00
23/11/2026, 00:0023/11/2026, 03:00
24/11/2026, 00:0024/11/2026, 03:00
25/11/2026, 00:0025/11/2026, 03:00
26/11/2026, 00:0026/11/2026, 03:00
27/11/2026, 00:0027/11/2026, 03:00
30/11/2026, 00:0030/11/2026, 03:00

O que é uma expressão cron

Uma expressão cron é a sintaxe usada pelo agendador cron — padrão em sistemas Linux/Unix e adotado também por containers, pipelines de CI/CD (incluindo o schedule do GitHub Actions) e orquestradores — para definir quando uma tarefa automatizada deve rodar. Em vez de escrever "todo dia às 3 da manhã" em texto livre, a expressão cron usa 5 campos numéricos separados por espaço, cada um representando uma unidade de tempo diferente.

Os 5 campos da expressão cron

Da esquerda para a direita: minuto (0-59), hora (0-23), dia do mês (1-31), mês (1-12, ou nome de 3 letras como JAN) e dia da semana (0-7, onde tanto 0 quanto 7 significam domingo — ou nome de 3 letras como MON). Cada campo aceita um valor fixo (5), um curinga de qualquer valor (*), um intervalo (1-5), uma lista (1,3,5) ou um step (*/15, "a cada 15 unidades").

Em que fuso horário o crontab executa

Esta é a dúvida nº 1 de quem agenda uma tarefa com uma expressão cron: o crontab não sabe onde você mora — ele executa no fuso horário configurado no sistema operacional do servidor onde está rodando. A imensa maioria dos servidores cloud, containers Docker e runners de CI/CD usa UTC como padrão de fábrica, não o horário de Brasília — uma diferença de 3 horas (America/Sao_Paulo não observa horário de verão desde 2019, então o deslocamento é sempre fixo em 3 horas). É por isso que um job "agendado para as 9h" pode rodar às 6h da manhã (horário de Brasília) sem nenhum erro de sintaxe — a expressão cron fez exatamente o que foi pedida, só que no fuso errado para quem escreveu pensando em horário local. Esta ferramenta assume execução em UTC e mostra as próximas execuções já convertidas para America/Sao_Paulo ao lado, para eliminar essa conta de cabeça.

Diferença entre expressão cron e Quartz/Spring (6 campos)

O cron POSIX tradicional — o formato interpretado por esta ferramenta — usa 5 campos, sem precisão de segundos. Já o Quartz Scheduler, usado pelo Spring através da anotação @Scheduled(cron = "..."), usa 6 (às vezes 7) campos, com um campo extra de segundos logo no início da expressão. Uma expressão cron POSIX de 5 campos não é diretamente compatível com Quartz: é preciso adicionar o campo de segundos (geralmente 0) e, em alguns casos, ajustar a sintaxe de dia da semana. Por exemplo, "todo dia às 3h" é 0 3 * * * em cron POSIX, mas 0 0 3 * * ? em Quartz.

Por que minha expressão cron não executou

Os motivos mais comuns, em ordem de frequência: fuso horário divergente do esperado (ver seção acima); a combinação de dia do mês e mês nunca ocorre no calendário (ex.: dia 30 de fevereiro, que não existe — esta ferramenta detecta e avisa esse caso automaticamente); dia do mês e dia da semana restritos ao mesmo tempo, que no crontab funcionam como "OU" e não como "E" — um detalhe que surpreende até quem já usa expressão cron há anos, e que também é sinalizado como aviso aqui; e, por fim, erro de sintaxe que alguns agendadores ignoram silenciosamente em vez de reportar. Cole sua expressão no campo desta página para descartar cada uma dessas causas em segundos.

Assim como os claims exp/iat/nbf de um JWT são timestamps que também dependem de fuso horário para fazer sentido, a expressão cron do servidor opera sobre a mesma lógica de "instante em UTC, interpretado de acordo com o fuso de quem lê". Se você já usou o Decodificador de JWT para conferir a validade de um token, é o mesmo raciocínio de conversão de fuso aplicado aqui a um agendamento em vez de um token.

Perguntas frequentes