JavaScript의 setUTCDate() 메서드는 세계 표준시(UTC)를 기준으로 특정 Date 객체의 '일(day)'을 설정하는 데 사용됩니다. 현지 시간이 아닌 UTC 기준으로 날짜를 조정해야 할 때 유용하게 활용할 수 있습니다.
setUTCDate() 메서드의 매개변수
setUTCDate(dayValue) 메서드는 다음과 같은 매개변수를 사용합니다.
- dayValue – 해당 월의 일을 나타내는 1부터 31 사이의 정수입니다.
사용 예제
아래 코드를 실행하면 UTC 기준으로 지정된 날짜의 일을 설정할 수 있습니다.
<html> <head> <title>JavaScript setUTCDate Method</title> </head> <body> <script> var dt = new Date( "Oct 15, 2017 23:30:00" ); dt.setUTCDate( 20 ); document.write( dt ); </script> </body> </html>
실행 결과
위 예제에서는 2017년 10월 15일 23:30:00으로 생성된 Date 객체의 일을 20일로 변경합니다. 따라서 출력 결과는 다음과 같습니다.
Sun Oct 20 2017 23:30:00 GMT+0900 (Korean Standard Time)
이처럼 setUTCDate() 메서드를 사용하면 기존 Date 객체의 연도와 월은 그대로 유지한 채, 일(day)만 손쉽게 변경할 수 있습니다. 참고로 1~31 범위를 벗어난 값을 입력하면 JavaScript가 자동으로 월 단위를 조정하여 계산하므로, 예를 들어 32를 입력하면 다음 달 1일로 설정됩니다.