MongoDB聚合运算符：$toObjectId

$toObjectId聚合运算符将指定的值转换为ObjectId。如果值无法被转换为ObjectId，则报错。

语法

{$toObjectId: <expression>
}

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

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

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

使用

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

输入类型	规则
String	返回长度为 24 的十六进制字符串的 ObjectId。如果字符串值不是长度为 24 的十六进制字符串，则无法转换。

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

示例	结果
{$toObjectId: "5ab9cbfa31c2ab715d42129e"}	ObjectId("5ab9cbfa31c2ab715d42129e")
{$toObjectId: "5ab9cbfa31c2ab715d42129"}	Error

举例

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

db.orders.insertMany( [{ _id: "5ab9cbe531c2ab715d42129a", item: "apple", qty: 10 },{ _id: ObjectId("5ab9d0b831c2ab715d4212a8"), item: "pie", qty: 5 },{ _id: ObjectId("5ab9d2d331c2ab715d4212b3"), item: "ice cream", qty: 20 },{ _id: "5ab9e16431c2ab715d4212b4", item: "almonds", qty: 50 },
] )

下面的聚合操将_id转换为ObjectId，并进行排序：

// 定义转换阶段，将_id值转换为ObjectId并添加到文档idConversionStage = {$addFields: {convertedId: { $toObjectId: "$_id" }}
};// 定义排序阶段，根据convertedId进行排序sortStage = {$sort: { "convertedId": -1 }
};db.orders.aggregate( [idConversionStage,sortStage
] )

执行的结果为：

{_id: '5ab9e16431c2ab715d4212b4',item: 'almonds',qty: 50,convertedId: ObjectId("5ab9e16431c2ab715d4212b4")
},
{_id: ObjectId("5ab9d2d331c2ab715d4212b3"),item: 'ice cream',qty: 20,convertedId: ObjectId("5ab9d2d331c2ab715d4212b3")
},
{_id: ObjectId("5ab9d0b831c2ab715d4212a8"),item: 'pie',qty: 5,convertedId: ObjectId("5ab9d0b831c2ab715d4212a8")
},
{_id: '5ab9cbe531c2ab715d42129a',item: 'apple',qty: 10,convertedId: ObjectId("5ab9cbe531c2ab715d42129a")
}