程序员之家 服务器常用软件
快捷导航
您的位置：首页 → 数据库 → MongoDB → MongoDB $dateFromString

MongoDB聚合运算符$dateFromString详解

 更新时间：2024年03月07日 15:18:15   作者：原子星  
$dateFromString聚合运算符将日期时间字符串转换为日期对象,本文给大家介绍MongoDB聚合运算符$dateFromString的相关知识,感兴趣的朋友跟随小编一起看看吧
（福利推荐：【腾讯云】服务器最新限时优惠活动，云服务器1核2G仅99元/年、2核4G仅768元/3年，立即抢购>>>：9i0i.cn/qcloud）

（福利推荐：你还在原价购买阿里云服务器？现在阿里云0.8折限时抢购活动来啦！4核8G企业云服务器仅2998元/3年，立即抢购>>>：9i0i.cn/aliyun）

$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
%GISO8601格式 年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
%uISO8601格式的一周内的第几天1-7
%U一年内的第几周（2个数字，0填充）00-53
%VISO8601格式的一年内的第几周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)
         }
      }
   }
} ] )

返回下面的结果：

{ "_id" : 1, "date" : ISODate("2017-02-08T17:10:40.787Z") }
{ "_id" : 2, "date" : ISODate("1970-01-01T00:00:00Z") }

到此这篇关于MongoDB聚合运算符：$dateFromString的文章就介绍到这了,更多相关MongoDB $dateFromString内容请搜索程序员之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持程序员之家！

您可能感兴趣的文章:

相关文章

  • Mongodb 启动命令mongod参数说明（中文翻译）

    Mongodb 启动命令mongod参数说明（中文翻译）

    这篇文章主要介绍了Mongodb 启动命令mongod参数说明（中文翻译）的相关资料,需要的朋友可以参考下
    2016-10-10
  • MongoDB导出查询结果到文件例子

    MongoDB导出查询结果到文件例子

    这篇文章主要介绍了MongoDB导出查询结果到文件例子,本文直接给出示例代码,简洁易懂,需要的朋友可以参考下
    2015-02-02
  • MongoDB 学习笔记

    MongoDB 学习笔记

    最近在学习MongoDB，小结一下，主要都是一些基础知识,需要的朋友可以参考下
    2014-07-07
  • MongoDB连接数据库并创建数据等使用方法

    MongoDB连接数据库并创建数据等使用方法

    MongoDB?是一个介于关系数据库和非关系数据库之间的产品，是非关系数据库当中功能最丰富，最像关系数据库的。接下来通过本文给大家介绍MongoDB连接数据库并创建数据等使用方法，感兴趣的朋友一起看看吧
    2021-11-11
  • MongoDB实现自动备份的全过程记录

    MongoDB实现自动备份的全过程记录

    这篇文章主要给大家介绍了关于MongoDB实现自动备份的全过程，文中通过示例代码介绍的非常详细，对大家学习或者使用MongoDB具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
    2019-05-05
  • mongodb禁止外网访问及添加账号的操作方法

    mongodb禁止外网访问及添加账号的操作方法

    这篇文章主要介绍了mongodb禁止外网访问及添加账号的操作方法,需要的朋友可以参考下
    2017-12-12
  • MongoDB超大块数据问题解决

    MongoDB超大块数据问题解决

    这篇文章主要为大家介绍了MongoDB超大块数据问题的技术瓶颈解决方法，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
    2023-02-02
  • MongoDB卸载安装的详细安装教程

    MongoDB卸载安装的详细安装教程

    MongoDB是一个是一个基于分布式文件存储的数据库,下面这篇文章主要给大家介绍了关于MongoDB卸载安装的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2023-04-04
  • MongoDB 常用的crud操作语句

    MongoDB 常用的crud操作语句

    本篇介绍了 MongoDB 的基本 CRUD 操作，可以看到 MongoDB 的语法极其简洁，而且可以使用链式调用的方式进行操作。操作的参数也很固定，且方法名称很明确，上手来说是很容易的
    2021-06-06
  • MongoDB aggregate 运用篇个人总结

    MongoDB aggregate 运用篇个人总结

    最近一直在用mongodb，有时候会需要用到统计，在网上查了一些资料，最适合用的就是用aggregate，以下介绍一下自己运用的心得
    2016-11-11

最新评论

?


http://www.vxiaotou.com