JavaScript Date setUTCFullYear()

❮ Previous JavaScript Date Reference Next ❯

Example

Set the year to 2015:

const d = new Date();
d.setUTCFullYear(2015);
Try it Yourself »

More "Try it Yourself" examples below.

Description

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:

  • -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: 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 »

Related Pages:

JavaScript Dates

JavaScript Date Formats

JavaScript Date Get Methods

JavaScript Date Set Methods

❮ Previous JavaScript Date Reference Next ❯
Copyright 1999-2023 by Refsnes Data. All Rights Reserved.