$toUpper (大文字化)
最終更新：2026-10-09
$toUpper (大文字化)
$toUpper は文字列を大文字に変換します。最も単純な文字列変換演算子で、比較の正規化や出力形式の統一によく使われます。文字列のみを受け付け、他の型はエラーになります（先に $toString で変換してください）。
| カテゴリ | 文字列 |
|---|---|
| MongoDB バージョン | 1.0+ |
| 例の言語 | mongosh（シェル） |
📝 構文
{ $toUpper: <string-expression> }▶ 例
以下のコマンドをローカルの 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 は何を返しますか？
Anull を返します。式は中断されません。null を処理したい場合は後段で $ifNull をチェーンしてください。
Q$toUpper と $toLower はチェーンできますか？
Aできますが、後者が前者の結果を上書きするだけなので意味がありません。よくある使い方は、大文字小文字を無視した比較のために $regexMatch と組み合わせることです。
