$dateTrunc (operador de expressão )

binSize e unit campos

Juntos, binSize e unit especificam o período de tempo usado no $dateTrunc cálculo.

Por exemplo:

• Se binSize for 1 e unit hourfor, o período de tempo será de uma hora. Para a data, 2021-03-20T11:30:05Z $dateTrunc 2021-03-20T11:00:00Zretorna.

• Se binSize for 2 e unit hourfor, o período de tempo será de duas horas. Para a data, 2021-03-20T11:30:05Z $dateTrunc 2021-03-20T10:00:00Zretorna.

$dateTrunc:

• Divide o tempo para o $dateTrunc cálculo do em períodos binSize na unidade de tempo especificada.

  Os períodos de tempo começam em uma data de referência, que é determinada pela unidade. Se a unidade for:

  • Uma string diferente week de, utiliza uma data de$dateTrunc referência 2000-01-01T00:00:00.00Z de. Por exemplo, se binSize for 10 e a unidade yearfor, os períodos de tempo de exemplo serão:

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

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

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

  • Igual week a, usa uma data de referência que é definida como o primeiro dia da semana mais cedo que é maior ou$dateTrunc igual 2000-01-01 a. O primeiro dia é definido usando startOfWeek (o padrão é domingo).

• Retorna o limite inferior do período de tempo em que a data está. O limite é retornado como um ISODate. Se o campo binSize 1 estiver, define as partes$dateTrunc menos significativas (conforme determinado pela unit) do 0 ISODate retornado como e mantém o restante do ISODate igual.

Se a unidade for:

• year: $dateTrunc retorna o ISODate para o início de janeiro de 1 para o ano em data.

• quarter: $dateTrunc retorna o ISODate para o início do primeiro dia do trimestre do calendário em data.

  Os trimestres são:

  • De janeiro a março

  • De abril a junho

  • De julho a setembro

  • De outubro a dezembro

• month: $dateTrunc retorna o ISODate para o início do primeiro dia do mês em data.

• week: $dateTrunc retorna o ISODate para o início do dia startOfWeek em data.O padrão para startOfWeek é domingo.

• day: $dateTrunc retorna o ISODate para o início do dia em data.

• hour: $dateTrunc retorna o ISODate para o início da hora em data.

• minute: $dateTrunc retorna o ISODate para o início do minuto em data.

• second: $dateTrunc retorna o ISODate para o início do segundo em data.

unit e startOfWeek campos

Se a unidade for:

• Uma string diferente de week, startOfWeek é ignorada.

• Igual a week e startOfWeek é:

  • Especificado: $dateTrunc utiliza startOfWeek como o primeiro dia da semana para o cálculo.

  • Omitido: utiliza Domingo como o início da semana para o$dateTrunc cálculo.

Truncar datas de pedido em um estágio de pipeline $project

Este exemplo usa $dateTrunc em um estágio para truncar os valores de vendas de $project bolo orderDate para duas semanas:

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

No exemplo:

• $project inclui os campos _id, orderDate e truncatedOrderDate na saída.

• $dateTrunc trunca o orderDate campo para um 2 week período de tempo de unidade binSize no fuso horário America/Los_Angeles com startOfWeek definido Monday como.

Neste exemplo de saída, o orderDate truncado é mostrado no 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")
   }
]

Truncar datas de pedidos e obter soma de quantidade em um estágio de pipeline $group

Este exemplo usa $dateTrunc em um estágio para truncar os valores de vendas do $group bolo orderDate para seis meses e retornar a soma dos quantity valores:

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

No exemplo:

• $group tem o campo _id configurado para o campo truncatedOrderDate para agrupar os documentos cakeSales e retorna a soma dos valores quantity para cada grupo utilizando $sum.

• $dateTrunc trunca o orderDate campo para um 6 month período de tempo de unidade binSize .

Neste exemplo de saída, o orderDate truncado é mostrado no campo truncatedOrderDate e a soma quantity é mostrada no 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
   }
]