Expressão cron: no último dia do mês

0 0 28-31 * * roda no último dia do mês. Veja o que significa cada campo, quando ele roda na próxima vez e como usar no crontab, GitHub Actions, Kubernetes e Node.js.

Atualizado em

0 0 28-31 * *
Expressão cron
No último dia do mês
Agendamento

Abrir no Gerador de Expressão Cron →

O que 0 0 28-31 * * significa

O cron lê cinco campos da esquerda para a direita: minuto, hora, dia do mês, mês e dia da semana. Para no último dia do mês, os campos são:

CampoValorSignificadoPermitido
Minuto000–59
Hora000:000–23
Dia do mês28-31do dia 28 ao 311–31
Mês*todo mês1–12
Dia da semana*todo dia da semana0–6 (dom–sáb)

Próximas execuções

Calculado no seu navegador para seu fuso horário. Em um servidor, o cron usa o fuso horário do servidor (geralmente UTC).

  1. Ative o JavaScript para ver os horários das próximas execuções.

Usos comuns

  • Fechamento do mês
  • Relatórios mensais finais

Bom saber

O cron padrão não tem um valor de “último dia”. Execute nos dias 28 a 31 e deixe o comando sair sem fazer nada, a menos que amanhã seja dia 1: [ "$(date -d tomorrow +\%d)" = 01 ] && /job.sh. O Quartz e alguns agendadores aceitam L diretamente.

Use no crontab, GitHub Actions, Kubernetes e Node.js

crontab (crontab -e):

0 0 28-31 * * /usr/local/bin/my-job.sh >> /var/log/my-job.log 2>&1

GitHub Actions (os horários são em UTC):

on:
  schedule:
    - cron: '0 0 28-31 * *'

Kubernetes CronJob:

apiVersion: batch/v1
kind: CronJob
metadata:
  name: my-job
spec:
  schedule: "0 0 28-31 * *"
  concurrencyPolicy: Forbid
  jobTemplate:
    spec:
      template:
        spec:
          restartPolicy: OnFailure
          containers:
            - name: my-job
              image: alpine:3
              command: ["sh", "-c", "echo running"]

Node.js (node-cron):

import cron from 'node-cron';
cron.schedule('0 0 28-31 * *', () => {
  // your job
});

Agendamentos relacionados

Perguntas frequentes

Qual é a expressão cron para no último dia do mês?
0 0 28-31 * *. Ela roda no minuto 0; às 00:00; do dia 28 ao 31.
Qual fuso horário o cron usa?
O cron clássico usa o fuso horário local do servidor, e muitos servidores rodam em UTC. O GitHub Actions sempre usa UTC. Os CronJobs do Kubernetes usam o fuso horário do controlador, a menos que você defina spec.timeZone (por exemplo, Europe/Berlin).
Como testar uma expressão cron?
Cole a expressão no Gerador de Expressão Cron para vê-la em linguagem simples, com os horários das próximas execuções. Depois, confira o log do seu job após a primeira execução agendada.