MongoDB聚合运算符：$dateAdd

2024-03-04 06:36
文章标签 mongodb 运算符 聚合 dateadd

本文主要是介绍MongoDB聚合运算符：$dateAdd，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

文章目录

    • 语法
    • 使用
      • 时间测量
      • 时区
    • 举例
      • 添加未来日期
      • 根据日期范围筛选
      • 调整夏令时

$dateAdd聚合运算符将Date()对象按指定的时间单位递增。

语法

{$dateAdd: {startDate: <Expression>,unit: <Expression>,amount: <Expression>,timezone: <tzExpression>}
}

返回一个日期对象Date()，startDate可以是任何能被解析为日期、时间戳或对象Id的表达式，这三种类型都会返回Date()对象。

参数字段说明：

|字段|是否必须|描述|
|-|-|
|startDate|是|开始日期（UTC），可以是日期、时间戳或对象Id表达式|
|unit|是|要增加的时间的单位，单位可以是能被解析为下列值的表达式：year、quarter、week、month、day、hour、minute、second、millisecond|
|amount|是|以units为单位，在startDate基础上的增量，amount是可以被解析为整数、小数或双精度数的表达式|
|timezone|否|执行操作的时区，<tzExpression>必须是能被解析为奥尔森时区标识符格式的字符串或UTC偏移量，如果timezone不指定，返回值显示为UTC|

使用

时间测量

MongoDB遵循流行的数据库用法，以 UTC 为时间单位工作。dateAdd表达式总是以 UTC 为起始日期，并以 UTC 为结果返回。如果指定了时区，计算将使用指定的时区进行。当计算涉及夏令时（DST）时，时区尤为重要。

如果单位是一个月或更大，操作会根据该月的最后一天进行调整。例如，在 10 月的最后一天增加一个月，这就是 "月末最后一天 "调整。

{$dateAdd:{startDate: ISODate("2020-10-31T12:10:05Z"),unit: "month",amount: 1}
}

注意：返回的日期ISODate("2020-11-30T12:10:05Z")是30日，而不是 31日，因为11月的天数比10月少。

时区

在<timezone>字段中使用 Olson 时区标识符时，MongoDB 会应用 DST 偏移（如果适用于指定的时区）。

例如，包含以下文件的sales集合：

{"_id" : 1,"item" : "abc","price" : 20,"quantity" : 5,"date" : ISODate("2017-05-20T10:24:51.303Z")
}

下面的聚合说明了 MongoDB 如何处理 Olson 时区标识符的 DST 偏移量。示例使用$hour和$minute操作符返回日期字段的相应部分：

db.sales.aggregate([
{$project: {"nycHour": {$hour: { date: "$date", timezone: "-05:00" }},"nycMinute": {$minute: { date: "$date", timezone: "-05:00" }},"gmtHour": {$hour: { date: "$date", timezone: "GMT" }},"gmtMinute": {$minute: { date: "$date", timezone: "GMT" } },"nycOlsonHour": {$hour: { date: "$date", timezone: "America/New_York" }},"nycOlsonMinute": {$minute: { date: "$date", timezone: "America/New_York" }}}
}])

操作返回以下结果：

{"_id": 1,"nycHour" : 5,"nycMinute" : 24,"gmtHour" : 10,"gmtMinute" : 24,"nycOlsonHour" : 6,"nycOlsonMinute" : 24
}

举例

添加未来日期

shipping集合中包括了顾客订单的日期：

db.shipping.insertMany([{ custId: 456, purchaseDate: ISODate("2020-12-31") },{ custId: 457, purchaseDate: ISODate("2021-02-28") },{ custId: 458, purchaseDate: ISODate("2021-02-26") }]
)

假设正常发货时间为3天。您以在聚合管道中使用$dateAdd来设置3天后的预期交货日期：

db.shipping.aggregate([{$project:{expectedDeliveryDate:{$dateAdd:{startDate: "$purchaseDate",unit: "day",amount: 3}}}},{$merge: "shipping"}])

在$project阶段用$dateAdd将购买日期增加3天后，$merge阶段用 expectedDeliveryDate更新原始文档。

最后得到的文档如下：

{"_id" : ObjectId("603dd4b2044b995ad331c0b2"),"custId" : 456,"purchaseDate" : ISODate("2020-12-31T00:00:00Z"),"expectedDeliveryDate" : ISODate("2021-01-03T00:00:00Z")
}
{"_id" : ObjectId("603dd4b2044b995ad331c0b3"),"custId" : 457,"purchaseDate" : ISODate("2021-02-28T00:00:00Z"),"expectedDeliveryDate" : ISODate("2021-03-03T00:00:00Z")
}
{"_id" : ObjectId("603dd4b2044b995ad331c0b4"),"custId" : 458,"purchaseDate" : ISODate("2021-02-26T00:00:00Z"),"expectedDeliveryDate" : ISODate("2021-03-01T00:00:00Z")
}

根据日期范围筛选

使用下面的代码更新上一个示例中的shipping集合，在文档中添加交货日期：

db.shipping.updateOne({ custId: 456 },{ $set: { deliveryDate: ISODate( "2021-01-10" ) } }
)db.shipping.updateOne({ custId: 457 },{ $set: { deliveryDate:  ISODate( "2021-03-01" ) } }
)db.shipping.updateOne({ custId: 458 },{ $set: { deliveryDate:  ISODate( "2021-03-02" ) } }
)

下面的聚合查找延迟发货的文档，在$match阶段使用$dateAdd创建一个过滤器，匹配起始点（$purchaseDate）和 $dateAdd 给定的时间段所定义的日期范围内的文档：

db.shipping.aggregate([{$match:{$expr:{$gt:[ "$deliveryDate",{$dateAdd:{startDate: "$purchaseDate",unit: "day",amount: 5}}]}}},{$project:{_id: 0,custId: 1,purchased:{$dateToString:{format: "%Y-%m-%d",date: "$purchaseDate"}},delivery:{$dateToString:{format: "%Y-%m-%d",date: "$deliveryDate"}}}}]
)

$match阶段使用表达式($expr)中的$gt和$dateAdd来比较实际交货日期和预期日期。交货日期比购买日期晚5天以上的文档会被转到$project阶段。

$project阶段使用$dateToString表达式将日期转换为更易读的格式。如果不进行转换，MongoDB将以ISODate格式返回日期。

本例中只返回一条记录：

{ "custId" : 456, "purchased" : "2020-12-31", "delivery" : "2021-01-10" }

调整夏令时

所有日期在内部都以UTC时间存储。如果指定了时区，$dateAdd将使用当地时间进行计算。计算结果以UTC显示。

本例假如客户分布在多个时区，按天或按小时计费，现在要了解夏令时对计费期的影响。

创建billing集合：

db.billing.insertMany([{location: "America/New_York",login: ISODate("2021-03-13T10:00:00-0500"),logout: ISODate("2021-03-14T18:00:00-0500")},{location: "America/Mexico_City",login: ISODate("2021-03-13T10:00:00-00:00"),logout: ISODate("2021-03-14T08:00:00-0500")}]
)

首先，在每个文档中的login日期上添加1天，然后添加24小时。

db.billing.aggregate([{$project:{_id: 0,location: 1,start:{$dateToString:{format: "%Y-%m-%d %H:%M",date: "$login"}},days:{$dateToString:{format: "%Y-%m-%d %H:%M",date:{$dateAdd:{startDate: "$login",unit: "day",amount: 1,timezone: "$location"}}}},hours:{$dateToString:{format: "%Y-%m-%d %H:%M",date:{$dateAdd:{startDate: "$login",unit: "hour",amount: 24,timezone: "$location"}}}},startTZInfo:{$dateToString:{format: "%Y-%m-%d %H:%M",date: "$login",timezone: "$location"}},daysTZInfo:{$dateToString:{format: "%Y-%m-%d %H:%M",date:{$dateAdd:{startDate: "$login",unit: "day",amount: 1,timezone: "$location"}},timezone: "$location"}},hoursTZInfo:{$dateToString:{format: "%Y-%m-%d %H:%M",date:{$dateAdd:{startDate: "$login",unit: "hour",amount: 24,timezone: "$location"}},timezone: "$location"}},}}]
).pretty()

$dateToString表达式对输出进行了重新格式化，以提高可读性。结果汇总如下：

|字段|纽约|墨西哥城|
|-|-|
|start|2021-03-13 15:00|2021-03-13 10:00|
|Start, TZ Info|2021-03-13 10:00|2021-03-13 04:00|
|1 Day|2021-03-14 14:00|2021-03-14 10:00|
|1 Day, TZ Info|2021-03-14 10:00|2021-03-14 04:00|
|24 Hours|2021-03-14 15:00|2021-03-14 10:00|
|24 Hours, TZ Info|2021-03-14 11:00|2021-03-14 04:00|

上表强调了几点：

  • 未格式化的日期以 UTC 返回。纽约的$login是 UTC -5，但开始、天数和小时行显示的时间是 UTC 时间。

  • 3月14日是纽约的夏令时开始日，但不是墨西哥的夏令时开始日。当某地切换到DST并从某一天跨入下一天时，计算的时间会进行调整。

  • 夏令时改变的是一天的长度，而不是小时。夏令时不会改变小时数。只有当测量单位为日或更大且计算跨越指定时区的时钟变化时，才会对 DST 进行调整。

这篇关于MongoDB聚合运算符：$dateAdd的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/772291。

相关文章

基于MongoDB实现文件的分布式存储

基于MongoDB实现文件的分布式存储

《基于MongoDB实现文件的分布式存储》分布式文件存储的方案有很多,今天分享一个基于mongodb数据库来实现文件的存储,mongodb支持分布式部署,以此来实现文件的分布式存储,需要的朋友可以参考... 目录一、引言二、GridFS 原理剖析三、Spring Boot 集成 GridFS3.1 添加依赖
阅读更多...
Kotlin运算符重载函数及作用场景

Kotlin运算符重载函数及作用场景

《Kotlin运算符重载函数及作用场景》在Kotlin里,运算符重载函数允许为自定义类型重新定义现有的运算符(如+-…)行为,从而让自定义类型能像内置类型那样使用运算符,本文给大家介绍Kotlin运算... 目录基本语法作用场景类对象数据类型接口注意事项在 Kotlin 里，运算符重载函数允许为自定义类型重
阅读更多...
Python中的Walrus运算符分析示例详解

Python中的Walrus运算符分析示例详解

《Python中的Walrus运算符分析示例详解》Python中的Walrus运算符（:=）是Python3.8引入的一个新特性,允许在表达式中同时赋值和返回值,它的核心作用是减少重复计算,提升代码简... 目录1. 在循环中避免重复计算2. 在条件判断中同时赋值变量3. 在列表推导式或字典推导式中简化逻辑
阅读更多...
关于MongoDB图片URL存储异常问题以及解决

关于MongoDB图片URL存储异常问题以及解决

《关于MongoDB图片URL存储异常问题以及解决》：本文主要介绍关于MongoDB图片URL存储异常问题以及解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐... 目录MongoDB图片URL存储异常问题项目场景问题描述原因分析解决方案预防措施js总结MongoDB图
阅读更多...
Java逻辑运算符之&&、|| 与&、 |的区别及应用

Java逻辑运算符之&&、|| 与&、 |的区别及应用

《Java逻辑运算符之&&、||与&、|的区别及应用》：本文主要介绍Java逻辑运算符之&&、||与&、|的区别及应用的相关资料,分别是&&、||与&、|,并探讨了它们在不同应用场景中... 目录前言一、基本概念与运算符介绍二、短路与与非短路与：&& 与 & 的区别1. &&：短路与（AND）2. &：非短
阅读更多...
Go Mongox轻松实现MongoDB的时间字段自动填充

Go Mongox轻松实现MongoDB的时间字段自动填充

《GoMongox轻松实现MongoDB的时间字段自动填充》这篇文章主要为大家详细介绍了Go语言如何使用mongox库,在插入和更新数据时自动填充时间字段,从而提升开发效率并减少重复代码,需要的可以... 目录前言时间字段填充规则Mongox 的安装使用 Mongox 进行插入操作使用 Mongox 进行更
阅读更多...
使用Python实现操作mongodb详解

使用Python实现操作mongodb详解

《使用Python实现操作mongodb详解》这篇文章主要为大家详细介绍了使用Python实现操作mongodb的相关知识,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录一、示例二、常用指令三、遇到的问题一、示例from pymongo import MongoClientf
阅读更多...
使用MongoDB进行数据存储的操作流程

使用MongoDB进行数据存储的操作流程

《使用MongoDB进行数据存储的操作流程》在现代应用开发中,数据存储是一个至关重要的部分,随着数据量的增大和复杂性的增加,传统的关系型数据库有时难以应对高并发和大数据量的处理需求,MongoDB作为... 目录什么是MongoDB？MongoDB的优势使用MongoDB进行数据存储1. 安装MongoDB
阅读更多...
Jenkins构建Maven聚合工程，指定构建子模块

Jenkins构建Maven聚合工程，指定构建子模块

一、设置单独编译构建子模块 配置： 1、Root POM指向父pom.xml 2、Goals and options指定构建模块的参数： mvn -pl project1/project1-son -am clean package 单独构建project1-son项目以及它所依赖的其它项目。 说明： mvn clean package -pl 父级模块名/子模块名 -am参数
阅读更多...
【重学 MySQL】十九、位运算符的使用

【重学 MySQL】十九、位运算符的使用

【重学 MySQL】十九、位运算符的使用 示例检查权限添加权限移除权限 在 MySQL 中，位运算符允许你直接在整数类型的列或表达式上进行位级操作。这些操作对于处理那些需要在二进制表示上进行直接修改或比较的场景特别有用，比如权限管理、状态标记等。 &（位与） 对两个数的二进制表示进行位与操作。只有两个相应的二进制位都为 1 时，结果的该位才为 1，否则为 0。 |（位
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2