Date.IsInPreviousYear

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

Sintaxis

Date.IsInPreviousYear(
    dateTime as any
) as nullable logical

Parámetros
  • dateTime: valor temporal de tipo datedatetime o datetimezone a evaluar
Información adicional

La fecha y hora con la que comparar el argumento dateTime es la proporcionada por el reloj del equipo local.

Ejemplos

Si la fecha actual es jueves 16 de julio de 2020, cualquier valor temporal correspondiente al año actual devolverá el valor lógico False cuando se pase como argumento a la función Date.IsInPreviousYear:

Date.IsInPreviousYear(
    DateTime.LocalNow()
)

FALSE

Función M Date.IsInPreviousYear

Sin embargo, si pasamos como argumento cualquier valor temporal del año 2019, la función devolverá el valor lógico True:

Date.IsInPreviousYear(
    #datetime(2019,12,31,23,59,59)
)

TRUE

Función M Date.IsInPreviousYear

Por otro lado, mi zona horaria actual es UTC+2 en horario de verano -y UTC+1 en invierno-, si pasamos a la función Date.IsInPreviousYear el valor temporal correspondiente a las 23:59:59 UTC+1 del 31 de diciembre de 2019, obtendremos el valor lógico True como resultado:

Date.IsInPreviousYear(
    #datetimezone(2019,12,31,23,59,59,1,0)
)

TRUE

Función M Date.IsInPreviousYear

Sin embargo, si el argumento pasado a la función es el correspondiente a la misma hora y misma fecha pero para el huso horario UTC-1, obtendremos como resultado False, pues dicha fecha, convertida a nuestra zona horaria, ya caería en el año actual:

Date.IsInPreviousYear(
    #datetimezone(2019,12,31,23,59,59,-1,0)
)

FALSE

Función M Date.IsInPreviousYear
Categoría
Funciones de fecha
Enviado por admin el Jue, 16/07/2020 - 16:09