La función Date.WeekOfYear devuelve el número de semana del año correspondiente al valor temporal indicado.
Date.WeekOfYear(
dateTime as any,
optional firstDayOfWeek as nullable number
) as nullable number
- dateTime: valor temporal de tipo date, datetime o datetimezone del que extraer el número de semana del año.
- firstDayOfWeek: (opcional) constante indicando el primer día de la semana.
El resultado es un número entero mayor o igual a 1 y menor o igual a 54.
Si no se especifica el argumento firstDayOfWeek, se aplica un valor que dependerá de la configuración regional del equipo.
Obsérvese el calendario de enero de 2020:

El viernes 3, con la configuración regional de mi equipo (español de España), queda englobado en la primera semana del año:
Date.WeekOfYear(#date(2020,1,3))
1

Sin embargo, si especificamos como primer día de la semana el jueves, el viernes 3 ya caería en la segunda semana del año:
Date.WeekOfYear(#date(2020,1,3), Day.Thursday)
2
