La función DateTime.IsInPreviousNHours comprueba si un valor temporal hace referencia a un instante de tiempo englobado en las N horas anteriores a la indicada por el reloj del sistema, devolviendo el valor lógico True en caso positivo.
DateTime.IsInPreviousNHours(
dateTime as any,
hours as number
) as nullable logical
- dateTime: valor temporal de tipo date, datetime o datetimezone a evaluar
- hours: número de horas 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.
Las N horas anteriores no incluyen la hora actual. Esto supone que si el argumento dateTime pasado a la función hace referencia a la hora actual, la función devolverá el valor lógico False.
Si el reloj del sistema marca las 10:38 del día 26 de junio de 2020, el valor temporal correspondiente a las 10:00 del mismo día pasado como argumento de la función DateTime.IsInPreviousNHours devolverá el valor lógico False pues la hora actual no se incluye en la ventana de, por ejemplo, las 3 horas anteriores:
DateTime.IsInPreviousNHours(#datetime(2020,6,26,10,0,0),3)
FALSE
Sin embargo, si apuntamos a un segundo antes (a las 9:59:59 del mismo día) la función ya devuelve un valor True:
DateTime.IsInPreviousNHours(#datetime(2020,6,26,9,59,59),3)
TRUE
