addYears

The addYears() function adds a positive number of years to a TheDate. It accepts a curried signature to compose transformations.

Interactive example

Syntax

Classic signature

function addYears<
	GenericInput extends TheDate,
	GenericYear extends number
>(
	input: GenericInput,
	year: PositiveNumber<GenericYear>
): TheDate

Curried signature

function addYears<
	GenericInput extends TheDate,
	GenericYear extends number
>(
	year: PositiveNumber<GenericYear>
): (input: GenericInput) => TheDate

Parameters

• year: Strictly positive number of years (PositiveNumber).
• input: TheDate to modify (classic version).

Return value

A new TheDate incremented by the requested number of years.

See also

• addMonths
• subtractYears

Sources

• MDN Web Docs - Date.prototype.setUTCFullYear()