DIA DA SEMANA

Retorna um número que representa o dia da semana de uma data especificada.

Exemplo de uso

WEEKDAY(Date)

Sintaxe

A sintaxe a seguir retorna um número que representa o dia da semana de um valor de data.

WEEKDAY( date_expression )

A sintaxe a seguir retorna 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: campo ou expressão de "Data e hora".
  • X: campo ou expressão que resulta em texto, número ou data do modo de compatibilidade.
  • format_string: formato de X. Essa propriedade é opcional quando X está configurado corretamente como um campo semântico de data.

Formato de entrada para datas do modo de compatibilidade

As funções de data compatíveis aceitam os seguintes formatos de entrada se X for um campo de texto, uma expressão ou uma data do 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, Sat, 24 May 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 é aceito.

Se X for uma expressão ou um campo numérico, as funções de hora compatíveis vão aceitar o seguinte formato de entrada:

  • SECONDS: segundos desde a Era Unix
  • MILLIS: milissegundos desde a Era Unix
  • MICROS: microssegundos desde a Era Unix
  • NANOS: nanossegundos desde a Era Unix
  • JULIAN_DATE: dias desde a Era Unix

Exemplos

Example formula Input Output
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

Observações

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

Os dias são contabilizados a partir do domingo. O valor para domingo é 0 e para sábado, 6.