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 関数を使って、文字列を時刻に変換します。日付リテラルを使用して、時刻を日付型 (Date) の変数に直接代入することもできます。
Dim thisTime As Date
thisTime = TimeValue("4:35:17 PM")
必要条件
名前空間 : Microsoft.VisualBasic
モジュール : DateAndTime
アセンブリ : Visual Basic ランタイム ライブラリ (Microsoft.VisualBasic.dll)