---
title: "addMonths"
slug: "tools-addmonths"
updated: 2025-11-06T18:59:28Z
published: 2025-11-06T18:59:28Z
canonical: "docs.doc-know.com/tools-addmonths"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doc-know.com/llms.txt
> Use this file to discover all available pages before exploring further.

# addMonths

### tools.addMonths

Returns a DateTime object with a specified number of months added to today's date. Both positive and negative values are supported to either add or subtract the specified amount of time.

### Input Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| **value** | Number | Yes | Number of months to add or subtract |

### Returns

Type: **DateTime**

Returns a new DateTime value with the adjusted time component.

### Examples

```
// returns a new DateTime with 3 months added from today
var date = tools.addMonths(3);
```

```
// returns a new DateTime with 3 months subtracted from today
var date = tools.addMonths(-3);
```

### Remarks

Use this helper function when you want to create offset DateTime values computed from today's date and time.