JavaScript에는 날짜와 시간을 다루기 위한 Date 객체가 기본으로 내장되어 있습니다. Date 객체는 new Date() 생성자를 통해 아래와 같이 생성할 수 있습니다.
Date 객체가 한 번 생성되면, 이 객체에 대해 다양한 작업을 수행할 수 있는 여러 메서드를 사용할 수 있습니다. 대부분의 메서드는 객체의 연도, 월, 일, 시, 분, 초, 밀리초 필드를 현지 시간(local time) 또는 UTC(협정 세계시, GMT) 기준으로 가져오거나 설정하는 역할을 합니다.
Date 객체의 setMinutes() 함수는 분(minute)을 나타내는 정수 값을 인수로 받아, 현재 날짜 객체의 '분' 값을 해당 값으로 대체합니다.
문법(Syntax)
setMinutes() 함수의 기본 문법은 다음과 같습니다.
dateObj.setMinutes();
예제 1 – 기본 사용법
아래 예제에서는 Date 객체를 생성한 후, setMinutes() 함수를 사용하여 '분' 값을 변경하는 과정을 보여줍니다.
<html>
<head>
<title>JavaScript Example</title>
</head>
<body>
<script type="text/javascript">
var dateObj = new Date('september 26, 89 5:4:25:96');
document.write("Current date: "+dateObj.toUTCString());
document.write("<br>");
dateObj.setMinutes(12);
document.write("Date after setting the minutes: "+dateObj.toUTCString());
</script>
</body>
</html>실행 결과
Current date: Mon, 25 Sep 1989 23:34:25 GMT Date after setting the minutes: Mon, 25 Sep 1989 23:42:25 GMT
위 결과에서 볼 수 있듯이, 원래 34분이었던 시간이 setMinutes(12) 호출 후 42분으로 변경된 것을 확인할 수 있습니다.
예제 2 – 분 값이 없는 날짜 객체에 설정하기
Date 객체를 생성할 때 분 값을 지정하지 않았더라도, setMinutes() 함수를 사용하면 나중에 얼마든지 분 값을 설정할 수 있습니다.
<html>
<head>
<title>JavaScript Example</title>
</head>
<body>
<script type="text/javascript">
var dateObj = new Date('september 26, 1989');
dateObj.setMinutes(15);
document.write(dateObj.toString());
</script>
</body>
</html>실행 결과
Tue Sep 26 1989 00:15:00 GMT+0530 (India Standard Time)
예제 3 – 현재 날짜 객체에 적용하기
같은 방식으로, 생성자에 아무 값도 전달하지 않고 Date 객체를 생성한 경우에도 setMinutes() 함수를 사용해 분 값을 설정할 수 있습니다. 이때 월, 일, 연도 등 나머지 값들은 현재 날짜(및 시간)의 값이 그대로 유지됩니다.
<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)
참고 사항
setMinutes() 함수는 선택적으로 두 번째 인수로 초(seconds), 세 번째 인수로 밀리초(milliseconds)를 함께 전달할 수도 있습니다. 또한 범위를 벗어난 값(예: 60 이상의 분 값)을 입력하면 자동으로 시(hour) 단위로 올림 처리되므로, 유연하게 활용할 수 있다는 점도 기억해 두면 좋습니다.