Baseline Widely available
The setUTCFullYear()
method of Date
instances changes the year for this date according to universal time.
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"
Syntax
setUTCFullYear(yearValue)
setUTCFullYear(yearValue, monthValue)
setUTCFullYear(yearValue, monthValue, dateValue)
Parameters
yearValue
An integer representing the year. For example, 1995.
monthValue
Optional
An integer representing the month: 0 for January, 1 for February, and so on.
dateValue
Optional
An integer between 1 and 31 representing the day of the month. If you specify dateValue
, you must also specify monthValue
.
Changes the Date
object in place, and returns its new timestamp. If a parameter is NaN
(or other values that get coerced to NaN
, such as undefined
), the date is set to Invalid Date and NaN
is returned.
If you do not specify the monthValue
and dateValue
parameters, the values returned from the getUTCMonth()
and getUTCDate()
methods are used.
If a parameter you specify is outside of the expected range, setUTCFullYear()
attempts to update the other parameters and the date information in the Date
object accordingly. For example, if you specify 15 for monthValue
, the year is incremented by 1 (yearValue + 1
), and 3 is used for the month.
const theBigDay = new Date();
theBigDay.setUTCFullYear(1997);
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4