WebGroundwebground.app
Info e Guias · Referência Dev

Guia de Expressões Cron e Interpretador de Agendamentos

Entenda a sintaxe de agendamento do cron com exemplos comuns e cole qualquer expressão de cinco campos para validá-la e ver os horários das próximas execuções.

Verifique uma expressão cron

Cinco campos separados por espaços: minuto, hora, dia do mês, mês, dia da semana.

Expressão cron válida

Detalhamento campo a campo

  • Minuto

    Permitido: 0 a 59

    Valor
    */15
    Corresponde a
    • 0
    • 15
    • 30
    • 45
  • Hora

    Permitido: 0 a 23

    Valor
    9-17
    Corresponde a
    • 9 a 17
  • Dia do mês

    Permitido: 1 a 31

    Valor
    *
    Corresponde a
    Todos os dias do mês
  • Mês

    Permitido: 1 a 12

    Valor
    *
    Corresponde a
    Todos os meses
  • Dia da semana

    Permitido: 0 a 7

    Valor
    MON-FRI
    Corresponde a
    • segunda-feira a sexta-feira

Próximas execuções

Agendamentos comuns

  • * * * * *
    Quando é executado
    A cada minuto
    Atalho
  • */5 * * * *
    Quando é executado
    A cada 5 minutos
    Atalho
  • */30 * * * *
    Quando é executado
    A cada 30 minutos
    Atalho
  • 0 * * * *
    Quando é executado
    A cada hora, na hora cheia
    Atalho
    @hourly
  • 0 */6 * * *
    Quando é executado
    A cada 6 horas, a partir da meia-noite
    Atalho
  • 0 0 * * *
    Quando é executado
    Todos os dias à meia-noite
    Atalho
    @daily
  • 30 8 * * *
    Quando é executado
    Todos os dias às 8:30 da manhã
    Atalho
  • 0 9 * * 1-5
    Quando é executado
    De segunda a sexta às 9:00 da manhã
    Atalho
  • 0 0 * * 0
    Quando é executado
    Todo domingo à meia-noite
    Atalho
    @weekly
  • 0 0 1 * *
    Quando é executado
    À meia-noite do primeiro dia de cada mês
    Atalho
    @monthly
  • 0 0 1 */3 *
    Quando é executado
    À meia-noite do primeiro dia de janeiro, abril, julho e outubro
    Atalho
  • 0 0 1 1 *
    Quando é executado
    À meia-noite de 1º de janeiro, todos os anos
    Atalho
    @yearly

Caracteres especiais

  • *
    Significado
    Todos os valores do campo.
    Exemplo
    * * * * *
  • ,
    Significado
    Uma lista de valores separados.
    Exemplo
    0 9,18 * * *
  • -
    Significado
    Um intervalo de valores, incluindo os dois extremos.
    Exemplo
    0 9-17 * * *
  • /
    Significado
    Um passo: um valor a cada n, contado a partir do início do intervalo.
    Exemplo
    */10 * * * *

Como uma expressão cron é formada

Uma expressão cron tem cinco campos separados por espaços: minuto, hora, dia do mês, mês e dia da semana. Cada campo diz quando a tarefa pode ser executada, e ela roda em todo minuto em que os campos coincidem.

Um campo pode ser um único número, um asterisco para todos os valores, uma lista com vírgulas, um intervalo com hífen ou um passo com barra. Meses e dias da semana também podem ser escritos como nomes em inglês de três letras, como JAN ou MON.

O que costuma dar errado

Um agendamento que parece certo ainda pode rodar em horários inesperados.

  • O cron usa o fuso horário do servidor, que pode ser diferente do seu. Os horários de execução acima usam o fuso horário do seu dispositivo.
  • Quando o dia do mês e o dia da semana estão ambos definidos, a tarefa roda quando qualquer um dos dois coincide.
  • No campo de dia da semana, tanto 0 quanto 7 significam domingo.
  • Um passo como */7 recomeça a cada nova hora, dia ou mês, então os intervalos nem sempre são iguais.

Perguntas Frequentes

Por que minha expressão de seis campos é rejeitada?+

O cron padrão do Linux e do macOS usa cinco campos. Expressões com seis ou sete campos vêm do Quartz, do Spring e de agendadores semelhantes, que acrescentam um campo de segundos e às vezes um de ano, além de usar símbolos extras como ? e L.

O que significam atalhos como @daily?+

São nomes curtos para agendamentos comuns. @hourly, @daily, @weekly, @monthly e @yearly rodam no início de cada hora, dia, semana, mês ou ano. @reboot roda uma vez na inicialização, então não tem horários de execução para mostrar.

A expressão que eu digito é enviada para algum lugar?+

Não. A expressão é verificada e os horários de execução são calculados no seu navegador.

Explorar mais no WebGround

Ver tudo