La función Date.EndOfWeek devuelve un valor temporal correspondiente al final de la semana del valor temporal indicado.
Date.EndOfWeek(
dateTime as any,
optional firstDayOfWeek as nullable number
) as any
- dateTime: valor temporal de tipo date, datetime o datetimezone del que extraer el final del mes
- firstDayOfWeek: (opcional) constante indicando el primer día de la semana.
La función Date.EndOfWeek devuelve un valor del mismo tipo que el argumento dateTime, conservando la información sobre la zona horaria (si está incluida en el argumento).
Si dicho argumento es de tipo date, la función devuelve el último día de la semana. Si, por el contrario, el argumento es de tipo datetime o datetimezone, la función devuelve el primer segundo posterior a la semana (es decir, el primer segundo de la semana siguiente).
Según la documentación de Microsoft, el valor por defecto del argumento firstDayOfWeek es Day.Sunday. La práctica parece indicar, por el contrario, que se aplica un valor que dependerá de la configuración regional del equipo.
Obsérvese el calendario de julio de 2020:
El final de la semana correspondiente al jueves 9 de julio (al menos según la "perspectiva regional" de español de España) es el domingo 12:
Date.EndOfWeek(#date(2020,7,9))
12/07/2020
Siguiendo con el mismo ejemplo, si especificamos como primer día de la semana el miércoles, el último día de la semana correspondiente a la misma fecha del 9 de julio será el martes 14:
Date.EndOfWeek(#date(2020,7,9), Day.Wednesday)
14/07/2020
