$month (月)

最終更新：2026-10-09

$month (月)

$month は日付の月（1〜12）を返します。月次レポートで最もよく使われる式の 1 つです。$year と組み合わせて $group のキーにすると、年月のディメンションを作れます。戻り値はゼロ埋めしない整数で、2 桁の文字列が必要なら $dateToString の %m を使います。timezone は月の境界を決め、既定は UTC です。業務の月次レポートでは必ず timezone を指定してください。

📝 構文

{ $month: { date: <date-expression>, timezone: <timezone> } }

⚙️ パラメータ

戻り値：月（1〜12）。date が null の場合は null。

▶ 例

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

// $month + $year: 注文額を月ごとに集計
 db.orders.aggregate([
  { $group: {
      _id: { y: { $year: { date: '$orderDate' } }, m: { $month: { date: '$orderDate' } } },
      total: { $sum: '$amount' }
  } }
])

出力：

{ "_id": { "y": 2026, "m": 9 }, "total": 45600 }
{ "_id": { "y": 2026, "m": 10 }, "total": 52300 }

📌 注意事項

• 1 月は 1、12 月は 12
• 月だけを集計キーにせず、必ず年と組み合わせる（年をまたぐと混ざる）
• 既定は UTC — 月次レポートでは timezone を明示的に設定する

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

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

私たちについて