DateTime.IsInCurrentHour

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.

Sintaxis

DateTime.IsInCurrentHour(
    dateTime as any
) as nullable logical

Parámetros
  • dateTime: valor temporal de tipo date, datetime o datetimezone a evaluar
Información adicional

La fecha y hora con la que comparar el argumento dateTime es la proporcionada por el reloj del equipo local.

Ejemplos

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

Función M DateTime.IsInCurrentHour

O:

DateTime.IsInCurrentHour(#datetime(2020,6,23,20,59,59))

TRUE

Función M DateTime.IsInCurrentHour

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

Función M DateTime.IsInCurrentHour

Y las 21:00:00 también devolverían un valor negativo:

DateTime.IsInCurrentHour(#datetime(2020,6,23,21,00,00))

FALSE

Función M DateTime.IsInCurrentHour

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

Función M DateTime.IsInCurrentHour
Categoría
Funciones DateTime
Submitted by admin on Tue, 06/23/2020 - 20:12