JavaScript의 Date 객체는 언어에 기본으로 내장된 데이터 타입입니다. Date 객체는 아래와 같이 new Date() 생성자를 사용하여 만들 수 있습니다.
Date 객체가 한 번 생성되면 다양한 메서드를 통해 객체를 조작할 수 있습니다. 대부분의 메서드는 현지 시간(local time) 또는 UTC(협정 세계시, GMT)를 기준으로 연도, 월, 일, 시, 분, 초, 밀리초 필드를 읽거나 설정하는 역할을 합니다.
그중 getMilliseconds() 메서드는 해당 날짜 객체의 밀리초(millisecond) 값을 반환합니다.
문법(Syntax)
getMilliseconds() 메서드의 기본 문법은 다음과 같습니다.
dateObj.getMilliseconds();
예제 1 – 기본 사용법
날짜 문자열에 밀리초가 포함된 경우, 해당 값을 그대로 반환합니다.
<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(dateObj.getMilliseconds());
</script>
</body>
</html>실행 결과
96
예제 2 – 밀리초를 지정하지 않은 경우
Date 객체를 생성할 때 밀리초를 명시하지 않으면 이 메서드는 0을 반환합니다.
<html>
<head>
<title>JavaScript Example</title>
</head>
<body>
<script type="text/javascript">
var dateObj = new Date('september 26, 89 04:50:12');
document.write(dateObj.getMilliseconds());
</script>
</body>
</html>실행 결과
0
예제 3 – 인자 없이 현재 시간으로 생성한 경우
생성자에 아무 값도 전달하지 않고 Date 객체를 만들면, 이 메서드는 현재 시각의 밀리초를 반환합니다.
<html>
<head>
<title>JavaScript Example</title>
</head>
<body>
<script type="text/javascript">
var dateObj = new Date();
document.write("Current milliseconds: "+dateObj.getMilliseconds());
</script>
</body>
</html>실행 결과
Current milliseconds: 504
예제 4 – 범위를 벗어난 값의 처리
JavaScript에서 밀리초의 유효 범위는 0부터 999까지입니다. 이 범위를 벗어나는 값을 사용하면 이 메서드는 0을 반환합니다.
<html>
<head>
<title>JavaScript Example</title>
</head>
<body>
<script type="text/javascript">
var dateObj = new Date('september 26, 89 04:50:12:1035');
document.write("Current milliseconds: "+dateObj.getMilliseconds());
</script>
</body>
</html>실행 결과
Current milliseconds: 0
정리
getMilliseconds() 메서드는 Date 객체에서 0~999 사이의 밀리초 값을 손쉽게 추출할 수 있는 유용한 도구입니다. 밀리초가 지정되지 않았거나 유효 범위를 벗어난 경우에는 0이 반환된다는 점을 기억해 두면, 시간 기반 로직을 작성할 때 예상치 못한 오류를 방지할 수 있습니다.