會傳回包含指定日期之指定部分的 Variant (Integer)。
| 警告 使用這個函數時發生問題。 某些日曆年中的最後一個星期一可以傳回為第 53 週，而該週應該是第 1 週。 如需詳細資訊和因應措施，請參閱 Format 或 DatePart 函數可能會傳回一年中最後一個星期一的錯誤週數。 |
|---|
語法
DatePart (interval， date [， firstdayofweek] [， firstweekofyear] )
DatePart 函數語法具有下列引數：
| 引數 | 描述 |
|---|---|
| interval | 必要。 字串運算式，這是您要傳回的時間間隔。 |
| 日期 | 必要。 Variant (日期) 您要評估的值。 |
| firstdayofweek | 可省略。 指定一週第一天的常數。 如果未指定，則會假設星期日。 |
| firstweekofyear | 可省略。 指定一年第一週的常數。 如果未指定，則會假設第一週是 1 月 1 日發生的那一週。 |
設定
interval 引數具有下列設定：
| 設定 | 描述 |
|---|---|
| yyyy | 年 |
| q | 季 |
| m | 月份 |
| y | 日期 |
| d | 日期 |
| w | Weekday |
| ww | 週 |
| h | 時 |
| n | 分鐘 |
| s | 秒 |
firstdayofweek 引數具有下列設定：
| 常數 | 值 | 描述 |
|---|---|---|
| vbUseSystem | 0 | 使用 NLS API 設定。 |
| vbSunday | 1 | 星期日 (預設) |
| vbMonday | 2 | 星期一 |
| vbTuesday | 3 | 星期二 |
| vbWednesday | 4 | 星期三 |
| vbThursday | 5 | 星期四 |
| vbFriday | 6 | 星期五 |
| vbSaturday | 7 | 星期六 |
firstweekofyear 引數具有下列設定：
| 常數 | 值 | 描述 |
|---|---|---|
| vbUseSystem | 0 | 使用 NLS API 設定。 |
| vbFirstJan1 | 1 | 從預設) 1 月 1 日發生的那週開始 (。 |
| vbFirstFourDays | 2 | 從新一年至少有四天的第一週開始。 |
| vbFirstFullWeek | 3 | 從一年中的第一個完整週開始。 |
註解
您可以使用 DatePart 函數來評估日期，然後傳回特定的時間間隔。 例如，您可以使用 DatePart 來計算星期幾或目前的小時。
firstdayofweek 引數會影響使用 “w” 和 “ww” 間隔符號的計算。
如果 日期 是日期文字，則指定的年份會成為該日期的永久部分。 不過，如果 日期 以雙引號括住 (“ ”) 且省略年份，則每次評估 日期 運算式時，程式碼中會插入目前年份。 這使得編寫可以在不同年份使用的代碼成為可能。
注意
針對日期，如果 Calendar 屬性設定為 Gregorian，則提供的日期必須是 Gregorian。 如果日曆是回曆，則提供的日期必須是回曆。
傳回的日期部分是以目前阿拉伯曆法的時間週期單位表示。 例如，如果目前行事曆是回曆，且要傳回的日期部分是年份，則年份值是回曆年份。
查詢範例
| 運算式 | 結果 |
|---|---|
| SELECT DatePart (“yyyy”，[DateofSale]) AS NewDate FROM ProductSales; | 傳回 “DateofSale” 欄位中日期值的 'Year'。 |
| SELECT DatePart (“q”，[DateofSale]) AS NewDate FROM ProductSales; | 根據 “DateofSale” 欄位日期值的行事曆年份) ，傳回「季」 (。 |
| SELECT DatePart (“y”，[DateofSale]) AS NewDate FROM ProductSales; | 傳回 “DateofSale” 欄位日期值 (1 到 365) 的 'Day of Year'。 |
| SELECT DatePart (“d”，[DateofSale]) AS NewDate FROM ProductSales; | 傳回 “DateofSale” 欄位中日期值的 'Day'。 |
| SELECT DatePart (“w”，[DateofSale]) AS NewDate FROM ProductSales; | 傳回 1 到 7 的 'Weekday' (，其中 1 代表 “DateofSale” 欄位日期值的星期日) 。 |
| SELECT DatePart (“ww”，[DateofSale]) AS NewDate FROM ProductSales; | 傳回 “DateofSale” 欄位日期值 1 到 52) 的 '週數' (。 |
| SELECT DatePart (“h”，[DateTime]) AS NewDate FROM ProductSales; | 傳回 “DateTime” 欄位中日期值的 '小時'。 |
| SELECT DatePart (“n”，[DateTime]) AS NewDate FROM ProductSales; | 傳回 “DateTime” 欄位中日期值的「分鐘」。 |
| SELECT DatePart (“s”，[DateTime]) AS NewDate FROM ProductSales; | 傳回 “DateTime” 欄位中日期值的「秒」。 |
VBA 範例
注意
下列範例示範如何在 Visual Basic for Applications (VBA) 模組中使用此函數。 如需使用 VBA 的詳細資訊，請在 [搜尋] 旁的下拉式清單中選取 [開發人員參考]，並在 [搜尋] 方塊中輸入一個或多個字詞。
此範例採用日期，並使用 DatePart 函數顯示該日期發生所在年份的季度。
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg