La función DateTime.IsInPreviousNSeconds comprueba si un valor temporal hace referencia a un instante de tiempo englobado en los N segundos anteriores a los indicados por el reloj del sistema, devolviendo el valor lógico True en caso positivo.
DateTime.IsInPreviousNSeconds(
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 segundos anteriores 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 pasamos a la función DateTime.IsInPreviousNSeconds la hora del sistema obtendremos el valor lógico False pues, como se ha comentado, el segundo actual no está incluido en la ventana de, por ejemplo, los tres segundos anteriores:
DateTime.IsInPreviousNSeconds(DateTime.LocalNow(), 3)
FALSE
Sin embargo, en cuanto restamos, por ejemplo, dos segundos a la hora devuelta por el reloj del sistema ya estaríamos apuntando a un valor temporal en la ventana de tres segundos:
DateTime.IsInPreviousNSeconds(
DateTime.LocalNow()-#duration(0,0,0,2),
3
)
TRUE
