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.
Date.IsInCurrentMonth(
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 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
Si embargo, la fecha del 27 de julio del año anterior devuelve el valor False:
Date.IsInCurrentMonth(#date(2019,7,27))
FALSE
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
Sin embargo, las 00:00:00 del 1 de agosto ya devuelve FALSE:
Date.IsInCurrentMonth(
#datetime(2020,8,1,0,0,0)
)
FALSE
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
Sin embargo, el resultado devuelto para una hora menos es True:
Date.IsInCurrentMonth(
#datetimezone(2020,7,31,22,59,59,1,0)
)
TRUE
