JavaScript Date setFullYear()

❮ Previous JavaScript Date Reference Next ❯

Example 1

const d = new Date();
d.setFullYear(2020);
Try it Yourself »

Description

setFullYear() sets the year of a date.

setFullYear() can also set month and day.

Example 2

const d = new Date();
d.setFullYear(2020, 10, 3);
Try it Yourself »

Example 3

Set the date to six months ago:

const d = new Date();
d.setFullYear(d.getFullYear(), d.getMonth() - 6);
Try it Yourself »

Browser Support

setFullYear() 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.setFullYear(year, month, day)

Parameters

year Required.
The year. Negative values are allowed.
month Optional.
The month (0 to 11).

Higher and lower values are handeled with date maths:

  • -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.
The day (0 to 31).

Higher and lower values are handeled with date maths:

  • 0 gives the last day of the previous month
  • -1 gives the day before the last day of the previous month
  • 32 gives the first day of the next month (if 31 days)
  • 41 gives the tenth day of the next month (if 31 days)

Return Value

A number.

Number of milliseconds between the date and January 1, 1970 00:00:00 UTC.

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.