ADD_MONTHS 함수

ADD_MONTHS는 지정한 월 수를 날짜 또는 타임스탬프 값이나 표현식에 더합니다. DATEADD 함수가 이와 유사한 기능을 제공합니다.

명령문

ADD_MONTHS( {date | timestamp}, integer)

인수

date | timestamp

날짜 또는 타임스탬프 열이거나, 혹은 묵시적으로 날짜 또는 타임스탬프로 변환되는 표현식입니다. 날짜가 월의 마지막 날이거나, 혹은 결과에 따른 월이 더 짧은 경우에는 함수가 월의 마지막 날을 결과로 반환합니다. 그 밖에 다른 날짜일 때는 날짜 표현식과 동일한 날의 숫자가 결과로 반환됩니다.

integer

양의 또는 음의 정수입니다. 날짜에서 월을 뺄 때는 음의 정수를 사용합니다.

반환 타입

TIMESTAMP

예

다음은 TRUNC 함수 내에서 ADD_MONTHS 함수를 사용하는 쿼리입니다. TRUNC 함수는 ADD_MONTHS 결과에서 시간 부분을 제거합니다. ADD_MONTHS 함수는 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_MONTHS 함수를 실행할 경우 동작에 대해서 설명하는 예입니다.

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)