Função WEEKDAY

Deriva o valor numérico para o dia da semana (1, 2 etc.). A entrada precisa ser uma referência a uma coluna contendo valores Datetime.

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

Dica: é possível usar a função DATEFORMAT para gerar versões de texto do dia da semana. Consulte os exemplos abaixo.

Uso básico

Exemplo de referência de coluna:

derive type:single value:WEEKDAY(MyDate)

Saída: gera uma coluna de valores que contém os valores numéricos do dia da semana derivados da coluna MyDate.

Sintaxe

derive type:single value:WEEKDAY(datetime_col)

ArgumentoObrigatório?Tipo de dadosDescrição
datetime_colSdatetimeNome da coluna cujos valores de dia da semana 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 cujo valor de dia de semana será calculado.

  • Os valores ausentes nos dados de origem dessa função resultam em valores ausentes na saída.
  • Colunas múltiplas e caracteres curinga não são aceitos.

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

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de exemplo
SimDatetimemyDate

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

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Google Cloud Dataprep
Precisa de ajuda? Acesse nossa página de suporte.