$convert（类型转换）

最后更新：2026-10-09

$convert（类型转换）

$convert 把值转换为指定 BSON 类型，是类型转换操作符的总入口。to 参数支持 double、string、objectId、bool、date、int、long、decimal。转换失败时默认报错，可用 onError 提供兜底值；输入为 null 时默认返回 null，可用 onNull 覆盖。典型场景包括把字符串数字转成数值参与计算、把时间字符串转成日期。与 $toInt 等快捷操作符相比，$convert 多了错误兜底能力。

📝 语法

{ $convert: { input: <表达式>, to: <类型>, onError: <兜底值>, onNull: <空值结果> } }

⚙️ 参数

返回值：转换后的目标类型值；失败或 null 时按 onError/onNull 返回

▶ 示例

请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：

// $convert：把字符串价格转成数值，失败记 0
db.products.aggregate([
  { $project: {
      priceNum: { $convert: { input: '$priceStr', to: 'double', onError: 0 } }
  } }
])

运行结果：

{ '_id': 1, 'priceNum': 19.9 }
{ '_id': 2, 'priceNum': 0 }

📌 注意事项

• 转换失败默认报错，生产环境建议总是提供 onError
• null 输入返回 null，可用 onNull 换成默认值
• $toInt/$toDouble 等是 $convert 的快捷写法，但没有 onError

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们