WEEKNUM
Aplica-se a: Coluna calculada Tabela calculada Medida Cálculo visual
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, 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 Employees. Esse cálculo pressupõe que as semanas começam no domingo.
= WEEKNUM('Employees'[HireDate])