Javascript - Date setUTCFullYear() Method

The setUTCFullYear() method sets the year (four digits for dates between year 1000 and 9999) of a date object, according the UTC time.

Description

The setUTCFullYear() method sets the year (four digits for dates between year 1000 and 9999) of a date object, according the UTC time.

UTC time is the same as GMT time.

Syntax

Date.setUTCFullYear(year,month,day)

Parameter Values

Parameter Require Description
year Required. A value representing the year, negative values are allowed
month Optional.An integer representing the month
day Optional.An integer representing the day of month

For the month value, the expected values are 0-11, but other values are allowed:

  • -1 will result in the last month of the previous year
  • 12 will result in the first month of the next year
  • 13 will result in the second month of the next year

For the day value, the expected values are 1-31, but other values are allowed:

  • 0 will result in the last hour of the previous month
  • -1 will result in the hour before the last hour of the previous month
  • If the month has 31 days: 32 will result in the first day of the next month
  • If the month has 30 days: 32 will result in the second day of the next month

Return Value

Type Description
Number Milliseconds between the date object and midnight January 1 1970

Example

Set the year to 1992:

Demo

//display a date after changing the year.
var d = new Date();
d.setUTCFullYear(2020);/*from  w  ww  . j  a  v  a2  s . c om*/
console.log(d);

//Set the date to November 3, 2020:
//display a date after changing the year, month, and day of month.
var d = new Date();
d.setUTCFullYear(2020, 10, 3);
console.log(d);

//Set the date to six months ago, UTC time:
var d = new Date();
d.setUTCFullYear(d.getUTCFullYear(), d.getUTCMonth() - 6);
console.log(d);

Result