Addmonths

$addMonths

The $addMonths operator adds a specified number of months to a date object.

Input

• An array containing a date object and an integer number of months to add

Output

• A new date object with the specified number of months added

Examples

Add Months to Date

{
  "$addMonths": [
    {
      "$toDate": ["2023-01-15T10:30:00Z"]
    },
    3
  ]
}

Result: Date object representing April 15, 2023 at 10:30:00 UTC

Add Months to Field Value

{
  "$addMonths": [
    {
      "$input": "start_date"
    },
    {
      "$input": "months_to_add"
    }
  ]
}

Result: A new date with months_to_add added to the start_date field