La función Date.IsInPreviousNQuarters comprueba si un valor temporal hace referencia a un instante de tiempo englobado en los N trimestres anteriores al indicado por el reloj del sistema, devolviendo el valor lógico True en caso positivo.
Date.IsInPreviousNQuarters(
dateTime as any,
quarters as number
) as nullable logical
- dateTime: valor temporal de tipo date, datetime o datetimezone a evaluar
- quarters: número de trimestres 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 quarters 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 trimestres anteriores no incluyen el trimestre actual. Esto supone que si el argumento dateTime pasado a la función hace referencia al trimestre actual, la función devolverá el valor lógico False.
Si estamos a día 17 de julio de 2020 (tercer trimestre del año), podemos comprobar si el 1 de enero está englobado en los dos trimestres anteriores con la siguiente expresión:
Date.IsInPreviousNQuarters(
#date(2020,1,1),
2
)
TRUE
Siguiendo con el mismo ejemplo, si pasamos a la función el valor temporal correspondiente a un día antes (31 de diciembre de 2019), el resultado ya es False:
Date.IsInPreviousNQuarters(
#date(2019,12,31),
2
)
FALSE
