$toLong（转 64 位整数）
最后更新：2026-10-09
$toLong（转 64 位整数）
$toLong 把值转换为 64 位有符号整数（BSON long），范围远超 int，适合时间戳、ID 等大整数。支持数字、数字字符串和布尔值；null 返回 null。典型场景包括把高精度 ID 字符串转成数值、处理秒级或毫秒级时间戳。字符串必须是整数形式。它是 $convert 的 to: long 快捷写法。注意聚合里 int 与 long 混算会自动提升为 long。
| 分类 | 集合·条件·转换 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $toLong: <表达式> }⚙️ 参数
| 表达式 | 数字、数字字符串或布尔值。 |
|---|
返回值：long 类型；输入为 null 时返回 null
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $toLong：把时间戳字符串转成数值
db.events.aggregate([
{ $project: {
ts: { $toLong: '$tsStr' }
} }
])运行结果：
{ '_id': 1, 'ts': 1780000000000 }📌 注意事项
- 64 位范围足够存毫秒级时间戳
- 字符串必须是整数形式，非法值报错
- int 与 long 混算自动提升为 long
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q什么时候用 $toLong？
A值可能超过正负 21 亿时，如时间戳和大 ID。
Q与 $toInt 混算会怎样？
A自动提升为 long，结果类型为 long。
Qnull 返回什么？
A返回 null。
