Skip to content
ENPT

Agendamento cron

Cron a cada 15 minutos

A expressão cron para rodar a cada 15 minutos é */15 * * * *. Ela dispara nos quartos de hora, nos minutos 0, 15, 30 e 45, o que dá 96 vezes por dia.

A cada 15 minutos
Expressão*/15 * * * *
Execuções96 vezes por dia
OnCalendar do systemd*:0/15

Como funciona

O */15 pega de quinze em quinze minutos a partir do 0, então a tarefa fica alinhada com os quartos de hora. A lista explícita 0,15,30,45 * * * * é o mesmo agendamento, e tem gente que acha mais fácil de ler.

Alinhar com o quarto de hora ajuda em tudo que as pessoas conferem no relógio: relatórios de uso, aquecimento de cache antes de reuniões, painéis que devem atualizar em horários previsíveis. O agendamento fica mais útil quando você limita as horas, por exemplo */15 8-18 * * 1-5 na semana de trabalho.

Cuidado com os agendadores de seis campos. No node-cron e no Spring o primeiro campo são os segundos, então a mesma string com um campo a mais significa outra coisa; veja as armadilhas.

Explicação campo a campo
CampoValorSignificado
Minuto*/15a cada 15 minutos: 0, 15, 30, 45
Hora*toda hora
Dia do mês*todo dia do mês
Mês*todo mês
Dia da semana*todo dia da semana

Próximas execuções

Relógio do agendador

Como no GitHub Actions sem timezone, na Vercel, na Cloudflare e no Kubernetes com timeZone "Etc/UTC".

Próximas execuções, calculadas no seu navegador a partir de agora
ExecuçãoSeu horárioUTC
1Calculando… 
2  
3  
4  
5  

Versões prontas para colar

O mesmo agendamento em cada agendador, com o que muda em cada um.

crontab (Linux, macOS, BSD)

crontab -e
# m h dom mon dow  command
*/15 * * * * /usr/local/bin/job.sh >> /var/log/job.log 2>&1

# Same, but skip a run while the previous one is still going:
*/15 * * * * flock -n /tmp/job.lock /usr/local/bin/job.sh
  • O cron usa o fuso horário do servidor. No cronie (Fedora, RHEL), CRON_TZ=America/Sao_Paulo numa linha acima muda o fuso das linhas seguintes.

GitHub Actions

.github/workflows/scheduled.yml
on:
  schedule:
    - cron: '*/15 * * * *'
  workflow_dispatch: {}
  • Roda em UTC, a menos que você defina timezone, e só no branch padrão. A documentação do GitHub avisa que execuções agendadas podem atrasar em horários de pico e que, em repositórios públicos, o agendamento é desativado após 60 dias sem atividade.

CronJob do Kubernetes

cronjob.yaml
apiVersion: batch/v1
kind: CronJob
metadata:
  name: scheduled-job
spec:
  schedule: "*/15 * * * *"
  timeZone: "Etc/UTC"
  concurrencyPolicy: Forbid
  jobTemplate:
    spec:
      template:
        spec:
          restartPolicy: OnFailure
          containers:
            - name: job
              image: busybox:1.36
              command: ["/bin/sh", "-c", "date; echo running"]
  • spec.timeZone é estável desde o Kubernetes 1.27; sem ele, vale o fuso do kube-controller-manager. concurrencyPolicy: Forbid pula uma execução se a anterior ainda estiver rodando.

Cron Jobs da Vercel

vercel.json
{
  "crons": [
    { "path": "/api/cron", "schedule": "*/15 * * * *" }
  ]
}
  • A Vercel sempre usa UTC, não aceita nomes como MON ou JAN e não deixa definir dia do mês e dia da semana ao mesmo tempo.
  • Roda mais de uma vez por dia, então precisa do plano Pro ou Enterprise. No Hobby, a documentação diz que o deploy falha com expressões que rodam mais de uma vez por dia.

Cloudflare Workers

wrangler.toml
[triggers]
crons = ["*/15 * * * *"]
  • Cron Triggers rodam em UTC. Mudanças podem levar até 15 minutos para se propagar pela rede da Cloudflare.

node-cron (Node.js)

scheduler.js
import cron from 'node-cron';

// 6 campos: o primeiro (segundos) é opcional
cron.schedule('0 */15 * * * *', async () => {
  await runJob();
}, { timezone: 'UTC', noOverlap: true });
  • O agendamento vive dentro do processo Node: se ele cair, nada roda; se houver três réplicas, a tarefa roda três vezes. noOverlap pula um disparo enquanto o anterior não terminou.

Timer do systemd

job.timer + job.service
# /etc/systemd/system/job.timer
[Unit]
Description=Run job.service every 15 minutes

[Timer]
OnCalendar=*:0/15

[Install]
WantedBy=timers.target

# /etc/systemd/system/job.service
[Service]
Type=oneshot
ExecStart=/usr/local/bin/job.sh

# systemctl daemon-reload && systemctl enable --now job.timer
  • Confira com systemd-analyze calendar '*:0/15', que mostra a forma normalizada e a próxima execução. AccuracySec padrão é 1min, então o disparo pode variar até um minuto.

Spring @Scheduled e Quartz

Java
@Scheduled(cron = "0 */15 * * * *", zone = "UTC")
public void runJob() {
    // ...
}

// Quartz CronTrigger:
CronScheduleBuilder.cronSchedule("0 0/15 * * * ?")
  • No Spring, o primeiro dos 6 campos são os segundos; o resto segue o cron comum (0 ou 7 = domingo).
  • No Quartz, um dos campos de dia precisa ser ?, por isso o dia da semana leva ?.

Armadilhas

15 * * * * é uma vez por hora

Um 15 solto no campo de minuto é um valor único: minuto 15 de toda hora, 24 execuções por dia. O passo precisa da barra: */15.

No node-cron e no Spring, */15 * * * * * é a cada 15 segundos

Com seis campos, o primeiro são os segundos. */15 * * * * * dispara quatro vezes por minuto. Para a cada 15 minutos num agendador de 6 campos, escreva 0 */15 * * * *.

A última execução de uma janela restrita

*/15 9-17 * * * inclui 17:00, 17:15, 17:30 e 17:45, porque a hora 17 está na faixa. Se a janela deve terminar às 17:00, use */15 9-16 * * * e uma linha separada 0 17 * * *.

Perguntas frequentes

Qual é a expressão cron para a cada 15 minutos?
*/15 * * * *. Ela roda nos minutos 0, 15, 30 e 45 de toda hora. 0,15,30,45 * * * * é a mesma coisa.
Como rodar a cada 15 minutos em dias úteis, no horário comercial?
*/15 9-17 * * 1-5 roda a cada quarto de hora das 09:00 às 17:45, de segunda a sexta.
Como deslocar uma tarefa de 15 minutos para fugir do quarto de hora?
Use faixa com passo: 5-59/15 * * * * roda nos minutos 5, 20, 35 e 50.
Como fica a cada 15 minutos no Quartz?
0 0/15 * * * ? no Quartz: segundos primeiro, depois minutos 0/15, e ? no campo de dia da semana.

Revisado em por Arielton Oberek.