WeekNum e ISOWeekNum funções

Função	Aplica-se a
ISOWeekNum	Colunas de fórmulas do Dataverse de aplicativos de tela Power Pages
WeekNum	Aplicativos de tela O Copilot Studio Desktop flui colunas de fórmula do Dataverse para aplicativos controlados por modelos do Power Platform CLI Dataverse functions Power Pages

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

Description

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

Essas 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 dessa função pode variar de 1 a 54.

• ISOWeekNum usa a semana que contém a primeira quinta-feira do ano como a primeira semana do ano. Isso segue a Definição padrão de data e hora do ISO 8601 para numeração da semana. O resultado dessa função pode variar de 1 a 53. É possível que 52 ou 53 sejam devolvidos para os primeiros dias de janeiro, pois as datas podem pertencer à última semana do ano anterior.

Use o segundo parâmetro para WeekNum especificar qual dia começa por semana. Você pode fornecer um número de código do Excel ou usar a enumeração StartOfWeek:

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

Se você passar um número para essas funções, o valor de retorno será um resultado único. Se você passar uma tabela de coluna única que contém números, o valor retornado é uma tabela de resultados de coluna única, com um resultado para cada registro na tabela do argumento. Se você tiver uma tabela de várias colunas, é possível formatá-la como uma tabela de coluna única, como descrito em Trabalhando com tabelas.

Sintaxe

WeekNum(DateTime [, StartOfWeek ])

• DateTime - Obrigatório. Valor de data/hora no qual operar.
• StartOfWeek - Opcional. Código do Excel ou enumeração StartOfWeek que determina em que dia a semana começa.

ISOWeekNum(DateTime)

• DateTime - Obrigatório. Valor de data/hora no qual operar. A semana sempre começa na segunda-feira.

Exemplos

Primeira e última semanas de calendário de 2021