La función DateTime.IsInNextSecond comprueba si un valor temporal hace referencia a un instante de tiempo englobado en el segundo siguiente al indicado por el reloj del sistema, devolviendo el valor lógico True en caso positivo.
DateTime.IsInNextSecond(
dateTime as any
) as nullable logical
- dateTime: valor temporal de tipo date, datetime o datetimezone a evaluar
La fecha y hora con la que comparar el argumento dateTime es la proporcionada por el reloj del equipo local.
Para probar la función podemos extraer la fecha y hora actual del sistema con la función DateTime.LocalNow. Si pasamos dicho valor temporal a la función DateTime.IsInNextSecond, el resultado es False pues, lógicamente, el segundo actual no está incluido en el siguiente segundo:
DateTime.IsInNextSecond(DateTime.LocalNow())
FALSE
Sin embargo, si al valor temporal le añadimos un segundo adicional, el resultado ya será True pues estaremos apuntando a un valor temporal que sí caerá en el siguiente segundo:
DateTime.IsInNextSecond(
DateTime.LocalNow()+
#duration(0,0,0,1)
)
TRUE