Formato do cron job e fuso horário

Os cron jobs são programados em intervalos recorrentes e especificados usando um formato baseado em ativado unix-cron. É possível definir uma programação para que o job seja executado diversas vezes por dia ou em dias e meses determinados. (Embora não recomendemos mais seu uso, a versão A sintaxe do cron do App Engine é ainda é compatível com jobs atuais).

Formato do cron job

É possível usar o console do Google Cloud, Google Cloud CLI ou a API REST do Cloud Scheduler para definir seu cronograma.

Uma programação é definida usando o formato de string unix-cron (* * * * *), que é um conjunto de cinco campos em uma linha, indicando quando o job deve ser executado.

Os campos de hora têm o formato e os valores possíveis a seguir e precisam seguir esta ordem:

|------------------------------- Minute (0-59)
|     |------------------------- Hour (0-23)
|     |     |------------------- Day of the month (1-31)
|     |     |     |------------- Month (1-12; or JAN to DEC)
|     |     |     |     |------- Day of the week (0-6; or SUN to SAT; or 7 for Sunday)
|     |     |     |     |
|     |     |     |     |
*     *     *     *     *
Campo Valores válidos
Minuto 0-59
Hora 0-23
dia do mês 1-31
Mês 1 a 12 (ou JAN a DEC)
Dia da semana 0-6 (ou DOM a SÁB; ou 7 para domingo)
  • Minuto: indica quanto tempo além do topo da hora seu job é executado, em minutos. Por exemplo, se o minuto for definido como 0, o job será executado no início da hora (porque é 0 minuto após a hora). Então, se a hora são 8h, o job é executado às 8h.

  • Hora: indica quanto tempo passa da meia-noite em que o job é executado. (arredondado para a hora mais próxima, porque os minutos restantes são indicados no campo minute). A meia-noite é 0 e o meio-dia é 12. Por exemplo, se a hora for definida como 0, o job será executado à meia-noite (porque é 0 horas após a meia-noite).

  • Dia do mês:indica a data do mês. Por exemplo, 1 para o primeiro dia do mês. O Cloud Scheduler não aceita L para indicar o último dia do mês.

  • Mês: indica o mês. Especifique o número do mês ou os três primeiros letras maiúsculas do nome do mês. Por exemplo, 1 para janeiro ou equivalente, JAN.

  • Dia da semana:indica o dia da semana. A segunda-feira é 1 e terça-feira é 2 e assim por diante. 0ou 7 podem indicar domingo. Especifique o dia a semana, seja por número ou pelas três primeiras letras do nome do dia da semana em letras maiúsculas (por exemplo, SUN para domingo).

    • Este campo é avaliado como um OR inclusivo com o day of the month campo, a menos que um desses campos seja marcado como irrestrito pelo asterisco (*). Por exemplo, se o dia do mês for definido como 1 e o dia da semana estiver definido como SAT, o job será executado no primeiro dia do e em todos os sábados do mês, mesmo se o primeiro dia do o mês não é um sábado. Se o dia da semana não tiver restrição (definido como *), o job será executado apenas no primeiro dia do mês.

Corresponder a todos os valores

Para corresponder a todos os valores de um campo, use o asterisco: *. Quando um campo é definido como o asterisco, o campo corresponde a todos os valores válidos para esse campo sempre que a outras condições de campo sejam atendidas. A definição de um campo como asterisco às vezes é chamada de deixar o campo irrestrito, porque ele não é restringido a um valor específico.

Veja dois exemplos em que o campo de minuto fica irrestrito:

  • * 0 1 1 1: o job é executado a cada minuto da meia-noite em 1º de janeiro e às segundas-feiras.
  • * * * * *: o job é executado a cada minuto (de cada hora, de cada dia do mês, de cada mês, de cada dia da semana, porque cada um desses campos também não tem restrições).

O asterisco é equivalente a um caso especial de um intervalo, em que o intervalo começa no primeiro valor válido do campo e termina no último valor válido do campo (por exemplo, 0-59 para o campo de minutos).

Corresponder a um intervalo

Para corresponder a um intervalo de valores, especifique os valores inicial e final, separados por um hífen (-). Não inclua espaços no intervalo. Os intervalos são inclusivos. O primeiro número precisa ser menor que o segundo. Se você estiver usando nomes abreviados para o mês ou o dia da semana (por exemplo, JAN em vez de 1 para o primeiro mês do ano), o primeiro valor precisa ser anterior ao segundo no mês ou na semana.

Os exemplos equivalentes a seguir são executados à meia-noite nas segundas, terças, quartas, quintas e sextas-feiras (em todos os meses):

  • 0 0 * * 1-5
  • 0 0 * * MON-FRI

Como fazer a correspondência com uma lista

As listas podem conter qualquer valor válido para o campo, incluindo intervalos. Especifique os valores separados por vírgula (,). Não inclua espaços no lista.

Exemplos:

  • 0 0,12 * * *: o job é executado à meia-noite e ao meio-dia.
  • 0-5,30-35 * * * *: o job é executado nos primeiros cinco minutos de cada meia hora (no início e no meio da hora).

Ignorar valores em um intervalo

É possível pular valores em um intervalo especificando uma taxa de progressão pelo intervalo. Às vezes, isso é chamado de uso de uma função de etapa (ou valor de etapa ou expressão de taxa). Para fazer isso, especifique o intervalo, seguido pelo traço (/) e a taxa de omissão.

É possível usar o asterisco (*) para indicar o intervalo de todos os valores do . Quando você usa o asterisco, o primeiro valor do intervalo é: 0 para o minuto, hora e dia da semana (domingo) e 1 para o dia do mês e os campos de mês.

O valor da etapa não pode ser maior que o maior valor possível para o campo. A etapa padrão é 1. Portanto, a função de etapa /1 é a mesma que não usar uma função de etapa.

Exemplos de intervalos que usam funções de etapa:

  • */2: é uma função de etapa válida para qualquer campo. Para o campo de minuto, corresponde a 0, 2, 4, ... , 58. Para a hora, ela corresponde a 0, 2, 4, ... , 22. Para o dia do mês, ele corresponde a 1, 3, 5, ... , 31 (para um mês com 31 dias). Para o mês, corresponde a 1, 3, 5, ... , 11. Para o dia da semana, e corresponde a 0, 2, 4, 6.

  • 0-12/2: é uma função de etapa válida para os campos de minuto e hora. Ele corresponde a 0, 2, 4, ... , 12.

Exemplos de programação usando funções degrau:

  • */2 * * * *: o job é executado a cada dois minutos.

  • 0 0-12/2 * * *: o job é executado a cada duas horas, a cada hora. A primeira execução é à meia-noite. A última corrida é ao meio-dia.

Exemplos de programação

A tabela a seguir mostra alguns exemplos de programações cron job e suas descrições:

Programar Formato do cron job Explicação
A cada minuto * * * * * É executada no minuto. Por exemplo, 9:00 AM, 9:01 AM, :02 AM e assim por diante.
A cada hora 0 * * * * É executada por hora. Por exemplo, 9h, 10h, 11h etc.
Todos os dias 0 0 * * * É executada às 12h (00:00 no formato de 24 horas) todos os dias.
Todos os dias úteis
(seg-sex)
Os seguintes são equivalentes:
  • 0 0 * * 1-5
  • 0 0 * * MON-FRI
É executado às 12h (00:00 no formato de 24 horas) às segundas, terças, quartas, quintas e sextas-feiras.
Toda semana Os seguintes são equivalentes:
  • 0 0 * * 0
  • 0 0 * * 7
  • 0 0 * * SUN
É executado aos domingos às 12h (00:00 no formato de 24 horas).
Todo mês 0 0 1 * * É executado à meia-noite (00:00 no formato de 24 horas) no primeiro dia do mês.
Todo trimestre Os seguintes são equivalentes:
  • 0 0 1 1,4,7,10 *
  • 0 0 1 JAN,APR,JUL,OCT *
É executado à meia-noite (00:00 no formato de 24 horas) no primeiro dia do trimestre, para a programação trimestral padrão: 1o de janeiro, 1o de abril, 1o de julho 1o e 1o de outubro.
Todo ano Os seguintes são equivalentes:
  • 0 0 1 1 *
  • 0 0 1 JAN *
É executado às 12h (00:00 no formato de 24 horas) no primeiro dia do primeiro mês do ano (1º de janeiro).

Fuso horário

Você pode selecionar o fuso horário para avaliar a programação no Console do Google Cloud (na página Criar um job, selecione um Fuso horário da lista) ou usando a flag gcloud --time-zone ao criar o job.

O valor desse campo precisa ser a abreviação do fuso horário usado no banco de dados tz. O fuso horário padrão é UTC.

Em alguns fusos horários, o horário de verão pode fazer com que os jobs sejam executados ou não. de maneira inesperada. Isso ocorre porque o Cloud Scheduler é executado no horário normal. Nos casos em que um horário pode ocorrer duas vezes (como quando os relógios para trás) e seu job estiver agendado para este horário, ele poderá e observar anomalias na execução.

Se o seu trabalho exige uma cadência muito específica, considere escolher um fuso horário que não observe o horário de verão. Especificamente: O UTC é recomendado para que o Cloud Scheduler evite o problema completamente.