JavaScript의 setUTCFullYear() 메서드는 표준시(Universal Time, UTC)를 기준으로 특정 Date 객체의 전체 연도를 설정하는 데 사용됩니다. 이 메서드를 활용하면 현지 시간대와 무관하게 UTC 기준으로 연도를 정확하게 변경할 수 있습니다.
setUTCFullYear() 메서드의 매개변수
메서드의 사용 형식은 다음과 같습니다.
setUTCFullYear(yearValue[, monthValue[, dayValue]])
- yearValue – 설정할 연도를 나타내는 정수입니다. 예를 들어 2008처럼 네 자리 숫자로 지정합니다.
- monthValue – 월을 나타내는 0부터 11 사이의 정수입니다. 0은 1월을, 11은 12월을 의미합니다.
- dayValue – 일을 나타내는 1부터 31 사이의 정수입니다. dayValue 매개변수를 지정하려면 반드시 monthValue도 함께 지정해야 합니다.
사용 예제
다음 코드를 실행하면 표준시(UTC)를 기준으로 지정된 날짜의 연도가 변경되는 것을 확인할 수 있습니다.
<html>
<head>
<title>JavaScript setUTCFullYear Method</title>
</head>
<body>
<script>
var dt = new Date("Aug 28, 2012 23:30:00");
dt.setUTCFullYear(2018);
document.write(dt);
</script>
</body>
</html>실행 결과
위 예제에서는 2012년 8월 28일로 생성된 Date 객체에 setUTCFullYear(2018)을 호출하여 연도만 2018년으로 변경합니다. 따라서 출력 결과는 다음과 같습니다.
Tue Aug 28 2018 23:30:00 GMT+0900 (한국 표준시)
이처럼 setUTCFullYear() 메서드는 월과 일은 그대로 유지한 채 연도 값만 손쉽게 수정할 수 있어, 날짜 계산이나 데이터 처리 시 유용하게 활용됩니다.