$dateAdd

$dateAdd 运算符将指定的时间单位数添加到日期。 在需要基于给定日期和时间间隔计算未来日期的情况下,它非常有用。

语法

$dateAdd: {
   startDate: <expression>,
   unit: <string>,
   amount: <number>,
   timezone: <string>  // Optional
}

参数

参数 说明
startDate 添加作的开始日期。
unit 要添加的时间单位。 有效单位包括:year、、、quartermonthweekdayhourminute、。 secondmillisecond
amount 要添加的单位数。
timezone 可选。 用于作的时区。

例子

让我们了解 stores 数据集中的示例 json 的用法。

{
  "_id": "e6410bb3-843d-4fa6-8c70-7472925f6d0a",
  "name": "Relecloud | Toy Collection - North Jaylan",
  "location": {
    "lat": 2.0797,
    "lon": -94.4134
  },
  "staff": {
    "employeeCount": {
      "fullTime": 7,
      "partTime": 4
    }
  },
  "sales": {
    "salesByCategory": [
      {
        "categoryName": "Educational Toys",
        "totalSales": 3299
      }
    ],
    "revenue": 3299
  },
  "promotionEvents": [
    {
      "eventName": "Massive Markdown Mania",
      "promotionalDates": {
        "startDate": {
          "Year": 2024,
          "Month": 9,
          "Day": 21
        },
        "endDate": {
          "Year": 2024,
          "Month": 9,
          "Day": 29
        }
      },
      "discounts": [
        {
          "categoryName": "Remote Control Toys",
          "discountPercentage": 6
        },
        {
          "categoryName": "Building Sets",
          "discountPercentage": 21
        }
      ]
    }
  ],
  "company": "Relecloud",
  "city": "North Jaylan",
  "lastUpdated": {
    "$timestamp": {
      "t": 1733313006,
      "i": 1
    }
  },
  "storeOpeningDate": "2024-09-05T11:50:06.549Z"
}

示例 1:向日期添加天数

查询项目 eventName 并计算一个 newEndDate ,方法是将 7 天添加到从嵌套年份、月和日字段构造的日期。 结果是一个简化的文档,其中显示了事件名称和其扩展结束日期。

db.stores.aggregate([
  { $match: { _id: "e6410bb3-843d-4fa6-8c70-7472925f6d0a" } },
  { $unwind: "$promotionEvents" },
  { $unwind: "$promotionEvents.promotionalDates" },
  {
    $project: {
      eventName: 1,
      newEndDate: {
        $dateAdd: {
          startDate: {
            $dateFromParts: {
              year: "$promotionEvents.promotionalDates.endDate.Year",
              month: "$promotionEvents.promotionalDates.endDate.Month",
              day: "$promotionEvents.promotionalDates.endDate.Day"
            }
          },
          unit: "day",
          amount: 7
        }
      }
    }
  }
])

该查询返回每个事件的 eventName 以及一个在嵌套升级数据中指定的原始 endDate 7 天后的新EndDate。

{
  "_id": "e6410bb3-843d-4fa6-8c70-7472925f6d0a",
  "newEndDate": "2024-10-06T00:00:00.000Z"
}

示例 2:将月份添加到日期

聚合查询通过向嵌套提升字段重新构造的开始日期添加 1 个月来投影 eventName 并计算 newStartDate。 它有助于根据原始计划确定调整的事件开始日期。

db.stores.aggregate([
  { $match: { _id: "e6410bb3-843d-4fa6-8c70-7472925f6d0a" } },
  { $unwind: "$promotionEvents" },
  { $unwind: "$promotionEvents.promotionalDates" },
  {
    $project: {
      eventName: "$promotionEvents.eventName",
      newStartDate: {
        $dateAdd: {
          startDate: {
            $dateFromParts: {
              year: "$promotionEvents.promotionalDates.startDate.Year",
              month: "$promotionEvents.promotionalDates.startDate.Month",
              day: "$promotionEvents.promotionalDates.startDate.Day"
            }
          },
          unit: "month",
          amount: 1
        }
      }
    }
  }
])

该查询从嵌套升级事件数据返回每个文档的 eventName 和一个 1 个月后的 newStartDate。

{
  "_id": "e6410bb3-843d-4fa6-8c70-7472925f6d0a",
  "eventName": "Massive Markdown Mania",
  "newStartDate": "2024-10-21T00:00:00.000Z"
}