$ toDouble（聚合）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 聚合管道运营商 > $ toDouble（聚合）

在本页面

定义
行为
例

定义¶

$toDouble¶

版本4.0中的新功能。

将值转换为双精度。如果该值不能转换为双精度数，则会$toDouble出错。如果该值为null或缺少，则$toDouble返回null。

$toDouble 具有以下语法：

复制

{
   $toDouble: <expression>
}

在$toDouble采取任何有效的表达。

的$toDouble是以下的简写 $convert表达：

复制

{ $convert: { input: <expression>, to: "double" } }

行为¶

下表列出了可以转换为双精度型的输入类型：

输入类型	行为
布尔型	返回`0`的 `false`。返回`1`的`true`。
双	没事返回双精度型。
小数	以双精度值返回十进制值。十进制值必须在两倍的最小值和最大值之内。您不能转换一个小于最小双精度值或大于最大双精度值的十进制值。
整数	以双精度值返回int值。
长	将long值作为双精度值返回。
串	以双精度值形式返回字符串的数值。字符串值必须是基的₁₀数字值（例如 `"-5.5"`，`"123456"`）和下降的最低和最高值用于双内。您不能转换非以₁₀为底的数字的字符串值（例如`"0x6400"`）或超出双精度的最小值和最大值的值。
日期	返回自与日期值对应的纪元以来的毫秒数。

下表列出了一些转换为双重示例的示例：

例	结果
`$toDouble: true`	1个
`$toDouble: false`	0
`$toDouble: 2.5`	2.5
`$toDouble: NumberInt(5)`	5
`$toDouble: NumberLong(10000)`	10000
`$toDouble: "-5.5"`	-5.5
`$toDouble: ISODate("2018-03-27T05:04:47.890Z")`	1522127087890

例子¶

weather使用以下文档创建一个集合：

复制

db.weather.insert( [
   { _id: 1, date: new Date("2018-06-01"), temp: "26.1C" },
   { _id: 2,  date: new Date("2018-06-02"), temp: "25.1C" },
   { _id: 3,  date: new Date("2018-06-03"), temp: "25.4C" },
] )

集合上的以下聚合操作将weather解析该temp值并将其转换为双精度型：

复制

// Define stage to add degrees field with converted value

tempConversionStage = {
   $addFields: {
      degrees: { $toDouble: { $substrBytes: [ "$temp", 0, 4 ] } }
   }
};


db.weather.aggregate( [
   tempConversionStage,
])

该操作返回以下文档：

复制

{ "_id" : 1, "date" : ISODate("2018-06-01T00:00:00Z"), "temp" : "26.1C", "degrees" : 26.1 }
{ "_id" : 2, "date" : ISODate("2018-06-02T00:00:00Z"), "temp" : "25.1C", "degrees" : 25.1 }
{ "_id" : 3, "date" : ISODate("2018-06-03T00:00:00Z"), "temp" : "25.4C", "degrees" : 25.4 }

注意

如果转换操作遇到错误，则聚合操作将停止并引发错误。要覆盖此行为，请 $convert改用。