DateSerial 函式

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

語法

DateSerial (年、 月、 日)

DateSerial 函式語法具有下列命名自變數：

部分	描述
年	必填; 整數。 介於 100 到 9999 之間的數位，包含或 數值表示式。
月	必填; 整數。 任何數值表達式。
日	必填; 整數。 任何數值表達式。

註解

若要指定日期，例如 1991 年 12 月 31 日，每個 DateSerial 自變數的數位範圍應在單位的可接受範圍內;也就是說，天為 1–31，月為 1–12。 不過，您也可以使用任何數值表達式來指定每個自變數的相對日期，此表示式代表特定日期之前或之後的天數、月數或年份。

下列範例使用數值表示式，而不是絕對日期數位。 在此 ，DateSerial 函式會傳回日期，也就是第一天 () 1 - 1 的前一天，也就是 1990 年 8 月 (8 - 2) 之前的兩個月，1990 年之前的 10 年 (1990 - 10) ;換句話說，1980 年 5 月 31 日。

在 Windows 98 或 Windows 2000 底下，會根據使用者定義的機器設定來解譯 year 自變數的兩位數年份。 默認設定是包含 0 到 29 之間的值會解譯為 2000–2029 年。 30 到 99 之間的預設值會解譯為 1930–1999 年。 針對所有其他 年份 自變數，請使用四位數年份 (例如 1800) 。

舊版 Windows 會根據先前所述的預設值來解譯兩位數年份。 若要確定函式傳回適當的值，請使用四位數的年份。

當任何自變數超過該自變數的接受範圍時，它會視需要遞增為下一個較大的單位。 例如，如果您指定 35 天，它會評估為一個月和一些天數，視套用該年份的位置而定。 如果有任何單一自變數超出 -32,768 到 32,767 的範圍，就會發生錯誤。 如果三個自變數所指定的日期超出可接受的日期範圍，就會發生錯誤。

注意事項

針對 年、 月和 日，如果 Calendar 屬性設定為公曆，則會假設提供的值為公曆。 如果 Calendar 屬性設定為 Hijri，則會假設提供的值為 Hijri。

傳回的日期部分是目前 Visual Basic 行事歷的時間週期單位。 例如，如果目前的行事曆是Hijri，而要傳回的日期部分是年份，則年份值為回歷年。 針對自 變數年份，介於 0 和 99 之間的值，包含 ，會解譯為年份 1400–1499。 針對所有其他 年份 值，請使用完整的四位數年份 (例如 1520) 。

範例

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

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

另請參閱

• 函式 (Visual Basic for Applications)

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。