$año (agregación)

Definición

$year

Devuelve la parte del año de una fecha.

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

{ $year: <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

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

{ $year: { date: new Date("Jan 7, 2003") } }

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

{ $year: ISODate("1998-11-07T00:00:00Z") }

{ $year: {
    date: ISODate("1998-11-07T00:00:00Z"),
    timezone: "-0400"
} }

{ $year: "March 28, 1976" }

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

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

Ejemplo

Considera una colección sales con los siguientes documentos:

 db.sales.insertOne(
  {
   "_id" : 1,
   "item" : "abc",
   "price" : 10,
   "quantity" : 2,
   "date" : ISODate("2014-01-01T08:15:39.736Z")
  }
)

La siguiente agregación utiliza y otros operadores de fecha para desglosar $year el date campo:

db.sales.aggregate(
   [
     {
       $project:
         {
           year: { $year: "$date" },
           month: { $month: "$date" },
           day: { $dayOfMonth: "$date" },
           hour: { $hour: "$date" },
           minutes: { $minute: "$date" },
           seconds: { $second: "$date" },
           milliseconds: { $millisecond: "$date" },
           dayOfYear: { $dayOfYear: "$date" },
           dayOfWeek: { $dayOfWeek: "$date" },
           week: { $week: "$date" }
         }
     }
   ]
)

La operación devuelve el siguiente resultado:

{
  "_id" : 1,
  "year" : 2014,
  "month" : 1,
  "day" : 1,
  "hour" : 8,
  "minutes" : 15,
  "seconds" : 39,
  "milliseconds" : 736,
  "dayOfYear" : 1,
  "dayOfWeek" : 4,
  "week" : 0
}