협정 세계 표준시(UTC)를 사용하여 Date 개체의 일자값을 설정한다.

인수/파라메터

dateObj : (일자 개체)

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

numDate : (일자)

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

범위는 해당 월의 길이에 따라 1과 31를 포함한 사이의 정수이다.

반환값

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

설명

numDate의 값이 1부터 해당 월 마지막 일까지의 수치이면 그 일자로 설정되고, 그 범위에서 벋어나거나 음수이면 월초부터 계산한 일자로 월을 증감하고, 계산된 월도 범위를 벋어나면 년도가 변경된다.
예를 들어, 저장된 일자가 "Jan 5, 2002"이고 setUTCDate(32)가 호출되면 일자는 "Feb 1, 2002"으로 바뀐다.
현재부터 계산하는 것이 아니라 월초부터 계산하여 설정한다.

특기

현지시간을 사용하는 일자를 설정하려면 setDate 메서드를 사용하라.

간단한 setUTCDate 메서드 예제

<SCRIPT>
var now=new Date(); // 현재 시간을 변수에 할당
document.write('지금은 표준시 일자는 '+(now.getUTCMonth()+1)+'월 '+now.getUTCDate()+'일이다.<BR>');
  // 현재 표준시간으로 월, 일을 출력한다.
now.setUTCDate(32); // 표준시간에 일자를 설정한다.
document.write('설정된 표준시 일자는 '+(now.getUTCMonth()+1)+'월 '+now.getUTCDate()+'일이다.<BR>');
  // 새로 설정된 표준시간으로 월, 일을 출력한다.
document.write('now.setUTCDate(32)='+now.setUTCDate(32)+'<BR>');
document.write('now.getTime()='+now.getTime());