$ln (聚合)

在本页

定义

行为
示例

定义

$ln

计算一个数字的自然对数 ln（即 log _e），并将结果作为双精度浮点数返回。

$ln 具有以下语法

{ $ln: <number> }

<number> 表达式可以是任何有效的表达式，只要解析结果为非负数即可。有关表达式的更多信息，请参阅表达式运算符。

$ln 等价于 $log: [ <number>, Math.E ] 表达式，其中 Math.E 是 Euler 数 e 的 JavaScript 表示。

行为

默认返回类型是 double。如果至少有一个操作数是 decimal，则返回类型为 decimal。

如果参数解析为 null 或引用的字段不存在，则 $ln 返回 null。如果参数解析为 NaN，则 $ln 返回 NaN。

示例	结果
`{ $ln: 1 }`	`0`
`{ $ln: Math.E }`，其中 `Math.E` 是 e 的 JavaScript 表示。	`1`
`{ $ln: 10 }`	`2.302585092994046`

示例

包含以下文档的集合 sales

{ _id: 1, year: "2000", sales: 8700000 }
{ _id: 2, year: "2005", sales: 5000000 }
{ _id: 3, year: "2010", sales: 6250000 }

以下示例转换 sales 数据

db.sales.aggregate( [ { $project: { x: "$year", y: { $ln: "$sales"  } } } ] )

操作返回以下结果

{ "_id" : 1, "x" : "2000", "y" : 15.978833583624812 }
{ "_id" : 2, "x" : "2005", "y" : 15.424948470398375 }
{ "_id" : 3, "x" : "2010", "y" : 15.648092021712584 }

提示

另请参阅

$log

$literal

$locf