$isoWeek (ISO 週番号)

最終更新：2026-10-09

$isoWeek (ISO 週番号)

$isoWeek は日付の ISO 8601 週番号（1 から 53）を返します。ISO の週は月曜日に始まり、最初の木曜日を含む週が第 1 週になります。日曜始まりで 0 を返し得る米国式の $week とは異なります。国際的な週ベースの統計に最適で、$isoWeekYear と組み合わせて年・週のキーを作ることが多いです。timezone が週の境界を決めます。

📝 構文

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

⚙️ パラメータ

戻り値：ISO 週番号（1〜53）。date が null の場合は null。

▶ 例

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

// $isoWeek: 売上を ISO 週単位で集計
 db.sales.aggregate([
  { $group: {
      _id: { $isoWeek: { date: '$soldAt', timezone: 'Asia/Shanghai' } },
      total: { $sum: '$amount' }
  } }
])

出力：

{ "_id": 39, "total": 9800 }
{ "_id": 40, "total": 10450 }

📌 注意事項

• ISO の週は月曜始まり。第 1 週はその年の最初の木曜日を含む週
• $week と違い、$isoWeek は 0 を返さない。範囲は 1〜53
• 通常は $isoWeekYear や $isoDayOfWeek と組み合わせて完全な週キーを作る

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

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

私たちについて