$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	Optional. La zona horaria del resultado de la operación. <tzExpression> debe ser una expresión válida que se resuelva en una cadena formateada como un identificador de zona horaria de Olsono una diferencia UTC. Si no timezone se proporciona, el resultado se muestra UTC en. 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 }
]