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.
Date.IsInPreviousYear(
dateTime as any
) as nullable logical
- dateTime: valor temporal de tipo date, datetime o datetimezone a evaluar
La fecha y hora con la que comparar el argumento dateTime es la proporcionada por el reloj del equipo local.
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
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
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
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
