JavaScript의 setUTCHours() 메서드는 세계 표준시(UTC)를 기준으로 특정 Date 객체의 '시(hour)' 값을 설정합니다. 현지 시간이 아닌 국제 표준시에 맞춰 시간을 조정해야 할 때 유용하게 사용됩니다.
setUTCHours() 메서드의 매개변수
메서드의 기본 문법은 다음과 같습니다.
setUTCHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])
- hoursValue – 시(hour)를 나타내는 정수로, 0부터 23 사이의 값입니다.
- minutesValue – 분(minutes)을 나타내는 정수로, 0부터 59 사이의 값입니다.
- secondsValue – 초(seconds)를 나타내는 정수로, 0부터 59 사이의 값입니다. 이 매개변수를 사용하려면 minutesValue도 반드시 함께 지정해야 합니다.
- msValue – 밀리초(milliseconds)를 나타내는 숫자로, 0부터 999 사이의 값입니다. 이 매개변수를 사용하려면 minutesValue와 secondsValue도 반드시 함께 지정해야 합니다.
사용 예제
아래 코드를 실행하면 UTC 기준으로 특정 날짜의 시간이 변경되는 것을 확인할 수 있습니다.
<html>
<head>
<title>JavaScript setUTCHours Method</title>
</head>
<body>
<script>
var dt = new Date("Aug 28, 2008 23:30:00");
dt.setUTCHours(15);
document.write(dt);
</script>
</body>
</html>
위 예제에서는 2008년 8월 28일 23시 30분으로 생성된 Date 객체의 시간을 setUTCHours(15)를 통해 UTC 기준 15시로 변경합니다. 실행 결과는 브라우저가 위치한 시간대에 따라 현지 시간으로 변환되어 출력됩니다.