共用方式為


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 運算式。

例外狀況

例外狀況類型

錯誤代碼

條件

InvalidCastException

13

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 中)

請參閱

參考

DateTime

DateSerial 函式 (Visual Basic)

DateValue 函式 (Visual Basic)

Hour 函式 (Visual Basic)

Minute 函式

Now 屬性

Second 函式 (Visual Basic)

TimeSerial 函式 (Visual Basic)

Date 資料型別 (Visual Basic)

TimeSpan