$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>
} }

El $dateFromString procesa 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. La especificación del formato de fecha de dateString. El format puede ser cualquier expresión que se evalúe como un literal de string, que contenga 0 o más especificadores de formato. Para ver una lista de los especificadores disponibles, consulte Especificadores de formato. Si no se especifica, $dateFromString utiliza "%Y-%m-%dT%H:%M:%S.%LZ" como formato por defecto, pero acepta una variedad de formatos e intenta analizar el 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 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	opcional. Si $dateFromString encuentra un error al analizar el/la dateString proporcionado(a), muestra el valor del resultado de la onError proporcionada expresión. Este valor de resultado puede ser de cualquier tipo. Si no se especifica onError, $dateFromString arroja un error si no puede analizar dateString.
onNull	opcional. Si el dateString proporcionado a $dateFromString es null o falta, se obtiene el valor de resultado de la expresión onNull proporcionada. Este valor de resultado puede ser de cualquier tipo. Si no especifica onNull y dateString es null o falta, entonces $dateFromString emite 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") }