La función Date.AddYears añade un cierto número de años a un valor temporal.
Sintaxis
Date.AddYears(
dateTime as any,
numberOfYears as number
) as any
Parámetros
- dateTime: valor temporal de tipo date, datetime o datetimezone al que añadir el número de años indicado
- numberOfYears: número de años a añadir al valor temporal dateTime
Información adicional
La función devuelve un valor del mismo tipo que el del argumento dateTime.
El argumento numberOfYears deberá ser un número entero (puede ser tanto positivo, como nulo o negativo).
Ejemplos
Podemos restar a la fecha del 28 de junio de 2020 dos años con la siguiente expresión:
Date.AddYears(#date(2020,6,28),-2)
28/06/2018
Si el argumento dateTime es de tipo datetimezone, por ejemplo el correspondiente a las 13:15:00 +01:00 del 28 de junio de 2020, al restar dos años se devuelve un valor del mismo tipo:
Date.AddYears(#datetimezone(2020,6,28,13,15,0,1,0),-2)
28/06/2018 13:15:00 +01:00
Categoría
Funciones de fecha
