$dateTrunc（表达式操作符）

binSize 和 字段unit

binSize 和unit 一起指定$dateTrunc 计算中使用的时间段。

例如：

• 如果 binSize 为 1，unit 为 hour，则时间段为一小时。对于日期2021-03-20T11:30:05Z，$dateTrunc 返回 2021-03-20T11:00:00Z。

• 如果 binSize 为 2，unit 为 hour，则时间段为两小时。对于日期2021-03-20T11:30:05Z，$dateTrunc 返回 2021-03-20T10:00:00Z。

$dateTrunc:

• 将 $dateTrunc 计算的时间划分为指定时间单位的 binSize 时间段。

  时间段从参考日期开始，该日期由单位确定。如果单位是：

  • week 以外的字符串，$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 在日期中返回当月第一天开始的ISODate 。

• week：$dateTrunc 以日期形式返回 startOfWeek 日开始的ISODate 。 startOfWeek 的默认是星期日。

• day：$dateTrunc 返回ISODate ，以表示日期中一天的开始。

• hour：$dateTrunc 返回日期中小时开始的ISODate 。

• minute：$dateTrunc 以日期形式返回分钟开始时间的ISODate 。

• second：$dateTrunc 返回ISODate ，作为日期中秒的开始时间。

unit 和 字段startOfWeek

如果单位是：

• week、startOfWeek 以外的字符串将被忽略。

• 等于 week 且 startOfWeek 为：

  • 指定：$dateTrunc 使用 startOfWeek 作为计算周的第一天。

  • 已省略：$dateTrunc 使用星期日作为计算一周的开始。

截断$project 管道阶段中的订单日期

此示例在 $project 阶段使用 $dateTrunc 将蛋糕销售 orderDate 值截断为两周：

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 将 orderDate字段截断为 America/Los_Angeles 时区中 2 binSize week 单位的时间段，并将 startOfWeek设立为 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 管道阶段截断订单日期并获取数量总和

此示例在 $group 阶段使用 $dateTrunc 将蛋糕销售 orderDate 值截断为六个月，并返回 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
   }
]