DateSerial 函數

套用到
Microsoft 365 Access Access 2024 Access 2021 Access 2019 Access 2016

會傳回指定年、月及日的 Variant (Date)。

語法

日期序列 (年、月、日)

警告 確保參數值在正確的範圍內。 無效的論證可能導致錯誤的結果。

DateSerial 函式語法包含以下參數:

引數 描述
年份 必要。 整數。 數字介於100到9999之間,或是數字表達式。
月份 必要。 整數。 任何數字表達式。
一天 必要。 整數。 任何數字表達式。

註解

若要指定日期,例如1991年12月31日,每個 DateSerial 參數的數字範圍應在該單位的接受範圍內;也就是說,天數為1–31,月份為1–12。 不過,你也可以用任何數字表達式,為每個參數指定相對日期,這些表達式代表某日期前後的天數、月份或年份。

以下範例使用數值表達式代替絕對日期數字。 此處 DateSerial 函式回傳的日期是) (第一天的前一天,) 1 - 1 年 8 月 (8 - 2 前兩個月, () 1990 - 10 1990 年前 10 年;換句話說,是 1980 年 5 月 31 日。

DateSerial(1990 - 10, 8 - 2, 1 - 1)

年份參數的兩位數年份是根據使用者定義的機器設定來解釋的。 預設設定是 0 到 29 之間的數值(含)會被解讀為 2000 至 2029 年。 30 到 99 之間的預設值則解釋為 1930 至 1999 年。 對於其他 年份 論證,請使用四位數年份 (例如1800) 。

Windows 2000 之前的 Windows 版本會根據上述預設值來解讀兩位數的年份。 為了確保函數回傳正確的數值,請使用四位數的年份。

當任何參數超過該參數的接受範圍時,該參數會依適當遞增至下一個較大的單位。 例如,如果你指定35天,則會以一個月和若干天數來評估,視該天數在年份中應用的哪個階段而定。 如果任何單一參數超出 -32,768 到 32,767 的範圍,就會發生錯誤。 若三個參數指定的日期超出可接受的日期範圍,則會發生錯誤。

注意

對於,若 Calendar 屬性設定為公曆,則假設所提供的值為公曆。 若 Calendar 屬性設定為 Hijri,則假設所提供的值為 Hijri。

回傳日期部分以目前 Visual Basic 日曆的時間單位表示。 例如,如果當前曆法是伊斯蘭曆,且要返回的日期部分是年份,那麼年值就是伊斯蘭曆年。 對於論證 年份,介於0到99之間的值(含)會被解釋為1400年至1499年。 其他 年份 數值則使用完整的四位數年份 (例如1520) 。

查詢範例

運算式 結果
選擇日期序列 (2018,12,13) NewDate,來自 ProductSales; 回傳函式參數中指定的年份、月份和日期的「日期」,並顯示在「NewDate」欄位中。 結果:「2018/13/12」。

VBA 範例

注意

下列範例示範如何在 Visual Basic for Applications (VBA) 模組中使用此函數。 如需使用 VBA 的詳細資訊,請在 [搜尋] 旁的下拉式清單中選取 [開發人員參考],並在 [搜尋] 方塊中輸入一個或多個字詞。

此範例使用 DateSerial 函式回傳指定年份、月份和日期的日期。

Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.

選擇合適的約會功能