WEEKNUM

Retorna o número da semana para a data especificada de acordo com o valor de return_type. O número da semana indica onde a semana se encaixa numericamente dentro de um ano.

Há dois sistemas usados para esta função:

  • Sistema 1 – a semana que contém 1º de janeiro é a primeira semana do ano e é numerada semana 1.
  • Sistema 2 – a semana que contém a primeira quinta-feira do ano é a primeira semana do ano e é numerada como a semana 1. Esse sistema é a metodologia especificada no ISO 8601, que é geralmente conhecida como sistema europeu de numeração da semana.

Sintaxe

WEEKNUM(<date>[, <return_type>])  

Parâmetros

Termo Definição
data A data no formato datetime.
return_type (Opcional) Um número que determina em qual dia a semana começa. O padrão é UTF-1. Consulte Observações.

Valor retornado

Um número inteiro.

Comentários

  • Por padrão, a função WEEKNUM usa uma convenção de calendário na qual a semana que contém o dia 1º de Janeiro é considerada a primeira semana do ano. No entanto, o padrão de calendário ISO 8601, amplamente usado na Europa, define a primeira semana como sendo aquela com a maioria dos dias (quatro ou mais) enquadrados no novo ano. Isso significa que return_type é qualquer valor além de 21 nos anos em que há três dias ou menos na primeira semana de Janeiro, a função WEEKNUM retorna números de semana diferentes daqueles retornados segundo a definição da ISO 8601.

  • No caso de return_type, exceto para 21, os seguintes valores válidos podem não ter suporte por algumas fontes de dados do DirectQuery:

    return_type A semana começa em Sistema
    1 ou omitido Sunday 1
    2 Monday 1
    11 Monday 1
    12 Terça-feira 1
    13 Quarta-feira 1
    14 Quinta-feira 1
    15 Friday 1
    16 Sábado 1
    17 Sunday 1
    21 Monday 2

Exemplo 1

O exemplo a seguir retorna o número da semana 14 de fevereiro de 2010. Esse cálculo pressupõe que as semanas começam na segunda-feira.

= WEEKNUM("Feb 14, 2010", 2) 

Exemplo 2

O exemplo a seguir retorna o número da semana da data armazenada na coluna HireDate da tabela Employees. Esse cálculo pressupõe que as semanas começam no domingo.

= WEEKNUM('Employees'[HireDate])

Confira também

função YEARFRAC
função WEEKDAY