$second(获取秒)
最后更新:2026-10-09
$second(获取秒)
$second 返回日期中的秒部分(0 到 59),常用于构造秒级时间标签或校验时间戳。返回整数,不补零,需要两位字符串时用 $dateToString 的 %S。它与 $minute、$hour、$millisecond 可组合还原任意精度的时间部件。timezone 对正常偏移下的秒值没有影响。
| 分类 | 日期 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $second: { date: <日期表达式>, timezone: <时区> } }
⚙️ 参数
| date | 必填,日期表达式。 |
|---|---|
| timezone | 可选,普通偏移下不影响秒值。 |
返回值:秒值(0-59)整数;date 为 null 时返回 null。
▶ 示例
请在本地安装的 mongosh 中执行以下命令(需已启动 mongod):
// $second + $millisecond:毫秒级时间标签
db.sensors.aggregate([
{ $project: { s: { $second: '$ts' }, ms: { $millisecond: '$ts' } } }
])
运行结果:
{ "_id": 1, "s": 42, "ms": 320 }
{ "_id": 2, "s": 0, "ms": 0 }
📌 注意事项
- 范围 0 到 59,不补零,需要两位字符串用 %S
- 与 $millisecond 组合可构造毫秒级时间标签
- 秒与时区无耦合,普通场景无需关注时区
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线,敬请期待。
📚 相关教程
❓ 常见问题
Q范围是多少?
A0 到 59。
Q怎么输出两位数的秒?
A用 $dateToString 的 %S,或用 $concat 手工补零。
Q和 $millisecond 怎么配合?
A两者直接相加即可还原秒.毫秒格式的时间部件。