TimeValue 関数

TimeValue(strTime)

時刻を表すバリアント型 (内部処理形式が日付型 (Date) の Variant) の値を返します。

引数

strTime

0:00:00 (12:00:00 AM) ～ 23:59:59 (11:59:59 PM) の範囲の時刻を表す文字列式を指定します。
また、この範囲で時刻を表す任意の式を指定することもできます。引数 strTime が有効な値ではない場合は、Null 値を返します。

使用例

次のコードは、TimeValue 関数を使って文字列を時刻に返還する例です。
varTime = #4:35:17 PM# のように、データリテラルを使用して、時刻を直接バリアント型 (Variant) に割り当てることもできます。

Dim strTime
strTime = TimeValue("4:35:17 PM")    '時刻を返します。（4:35:17 PM）

解説

12 時間制、24 時間制のどちらでも時刻を指定することができます。
たとえば、"2:24PM" と "14:24" は、両方とも有効な引数となります。
引数 strTime に日付の値が含まれている場合、TimeValue 関数はその日付を戻り値に含めません。ただし、引数 time に不正な日付を指定したときには、エラーが発生します。