$dateFromString (aggregation)

在本页面

• Definition

• Example

Definition

• $dateFromString
  • 3.6 版的新功能。

将日期/时间字符串转换为日期对象。

$dateFromString表达式具有以下语法：

{ $dateFromString: {
      'dateString': <dateStringExpression>,
      'timezone': <tzExpression>
  }
}

$dateFromString接收具有以下字段的文档：

Field	Description
dateString	要转换为日期对象的日期/时间字符串。有关日期/时间格式的更多信息，请参见Date。

如果dateStringExpression或tzExpression评估为 null，缺少或未定义，则$ dateFromString 表达式的结果为 null。

Example

考虑一个包含以下文档的集合logmessages：

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

以下聚合使用$ dateFromString 将date值转换为日期对象：

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

上述汇总返回以下文档，并将每个date字段转换为东部时区：

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

timezone参数也可以通过文档字段而不是硬编码参数来提供。例如：

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

上面的汇总返回以下文档，并将每个date字段转换为它们各自的 UTC 表示形式。

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