JavaScript의 Date 객체는 언어에 기본적으로 내장된 데이터 타입으로, 아래와 같이 new Date() 생성자를 통해 생성할 수 있습니다.
Date 객체가 생성되면 다양한 메서드를 사용해 객체를 조작할 수 있습니다. 대부분의 메서드는 현지 시간(Local Time) 또는 UTC(협정 세계시, GMT) 기준으로 연도, 월, 일, 시, 분, 초, 밀리초 필드를 읽거나 설정하는 역할을 합니다.
그중 setUTCMinutes() 메서드는 분을 나타내는 정수를 인수로 받아, 현재 날짜(시간)의 분 값을 세계 표준시(UTC) 기준으로 교체합니다.
문법(Syntax)
dateObj.setUTCMinutes(minutesValue);
매개변수
minutesValue: 0~59 사이의 정수로, 설정할 분 값을 지정합니다.
secondsValue (선택): 0~59 사이의 정수로, 초 값을 함께 변경할 수 있습니다.
msValue (선택): 0~999 사이의 정수로, 밀리초 값을 함께 변경할 수 있습니다.
예제 1 – 기본 사용법
다음 예제에서는 날짜 객체를 생성한 뒤, setUTCMinutes()를 호출하여 분 값을 58로 변경합니다.
<html>
<head>
<title>JavaScript Example</title>
</head>
<body>
<script type="text/javascript">
var dateObj = new Date('september 26, 89 12:4:25:96');
document.write("Current date: "+dateObj.toUTCString());
document.write("<br>");
dateObj.setUTCMinutes(58);
document.write("Value of minutes after modification: "+dateObj.toUTCString());
</script>
</body>
</html>실행 결과
Current date: Tue, 26 Sep 1989 06:34:25 GMT Value of minutes after modification: Tue, 26 Sep 1989 06:58:25 GMT
예제 2 – 분 값 없이 생성한 날짜 객체에 분 설정하기
날짜 객체를 생성할 때 분 값을 지정하지 않았더라도, setUTCMinutes() 메서드를 사용하면 세계 표준시 기준으로 분 값을 자유롭게 설정할 수 있습니다.
<html>
<head>
<title>JavaScript Example</title>
</head>
<body>
<script type="text/javascript">
var dateObj = new Date('September 26, 1989');
dateObj.setUTCMinutes(15);
document.write(dateObj.toString());
</script>
</body>
</html>실행 결과
Tue Sep 26 1989 00:15:00 GMT+0530 (India Standard Time)
예제 3 – 현재 시간 기준으로 분 설정하기
마찬가지로 생성자에 아무 값도 전달하지 않고 날짜 객체를 생성한 경우에도 이 메서드를 사용해 분 값을 설정할 수 있으며, 이때 연도, 월, 일 등 나머지 값들은 현재 날짜(시간) 그대로 유지됩니다.
<html> <head> <title>JavaScript Example</title> </head> <body> <script type="text/javascript"> var dateObj = new Date(); dateObj.setMinutes(15); document.write(dateObj.toString()); </script> </body> </html>
실행 결과
Thu Oct 18 2018 22:15:48 GMT+0530 (India Standard Time)
정리
setUTCMinutes()는 UTC 기준으로 분 값을 변경할 때 사용하며, 현지 시간 기준으로 변경하고 싶다면 setMinutes()를 사용하면 됩니다. 두 메서드의 차이를 이해하면 시간대(timezone)와 관련된 날짜 처리 작업을 훨씬 안전하게 수행할 수 있습니다.