DateTime.IsInNextNHours

La función DateTime.IsInNextNHours comprueba si un valor temporal hace referencia a un instante de tiempo englobado en las N horas siguientes a la indicada por el reloj del sistema, devolviendo el valor lógico True en caso positivo.

Sintaxis

DateTime.IsInNextNHours(
    dateTime as any,
    hours as number
) as nullable logical

Parámetros
  • dateTime: valor temporal de tipo date, datetime o datetimezone a evaluar
  • hours: número de horas 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.

Las N siguientes horas no incluyen la hora actual. Esto supone que si el argumento dateTime pasado a la función hace referencia a la hora actual, la función devolverá el valor lógico False.

Ejemplos

Si el reloj del sistema devuelve las 11:06 del día 25 de junio de 2020 y consideramos como período el correspondiente a 3 horas, cualquier valor temporal que haga referencia a un momento de tiempo entre las 12:00:00 y las 14:59:59 (del mismo día) devolverá el valor True, devolviéndose False para cualquier otro momento.

Por ejemplo, para las 11:59:59 la función devolverá False:

DateTime.IsInNextNHours(
    #datetime(2020,6,25,11,59,59),
    3
)

FALSE

Función M DateTime.IsInNextNHours

Sin embargo para un segundo más tarde, la función ya devuelve True:

DateTime.IsInNextNHours(
    #datetime(2020,6,25,12,0,0),
    3
)

TRUE
Función M DateTime.IsInNextNHours

De forma semejante, la función devuelve el valor True para las 14:59:59:

DateTime.IsInNextNHours(
    #datetime(2020,6,25,14,59,59),
    3
)

TRUE

Función M DateTime.IsInNextNHours

Sin embargo, para un segundo después la función ya devuelve el valor False:

DateTime.IsInNextNHours(
    #datetime(2020,6,25,15,0,0),
    3
)

FALSE

Función M DateTime.IsInNextNHours

 

Categoría
Funciones DateTime
Enviado por admin el Jue, 25/06/2020 - 11:03