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

인수

dateObj (일자개체)

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

numYear

필수적인 요소이며, 년도 값에 해당하는 숫자 값이다.

numMonth (월)

선택적인 요소이며, 월 값에 해당하는 숫자 값이다. numDate를 사용하면 반드시 사용해야 한다.

numDate (일자)

선택적인 요소이며, 일 값에 해당하는 숫자 값이다.

반환값

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

설명

setFullYear 메서드는 dateObj 일자 개체에 인수에서 지정한 내용에 맞춰 현지 시간을 설정한다.

선택적인 인수를 갖는 모든 set 메서드들은 선택적인 인수를 지정하지 않으면 이에 해당하는 get 메서드에서 반환된 값을 사용한다. 예를 들어, 만일 numMonth 인수가 선택적인 요소이고 이를 지정하지 않으면 Javascript는 getMonth 메서드에서 반환된 값을 사용한다.

또한 인수 값이 범위를 초과하였거나 음수이면 이에 따라 저장된 다른 값들도 계산하여 수정된다.

협정 세계 표준시(UTC)를 사용하는 년도 값, 일자값을 설정하려면 setUTCFullYear 메서드를 사용하라.

일자 개체가 지원하는 년도 범위는 1970년을 전후로 약 285,616년까지이다.

간단한 setFullYear 메서드 예제

<SCRIPT>
var br='<BR>'; // 줄바꿈
var str=''; // 출력 문자열 변수 선언
var now=new Date(); // 현재 시간을 변수에 할당
str+='now.toLocaleString()='+now.toLocaleString()+br;
now.setFullYear(2005,11,25);
str+='now.setFullYear(2005,11,25); 하면'+br;
str+='now.toLocaleString()='+now.toLocaleString()+br;
str+='now.setFullYear(2005,11,25)='+now.setFullYear(2005,11,25)+br;
document.write(str); // 결과 문자열 출력
</SCRIPT>