$dateFromString (operador de agregación)

Definición

$dateFromString

Convierte una string de fecha/hora en un objeto de fecha.

La expresión $dateFromString tiene la siguiente sintaxis:

{ $dateFromString: {
     dateString: <dateStringExpression>,
     format: <formatStringExpression>,
     timezone: <tzExpression>,
     onError: <onErrorExpression>,
     onNull: <onNullExpression>
} }

El $dateFromString procesa un documento con los siguientes campos:

Campo	Descripción
dateString	La cadena de fecha y hora que se convertirá en un objeto de fecha. Ver Fecha para obtener más información sobre los formatos de fecha/hora. Si se especifica la opción timezone para el operador, no incluya información de zona horaria en dateString.
format	Opcional. La especificación del formato de fecha dateString de.format puede ser cualquier expresión que evalúe un literal de cadena y que contenga 0 o más especificadores de formato. Para obtener una lista de los especificadores disponibles, consulte Especificadores de Formato. Si no se especifica, $dateFromString usa "%Y-%m-%dT%H:%M:%S.%LZ" como formato predeterminado, pero acepta una variedad de formatos e intenta analizar si dateString es posible.
timezone	Opcional. La zona horaria que se utilizará para formatear la fecha. Si el argumento dateString tiene el formato '2017-02-08T12:10:40.787Z', en el que la 'Z' al final indica la hora zulú (zona horaria UTC), no puede especificar el argumento timezone. <timezone> permite las siguientes opciones y expresiones que evalúan a ellas: un identificador de zona horaria de Olson, como "Europe/London" "America/New_York"o, o un desplazamiento UTC en la forma: +/-[hh]:[mm], por ejemplo "+04:45", o +/-[hh][mm], por ejemplo "-0530", o +/-[hh], por ejemplo "+03", o Las cadenas "Z", "UTC" o "GMT" Para obtener más información sobre las expresiones, consulta Expresiones.
onError	Opcional. Si encuentra un error al analizar $dateFromString el dateString especificado, genera el valor resultante de la onError expresión proporcionada. Este valor resultante puede ser de cualquier tipo. Si no onError especifica, genera un error si no$dateFromString puede dateString analizar.
onNull	Opcional. Si el dateString proporcionado a $dateFromString es null o no está presente, se genera el valor resultante de la onNull expresión proporcionada. Este valor resultante puede ser de cualquier tipo. Si no especifica onNull y dateString es null o falta, entonces $dateFromString nullgenera.

Comportamiento

{ $dateFromString: {
    dateString: "2017-02-08T12:10:40.787"
} }

{ $dateFromString: {
     dateString: "2017-02-08T12:10:40.787",
     timezone: "America/New_York"
} }

{ $dateFromString: {
     dateString: "2017-02-08"
} }

{ $dateFromString: {
     dateString: "06-15-2018",
     format: "%m-%d-%Y"
} }

{ $dateFromString: {
     dateString: "15-06-2018",
     format: "%d-%m-%Y"
} }

{ $dateFromString: {
     dateString: "WED jan 31 12:05:28 +03:30 1996"
} }

Especificadores de formato

Los siguientes especificadores de formato están disponibles para usarse en <formatString>:

Ejemplos

{ _id: 1, date: "2017-02-08T12:10:40.787", timezone: "America/New_York", message:  "Step 1: Started" },
{ _id: 2, date: "2017-02-08", timezone: "-05:00", message:  "Step 1: Ended" },
{ _id: 3, message:  " Step 1: Ended " },
{ _id: 4, date: "2017-02-09", timezone: "Europe/London", message: "Step 2: Started"},
{ _id: 5, date: "2017-02-09T03:35:02.055", timezone: "+0530", message: "Step 2: In Progress"}

db.logmessages.aggregate( [ {
   $project: {
      date: {
         $dateFromString: {
            dateString: '$date',
            timezone: 'America/New_York'
         }
      }
   }
} ] )

{ "_id" : 1, "date" : ISODate("2017-02-08T17:10:40.787Z") }
{ "_id" : 2, "date" : ISODate("2017-02-08T05:00:00Z") }
{ "_id" : 3, "date" : null }
{ "_id" : 4, "date" : ISODate("2017-02-09T05:00:00Z") }
{ "_id" : 5, "date" : ISODate("2017-02-09T08:35:02.055Z") }

db.logmessages.aggregate( [ {
   $project: {
      date: {
         $dateFromString: {
            dateString: '$date',
            timezone: '$timezone'
         }
      }
   }
} ] )

{ "_id" : 1, "date" : ISODate("2017-02-08T17:10:40.787Z") }
{ "_id" : 2, "date" : ISODate("2017-02-08T05:00:00Z") }
{ "_id" : 3, "date" : null }
{ "_id" : 4, "date" : ISODate("2017-02-09T00:00:00Z") }
{ "_id" : 5, "date" : ISODate("2017-02-08T22:05:02.055Z") }

{ "_id" : 1, "date" : "2017-02-08T12:10:40.787", timezone: "America/New_York" },
{ "_id" : 2, "date" : "20177-02-09T03:35:02.055", timezone: "America/New_York" }

db.dates.aggregate( [ {
   $project: {
      date: {
         $dateFromString: {
            dateString: '$date',
            timezone: '$timezone',
            onError: '$date'
         }
      }
   }
} ] )

{ "_id" : 1, "date" : ISODate("2017-02-08T17:10:40.787Z") }
{ "_id" : 2, "date" : "20177-02-09T03:35:02.055" }

{ "_id" : 1, "date" : "2017-02-08T12:10:40.787", timezone: "America/New_York" },
{ "_id" : 2, "date" : null, timezone: "America/New_York" }

db.dates.aggregate( [ {
   $project: {
      date: {
         $dateFromString: {
            dateString: '$date',
            timezone: '$timezone',
            onNull: new Date(0)
         }
      }
   }
} ] )

{ "_id" : 1, "date" : ISODate("2017-02-08T17:10:40.787Z") }
{ "_id" : 2, "date" : ISODate("1970-01-01T00:00:00Z") }