La función DateTime.IsInNextNHours comprueba si un valor temporal hace referencia a un instante de tiempo englobado en las N horas siguientes a la indicada por el reloj del sistema, devolviendo el valor lógico True en caso positivo.
DateTime.IsInNextNHours(
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 siguientes horas 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 devuelve las 11:06 del día 25 de junio de 2020 y consideramos como período el correspondiente a 3 horas, cualquier valor temporal que haga referencia a un momento de tiempo entre las 12:00:00 y las 14:59:59 (del mismo día) devolverá el valor True, devolviéndose False para cualquier otro momento.
Por ejemplo, para las 11:59:59 la función devolverá False:
DateTime.IsInNextNHours(
#datetime(2020,6,25,11,59,59),
3
)
FALSE
Sin embargo para un segundo más tarde, la función ya devuelve True:
DateTime.IsInNextNHours(
#datetime(2020,6,25,12,0,0),
3
)
De forma semejante, la función devuelve el valor True para las 14:59:59:
DateTime.IsInNextNHours(
#datetime(2020,6,25,14,59,59),
3
)
TRUE
Sin embargo, para un segundo después la función ya devuelve el valor False:
DateTime.IsInNextNHours(
#datetime(2020,6,25,15,0,0),
3
)
FALSE
