MongoDB聚合运算符：$toInt

MongoDB聚合运算符：$toInt

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

语法

{
   $toInt: <expression>
}

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

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

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

使用

下表列出了可转换为整数的类型：

输入类型	规则
Boolean	对于True，返回1，对于False返回0
Decimal	返回截断值。截断的小数值必须在整数的最小值和最大值范围内。如果截断值小于最小整数值或大于最大整数值，则无法转换
Double	返回截断值。截断的双数值必须在整数的最小值和最大值范围内。如果截断值小于最小整数值或大于最大整数值，则无法转换
Integer	直接返回
Long	以整数返回Long值，Long值必须在整数的最小值和最大值范围内。如果截断值小于最小整数值或大于最大整数值，则无法转换
String	将字符串转换为整数返回，但字符串表示的必须是10进制的整数比如"-5"、“1233”，非10进制的会报错，如：“0x3343”

下表列出了一些转换为整数的示例：

示例	结果
$toInt: true	1
$toInt: false	0
$toInt: 1.99999	1
$toInt: NumberDecimal("5.5000")	5
$toInt: NumberDecimal("9223372036000.000")	Error
$toInt: NumberLong("5000")	5000
$toInt: NumberLong("922337203600")	Error
$toInt: "-2"	-2
$toInt: "2.5"	Error
$toInt: null	null

举例

使用下面的脚本创建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 }
] )

下面的聚合操将qty集转换为整数，将Price转换为小数，并计算总价格：

// 定义阶段，转换price为小数，转换qty为整数

priceQtyConversionStage = {
   $addFields: {
      convertedPrice: { $toDecimal: "$price" },
      convertedQty: { $toInt: "$qty" },
   }
};

// 定义阶段，计算总价


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") }