Date.IsInNextNYears

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

Sintaxis

Date.IsInNextNYears(
    dateTime as any,
    years as number
) as nullable logical

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

Ejemplos

Si estamos a 17 de julio de 2020, la fecha del 1 de enero de 2022 pertenece a los próximos dos años:

Date.IsInNextNYears(
    #date(2022,1,1),
    2
)

TRUE

Función M Date.IsInNextNYears

El último día no incluido en los N siguientes años será el 31 de diciembre de este año, 2020:

Date.IsInNextNYears(
    #date(2020,12,31),
    1
)

FALSE

Función M Date.IsInNextNYears

Si el argumento years toma el valor 0 o un valor negativo, la función siempre devuelve el valor lógico False:

Date.IsInNextNYears(
    DateTime.LocalNow(),
    0
)

FALSE

Función M Date.IsInNextNYears
Categoría
Funciones de fecha
Submitted by admin on Fri, 07/17/2020 - 12:34