La función DateTime.IsInCurrentHour comprueba si un valor temporal hace referencia a un instante de tiempo englobado en la hora actual, devolviendo el valor lógico True en caso positivo.
DateTime.IsInCurrentHour(
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.
Por ejemplo, si en mi equipo la hora actual son las 20:16 del día 23 de junio de 2020, cualquier momento temporal entre las 20:00:00 y las 20:59:59 de la fecha referida se considerará englobada dentro de la hora actual. Por ejemplo:
DateTime.IsInCurrentHour(#datetime(2020,6,23,20,0,0))
TRUE
O:
DateTime.IsInCurrentHour(#datetime(2020,6,23,20,59,59))
TRUE
Sin embargo, las 19:59:59 de la misma fecha ya devuelve un valor negativo:
DateTime.IsInCurrentHour(#datetime(2020,6,23,19,59,59))
FALSE
Y las 21:00:00 también devolverían un valor negativo:
DateTime.IsInCurrentHour(#datetime(2020,6,23,21,00,00))
FALSE
Si el reloj del sistema marca las 18:03 del día 3 de julio de 2020, podemos pasar a la función un valor temporal de tipo datetimezone. Obsérvese que, en el siguiente ejemplo, la zona horaria es GMT+1 y que se está pasando como hora las 17:00:
DateTime.IsInCurrentHour(#datetimezone(2020,7,3,17,0,0,1,0))
TRUE
