WeekNum e ISOWeekNum funções

Função	Aplica-se a
ISOWeekNum	Aplicativos de tela Colunas de fórmula Dataverse Aplicações orientadas por modelos Power Pages
WeekNum	Aplicativos do Canvas Fluxos do Copilot Studio Desktop Colunas de fórmulas Dataverse Aplicações orientadas por modelos CLI da Power Platform Funções Dataverse Páginas de energia

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

Descrição

Use as WeekNum funções 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 a 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.

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

ISOWeekNum usa sempre a segunda-feira como início da semana. No Excel, a WeekNum função suporta um código de adição 21 que não é suportado aqui, use 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 [, Início da Semana ])

• DateTime - Obrigató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 - Obrigatório. Valor Data/Hora a utilizar. A semana começa sempre à segunda-feira.

Exemplos

Primeira e última semana de calendário de 2021