WEEKDAY

Devolve um número que representa o dia da semana para uma determinada data.

Exemplos de utilização

WEEKDAY(Date)

Sintaxe

A sintaxe seguinte devolve um número que representa o dia da semana de um valor de data.

WEEKDAY( date_expression )

A sintaxe seguinte devolve um número que representa o dia da semana de um valor de data do modo de compatibilidade.

WEEKDAY( X [, format_string ])

Parâmetros

  • date_expression: um campo ou uma expressão de data e hora.
  • X: um campo ou uma expressão que é avaliada como texto, número ou data do modo de compatibilidade.
  • format_string – formato para X. Opcional se X estiver configurado corretamente como um campo de data semântico.

Formato de entrada para datas do modo de compatibilidade

As funções de data suportadas aceitam os seguintes formatos de entrada se X for um campo de texto ou uma expressão, ou uma data no modo de compatibilidade:

  • BASIC: %Y/%m/%d-%H:%M:%S
  • DEFAULT_DASH: %Y-%m-%d [%H:%M:%S]
  • DEFAULT_SLASH: %Y/%m/%d [%H:%M:%S]
  • DEFAULT_DECIMAL: %Y%m%d [%H:%M:%S]
  • RFC_1123: por exemplo, sáb., 24 de maio de 2008, 20:09:47 GMT
  • RFC_3339: por exemplo, 2008-05-24T20:09:47Z
  • DECIMAL_DATE: igual a DEFAULT_DECIMAL

Qualquer formato strptime válido é aceite.

As funções de tempo suportadas aceitam o seguinte formato de entrada se X for um campo ou uma expressão numérica:

  • SECONDS: segundos desde a época
  • MILLIS: milissegundos desde a época
  • MICROS: microssegundos desde a época
  • NANOS: nanosegundos desde a época
  • JULIAN_DATE: dias desde a época

Exemplos

Fórmula de exemplo Entrada Resultado
WEEKDAY(Date) Jan 1, 2019 2
WEEKDAY(Date as Text, 'BASIC') 2019/01/01-09:40:45 2
WEEKDAY(Date as Number, 'SECONDS') 1561784874 6

WEEKDAY(Date as lots of Numbers, 'MILLIS')

1562004058620 1

Notas

Esta função funciona com datas do modo de compatibilidade e tipos de dados Data e Data e hora atualizados.

Os dias contam-se a partir de domingo e o valor de domingo é de 0, pelo que o valor de sábado é de 6.