Latest web development tutorials
 

JavaScript setUTCFullYear() Method

< JavaScript Date Object

Example

Set the year to 1992:

var d = new Date();
d.setUTCFullYear(1992);

The result of d will be:

Try it Yourself »

More "Try it Yourself" examples below.

Definition and Usage

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

Tip: The Universal Coordinated Time (UTC) is the time set by the World Time Standard.

Note: UTC time is the same as GMT time.

Browser Support

Method
setUTCFullYear() 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:

  • -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
day Optional. An integer representing the day of month

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

Technical Details

JavaScript Version: 1.3
Examples

More Examples

Example 2

Set the date to November 3, 2020:

var d = new Date();
d.setUTCFullYear(2020, 10, 3);

The result of d will be:

Try it Yourself »

Example

Set the date to six months ago, UTC time:

var d = new Date();
d.setUTCFullYear(d.getUTCFullYear, d.getUTCMonth() - 6);

The result of d will be:

Try it Yourself »
< JavaScript Date Object