$dateFromString (operador de expresió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>
} }

La función $dateFromString toma un documento con los siguientes campos:

Campo	Descripción
dateString	La string de fecha/hora para convertir a un objeto de fecha. Consulte Date() para obtener más información sobre los formatos de fecha/hora. Si se especifica la timezone opción al operador, no incluir información de zona horaria en el dateString.
format	Opcional. Especificación del formato de fecha de dateString. format puede ser cualquier expresión que se evalúe como una cadena literal, que contenga 0 o más especificadores de formato. Para ver la lista de especificadores disponibles, consulte Especificadores de formato. Si no seespecifica, $dateFromString utiliza "%Y-%m-%dT%H:%M:%S.%LZ" como formato predeterminado, pero acepta una variedad de formatos e intenta analizar dateString si es posible.
timezone	opcional. La zona horaria que se utilizará para formatear la fecha. Si el argumento dateString está formato como '2017-02-08T12:10:40.787Z', donde la 'Z' al final indica la hora Zulu (zona horaria UTC), no puedes especificar el argumento timezone. <timezone> permite las siguientes opciones y expresiones que se evalúan como ellas: un identificador de zona horaria de Olson, como "Europe/London" o "America/New_York", 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	Optional. If $dateFromString encounters an error while parsing the given dateString, it outputs the result value of the provided onError expression. This result value can be of any type. Si no especifica onError, $dateFromString genera un error si no puede analizar dateString.
onNull	Opcional. Si el valor dateString proporcionado a $dateFromString es null o no está presente, se mostrará el valor resultante de la expresión onNull proporcionada. Este valor resultante puede ser de cualquier tipo. Si no especifica onNull y dateString es null o falta, entonces $dateFromString genera null.

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: "oct 20 2020"
} }

{ $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") }