會傳回指定年、月及日的 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.