$minute (Obter Minuto)

Última atualização: 2026-10-09

$minute (Obter Minuto)

$minute retorna a parte de minutos de uma data (0 a 59) — comum para estatísticas de tráfego com granularidade de minuto, métricas de monitoramento ou rótulos de janelas. Retorna um inteiro sem zero à esquerda. timezone pode mudar a qual minuto um timestamp pertence: fusos com offsets de minutos (ex.: UTC+5:45) produzem valores diferentes, então sempre defina-o explicitamente. Combine com $hour e $second para reconstruir horários completos.

📝 Sintaxe

{ $minute: { date: <expressão de data>, timezone: <fuso horário> } }

⚙️ Parâmetros

Retorno：O minuto (0-59); null se date for null.

▶ Exemplo

Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):

// $minute: volume de logs por hora-minuto (horário de Pequim)
db.logs.aggregate([
  { $group: {
      _id: { h: { $hour: { date: '$ts', timezone: 'Asia/Shanghai' } }, m: { $minute: { date: '$ts', timezone: 'Asia/Shanghai' } } },
      cnt: { $sum: 1 }
  } }
])

Saída：

{ "_id": { "h": 8, "m": 30 }, "cnt": 56 }
{ "_id": { "h": 8, "m": 31 }, "cnt": 48 }

📌 Notas

• Intervalo de 0 a 59, com retorno a 0 após 60
• Fusos com offsets de minutos (ex.: UTC+5:45) mudam o valor do minuto após a conversão
• Os resultados mudam entre fusos — unifique o fuso horário antes das estatísticas

🏷️ Tags Relacionados

💡 Casos Relacionados

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós