JavaScript Date setUTCFullYear()
More "Try it Yourself" examples below.
Definition and Usage
The setUTCFullYear() method sets the year of a date object, according to UTC.
Notes
UTC (Universal Time Coordinated) is the time set by the World Time Standard.
UTC time is the same as GMT time (Greenwich Mean Time).
Browser Support
setUTCFullYear() is an ECMAScript1 (ES1) feature.
ES1 (JavaScript 1997) is fully supported in all browsers:
| Chrome | Edge | Firefox | Safari | Opera | IE |
| Yes | Yes | Yes | Yes | Yes | Yes |
Syntax
Date.setUTCFullYear(year, month, day)
Parameter Values
| Parameter | Description |
|---|---|
| year | Required. A value representing the year, negative values are allowed |
| month | Optional. An integer representing the month
Expected values are 0-11, but other values are allowed:
|
| day | Optional. An integer representing the day of month
Expected values are 1-31, but other values are allowed:
If the month has 31 days:
If the month has 30 days:
|
Return Value
| Type | Description |
|---|---|
| Number | Milliseconds between the date object and midnight January 1 1970 |
Technical Details
| JavaScript Version: | ECMAScript 1 |
|---|
More Examples
Example 2
Set the date to November 3, 2020, UTC time:
const d = new Date();
d.setUTCFullYear(2020, 10, 3);
Try it Yourself »
Example
Set the date to six months ago, UTC time:
const d = new Date();
d.setUTCFullYear(d.getUTCFullYear, d.getUTCMonth() - 6);
Try it Yourself »
