$toUpper(转大写)
最后更新:2026-10-09
$toUpper(转大写)
$toUpper 将字符串转为大写。它是聚合表达式中最简单直接的字符串转换操作符,常用于规范化比较或输出统一格式。注意它只处理字符串,其他类型会报错(可先 $toString 转换)。
| 分类 | 字符串 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $toUpper: <字符串表达式> }
▶ 示例
请在本地安装的 mongosh 中执行以下命令(需已启动 mongod):
// $toUpper:统一城市名为大写
db.users.aggregate([
{ $project: { cityUpper: { $toUpper: "$city" } } }
])
运行结果:
{ "_id": 1, "cityUpper": "BEIJING" }
{ "_id": 2, "cityUpper": "SHANGHAI" }
📌 注意事项
- 只接受字符串;数字/日期等类型需先转换
- 与 $toLower 互为反操作
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线,敬请期待。
📚 相关教程
❓ 常见问题
Q$toUpper 对中文等非拉丁字符有效吗?
A无效。$toUpper 只处理拉丁字母(A–Z),中文、日文、阿拉伯文等大小写不变的字符原样返回。
Q字段缺失或为 null 时 $toUpper 返回什么?
A返回 null。表达式不会中断,后续可接 $ifNull 处理空值。
Q$toUpper 和 $toLower 能链式使用吗?
A可以,但没必要——后一个会覆盖前一个的结果。常用场景是配合 $regexMatch 做不区分大小写的比较。