Date.IsInCurrentMonth

La función Date.IsInCurrentMonth comprueba si un valor temporal hace referencia a un instante de tiempo englobado en el mes actual, devolviendo el valor lógico True en caso positivo.

Sintaxis

Date.IsInCurrentMonth(
    dateTime as any
) as nullable logical

Parámetros
  • dateTime: valor temporal de tipo date, datetime 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 4 de julio de 2020, cualquier fecha entre el 1 y el 31 del mismo mes (y del mismo año) será considerada como perteneciente al mes actual. Por ejemplo el día 27:

Date.IsInCurrentMonth(
    #date(2020,7,27)
)

TRUE

Función M Date.IsInCurrentMonth

Si embargo, la fecha del 27 de julio del año anterior devuelve el valor False:

Date.IsInCurrentMonth(#date(2019,7,27))

FALSE

Función M Date.IsInCurrentMonth

Si el valor temporal es de tipo datetime, cualquier valor entre las 00:00:00 del 1 de julio de 2020 y las 23:59:59.999..., ambos incluidos devolverá True:

Date.IsInCurrentMonth(
    #datetime(2020,7,31,23,59,59.9999999)
)

TRUE

Función M Date.IsInCurrentMonth

Sin embargo, las 00:00:00 del 1 de agosto ya devuelve FALSE:

Date.IsInCurrentMonth(
    #datetime(2020,8,1,0,0,0)
)

FALSE

Función M Date.IsInCurrentMonth

Si el valor temporal es de tipo datetimezone, se convierte a su equivalente GMT antes de ser comparado con el reloj del sistema. Así, las 23:59:59 GMT+1 del 31 de julio (0:59:59 GMT del 1 de agosto) devuelven el valor False:

Date.IsInCurrentMonth(
    #datetimezone(2020,7,31,23,59,59,1,0)
)

FALSE

Función M Date.IsInCurrentMonth

Sin embargo, el resultado devuelto para una hora menos es True:

Date.IsInCurrentMonth(
    #datetimezone(2020,7,31,22,59,59,1,0)
)

TRUE

Función M Date.IsInCurrentMonth
Categoría
Funciones de fecha
Submitted by admin on Sat, 07/04/2020 - 09:40