DatePart 函數

會傳回包含指定日期之指定部分的 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

請參閱

選擇正確的日期函數

需要更多協助?

增進您的 Office 技巧
探索訓練
優先取得新功能
加入 Office 測試人員

這項資訊有幫助嗎?

感謝您的意見反應!

感謝您的意見反應! 我們將協助您與我們的其中一個 Office 支援專員連絡以深入了解您的意見。

×