$dateFromString (operador de expresión)

Definición

$dateFromString

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

La $dateFromString La expresión 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 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 del dateString. El format puede ser cualquier expresión que evalúe a un literal de string, que contenga 0 o más especificadores de formato. Para una lista de especificadores disponibles, consulta Especificadores de Formato. Si no se especifica, $dateFromString usa "%Y-%m-%dT%H:%M:%S.%LZ" como el 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 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 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	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 especificas onNull y dateString es null o está ausente, 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") }