Date.IsInNextNWeeks

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

Sintaxis

Date.IsInNextNWeeks(
    dateTime as any,
    weeks as number
) as nullable logical

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

La función no permite especificar el primer día de la semana.

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

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

Ejemplos

Si hoy es viernes día 17 de julio de 2020, este domingo 19 no queda dentro de la semana posterior a la actual:

Date.IsInNextNWeeks(
    #date(2020,7,19),
    1
)

FALSE

Función M Date.IsInNextNWeeks

Sin embargo, el lunes siguiente, día 20, ya sí forma parte de la siguiente semana:

Date.IsInNextNWeeks(
    #date(2020,7,20),
    1
)

TRUE

Función M Date.IsInNextNWeeks

Siguiendo con el mismo ejemplo, el día de hoy no queda dentro de las "cero" semanas próximas:

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

FALSE

Función M Date.IsInNextNWeeks
Categoría
Funciones de fecha
Enviado por admin el Vie, 17/07/2020 - 10:28