$toLower (小文字化)
最終更新：2026-10-09
$toLower (小文字化)
$toLower は文字列を小文字に変換する、基礎的な正規化演算子です。保存形式の統一や、大文字小文字を無視した検索キー（インデックス付き）の作成、ユーザー入力のクリーニングに使われます。文字列のみを受け付け、他の型はエラーになるため、先に $toString で変換してください。$toUpper の逆演算です。中国語のような大小の区別がない文字はそのまま通過します。
| カテゴリ | 文字列 |
|---|---|
| MongoDB バージョン | 1.0+ |
| 例の言語 | mongosh（シェル） |
📝 構文
{ $toLower: <string-expression> }⚙️ パラメータ
| 文字列 | 必須。小文字に変換する文字列式。 |
|---|
戻り値：小文字に変換した文字列。
▶ 例
以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：
// $toLower: メールアドレスを小文字に正規化
db.users.aggregate([
{ $project: { emailLower: { $toLower: '$email' } } }
])出力：
{ "_id": 1, "emailLower": "alice@example.com" }
{ "_id": 2, "emailLower": "bob@example.com" }📌 注意事項
- 文字列のみ — 数値や日付は先に変換する
- $toUpper の逆演算
- 中国語など大小の区別がない文字はそのまま通過する
🏷️ 関連タグ
💡 関連ケース
さらなる実践ケースを近日公開予定。
📚 関連チュートリアル
❓ よくある質問
Q中国語に影響しますか？
A中国語に大小はありません — 文字はそのまま返されます。
Q小文字化でクエリは速くなりますか？
A小文字で統一して保存すると、インデックスが完全一致をより効率的に処理できます。
Q$toUpper と併用すると？
A変換して戻すと元に戻るだけです — 追加の効果はありません。
