JavaScript의 Date 객체는 언어에 기본으로 내장된 데이터 타입으로, 날짜와 시간을 다룰 때 필수적으로 사용됩니다. Date 객체는 아래와 같이 new Date() 생성자를 통해 만들 수 있습니다.
var dateObj = new Date();
Date 객체가 한 번 생성되면, 이후에는 다양한 메서드를 사용해 객체를 조작할 수 있습니다. 대부분의 메서드는 현지 시간(local time) 또는 UTC(협정 세계시, GMT) 기준으로 객체의 연도, 월, 일, 시, 분, 초, 밀리초 값을 읽거나 설정하는 역할을 합니다.
그중 getUTCMilliseconds() 메서드는 지정된 날짜의 밀리초를 UTC(세계 표준시) 기준으로 반환합니다.
문법(Syntax)
기본 문법은 다음과 같습니다.
dateObj.getUTCMilliseconds();
이 메서드는 매개변수를 받지 않으며, 0부터 999 사이의 정수를 반환합니다.
예제 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.getUTCMilliseconds());
</script>
</body>
</html>출력 결과
96
예제 2: 밀리초를 지정하지 않은 경우
날짜 객체를 생성할 때 밀리초를 지정하지 않으면, 이 함수는 UTC 기준으로 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.getUTCMilliseconds());
</script>
</body>
</html>출력 결과
0
예제 3: 인자 없이 생성한 경우 (현재 시간)
생성자에 아무 값도 전달하지 않고 Date 객체를 만들면, 현재 시각이 자동으로 설정되며 이 함수는 현재 시점의 밀리초를 UTC 기준으로 반환합니다.
<html>
<head>
<title>JavaScript Example</title>
</head>
<body>
<script type="text/javascript">
var dateObj = new Date();
document.write("Current milliseconds: "+dateObj.getUTCMilliseconds());
</script>
</body>
</html>출력 결과
Current milliseconds: 226
예제 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.getUTCMilliseconds());
</script>
</body>
</html>출력 결과
Current milliseconds: 0
참고: 관련 메서드
getMilliseconds()– 현지 시간 기준으로 밀리초를 반환합니다.setUTCMilliseconds()– UTC 기준으로 밀리초 값을 설정합니다.
UTC 기준 메서드는 서버 간 시간 동기화, 로그 타임스탬프 처리 등 시간대(timezone)에 영향을 받지 않아야 하는 상황에서 특히 유용합니다.