JavaScript의 setUTCMinutes() 메서드는 지정된 Date 객체의 분(minute) 값을 협정 세계시(UTC) 기준으로 설정합니다. 현지 시간대가 아닌 표준시를 기준으로 분을 변경해야 할 때 유용하게 사용됩니다.
setUTCMinutes() 메서드의 매개변수
메서드의 기본 문법은 setUTCMinutes(minutesValue[, secondsValue[, msValue]])이며, 각 매개변수는 다음과 같습니다.
- minutesValue – 분을 나타내는 0부터 59 사이의 정수입니다.
- secondsValue – 초를 나타내는 0부터 59 사이의 정수입니다. 이 매개변수를 지정하려면 minutesValue도 반드시 함께 지정해야 합니다.
- msValue – 밀리초를 나타내는 0부터 999 사이의 숫자입니다. 이 매개변수를 지정하려면 minutesValue와 secondsValue도 반드시 함께 지정해야 합니다.
참고로, 지정한 값이 허용 범위를 벗어나면 JavaScript가 자동으로 시간 단위를 올려 계산합니다. 예를 들어 분 값으로 85를 지정하면 1시간 25분으로 처리되어 시간이 한 시간 늘어납니다.
사용 예제
다음 코드를 실행하면 UTC 기준으로 특정 날짜의 분을 설정하는 방법을 확인할 수 있습니다.
<html>
<head>
<title>JavaScript setUTCMinutes Method</title>
</head>
<body>
<script>
var dt = new Date( "Aug 28, 2008 13:30:00" );
dt.setUTCMinutes( 85 );
document.write( dt );
</script>
</body>
</html>
실행 결과
위 예제에서는 분 값으로 85를 설정했습니다. 이 값은 0~59 범위를 초과하기 때문에 자동으로 시간이 조정되어, 원래 13시 30분이던 시각은 2008년 8월 28일 목요일 오후 2시 55분(14:55)으로 출력됩니다. 이처럼 setUTCMinutes() 메서드는 범위를 넘는 값을 입력해도 오류 없이 날짜와 시간을 알맞게 보정해 줍니다.