本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# ADD\$1MONTHS 函數
<a name="ADD_MONTHS"></a>

ADD\$1MONTHS 會將指定幾個月新增至日期或時間戳記值或運算式。[DATE\$1ADD](DATE_ADD_function.md) 函數提供類似功能。

## 語法
<a name="ADD_MONTHS-synopsis"></a>

```
ADD_MONTHS( {date | timestamp}, integer)
```

## 引數
<a name="ADD_MONTHS-arguments"></a>

 *date* \$1 *timestamp*   
日期或時間戳記欄，或隱含轉換為日期或時間戳記的表達式。如果日期是某個月的最後一天，或者如果產生的月份是較短的月份，則函數會在結果中傳回該月的最後一天。若是其他日期，結果會包含與日期表達式一樣的相同天數。

 *integer*   
正或負整數。使用負數可減少日期中的月份。

## 傳回類型
<a name="ADD_MONTHS-return-type"></a>

TIMESTAMP

## 範例
<a name="ADD_MONTHS-example"></a>

以下查詢會使用 TRUNC 函數中的 ADD\$1MONTHS 函數。TRUNC 函數會從 ADD\$1MONTHS 結果移除某日時間。ADD\$1MONTHS 函數會從 CALDATE 欄中新增 12 個月至每個值。

```
select distinct trunc(add_months(caldate, 12)) as calplus12,
trunc(caldate) as cal
from date
order by 1 asc;

 calplus12  |    cal
------------+------------
 2009-01-01 | 2008-01-01
 2009-01-02 | 2008-01-02
 2009-01-03 | 2008-01-03
...
(365 rows)
```

下列範例示範當 ADD\$1MONTHS 函數對含有月份的日期進行操作的行為，而這些月份的天數皆不同時。

```
select add_months('2008-03-31',1);

add_months
---------------------
2008-04-30 00:00:00
(1 row)

select add_months('2008-04-30',1);

add_months
---------------------
2008-05-31 00:00:00
(1 row)
```