Date.IsInNextNMonths

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

Sintaxis

Date.IsInNextNMonths(
    dateTime as any,
    months as number
) as nullable logical

Parámetros
  • dateTime: valor temporal de tipo datedatetime o datetimezone a evaluar
  • months: número de meses 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 months 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 meses no incluyen el mes actual. Esto supone que si el argumento dateTime pasado a la función hace referencia al mes actual, la función devolverá el valor lógico False.

Ejemplos

Si estamos a 16 de julio de 2020, cualquier valor temporal correspondiente al actual mes de julio devolverá el valor lógico False con independencia del valor del argumento months que se indique:

Date.IsInNextNMonths(
    #datetime(2020,7,31,23,59,59),
    1
)

FALSE

Función M Date.IsInNextNMonths

Sin embargo, cualquier fecha del mes de septiembre se incluirá en los próximos 6 meses:

Date.IsInNextNMonths(
    #date(2020,9,15),
    6
)

TRUE

Función M Date.IsInNextNMonths

Si el argumento months toma el valor 0 o un valor negativo, la función siempre devuelve el valor lógico False. Así, si estamos a 17 de julio de 2020:

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

FALSE

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