Função WEEKNUM

Esta função deriva o valor numérico de uma semana do ano (1, 2 etc.). A entrada precisa ser o resultado da função DATE ou uma referência a uma coluna que contenha valores Datetime. O resultado desta função é incrementado no domingo.

A primeira semana do ano é a semana de 1º de janeiro.

OBSERVAÇÃO: se o valor Datetime de origem não incluir uma entrada válida para esta função, será retornado um valor ausente.

Uso básico

Exemplo de referência de coluna:

derive type:single value:WEEKNUM(MyDate)

Saída: é gerada uma coluna que contém os valores numéricos da semana, derivados da coluna MyDate.

Sintaxe

derive type:single value:WEEKNUM(datetime_col)

ArgumentoObrigatório?Tipo de dadosDescrição
datetime_colSdatetimeNome da coluna com os valores do número da semana que serão computados

Para mais informações sobre os padrões de sintaxe, consulte Notas de sintaxe da documentação da linguagem.

datetime_col

Nome da coluna com o valor de número da semana que precisa ser calculado.

  • Os valores ausentes nos dados de origem desta função geram valores ausentes no resultado.
  • Não são permitidas várias colunas e caracteres curinga.

Dica: não é possível inserir valores Datetime constantes como entradas para esta função. No entanto, é possível usar WEEKNUM(DATE(2017,12,20)).

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de exemplo
SimData/horamyDate

Exemplos

Exemplo: funções Day of Date

Neste exemplo, você aprende a aplicar funções para gerar os valores de dia da semana fora de uma coluna do tipo Datetime:

  • WEEKDAY: retorna o valor numérico do dia da semana para valores Datetime de origem. Consulte Função WEEKDAY.
  • WEEKNUM: retorna o valor numérico da semana no ano para valores Datetime de origem. Consulte Função WEEKNUM.
  • DATEFORMAT: é usado para formatar os valores Datetime de muitas maneiras diferentes. Consulte Função DATEFORMAT.

Origem:

myDate
30/10/17
31/10/17
01/11/17
02/11/17
03/11/17
04/11/17
05/11/17
06/11/17


Transformação:

A transformação abaixo gera um valor numérico para o dia da semana em uma nova coluna:

derive type:single value: WEEKDAY (myDate) as:'weekDayNum'

A próxima transformação gera uma versão em texto completo do nome do dia da semana:

derive type:single value:DATEFORMAT(myDate, 'EEEE') as:'weekDayNameFull'

Esta outra gera uma abreviatura de três letras para o nome do dia da semana:

derive type:single value:DATEFORMAT(myDate, 'EEE') as:'weekDayNameShort'

Esta gera o valor numérico da semana no ano:

derive type:single value: WEEKNUM (myDate) as:'weekNum'

Resultados:

myDateweekDayNumweekDayNameFullweekDayNameShortweekNum
30/10/171Segunda-feiraSeg44
31/10/172Terça-feiraTer44
01/11/173Quarta-feiraQua44
02/11/174Quinta-feiraQui44
03/11/175Sexta-feiraSex44
04/11/176SábadoSáb44
05/11/177DomingoDom45
06/11/171Segunda-feiraSeg45