Date.IsInNextNQuarters

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

Sintaxis

Date.IsInNextNQuarters(
    dateTime as any,
    quarters as number
) as nullable logical

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

Ejemplos

Si estamos a 16 de julio de 2020 (tercer trimestre del año), cualquier valor temporal anterior a las 0:00:00 del 1 de octubre de este mismo año devolverá el valor lógico False cuando se pase a la función Date.IsInNextNQuarters como argumento. Por ejemplo:

Date.IsInNextNQuarters(
    #datetime(2020,9,30,23,59,59),
    2
)

FALSE

Función M Date.IsInNextNQuarters

Sin embargo, un segundo más tarde (el valor temporal correspondiente a las 0:00:00 del 1 de octubre de 2020) ya estaría incluido en cualquier grupo de N trimestres:

Date.IsInNextNQuarters(
    #datetime(2020,10,1,0,0,0),
    2
)

TRUE

Función M Date.IsInNextNQuarters

Si pasamos a la función la fecha actual y el valor 0 como argumento quarters, obtenemos el valor lógico False:

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

FALSE

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