MongoDB聚合运算符：$toDecimal

$toDecimal聚合运算符将指定的值转换为Decimal类型。如果指定的值为空或缺失，则返回null；如果值无法被转换为Decimal，则报错。

语法

{$toDecimal: <expression>
}

$toDecimal接受任何有效的表达式。

$toDecimal是$convert表达式的简写形式：

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

使用

下表列出了可转换为布尔值的类型：

输入类型	规则
Boolean	对于True，返回Decimal128("1")，对于False返回Decimal128("0")
Double	以Decimal返回Double的值
Decimal	原样返回
Integer	以Decimal返回整数值
Long	以Decimal返回Long值
String	将字符串转换为Decimal返回，但字符串表示的必须是10进制的比如"-5.5"、“1233”，非10进制的会报错，如：“0x3343”
Date	返回自与日期值对应的纪元以来的毫秒数

下表列出了一些转换为布尔值的示例：

示例	结果
{$toDecimal: true}	Decimal128("1")
{$toDecimal: false}	Decimal128("0")
{$toDecimal: 2.5}	Decimal128("2.50000000000000")
{$toDecimal: NumberInt(5)}	Decimal128("5")
{$toDecimal: NumberLong(10000)}	Decimal128("10000")
{$toDecimal: "-5.5"}	Decimal128("-5.5")
{$toDecimal: ISODate("2018-03-27T05:04:47.890Z")}	Decimal128("1522127087890")

举例

使用下面的脚本创建orders集合：

db.orders.insertMany( [{ _id: 1, item: "apple", qty: 5, price: 10 },{ _id: 2, item: "pie", qty: 10, price: NumberDecimal("20.0") },{ _id: 3, item: "ice cream", qty: 2, price: "4.99" },{ _id: 4, item: "almonds",  qty: 5, price: 5 }
] )

下面的聚合操先orders集合的price转换为decimal，qty转换为整数，然后计算总费用：

// 定义转换阶段，转换后的price和qyt字段convertedPrice和convertedQty添加到文档priceQtyConversionStage = {$addFields: {convertedPrice: { $toDecimal: "$price" },convertedQty: { $toInt: "$qty" },}
};//定义计算合计阶段，将convertedPrice和convertedQty相乘得到总计totalPriceCalculationStage = {$project: { item: 1, totalPrice: { $multiply: [ "$convertedPrice", "$convertedQty" ] } }
};db.orders.aggregate( [priceQtyConversionStage,totalPriceCalculationStage
] )

执行的结果为：

{ _id: 1, item: 'apple', totalPrice: Decimal128("50") },
{ _id: 2, item: 'pie', totalPrice: Decimal128("200.0") },
{ _id: 3, item: 'ice cream', totalPrice: Decimal128("9.98") },
{ _id: 4, item: 'almonds', totalPrice: Decimal128("25") }