$dayOfWeek (曜日)

最終更新：2026-10-09

$dayOfWeek (曜日)

$dayOfWeek は日付の曜日を整数で返します。1 が日曜日、7 が土曜日で、JavaScript の Date.getDay() と同じ規則です。曜日ベースのトラフィック統計やスケジュール処理によく使われます。月曜日が 1 の ISO 規格の $isoDayOfWeek とは開始曜日が違う点に注意してください。timezone が曜日の境界を決め、既定は UTC です。

📝 構文

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

⚙️ パラメータ

戻り値：曜日番号（1=日曜、7=土曜）。date が null の場合は null。

▶ 例

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

// $dayOfWeek: 訪問数を曜日ごとに集計（北京時間）
 db.logs.aggregate([
  { $group: {
      _id: { $dayOfWeek: { date: '$ts', timezone: 'Asia/Shanghai' } },
      cnt: { $sum: 1 }
  } }
])

出力：

{ "_id": 1, "cnt": 1240 }
{ "_id": 2, "cnt": 980 }

📌 注意事項

• 1 は日曜日で月曜日ではない。よくある落とし穴。月曜始まりなら $isoDayOfWeek を使う
• $group と組み合わせて曜日ベースの統計を取る
• 既定は UTC。中国向けのビジネスでは Asia/Shanghai を渡す

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

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

私たちについて