Compartilhar via

Funções WeekNum e ISOWeekNum

  • Artigo

Aplica-se a: Aplicativos de tela Aplicativos baseado em modelo Colunas de fórmula do Dataverse

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

Description

Use as funções WeekNum e ISOWeekNum para determinar o número da 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 para especificar qual dia começa uma semana. Você pode fornecer um número de código do Excel ou usar a enumeração StartOfWeek:

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

ISOWeekNum sempre usa segunda-feira como o início da semana. No Excel, a função WeekNum oferece suporte a um código de adição 21 que não é compatível 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

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