Date.AddYears

Adiciona os anos especificados à data.

Syntax

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

Devolve o resultado de date, datetime ou datetimezone decorrente da adição de numberOfYears a um valor datetime dateTime.

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

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

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

Result:

#date(2015, 5, 14)

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

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

Result:

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