$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 期間に分割します。

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

  • 以外の$dateTrunc stringweek では、 は の参照日を使用します。例、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 date1 の年の 1 月 からのISODateを返します。

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

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

  • 1 月から 3 月

  • 4 月から 6 月

  • 7 月から 9 月

  • 10 月から 12 月

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

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

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

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

• minute: は date$dateTrunc の 分の開始の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 を に設定して、 タイムゾーンのorderDate フィールドを2 binSizeweek ユニット期間を切り捨てます。America/Los_AngelesMonday

この出力例では、切り捨てられた 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
   }
]