La función DateTime.IsInNextNSeconds comprueba si un valor temporal hace referencia a un instante de tiempo englobado en los N segundos siguientes a los indicados por el reloj del sistema, devolviendo el valor lógico True en caso positivo.
DateTime.IsInNextNSeconds(
dateTime as any,
seconds as number
) as nullable logical
- dateTime: valor temporal de tipo date, datetime o datetimezone a evaluar
- seconds: número de segundos 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.
Los N siguientes segundos no incluyen el segundo actual. Esto supone que si el argumento dateTime pasado a la función hace referencia al segundo actual, la función devolverá el valor lógico False.
Si extraemos la hora local del sistema y la pasamos como argumento de la función DateTime.IsInNextNSeconds, obtendremos un valor False pues ya sabemos que el segundo actual no está incluido en una ventana de, en el siguiente ejemplo, 3 segundos:
DateTime.IsInNextNSeconds(DateTime.LocalNow(), 3)
FALSE
Sin embargo, si añadimos a la hora local dos segundos -por ejemplo-, ya sí estaríamos pasando como argumento un valor temporal que caería en la ventana:
DateTime.IsInNextNSeconds(
DateTime.LocalNow() + #duration(0,0,0,2),
3
)
TRUE
