As funções WeekNum e ISOWeekNum em Power Apps

Devolve o número da semana de uma data específica.

Descrição

Utilize as funções WeekNum e ISOWeekNum para determinar o número da semana de uma data.

Estas funções diferem na forma como determinam a primeira semana do ano (semana 1):

• WeekNum usa a semana que contém 1 de janeiro como a primeira semana do ano. O resultado desta função pode variar de 1 a 54.

• ISOWeekNum utiliza a semana que contém a primeira quinta-feira do ano como primeira semana do ano. Isto segue a definição padrão de data e hora ISO 8601 para a numeração da semana. O resultado desta função pode variar de 1 a 53. É possível que 52 ou 53 possam ser devolvidos nos primeiros dias de janeiro, uma vez que as datas podem pertencer à última semana do ano anterior.

Utilize o segundo parâmetro para a WeekNum para especificar por que dia começa uma semana. Pode fornecer um número de código Excel ou utilizar a enumeração StartOfWeek:

Código do Excel	Enumeração StartOfWeek	Descrição
1, 17	StartOfWeek.Sunday	A semana começa ao domingo. Predefinição.
2, 11	StartOfWeek.Monday	A semana começa à segunda-feira.
12	StartOfWeek.Tuesday	A semana começa à terça-feira.
13	StartOfWeek.Wednesday	A semana começa à quarta-feira.
14	StartOfWeek.Thursday	A semana começa à quinta-feira.
15	StartOfWeek.Friday	A semana começa à sexta-feira.
16	StartOfWeek.Saturday	A semana começa ao sábado.

ISOWeekNum usa sempre a segunda-feira como início da semana. No Excel, a função WeekNum suporta um código de adição 21 que não é suportado aqui; utilize o ISOWeekNum em vez disso.

Se transmitir um único número a estas funções, o valor devolvido será um único resultado. Se passar uma tabela de coluna única que contenha números, o valor devolvido é uma tabela de coluna única de resultados, um resultado para cada registo na tabela do argumento. Se tiver uma tabela com várias colunas, pode formatá-las para uma tabela com uma única coluna, conforme descrito em trabalhar com tabelas.

Sintaxe

WeekNum(DateTime [, StartOfWeek ])

• DateTime – Necessário. Valor Data/Hora a utilizar.
• StartOfWeek - Opcional. Código Excel ou enumeração StartOfWeek que determina em que dia a semana começa.

ISOWeekNum(DateTime)

• DateTime – Necessário. Valor Data/Hora a utilizar. A semana começa sempre à segunda-feira.

Exemplos

Primeira e última semana de calendário de 2021

Data	WeekNum( Date )	ISOWeekNum( Date )	WeekNum( Date, StartOfWeek.Wednesday )
Sexta, janeiro 1, 2021	1	53	1
Sábado, Janeiro 2, 2021	1	53	1
Domingo, janeiro 3, 2021	2	53	1
Segunda, janeiro 4, 2021	2	1	1
Terça, janeiro 5, 2021	2	1	1
Quarta, janeiro 6, 2021	2	1	2
Quinta, janeiro 7, 2021	2	1	2
Sábado, dezembro 25, 2021	52	51	52
Domingo, dezembro 26, 2021	53	51	52
Segunda, dezembro 27, 2021	53	52	52
Terça, dezembro 28, 2021	53	52	52
Quarta, dezembro 29, 2021	53	52	53
Quinta, dezembro 30, 2021	53	52	53
Sexta, dezembro 31, 2021	53	52	53

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).