현지시간을 사용하여 Date 개체의 월 값을 설정한다.

인수/파라메터

dateObj : (일자개체)

필수적인 요소이며, 임의의 Date 개체이다.

numMonth : (월)

필수적인 요소이며, 월값에 해당하는 숫자 값이다. 범위는 0과 11을 포함한 사이의 정수이다.

numDate : (일자)

선택적인 요소이며, 일자값에 해당하는 숫자 값이다. 범위는 해당 월의 길이에 따라 1과 31를 포함한 사이의 정수이다.
값을 부여하지 않으면 getDate 메서드를 호출하여 받은 값을 사용한다.

반환값

반환값 iTime는 설정된 시간을 getTime 메서드로 반환받는 1970년 1월 1일 자정과의 시간값 사이의 시간을 밀리초 단위로 나타내는 정수값을 반환한다.

설명

numMonth의 값이 0(=1월)부터 11(=12월)까지의 수치이면 그 월을, 11보다 크거나 음수이면 이에 따라 저장된 년도가 증감한다. 그러나 현재 월에서 변동되는 것이 아니라 해당 년도초부터 계산된다.
예를 들어, 저장된 일자가 "Jan 5, 2002"이고 setMonth(15)가 호출되면 일자는 "Mar 5, 2003"으로 바뀐다.

일자도 해당 월의 길이를 넘치면 넘친만큼 다음 월로 이월 계산되고, 음수이면 해당 일수 만큼 뺀 전월로 설정된다.

특기

협정 세계 표준시(UTC)를 사용하는 월 값을 설정하려면 setUTCMonth 메서드를 사용하라.

간단한 setMonth 메서드 예제

<SCRIPT>
var now=new Date(); // 현재 시간을 변수에 할당
document.write('지금은 현지 일자는 '+(now.getMonth()+1)+'월 '+now.getDate()+'일이다.<BR>'); // 현재 월, 일을 출력한다.
now.setMonth(1,20); // 현지시간에 월, 일을 설정한다.
document.write('설정된 현지 일자는 '+(now.getMonth()+1)+'월 '+now.getDate()+'일이다.<BR>');
  // 새로 설정된 월, 일을 출력한다.
document.write('now.setMonth(1,20)='+now.setMonth(1,20));