Date.IsInYearToDate

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.

Sintaxis

Date.IsInYearToDate(
    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 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

Función M Date.IsInYearToDate

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

Función M Date.IsInYearToDate

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

Función M Date.IsInYearToDate
Categoría
Funciones de fecha
Submitted by admin on Sat, 07/18/2020 - 12:45