$pow (Potência)

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

$pow (Potência)

$pow eleva um número a uma potência. Ele recebe dois argumentos — a base e o expoente — retornando base elevada ao expoente. É usado em cálculos de área e volume, juros compostos e escalas, como elevar um raio ao quadrado para a área do círculo ou deslocar valores por potências de dez. Um expoente de 0 resulta em 1, e zero elevado a zero retorna 1 no MongoDB. Observe que uma base negativa com expoente não inteiro retorna null, pois o resultado não é um número real. Qualquer argumento null ou ausente resulta em null.

📝 Sintaxe

{ $pow: [ <base>, <expoente> ] }

⚙️ Parâmetros

Retorno：A base elevada ao expoente; null para base negativa com expoente não inteiro, ou argumentos null e ausentes

▶ Exemplo

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

// $pow: área do círculo a partir do raio ao quadrado (pi como 3.14)
db.shapes.aggregate([
  { $project: {
      area: { $multiply: [3.14, { $pow: ['$radius', 2] }] }
  } }
])

Saída：

{ '_id': 1, 'area': 28.26 }
{ '_id': 2, 'area': 12.56 }

📌 Notas

• Zero elevado a zero retorna 1
• Uma base negativa com expoente não inteiro (como -8 elevado a 1/3) retorna null
• Você pode calcular a raiz quadrada com expoente 0.5, mas $sqrt fica mais legível

🏷️ 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