Date.prototype.setUTCFullYear()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

setUTCFullYear() 메서드는 지정된 날짜의 전체 연도를 표준시에 따라 설정합니다.

시도해보기

const event = new Date("December 31, 1975 23:15:30 GMT-3:00");

console.log(event.getUTCFullYear());
// Expected output: 1976

console.log(event.toUTCString());
// Expected output: "Thu, 01 Jan 1976 02:15:30 GMT"

event.setUTCFullYear(1975);

console.log(event.toUTCString());
// Expected output: "Wed, 01 Jan 1975 02:15:30 GMT"

구문

js
setUTCFullYear(yearValue)
setUTCFullYear(yearValue, monthValue)
setUTCFullYear(yearValue, monthValue, dayValue)

매개변수

yearValue

연도의 숫자 값을 지정하는 정수입니다 (예 : 1995).

monthValue

선택적 입력값. 1월에서 12월까지의 월을 나타내는 0에서 11 사이의 정수입니다.

dayValue

선택적 입력값. 한 달의 날짜를 나타내는 1부터 31사이의 정수입니다. dayValue 매개 변수를 지정하는 경우 monthValue도 지정해야합니다.

반환값

1970년 1월 1일 00:00:00 UTC와 업데이트 된 날짜 사이의 밀리 초 숫자입니다.

설명

monthValuedayValue 매개 변수를 지정하지 않으면 getUTCMonth()getUTCDate() 메소드가 사용됩니다.

지정한 매개 변수가 예상 범위를 벗어난 경우 setUTCFullYear()는 다른 매개 변수와 Date 객체의 날짜 정보를 그에 따라 업데이트하려고 시도합니다. 예를 들어, monthValue에 15를 지정하면 연도가 1(yearValue + 1)만큼 증가하고 3은 해당 월에 사용됩니다.

예제

setUTCFullYear() 사용하기

js
var theBigDay = new Date();
theBigDay.setUTCFullYear(1997);

명세

Specification
ECMAScript® 2025 Language Specification
# sec-date.prototype.setutcfullyear

브라우저 호환성

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
setUTCFullYear

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

같이 보기