Date.IsInPreviousNYears

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

Sintaxis

Date.IsInPreviousNYears(
    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 años anteriores 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 18 de julio de 2020, la función Date.IsInPreviousNYears devolverá el valor lógico False si recibe como argumento un valor temporal correspondiente a 2020, con independencia del valor del argumento years:

Date.IsInPreviousNYears(
    #date(2020,1,1),
    1
)

FALSE

Función M Date.IsInPreviousNYears

Es posible evaluar si las 12:00:00 del 28 de octubre de 2016 es un valor temporal perteneciente a los últimos 5 años con la siguiente expresión:

Date.IsInPreviousNYears(
    #datetime(2016,10,28,12,0,0),
    5
)

TRUE

Función M Date.IsInPreviousNYears
Categoría
Funciones de fecha
Enviado por admin el Sáb, 18/07/2020 - 11:35