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

인수/파라메터

dateObj : (일자 개체)

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

numSec : (초)

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

numMilli : (밀리초)

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

반환값

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

설명

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

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

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

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

각 인수의 범위가 위 지정한 범위를 초과하거나 음수이면 이에따라 계산하여 다른 인수값을 수정하고 자체도 변경된다.
예를 들어, 저장된 일자가 "Jan 5, 1996 00:00:00"이고 setSeconds(150)가 호출되면 일자는 "Jan 5, 1996 00:02:30"로 바뀐다. 음수값도 같은 방법으로 처리된다.

특기

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

간단한 setSeconds 메서드 예제

<SCRIPT>
var now=new Date(); // 현재 시간을 변수에 할당
document.write('지금은 현지시간 '+now+'이다.<BR>'); // 문자열로 출력한다. toString()이 없더도 디폴트 문자열로 출력된다.
now.setSeconds(100,100);
  // 현지시간에 초, 밀리초를 설정한다. 초값을 지정하는 인수가 60이 넘으므로 40이 되고 분이 1 증가된다.
document.write('설정된 현지시간 '+now.toString()+'이다.<BR>'); // 새로 설정된 시각을 문자열로 출력한다.
document.write('now.setSeconds(100,100)='+now.setSeconds(100,100));