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

인수/파라메터

dateObj : (일자 개체)

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

numHr : (시간)

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

numMin : (분)

선택적인 요소이며, 분값에 해당하는 숫자 값이다. 범위는 0과 59를 포함한 사이의 정수이다.
numSec 또는 numMilli를 사용하면 반드시 사용해야 한다.

numSec : (초)

선택적인 요소이며, 초값에 해당하는 숫자 값이다. 범위는 0과 59를 포함한 사이의 정수이다.
numMilli를 사용하면 반드시 사용해야 한다.

numMilli : (밀리초)

선택적인 요소이며, 밀리초값(1/1000초)에 해당하는 숫자 값이다. 범위는 0과 999를 포함한 사이의 정수이다.

반환값

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

설명

하위 인수를 지정하기 위해서는 그보다 상위의 인수들이 지정되어야 한다.

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

각 인수의 범위가 위 지정한 범위를 초과하거나 음수이면 이에따라 계산하여 다른 인수값을 수정하고 자체도 변경된다.
예를 들어, 저장된 일자가 'Sat Jan 1 09:00:00 UTC+0900 2000'이고 setUTCHours(50)가 호출되면 일자는 'Mon Jan 3 11:00:00 UTC+0900 2000'으로 바뀐다.

특기

현지시간을 사용하는 시간값을 설정하려면 setHours 메서드를 사용하라.

간단한 setUTCHours 메서드 예제

<SCRIPT>
var now=new Date(); // 현재 시간을 변수에 할당
document.write('지금은 표준시는 '+now.toUTCString()+'이다.<BR>'); // 표준시 표시 방법으로 출력한다.
now.setUTCHours(10,20,30,40); // 표준시에 시간, 분, 초, 밀리초를 설정한다.
document.write('설정된 표준시는 '+now.toUTCString()+'이다.<BR>'); // 새로 설정된 시각을 표준시 표시 방법으로 출력한다.
document.write('now.setUTCHours(10,20,30,40)='+now.setUTCHours(10,20,30,40));