$toDecimal（转 Decimal128 高精度数值）
最后更新：2026-10-09
$toDecimal（转 Decimal128 高精度数值）
$toDecimal 把值转换为 Decimal128 高精度十进制数，用于金额等对精度敏感的计算，避免 double 的二进制浮点误差。支持数字、数字字符串和布尔值转换；null 返回 null。典型场景包括订单金额的累计与比较。与 double 混算时 MongoDB 会自动提升精度，但字符串转 decimal 失败会报错，可用 $convert onError 兜底。
| 分类 | 集合·条件·转换 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $toDecimal: <表达式> }⚙️ 参数
| 表达式 | 数字、数字字符串或布尔值。 |
|---|
返回值：Decimal128 值；输入为 null 时返回 null
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $toDecimal：把金额字符串转成高精度数值
db.orders.aggregate([
{ $project: {
amount: { $toDecimal: '$amountStr' }
} }
])运行结果：
{ '_id': 1, 'amount': { '$numberDecimal': '199.90' } }📌 注意事项
- 金额计算推荐 decimal，避免 double 精度误差
- 非法数字字符串（如 'abc'）会报错
- null 输入返回 null
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q为什么金额要用 decimal？
Adouble 有二进制浮点误差，0.1 累加会失真，Decimal128 精确。
Q能转哪些输入？
A数字、数字字符串、布尔（true 转 1）。
Q字符串 'abc' 会怎样？
A报错，需用 $convert onError 兜底。
