TimeValue 函式 (Visual Basic)
更新：2007 年 11 月
傳回包含以字串表示的時間資訊，並將日期資訊設定為 1 年 1 月 1 日的 Date 值。
Public Function TimeValue(ByVal StringTime As String) As DateTime
參數
- StringTime
必要項。表示由 1 年 1 月 1 日的 00:00:00 到 9999 年 12 月 31 日的 23:59:59 日期/時間值的 String 運算式。
例外狀況
例外狀況類型 |
錯誤代碼 |
條件 |
|---|---|---|
StringTime 包含無效日期資訊。 |
如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級，請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是，請盡可能考慮以 Visual Basic 的結構化例外處理概觀 取代這類錯誤控制項。
備註
您可以使用 12 小時或 24 小時制輸入有效的時間。例如，"2:24 P.M." 和 "14:24" 都是有效的 StringTime 引數。
如果 StringTime 引數中包含日期資訊，TimeValue 不會在傳回值中包含日期。然而，如果 StringTime 包含無效的日期資訊 (例如 "January 32")，則會發生 InvalidCastException 錯誤。
範例
下列範例會使用 TimeValue 函式，將字串轉換為時間。您也可使用日期常值 (Literal) 直接將時間指派給 Date 變數。
Dim thisTime As Date
thisTime = TimeValue("4:35:17 PM")
需求
命名空間 (Namespace)︰Microsoft.VisualBasic
**模組︰**DateAndTime
組件 (Assembly)：Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)