Mongodb字段更新操作符$currentDate

学习mongodb，体会mongodb的每一个使用细节，欢迎阅读威赞的文章。这是威赞发布的第54篇mongodb技术文章，欢迎浏览本专栏威赞发布的其他文章。

本文基于Mongodb的官方文档，整理了Mongodb字段更新操作符$currentDate的定义，语法，行为和操作用例，以供参考。

定义

Mongodb支持使用操作符$currentDate更新字段为当前时间。默认更新成Date类型的时间。但也支持将字段更新成为timestamp. 当字段不存在时，向更新的文档中添加字段并更新成当前时间。

语法

数据库操作人员在UPDATE语句中，通过下面的语法将字段更新成当前时间

{$currentDate: {<field1>: <typeSpecification1>, ...}}

其中可以使用下面中的任意一种形式：

• 使用布尔类型的true,将指定的字段设置为当前时间。
• 指定当前时间类型的文档，{$type: "timestamp"}或{$type: "date"}.其中$type类型中指定的字符串是大小写敏感的，并且只接受小写类型的字符串。

当指定的字段名称是嵌入式文档或位于数组当中时，需要使用点操作符（'.'）

行为

从mongodb5.0开始，更新操作的顺序按照文档字段名的字母表顺序执行。带有数字名称的字段，按照数字顺序更新。

如下面的更新语句中, 字段"a.2"在"a.10"前更新。因为数字2排列在数字10前。

{$set: { "a.2": <new value>, "a.10": <new value>}}

使用$currentDate更新字段时 ，获取到的时间是$currentDate的执行时间。

如果字段不存在 ，$currentDate向文档中添加该字段。

mongodb 5.0版本以后，向$currentDate传入空表达式({ })时，mongodb不再抛出错误。空表达式不会修改字段值 ，也不会在oplog中，添加新的操作记录。

应用举例

创建一个customers集合并插入一条数据。

db.customers.insertOne({
    _id: 1, status: "a", lastModified: ISODate("2013-10-02T01:11:18.965Z")
})

构建一条数据更新语句，要求添加cancellation文档字段，包含字段date和reason。其中，date字段是脚本执行时间。 修改字段status的值为"D"。同时将lastModified更新为脚本执行时间。

db.customers.updateOne(
    {_id: 1},
    {
        $currentDate: {
            lastModified: true,
            "cancellation.date":{ $type: "timestamp"}
        },
        $set:  {
            "cancellation.reason": "user request",
            status: "D"
        }
    }
)

查看更新结果

db.customers.find()
{
	"_id" : 1,
	"status" : "D",
	"lastModified" : ISODate("2024-04-01T15:57:28.663+08:00"),
	"cancellation" : {
		"date" : Timestamp(1711957959, 1),
		"reason" : "user request"
	}
}

自mongodb 4.2版本开始，也支持使用聚合操作来更新数据。其中CLUSTERTIME只在复制集和分片集中使用。

NOW和$$CLUSTER_TIME在聚合管道中返回相同的时间戳。

db.customers.updateOne(
    { _id: 1 },
    [
        {$set: {lastModified: "$$NOW", cancellation:  {date: "$$CLUSTER_TIME", reason: "user request"}, status: "D"}}        
    ]
)