MongoDB聚合运算符$dateFromString详解_Nosql

$datefromstring聚合运算符将日期时间字符串转换为日期对象。

语法

{ $datefromstring: {
     datestring: <datestringexpression>,
     format: <formatstringexpression>,
     timezone: <tzexpression>,
     onerror: <onerrorexpression>,
     onnull: <onnullexpression>
} }

参数字段说明：

字段	必须	说明
`datestring`	如果没有用`isoweekyear`则必须	日历年度，可以是任何能解析为整数的表达式，值域为：1~9999，如果超出范围将报错。从4.4以后最小值为1，再之前的版本最小值是0
`format`	若year没有用则必须	iso的周日期年，可以是任何能解析为整数的表达式，值域为：1~9999，如果超出将报错。从4.4以后最小值为1，再之前的版本最小值是0
`timezone`	可选	执行操作的时区，`<timezone>`可以是任何能被解析为：olson时区标识符或utc偏移量
`onerror`	可选	在解析`datestring`时如果出错，则输出`onerror`表达式的结果，结果值可以是任意类型
`onnull`	可选	如果`datestring`为`null`或不存在，则输出`onnull`表达式的结果，可以是任意类型

使用

使用例子对规则进行说明

例1：

{ $datefromstring: {
    datestring: "2017-02-08t12:10:40.787"
} }

结果：isodate("2017-02-08t12:10:40.787z")

例2：

{ $datefromstring: {
     datestring: "2017-02-08t12:10:40.787",
     timezone: "america/new_york"
} }

结果：isodate("2017-02-08t12:10:40.787z")

例3：

{ $datefromstring: {
     datestring: "2017-02-08"
} }

结果：isodate("2017-02-08t00:00:00z")

例4：

{ $datefromstring: {
     datestring: "oct 20 2020"
} }

结果：isodate("2020-10-20t00:00:00.000z")

例5：

{ $datefromstring: {
     datestring: "06-15-2018",
     format: "%m-%d-%y"
} }

结果：isodate("2018-06-15t00:00:00z")

例6：

{ $datefromstring: {
     datestring: "15-06-2018",
     format: "%d-%m-%y"
} }

结果：isodate("2018-06-15t00:00:00z")

{ $datefromstring: {
     datestring: "wed jan 31 12:05:28 +03:30 1996"
} }

结果：isodate("1996-01-31t08:35:28.000z")

格式指示符

指示符	描述	可能的值
%b	月份缩写（3个字符）	`jan`, `feb`, `mar`, `apr`, `may`, `jun`, `jul`, `aug`, `sep`, `oct`, `nov`, `dec`
%b	完整月份	`january`-`december`
%d	一个月内的第几天（2个数字，0填充）	`01`-`31`
%g	iso8601格式年	`0000-9999`
%h	小时（2个数字，0填充，24小时时钟）	`00-23`
%j	一年内的第几天（3个数字，0填充）	`001-366`
%l	毫秒（3个数字，0填充）	`000=999`
%m	月（2个数字，0填充）	`01-12`
%m	分钟（2个数字，0填充）	`00-59`
%s	秒（2个数字，0填充）	`00-60`
%u	iso8601格式的一周内的第几天	`1-7`
%u	一年内的第几周（2个数字，0填充）	`00-53`
%v	iso8601格式的一年内的第几周	`1-53`
%w	一周内的第几天（整数，0-sunday，6-saturday）	`0-6`
%y	年（4个数字，0填充）	`0000-9999`
%z	时区与utc的偏移量	`+/-[hh][mm]`
%z	从 utc 开始的分钟偏移量，用数字表示。例如，如果时区偏移`（+/-[hhmm]）为 +0445`，则分钟偏移为`+285`。	`+/-mmm`
%%	百分比字符作为字面值	`%`

举例

日期转换

集合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将日期值转换为日期对象：

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'
         }
      }
   }
} ] )

上述汇总返回以下文档，并将每个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") }

错误处理onerror

如果文档集中包含不可解析日期字符串的文档，则$datefromstring会出错，除非给参数onerror提供一个聚合表达式。

例如，给定一个包含以下文档的日期集合：

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

可以使用onerror参数以原始字符串形式返回无效日期：

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

空值的粗粒 onnull

如果集合文档包含空日期字符串，$datefromstring返回空，除非给onnull指定一个聚合表达式。

例如，集合dates有以下文档：

{ "_id" : 1, "date" : "2017-02-08t12:10:40.787", timezone: "america/new_york" },
{ "_id" : 2, "date" : null, timezone: "america/new_york" }

可以使用onnull参数让$datefromstring返回代表unix纪元的日期，而不是空值：

db.dates.aggregate( [ {
   $project: {
      date: {
         $datefromstring: {
            datestring: '$date',
            timezone: '$timezone',
            onnull: new date(0)
         }
      }
   }
} ] )

返回下面的结果：