Crie um agendamento com os controlos ou escreva uma expressão cron para a ver explicada em português claro.

Campos

Próximas execuções

O seu fuso horário

    Como funcionam as expressões cron

    Uma expressão cron descreve um agendamento recorrente em cinco campos separados por espaços. A cada minuto, o cron compara a hora atual com a expressão e executa a tarefa quando coincidem.

    Os cinco campos

    CampoValores permitidos
    Minuto0–59
    Hora0–23
    Dia do mês1–31
    Mês1–12 ou JAN–DEC
    Dia da semana0–7 ou SUN–SAT (0 e 7 significam ambos domingo)

    Caracteres especiais

    • * (qualquer valor): * * * * * é executado a cada minuto.
    • , (lista): 0 9,17 * * * é executado às 9:00 e às 17:00.
    • - (intervalo): 0 9 * * 1-5 é executado às 9:00 de segunda a sexta-feira.
    • / (passo): */15 * * * * é executado a cada 15 minutos. Um passo também funciona num intervalo: 0-30/10 significa os minutos 0, 10, 20 e 30.

    Dia do mês ou dia da semana?

    Quando ambos os campos de dia estão restringidos, a tarefa é executada nos dias que correspondem a qualquer um deles. 0 0 13 * 5 é executado no dia 13 de cada mês e em todas as sextas-feiras, não apenas na sexta-feira 13.

    Se um dos dois campos começar por *, como em */2, o dia tem de corresponder a ambos. O Cron Builder segue as mesmas regras do Vixie cron e do cronie, as implementações do cron usadas pela maioria das distribuições Linux.

    Exemplos comuns

    ExpressãoSignificado
    */5 * * * *A cada 5 minutos
    0 * * * *De hora a hora, à hora certa
    0 0 * * *Todos os dias à meia-noite
    0 9 * * 1-5Dias úteis às 9:00
    0 0 * * 0Todos os domingos à meia-noite
    0 0 1 * *No dia 1 de cada mês à meia-noite
    0 0 1 1 *Uma vez por ano, a 1 de janeiro à meia-noite

    Perguntas frequentes

    O que é uma expressão cron?

    Uma cadeia curta de cinco campos que define um agendamento recorrente. É usada pelo cron em Linux e macOS e por ferramentas como os CronJobs do Kubernetes, o GitHub Actions ou os agendamentos de pipelines do GitLab.

    Em que fuso horário são mostradas as próximas execuções?

    No fuso horário do seu navegador. O cron num servidor usa o fuso horário do servidor, muitas vezes UTC, por isso as horas reais podem ser diferentes.

    Porque é que */45 é executado às :00 e às :45 e não a cada 45 minutos?

    Um passo conta-se a partir do início do campo, não da execução anterior. No campo dos minutos, */45 significa os minutos 0 e 45, por isso os intervalos alternam entre 45 e 15 minutos. Para um intervalo regular, escolha um passo que divida 60 sem resto (como 5, 10, 15, 20 ou 30), ou 24 para as horas.

    Posso usar nomes em vez de números?

    Sim. As abreviaturas inglesas de três letras funcionam para os meses (JAN–DEC) e para os dias da semana (SUN–SAT). Não distinguem maiúsculas de minúsculas e também funcionam em listas e intervalos, por exemplo MON-FRI.

    O Cron Builder suporta segundos ou anos?

    Não, usa o formato padrão de cinco campos. Alguns agendadores, como o Quartz ou o Spring, acrescentam um campo para os segundos (e por vezes para o ano), por isso as suas expressões não funcionam aqui.

    E @daily, @reboot ou L?

    Atalhos como @hourly e @daily não são suportados. Use antes a expressão equivalente: @daily é 0 0 * * *. @reboot é executado no arranque do sistema e não tem equivalente baseado em horas. Também não são suportadas extensões como L, W, # e ?, usadas pelo Quartz e por alguns agendadores na nuvem.

    O Cron Builder é gratuito?

    Sim, é gratuito e não exige registo. Tudo funciona no seu navegador e as expressões que escreve não são enviadas para lado nenhum.