Todos os produtos
Search
Central de documentação

MaxCompute:DAYOFWEEK

Última atualização: Jun 26, 2026

Retorna o dia da semana de um valor de data como um número inteiro de 1 (domingo) a 7 (sábado).

Sintaxe

int dayofweek(datetime|timestamp|date|string <date>)

Parâmetros

date: Obrigatório. Valor de data do tipo DATETIME, TIMESTAMP, DATE ou STRING. O valor STRING deve incluir pelo menos a parte yyyy-mm-dd e não pode conter caracteres extras. Formatos aceitos:

  • yyyy-mm-dd

  • yyyy-mm-dd hh:mi:ss

  • yyyy-mm-dd hh:mi:ss.ff3

Valor de retorno

Retorna um valor INT de 1 a 7. Retorna null se a entrada for null, não corresponder a um dos tipos suportados ou não estiver em um formato válido.

Valor de retorno

Dia

1

Domingo

2

Segunda-feira

3

Terça-feira

4

Quarta-feira

5

Quinta-feira

6

Sexta-feira

7

Sábado

Exemplos

-- Returns 5 (Thursday)
SELECT dayofweek('2009-07-30');
-- Output: 5

Funções relacionadas

DAYOFWEEK é uma função de data. Para obter mais informações sobre funções de cálculo e conversão de datas, consulte Funções de data.