$millisecond（获取毫秒）

最后更新：2026-10-09

$millisecond（获取毫秒）

$millisecond 返回日期中的毫秒部分（0 到 999），是细粒度时间提取表达式。单独使用场景较少，多用于精确排序、去重或还原毫秒级时间戳。返回整数，不补零。timezone 对毫秒值没有影响（毫秒与时区无关），但语法上仍可传入。常与 $second 组合构造毫秒级时间标签。需要补零输出时可借助 $dateToString 的占位符或 $concat 手工拼接。

📝 语法

{ $millisecond: { date: <日期表达式>, timezone: <时区> } }

⚙️ 参数

返回值：毫秒值（0-999）整数；date 为 null 时返回 null。

▶ 示例

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

// $millisecond：取传感器时间戳的毫秒
 db.sensors.aggregate([
  { $project: { ms: { $millisecond: '$ts' } } }
])

运行结果：

{ "_id": 1, "ms": 320 }
{ "_id": 2, "ms": 0 }

📌 注意事项

• 范围 0 到 999，不补零
• 毫秒与时区无关，传不传 timezone 结果一样
• 与 $second 组合可还原毫秒级时间标签

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

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

关于我们