$dateTrunc (operador de agregación)

binSize and unit Fields

Juntos, binSize y unit especifican el período de tiempo utilizado en el $dateTrunc cálculo.

Por ejemplo:

• Si binSize es 1 y hourla unidad es, el período de tiempo es una hora. Para la fecha, 2021-03-20T11:30:05Z $dateTrunc 2021-03-20T11:00:00Zdevuelve.

• Si binSize es 2 y hourla unidad es, el período de tiempo es de dos horas. Para la fecha, 2021-03-20T11:30:05Z $dateTrunc 2021-03-20T10:00:00Zdevuelve.

$dateTrunc:

• Divide el tiempo para el $dateTrunc cálculo en períodos de tiempo binSize en la unidad de tiempo especificada.

  Los períodos de tiempo comienzan en una fecha de referencia, determinada por unidad. Si la unidad es:

  • Una cadena distinta de week, $dateTrunc utiliza una fecha de referencia de 2000-01-01T00:00:00.00Z. Por ejemplo, si binSize es 10 y unidad es year, los periodos de tiempo de ejemplo son:

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

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

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

  • Igual a week, $dateTrunc utiliza una fecha de referencia que se establece en el primer día de la semana más temprano que sea igual o posterior a 2000-01-01. El primer día se establece usando startOfWeek (el valor por defecto es domingo).

• Devuelve el límite inferior del período de tiempo en el que se encuentra la fecha. El límite se devuelve como una ISODate. Si el campo binSize 1 es, establece las partes$dateTrunc menos significativas (determinadas por la unidad) de la 0 ISODate devuelta en y mantiene el resto de la ISODate sin cambios.

Si unidad es:

• year: $dateTrunc returns the ISODate for the start of January 1 for the year in date.

• quarter: $dateTrunc devuelve el ISODate para el inicio del primer día del trimestre calendario en fecha.

  Los cuartos son:

  • Enero a marzo

  • Abril a junio

  • Julio a septiembre

  • Octubre a diciembre

• month: $dateTrunc returns the ISODate for the start of the first day of the month in date.

• week: $dateTrunc returns the ISODate for the start of the startOfWeek day in date. The default for startOfWeek is Sunday.

• day: $dateTrunc returns the ISODate for the start of the day in date.

• hour: $dateTrunc returns the ISODate for the start of the hour in date.

• minute: $dateTrunc returns the ISODate for the start of the minute in date.

• second: $dateTrunc devuelve el ISODate del inicio del segundo en fecha.

unit and startOfWeek Fields

Si unidad es:

• Una cadena distinta week de, startOfWeek se ignora.

• Igual a week y startOfWeek es:

  • Especificado: $dateTrunc utiliza startOfWeek como el primer día de la semana para el cálculo.

  • Omitido: utiliza el domingo como inicio de la semana para el$dateTrunc cálculo.

Truncar fechas de pedidos en una etapa de pipeline $project

Este ejemplo utiliza $dateTrunc en una etapa para truncar los valores de ventas de $project pasteles orderDate a dos semanas:

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

En el ejemplo:

• $project includes the _id, orderDate, and truncatedOrderDate fields in the output.

• $dateTrunc truncates the orderDate field to a 2 binSize week unit time period in the America/Los_Angeles timezone with startOfWeek set to Monday.

En este resultado de ejemplo, el orderDate truncado se muestra en el campo 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")
   }
]

Truncate Order Dates and Obtain Quantity Sum in a $group Pipeline Stage

Este ejemplo utiliza $dateTrunc en una etapa para truncar los valores de ventas de $group pasteles orderDate a seis meses y devolver la suma de los quantity valores:

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

En el ejemplo:

• $group has the _id field set to the truncatedOrderDate field to group the cakeSales documents, and returns the sum of the quantity values for each group using $sum.

• $dateTrunc truncates the orderDate field to a 6 binSize month unit time period.

En este ejemplo de salida, el orderDate truncado se muestra en el campo truncatedOrderDate y la suma quantity se muestra en el campo 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
   }
]