Date.IsInNextNDays

La función Date.IsInNextNDays comprueba si un valor temporal hace referencia a un instante de tiempo englobado en los N días siguientes al indicado por el reloj del sistema, devolviendo el valor lógico True en caso positivo.

Sintaxis

Date.IsInNextNDays(
    dateTime as any,
    days as number
) as nullable logical

Parámetros
  • dateTime: valor temporal de tipo datedatetime o datetimezone a evaluar
  • days: número de días 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.

El argumento days puede tomar el valor 0 o un valor negativo, pero la función siempre devolverá el valor lógico False en estos casos.

Los N siguientes días no incluyen el día actual. Esto supone que si el argumento dateTime pasado a la función hace referencia al día actual, la función devolverá el valor lógico False.

Ejemplos

Por ejemplo, si estamos a 16 de julio de 2020, podemos comprobar si el valor temporal correspondiente a las 15:00:00 del día 20 de este mismo mes cae en los 10 siguientes días con la siguiente expresión:

Date.IsInNextNDays(
    #datetime(2020,7,20,15,0,0),
    10
)

TRUE

Función M Date.IsInNextNDays

Sin embargo, cualquier valor temporal perteneciente al día 16 de julio devuelve el valor False:

Date.IsInNextNDays(
    #datetime(2020,7,16,23,59,59),
    10
)

FALSE

Función M Date.IsInNextNDays

Si el argumento days toma el valor 0, la función devuelve el valor lógico False aun cuando se esté pasando el día de hoy. Así, si estamos a 17 de julio de 2020:

Date.IsInNextNDays(
    #date(2020,7,17),
    0
)

FALSE

Función M Date.IsInNextNDays
Categoría
Funciones de fecha
Submitted by admin on Thu, 07/16/2020 - 16:34