La función Date.StartOfWeek devuelve un valor temporal correspondiente al comienzo de la semana del valor temporal indicado.
Date.StartOfWeek(
dateTime as any,
optional firstDayOfWeek as nullable number
) as any
- dateTime: valor temporal de tipo date, datetime o datetimezone del que extraer el comienzo de la semana
- firstDayOfWeek: (opcional) constante indicando el primer día de la semana.
La función Date.StartOfWeek 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 primer día de la semana. Si, por el contrario, el argumento es de tipo datetime o datetimezone, la función devuelve el primer segundo de la semana.
Obsérvese el calendario de julio de 2020:
El comienzo de la semana correspondiente al jueves 9 de julio (al menos según la "perspectiva regional" de español de España) es el lunes 6:
Date.StartOfWeek(#date(2020,7,9))
06/07/2020
Si fijamos como primer día de la semana el miércoles, ahora el primer día de la semana a la que pertenece la mencionada fecha del 9 de julio de 2020 es el día 8, miércoles:
Date.StartOfWeek(#date(2020,7,9), Day.Wednesday)
08/07/2020
Si el argumento dateTime es un valor temporal de tipo datetime, la función devuelve el primer segundo de la semana:
Date.StartOfWeek(#datetime(2020,7,9,21,12,55))
06/07/2020 0:00:00
Si dicho argumento es de tipo datetimezone, la función devuelve el primer segundo de la semana conservando la información sobre la zona horaria:
Date.StartOfWeek(#datetimezone(2020,7,9,21,12,55,1,0))
06/07/2020 0:00:00 +01:00
