La función DateTime.IsInNextNMinutes comprueba si un valor temporal hace referencia a un instante de tiempo englobado en los N minutos siguientes a los indicados por el reloj del sistema, devolviendo el valor lógico True en caso positivo.
DateTime.IsInNextNMinutes(
dateTime as any,
minutes as number
) as nullable logical
- dateTime: valor temporal de tipo date, datetime o datetimezone a evaluar
- minutes: número de minutos 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 minutos no incluyen el minuto actual. Esto supone que si el argumento dateTime pasado a la función hace referencia al minuto actual, la función devolverá el valor lógico False.
Si pasamos como argumento de esta función la hora del sistema, obtendremos el valor False pues el minuto actual no se incluye en el período considerado (de 3 minutos, en el siguiente ejemplo):
DateTime.IsInNextNMinutes(
DateTime.LocalNow(),
3
)
FALSE
Sin embargo, si a la hora del sistema le sumamos dos minutos (dentro de la ventana de tres minutos comentada), obtenemos el valor lógico True:
DateTime.IsInNextNMinutes(
DateTime.LocalNow() + #duration(0,0,2,0),
3
)
TRUE
