$isoWeek (operador de expresión)

Definición

$isoWeek

Devuelve el número de la semana en formato ISO 8601, con un rango de 1 a 53. Los números de las semanas comienzan en 1 con la semana (de lunes a domingo) que contiene el primer jueves del año.

El $isoWeek La expresión tiene lo siguiente Sintaxis de expresión del operador:

{ $isoWeek: <dateExpression> }

El argumento puede ser:

• Una expresión que se resuelve en una fecha, una marca de tiempo o un ObjectID.

• Un documento con este formato:

  { date: <dateExpression>, timezone: <tzExpression> }

  Campo	Descripción
  date	La fecha a la que se aplica el operador. <dateExpression> debe ser una expresión válida que se resuelva en una fecha, una marca de tiempo o un ObjectID.
  timezone	Opcional. La zona horaria del resultado de la operación. <tzExpression> debe ser una expresión válida que se resuelva en una cadena con el formato de identificador de zona horaria de Olson.o una diferencia horaria UTC. Si no timezone se proporciona, el resultado se expresa en UTC. Formato Ejemplos Olson Timezone Identifier "America/New_York" "Europe/London" "GMT" UTC Offset +/-[hh]:[mm], e.g. "+04:45" +/-[hh][mm], e.g. "-0530" +/-[hh], e.g. "+03"

Comportamiento

{ $isoWeek: { date: new Date("Jan 4, 2016") } }

{ $isoWeek: new Date("2016-01-01") }

{ $isoWeek: {
    date: new Date("August 14, 2011"),
    timezone: "America/Chicago"
} }

{ $isoWeek: ISODate("1998-11-02T00:00:00Z") }

{ $isoWeek: {
    date: ISODate("1998-11-02T00:00:00Z"),
    timezone: "-0500"
} }

{ $isoWeek: "March 28, 1976" }

{ $isoWeek: Date("2016-01-01") }

{ $isoWeek: "2009-04-09" }

Ejemplo

Una colección llamada deliveries contiene los siguientes documentos:

db.deliveries.insertMany( [
   { _id: 1, date: ISODate("2006-10-24T00:00:00Z"), city: "Boston" },
   { _id: 2, date: ISODate("2011-08-18T00:00:00Z"), city: "Detroit" }
] )

La siguiente operación devuelve el número de semana para cada campo date.

db.deliveries.aggregate( [
  {
    $project: {
      _id: 0,
      city: "$city",
      weekNumber: { $isoWeek: "$date" }
    }
  }
] )

La operación devuelve los siguientes resultados:

[
   { city: "Boston", weekNumber: 43 },
   { city: "Detroit", weekNumber: 33 }
]