Date.AddYears

Adiciona os anos especificados à data.

Syntax

Date.AddYears(
    dateTime as any,
    numberOfYears as number
) as any

Retorna o resultado de date, datetime ou datetimezone após adicionar numberOfYears a um valor datetime dateTime.

dateTime: o valor date, datetime ou datetimezone ao qual os anos são adicionados.
numberOfYears: o número de anos a serem adicionados.

Adicione 4 anos ao valor <code>datetime</code>, <code>datetimezone</code> ou <code>date</code> que representa a data 14/5/2011.

Date.AddYears(#date(2011, 5, 14), 4)

Result:

#date(2015, 5, 14)

Adicione 10 anos ao valor <code>datetime</code>, <code>datetimezone</code> ou <code>date</code> que representa a data e a hora 14/5/2011 08:15:22 AM.

Date.AddYears(#datetime(2011, 5, 14, 8, 15, 22), 10)

Result:

#datetime(2021, 5, 14, 8, 15, 22)