DateValue 函式 (Visual Basic)
更新:2007 年 11 月
傳回包含以字串表示的日期資訊,並將日期資訊設定為午夜 (00:00:00) 的 Date 值。
Public Function DateValue(ByVal StringDate As String) As DateTime
參數
- StringDate
必要項。表示由 1 年 1 月 1 日的 00:00:00 到 9999 年 12 月 31 日的 23:59:59 日期/時間值的 String 運算式。
例外狀況
例外狀況類型 |
錯誤代碼 |
條件 |
---|---|---|
StringDate 包含無效時間資訊。 |
如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級,請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是,請盡可能考慮以 Visual Basic 的結構化例外處理概觀 取代這類錯誤控制項。
備註
如果 StringDate 只包含數字 1 到 12,並且以有效的日期分隔字元分隔這些數字,DateValue 就會根據為您系統所指定的 Short Date 格式來識別月、日和年的順序。DateValue 會使用取自 System.Globalization 命名空間中的 CultureInfo 類別 (Class) 之 CurrentCulture 屬性的目前行事曆設定。預設的 CurrentCulture 值將由 [控制台] 設定決定。您可以在 System.Globalization 命名空間中,設定 DateTimeFormatInfo 類別的 ShortDatePattern 屬性來覆寫 Short Date 格式。
DateValue 會以完整、縮寫和數字形式識別月份名稱。例如,除了可辨識 12/30/1991 和 12/30/91 外,DateValue 也可辨識 December 30, 1991 和 Dec 30, 1991。
如果省略了 StringDate 中的年份部分,DateValue 將使用電腦的系統日期的年份。
如果 StringDate 引數中包含時間資訊,DateValue 並不會在傳回值中包含時間。但是,如果 StringDate 中包含了無效的時間資訊,例如 "89:98",將發生 InvalidCastException 錯誤。
範例
這個範例會使用 DateValue 函式將字串轉換為日期。您也可使用日期常值 (Literal) 來直接將日期指派給 Object 或 Date 變數,例如 oldDate = #2/12/69#。
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
需求
**模組︰**DateAndTime
組件:Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)