$toString (文字列への変換)

最終更新：2026-10-09

$toString (文字列への変換)

$toString は値を文字列に変換します。数値、日付、ブール値、ObjectId などをきれいに変換でき、null は null のままです。代表的な用途は、$concat の前に数値を文字列化したり、ObjectId をフロントエンドに文字列として渡したり、表示形式を統一したりすることです。to: string の $convert 短縮形です。日付から文字列への出力は形式を制御できないため、特定の形式が必要な場合は $dateToString を使います。

📝 構文

{ $toString: <expression> }

⚙️ パラメータ

戻り値：文字列。入力が null の場合は null

▶ 例

以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：

// $toString: 数値をラベルに連結
db.products.aggregate([
  { $project: {
      label: { $concat: ['SKU-', { $toString: '$skuNum' }] }
  } }
])

出力：

{ '_id': 1, 'label': 'SKU-1001' }

📌 注意事項

• 数値、日付、ブール値、ObjectId はすべて文字列に変換される
• null は null を返す。連結前にガードする
• 日付から文字列への出力は固定で制御できない。カスタム形式には $dateToString

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

私たちについて