DateTime.IsInNextNSeconds

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.

Sintaxis

DateTime.IsInNextNSeconds(
    dateTime as any,
    seconds as number
) as nullable logical

Parámetros
  • dateTime: valor temporal de tipo date, datetime o datetimezone a evaluar
  • seconds: número de segundos del período a considerar
Información adicional

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.

Ejemplos

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

Función M DateTime.IsInNextNSeconds

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

Función M DateTime.IsInNextNSeconds
Categoría
Funciones DateTime
Enviado por admin el Vie, 26/06/2020 - 10:20