

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Função DAYOFWEEK
<a name="DAYOFWEEK"></a>

A função DAYOFWEEK usa uma data ou timestamp como entrada e retorna o dia da semana como um número (1 para domingo, 2 para segunda-feira,..., 7 para sábado).

Essa função de extração de data é útil quando você precisa trabalhar com componentes específicos de uma data ou carimbo de data/hora, como ao realizar cálculos baseados em datas, filtrar dados ou formatar valores de data.

## Sintaxe
<a name="DAYOFWEEK-syntax"></a>

```
dayofweek(date)
```

## Argumentos
<a name="DAYOFWEEK-arguments"></a>

*data*  
Uma expressão DATE ou TIMESTAMP.

## Retornos
<a name="DAYOFWEEK-returns"></a>

A função DAYOFWEEK retorna um INTEGER onde

1 = domingo

2 = segunda-feira

3 = terça-feira

4 = quarta-feira

5 = quinta-feira

6 = sexta-feira

7 = sábado

## Exemplos
<a name="DAYOFWEEK-example"></a>

O exemplo a seguir extrai o dia da semana dessa data, que é 5 (representando quinta-feira).

```
SELECT dayofweek('2009-07-30');
 5
```

O exemplo a seguir extrai o dia da semana da `birthday` coluna da `squirrels` tabela e retorna os resultados como saída da instrução SELECT. O resultado dessa consulta será uma lista dos valores do dia da semana, um para cada linha na `squirrels` tabela, representando o dia da semana do aniversário de cada esquilo. 

```
SELECT dayofweek(birthday) FROM squirrels
```