Funcións WeekNum e ISOWeekNum

Aplícase a: Aplicacións de lenzo Aplicacións baseadas en modelos Power Pages Dataverse columnas de fórmulas

Devolve o número da semana dunha data determinada.

Descripción

Use as función WeekNum e ISOWeekNum para determinar o número de semana dunha data.

Estas funcións difiren na forma en que determinan a primeira semana do ano (semana 1):

• WeekNum usa a semana que contén o 1 de xaneiro como primeira semana do ano. O resultado desta función pode ir de 1 a 54.

• ISOWeekNum usa a semana que contén o primeiro xoves do ano como a primeira semana do ano. Isto segue a definición estándar de data e hora da norma ISO 8601 para a numeración das semanas. O resultado desta función pode ir de 1 a 53. É posible que se devolva 52 ou 53 para os primeiros días de xaneiro, xa que as datas poderían pertencer á última semana do ano anterior.

Use o segundo parámetro de WeekNum para especificar que día comeza a semana. Pode proporcionar un número de código de Excel ou usar a enumeración StartOfWeek:

Código Excel	Enumeración de StartOfWeek	Descripción
1, 17	StartOfWeek.Sunday	A semana comeza o domingo. Predefinido.
2, 11	StartOfWeek.Monday	A semana comeza o luns.
12	StartOfWeek.Tuesday	A semana comeza o martes.
13	StartOfWeek.Wednesday	A semana comeza o mércores.
14	StartOfWeek.Thursday	A semana comeza o xoves.
15	StartOfWeek.Friday	A semana comeza o venres.
16	StartOfWeek.Saturday	A semana comeza o sábado.

ISOWeekNum usa sempre o luns como comezo da semana. En Excel, a función WeekNum admite un código de adición 21 que non se admite aquí; use ISOWeekNum no seu lugar.

Se pasa un único número a estas funcións, o valor de retorno é un único resultado. Se pasa unha táboa dunha única columna que contén números, o valor de retorno é unha táboa de resultados dunha columna única, un resultado para cada rexistro na táboa do argumento. Se ten unha táboa con varias columnas, pode plasmala nunha táboa dunha única columna, como traballar con táboas describe.

Sintaxe

WeekNum(DateTime [, StartOfWeek ])

• DateTime - Obrigatorio. Valor de data/hora no que operar.
• StartOfWeek - Opcional. Código de Excel ou enumeración StartOfWeek que determina que día comeza a semana.

ISOWeekNum(DateTime)

• DateTime - Obrigatorio. Valor de data/hora no que operar. A semana sempre comeza o luns.

Exemplos

Primeira e última semana natural de 2021

Data	WeekNum( Date )	ISOWeekNum( Date )	WeekNum( Date, StartOfWeek.Wednesday )
Venres,1 dexaneiro de2021	1	53	1
Sábado, 2 dexaneiro de2021	1	53	1
Domingo,3 dexaneiro de2021	2	53	1
Luns,4 dexaneiro de2021	2	1	1
Martes, 5 de xaneiro de2021	2	1	1
Mércores, 6 de xaneiro de2021	2	1	2
Xoves, 7 de xaneiro de2021	2	1	2
Sábado,25 de decembro de2021	52	51	52
Domingo,26 dedecembro de2021	53	51	52
Luns,27 dedecembro de2021	53	52	52
Martes28 dedecembro de2021	53	52	52
Mércores29 dedecembro de2021	53	52	53
Xoves30 dedecembro de2021	53	52	53
Venres,31 dedecembro de2021	53	52	53