$dateTrunc（集計）

binSize およびunit フィールド

binSizeとunitは、 $dateTrunc計算で使用される期間を指定します。

以下に例を挙げます。

• binSizeが1で、 unitがhourの場合、期間は 1 時間です。 日付2021-03-20T11:30:05Zの場合、 $dateTruncは2021-03-20T11:00:00Zを返します。

• binSizeが2で、 unitがhourの場合、期間は 2 時間です。 日付2021-03-20T11:30:05Zの場合、 $dateTruncは2021-03-20T10:00:00Zを返します。

$dateTrunc:

• 計算の時間を指定された時間 単位$dateTrunc で binSize 期間に分割します。

  期間は、ユニットによって決定される基準日から始まります。ユニットが次の場合。

  • week以外の string では、 $dateTruncは2000-01-01T00:00:00.00Zの参照日を使用します。 たとえば、 binSizeが10で、 unitがyearの場合、期間の例は次のようになります。

    • 2000-01-01T00:00:00.00Z

    • 2010-01-01T00:00:00.00Z

    • 2020-01-01T00:00:00.00Z

  • weekと等しい場合、 $dateTruncは、 2000-01-01以上の週の最も近い最初の日に設定された参照日を使用します。 最初の日はstartOfWeekを使用して設定されます（デフォルトは日曜日）。

• 日付が含まれる期間の下限を返します。 境界はISODateとして返されます。 binSize フィールドが1 の場合、 は返された$dateTrunc ISODate の最下位部分（ ユニット によって決定）を に設定し、0 ISODate の残りの部分を同じままにします。

ユニットが次の場合。

• year: $dateTruncは date の年の 1 月1のISODateを返します。

• quarter: $dateTruncは、日付の暦上の四半期の最初の日の開始のISODateを返します。

  クォーターは次のとおりです。

  • 1 月から 3 月

  • 4 月から 6 月

  • 7 月から 9 月

  • 10 月から 12 月

• month: $dateTruncは date の最初の日の開始のISODateを返します。

• week: は$dateTrunc date の startOfWeek 日の開始の ISODate を返します。startOfWeekのデフォルトは日曜日です。

• day: $dateTruncにより、 date の開始時刻のISODateが返されます。

• hour: $dateTruncは date の時間の開始のISODateを返します。

• minute: $dateTruncは date の分の開始のISODateを返します。

• second: $dateTruncは の日付の秒開始のISODateを返します。

unit およびstartOfWeek フィールド

ユニットが次の場合。

• week以外の string では、 startOfWeekは無視されます。

• weekと等しく、 startOfWeekは次のとおりです。

  • 指定: $dateTruncはstartOfWeekを計算の最初の日として startOfWeek を使用します。

  • 省略: $dateTruncは日曜日を計算の週の開始として使用します。

パイプライン ステージでの注文日の切り捨て$project

この例では、 ステージで$dateTrunc $projectを使用して、ケーキ販売orderDate の値を 2 週間に切り捨てています。

db.cakeSales.aggregate( [
   {
      $project: {
         _id: 1,
         orderDate: 1,
         truncatedOrderDate: {
            $dateTrunc: {
               date: "$orderDate", unit: "week", binSize: 2,
               timezone: "America/Los_Angeles", startOfWeek: "Monday"
            }
         }
      }
   }
] )

この例では、次のことが行われます。

• $project は、出力に _id、orderDate、および truncatedOrderDate フィールドを含めます。

• $dateTrunc は、 startOfWeek が に設定されているorderDate2 weekタイムゾーン のAmerica/Los_Angeles フィールドを binSize ユニット 期間を切り捨てます。Monday

この出力例では、切り捨てられた orderDate が truncatedOrderDate フィールドに表示されます。

[
   {
      _id: 0,
      orderDate: ISODate("2020-05-18T14:10:30.000Z"),
      truncatedOrderDate: ISODate("2020-05-11T07:00:00.000Z")
   },
   {
      _id: 1,
      orderDate: ISODate("2021-03-20T11:30:05.000Z"),
      truncatedOrderDate: ISODate("2021-03-15T07:00:00.000Z")
   },
   {
      _id: 2,
      orderDate: ISODate("2021-01-11T06:31:15.000Z"),
      truncatedOrderDate: ISODate("2021-01-04T08:00:00.000Z")
   },
   {
      _id: 3,
      orderDate: ISODate("2020-02-08T13:13:23.000Z"),
      truncatedOrderDate: ISODate("2020-02-03T08:00:00.000Z")
   },
   {
      _id: 4,
      orderDate: ISODate("2019-05-18T16:09:01.000Z"),
      truncatedOrderDate: ISODate("2019-05-13T07:00:00.000Z")
   },
   {
      _id: 5,
      orderDate: ISODate("2019-01-08T06:12:03.000Z"),
      truncatedOrderDate: ISODate("2019-01-07T08:00:00.000Z")
   }
]

パイプライン$group ステージで注文日を切り捨てて数量の合計を取得する

この例では、 ステージで$dateTrunc $groupを使用して、ケーキ販売のorderDate 値を 6 か月に切り捨てて、 値の合計を返します。quantity

db.cakeSales.aggregate( [
   {
      $group: {
         _id: {
            truncatedOrderDate: {
               $dateTrunc: {
                  date: "$orderDate", unit: "month", binSize: 6
               }
            }
         },
         sumQuantity: { $sum: "$quantity" }
      }
   }
] )

この例では、次のことが行われます。

• $group _id フィールドを truncatedOrderDate フィールドに設定して cakeSales ドキュメントをグループ化し、$sum. を使用して各グループの quantity 値の合計を返します。

• $dateTrunc は、 orderDateフィールドを6 binSize month単位の期間に切り捨てます。

この出力例では、切り捨てられた orderDate が truncatedOrderDate フィールドに表示され、quantity の合計が sumQuantity フィールドに表示されます。

[
   {
      _id: { truncatedOrderDate: ISODate("2020-01-01T00:00:00.000Z") },
      sumQuantity: 224
   },
   {
      _id: { truncatedOrderDate: ISODate("2021-01-01T00:00:00.000Z") },
      sumQuantity: 285
   },
   {
      _id: { truncatedOrderDate: ISODate("2019-01-01T00:00:00.000Z") },
      sumQuantity: 296
   }
]