Ferramenta
Cria ou interpreta expressões Cron padrão de cinco campos. A expressão e as próximas execuções atualizam-se ao alterar os horários e os dias ou ao escrever uma expressão.
Formato: minuto hora dia-do-mês mês dia-da-semana. As próximas execuções usam o fuso horário Europe/Lisbon.
Escolha o horário e os dias na secção «Criar expressão»: a expressão e as próximas execuções atualizam-se automaticamente. Para consultar outro agendamento, escreva ou cole os cinco campos na secção «Interpretar expressão». A interpretação também é automática e usa o fuso horário indicado. Os botões permitem repetir o cálculo e identificar campos que precisem de correção.
É a forma compacta de dizer a um servidor quando deve executar uma tarefa. São cinco campos separados por espaços: minuto, hora, dia do mês, mês e dia da semana. A expressão 0 9 * * 1-5 significa às 9 da manhã, de segunda a sexta.
O * quer dizer «todos». A barra define intervalos: */15 no campo dos minutos é de quinze em quinze minutos. O hífen define uma gama, como 9-18. A vírgula lista valores soltos, como 1,15 no dia do mês. Combinando-os obtém-se quase tudo o que é preciso.
Quando os dois campos estão preenchidos ao mesmo tempo, o Cron executa a tarefa se qualquer um deles corresponder, e não os dois. A expressão 0 0 1 * 1 não quer dizer «no primeiro dia do mês, se for segunda-feira»: quer dizer «no primeiro dia do mês e também todas as segundas-feiras». É a confusão mais cara que se faz com Cron, e a razão pela qual convém confirmar as próximas execuções antes de pôr em produção.
No fuso do servidor, que muitas vezes é UTC e não a hora portuguesa. Uma tarefa marcada para as 9 da manhã pode correr às 10 no verão. Confirme o fuso do servidor antes de assumir que a hora é a sua, sobretudo em tarefas que enviam email a clientes.
Meia-noite em ponto é o horário mais congestionado que existe: metade das tarefas do mundo está marcada para 0 0 * * *. Se a tarefa não tem de correr a uma hora exata, escolher 0 3 ou um minuto qualquer que não seja zero distribui a carga e evita picos.
A ferramenta traduz a expressão para português e mostra as próximas execuções calculadas. Se a descrição não for a que tinha em mente, a expressão está errada — e é bastante mais barato descobri-lo aqui do que na segunda-feira de manhã.
Os cálculos são verificados por testes automáticos a cada alteração do site — como é feito e verificado. Se encontrar um erro, diga-nos e é corrigido.