WEEKNUM
Aplica-se a:
Coluna calculadaTabela calculadaMedidaCálculo visual
Devolve o número da semana para a data indicada de acordo com o valor return_type. O número da semana indica onde a semana cai numericamente dentro de um ano.
Existem dois sistemas utilizados 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 semana 1. Este sistema é a metodologia especificada na norma ISO 8601, vulgarmente conhecida como sistema de numeração das semanas europeias.
Sintaxe
WEEKNUM(<date>[, <return_type>])
Parâmetros
| Termo | Definição |
|---|---|
date |
A data em formato datetime. |
return_type |
(Opcional) Um número que determina em que dia a semana começa. A predefinição é 1. Ver Observações. |
Valor de retorno
Um número inteiro.
Observações
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, a norma de calendário ISO 8601, amplamente utilizada na Europa, define a primeira semana como aquela com a maioria dos dias (quatro ou mais) caindo no ano novo. Isso significa que, se
return_typefor 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 retorna números de semana diferentes da definição da ISO 8601.Para
return_type, os seguintes valores válidos podem não ser suportados por algumas fontes de dados DirectQuery:return_type A semana começa em Sistema 1 ou omitida Domingo 1 2 Segunda-feira 1 11 Segunda-feira 1 12 Tuesday 1 13 Quarta-feira 1 14 Quinta-feira 1 15 Sexta-feira 1 16 Sábado 1 17 Domingo 1 21 Segunda-feira 2
Exemplo 1
O exemplo a seguir retorna o número da semana de 14 de fevereiro de 2010. Este 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. Este cálculo pressupõe que as semanas começam no domingo.
= WEEKNUM('Employees'[HireDate])