$ln (Logaritmo Natural)

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

$ln (Logaritmo Natural)

$ln retorna o logaritmo natural (base e) de um número. É usado em cálculos de taxa de crescimento, suavização de dados e transformações de escala logarítmica, como aplicar o logaritmo natural em preços antes de uma análise de regressão. Um argumento null ou ausente resulta em null; a entrada deve ser positiva — valores zero ou negativos retornam null. e vale aproximadamente 2.71828. Para outras bases, use $log com uma base explícita, ou os dedicados $log10 e $log2. $ln é o inverso de $exp.

📝 Sintaxe

{ $ln: <expressão numérica> }

⚙️ Parâmetros

Retorno：O logaritmo natural da entrada; null para entrada não positiva, null ou ausente

▶ Exemplo

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

// $ln: aplicar o logaritmo natural nos valores
db.sales.aggregate([
  { $project: {
      logAmount: { $ln: '$amount' }
  } }
])

Saída：

{ '_id': 1, 'logAmount': 4.605170185988092 }
{ '_id': 2, 'logAmount': 2.995732273553991 }

📌 Notas

• A entrada deve ser maior que 0; valores zero ou negativos retornam null
• A base é fixa em e; use $log para outras bases
• Inverso de $exp: $exp($ln(x)) é igual a x

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