$dateFromString (agregação)

Definição

$dateFromString

Converte uma string de data/hora em um objeto de data.

A expressão $dateFromString tem a seguinte sintaxe:

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

O $dateFromString pega um documento com os seguintes campos:

Campo	Descrição
dateString	A string de data/hora para converter para um objeto de data. Consulte Date() para obter mais informações sobre formatos de data/hora. Se especificar a opção timezone para o operador, não inclua informações de fuso horário no dateString.
format	Opcional. A especificação do formato de data do dateString. O format pode ser qualquer expressão que avalia para uma string literal, contendo 0 ou mais especificadores de formato. Para obter uma lista de especificadores disponíveis, consulte Formatar especificadores. Se não for especificado, $dateFromString utiliza "%Y-%m-%dT%H:%M:%S.%LZ" como o formato padrão, mas aceita uma variedade de formatos e tenta analisar o dateString se possível.
timezone	Opcional. O fuso horário a ser usado para formatar a data. Se o argumento dateString estiver formatado como "2017-02-08T12:10:40,787Z", no qual o "Z" no final indica a hora de Zulu (fuso horário UTC), você não poderá especificar o argumento timezone. <timezone> permite as seguintes opções e expressões que avaliam para eles: identificador de fuso horário Olson, como "Europe/London" ou "America/New_York", ou um deslocamento UTC no formato: +/-[hh]:[mm], e.g. "+04:45" ou +/-[hh][mm], e.g. "-0530" ou +/-[hh], e.g. "+03" ou As strings "Z", "UTC" ou "GMT" Para mais informações sobre expressões, consulte Operadores de Expressão.
onError	Opcional. Se $dateFromString encontrar um erro na análise do dateString fornecido, ele vai gerar o valor do resultado da expressão onError fornecida. Esse valor gerado pode ser de qualquer tipo. Se você não especificar onError, $dateFromString gerará um erro se não conseguir analisar dateString.
onNull	Opcional. Se o dateString fornecido a $dateFromString estiver null ou ausente, produzirá o valor de resultado da expressão onNull fornecida. Esse valor de resultado pode ser de qualquer tipo. Se você não especificar onNull e dateString estiver null ou ausente, então $dateFromString entregará null.

Comportamento

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

Os seguintes especificadores de formato estão disponíveis para uso no <formatString>:

Exemplos

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