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.
Date.IsInNextNWeeks(
dateTime as any,
weeks as number
) as nullable logical
- dateTime: valor temporal de tipo date, datetime o datetimezone a evaluar
- weeks: número de semanas del período a considerar
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.
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
Sin embargo, el lunes siguiente, día 20, ya sí forma parte de la siguiente semana:
Date.IsInNextNWeeks(
#date(2020,7,20),
1
)
TRUE
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
