JavaScript의 setUTCMilliseconds() 메서드는 협정 세계시(UTC)를 기준으로 지정된 날짜 객체의 밀리초를 설정합니다. 이 메서드를 활용하면 시간대와 관계없이 표준 시간 기준으로 밀리초 값을 일관성 있게 다룰 수 있습니다.
매개변수
setUTCMilliseconds(millisecondsValue) 메서드에서 사용되는 매개변수는 다음과 같습니다.
- millisecondsValue − 설정할 밀리초를 나타내는 0부터 999 사이의 숫자입니다.
만약 이 범위를 벗어나는 값이 전달되면, JavaScript는 초 단위로 자동 넘김(carry-over)하여 날짜와 시간을 조정하므로 별도의 오류가 발생하지 않습니다.
예제
다음 코드를 실행하면 UTC 기준으로 지정된 날짜의 밀리초를 설정하는 방법을 직접 확인할 수 있습니다.
<html> <head> <title>JavaScript setUTCMilliseconds Method</title> </head> <body> <script> var dt = new Date( "Aug 28, 2008 23:30:00" ); dt.setUTCMilliseconds( 1200 ); document.write( dt ); </script> </body> </html>
위 예제에서는 2008년 8월 28일 23시 30분으로 생성된 Date 객체에 대해 setUTCMilliseconds() 메서드를 호출하여 밀리초를 설정한 뒤, 그 결과를 화면에 출력합니다. 전달된 값이 999를 초과하므로 자동으로 초 단위에 반영되어 최종 날짜가 계산됩니다.