Compartilhar via


WEEKNUM

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Retorna o número da semana da data determinada de acordo com o valor return_type. O número da semana indica onde a semana cai 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 está numerada na semana 1.
  • Sistema 2 - A semana que contém a primeira quinta-feira do ano é a primeira semana do ano e está 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
date 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 de retorno

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 1º de janeiro é considerada a primeira semana do ano. No entanto, o padrão do calendário ISO 8601, amplamente utilizado na Europa, define a primeira semana como aquela com a maioria dos dias (quatro ou mais) caindo no novo ano. Isso significa que, se return_type for qualquer valor válido diferente de 21, para qualquer ano em que haja três dias ou menos na primeira semana de janeiro, a função WEEKNUM retornará números de semana diferentes da definição ISO 8601.

  • Para return_type, os seguintes valores válidos podem não ter suporte em 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, Funcionários. Esse cálculo pressupõe que as semanas começam no domingo.

= WEEKNUM('Employees'[HireDate])

função YEARFRACWEEKDAY