La función Date.IsInPreviousNMonths comprueba si un valor temporal hace referencia a un instante de tiempo englobado en los N meses anteriores al indicado por el reloj del sistema, devolviendo el valor lógico True en caso positivo.
Date.IsInPreviousNMonths(
dateTime as any,
months as number
) as nullable logical
- dateTime: valor temporal de tipo date, datetime o datetimezone a evaluar
- months: número de meses del período a considerar
La fecha y hora con la que comparar el argumento dateTime es la proporcionada por el reloj del equipo local.
El argumento months puede tomar el valor 0 o un valor negativo, pero la función siempre devolverá el valor lógico False en estos casos.
Los N meses anteriores no incluyen el mes actual. Esto supone que si el argumento dateTime pasado a la función hace referencia al mes actual, la función devolverá el valor lógico False.
Si estamos a 17 de julio de 2020, podemos comprobar si la fecha del 1 de abril se encuentra en los 6 meses anteriores con la siguiente expresión:
Date.IsInPreviousNMonths(
#date(2020,4,1),
6
)
TRUE
Si pasamos a la función la fecha actual, el resultado siempre será False:
Date.IsInPreviousNMonths(
DateTime.LocalNow(),
1
)
FALSE
