會傳回包含指定日期之指定部分的 Variant (Integer)。
|
警告 使用此函數時，有一個問題。 某些日曆年度中的最後一個星期一可以當第 53 周當做第 1 周時退回。 有關詳細資訊和解決方法，請參閱 Format 或 DatePart 函數可能會針對年份的最後一個星期一，退回 錯誤的周數。 |
語法
DatePart ( interval， date [， firstdayofweek ] [ ， firstweekofyear])
DatePart函數語法具有這些引數：
引數 | 描述 |
|---|---|
|
interval |
必要。 這是要返回之時間間隔的字串運算式。 |
|
date |
必要。 Variant (日期) 要評估的值。 |
|
firstdayofweek |
選用。 指定 常數 日的第一天。 如果未指定，會假設為星期日。 |
|
firstweekofyear |
選用。 指定一年的第一周的常數。 如果未指定，則假設第一周是 1 月 1 日發生的周。 |
設定
interval 自 變數具有以下設定：
設定 | 描述 |
|---|---|
|
yyyy |
年 |
|
q |
季 |
|
m |
月份 |
|
y |
一年中的一天 |
|
d |
日期 |
|
w |
Weekday |
|
ww |
週 |
|
h |
時 |
|
n |
分鐘 |
|
s |
秒 |
firstdayofweek 自 變數具有以下設定：
常數 | 值 | 描述 |
|---|---|---|
|
vbUseSystem |
0 |
使用 NLS API 設定。 |
|
vbS本 |
1 |
星期日 (預設) |
|
vbMonday |
2 |
星期一 |
|
vbTuesday |
3 |
星期二 |
|
vbWednesday |
4 |
星期三 |
|
vbThursday |
5 |
星期四 |
|
vbFriday |
6 |
星期五 |
|
vbSaturday |
7 |
星期六 |
第 一weekofyear 自 變數具有以下設定：
常數 | 值 | 描述 |
|---|---|---|
|
vbUseSystem |
0 |
使用 NLS API 設定。 |
|
vbFirstJan1 |
1 |
從預設為 1 月 1 日 (開始) 。 |
|
vbFirstFourDays |
2 |
從新的一年至少四天的第一周開始。 |
|
vbFirstFullWeek |
3 |
從一年的第一個完整周開始。 |
註解
您可以使用 DatePart 函數評估日期，並返回特定的時間間隔。 例如，您可以使用 DatePart 來計算星期或目前小時。
firstdayofweek 引數會影響使用 "w" 和 "ww" 間隔符號的計算。
如果 date 是 日期文字，則指定的年份會成為該日期的永久部分。 不過，如果日期以雙引號括住 (" ") ，而您省略年份，則每次評估日期運算式時，您的程式碼會插入目前年份。 這可撰寫可在不同年使用的驗證碼。
附註: 若 為日期，如果 日曆 屬性設定為西曆，則提供的日期必須是西曆。 如果日曆是回曆，則提供的日期必須是回曆。
所退回的日期部分會以目前阿拉伯日曆的時段單位表示。 例如，如果目前的日曆是回曆，而要退回的日期部分是年份，則年份值是回曆年。
查詢範例
運算式 | 結果 |
|---|---|
|
SELECT DatePart ("yyyy",[DateofSale]) AS NewDate FROM ProductSales; |
會返回 "DateofSale" 欄位日期值的 「年份」。 |
|
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" 欄位日期值的 「日」。 |
|
SELECT DatePart ("w",[DateofSale]) AS NewDate FROM ProductSales; |
會 (1 到 7 的「平日」) ，其中 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
