本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# DAYOFWEEK 函數
<a name="DAYOFWEEK"></a>

DAYOFWEEK 函數以日期或時間戳記做為輸入，並以數字傳回星期幾 （星期日為 1，星期一為 2，...，星期六為 7)。

當您需要使用日期或時間戳記的特定元件時，例如執行以日期為基礎的計算、篩選資料或格式化日期值時，此日期擷取函數非常有用。

## 語法
<a name="DAYOFWEEK-syntax"></a>

```
dayofweek(date)
```

## 引數
<a name="DAYOFWEEK-arguments"></a>

*date*  
DATE 或 TIMESTAMP 表達式。

## 傳回值
<a name="DAYOFWEEK-returns"></a>

DAYOFWEEK 函數會傳回 INTEGER，其中

1 = 星期日

2 = 星期一

3 = 星期二

4 = 週三

5 = 星期四

6 = 星期五

7 = 週六

## 範例
<a name="DAYOFWEEK-example"></a>

下列範例會從這個日期擷取星期幾，即 5 （代表星期四）。

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

下列範例會從`squirrels`資料表的 `birthday` 欄擷取星期幾，並將結果傳回為 SELECT 陳述式的輸出。此查詢的輸出將是星期幾值的清單，`squirrels`表格中每一列各一個，代表每個松鼠生日的星期幾。

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