La función Date.IsInYearToDate comprueba si el valor temporal indicado pertenece al rango de fechas que van desde principio de año hasta el día de hoy, devolviendo el valor lógico True en caso positivo.
Date.IsInYearToDate(
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 estamos a 18 de julio de 2020, podemos evaluar si la fecha actual pertenece o no al rango de fechas incluido entre el primer día del año y hoy con la siguiente expresión:
Date.IsInYearToDate(
#date(2020,7,18)
)
TRUE
Obsérvese que la comprobación se realiza a nivel de día, no de hora. Por ejemplo, si el reloj del sistema marca las 13:01 de la fecha indicada (18 de julio de 2020), la función Date.IsInYearToDate devolverá el valor lógico True aun cuando el argumento temporal indique una hora posterior a la actual (siempre que el día sea el mismo):
Date.IsInYearToDate(
#datetime(2020,7,18,23,59,59)
)
TRUE
Si el argumento dateTime hace referencia a una fecha posterior a la actual, la función devuelve el valor lógico False:
Date.IsInYearToDate(
#date(2020,7,19)
)
FALSE
