TimeValue 関数

  • [アーティクル]

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

TimeValue(time)

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

解説

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

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

Dim MyTime
MyTime = TimeValue("4:35:17 PM")    ' MyTime は、4:35:17 PM です。

必要条件

バージョン 1

参照

DateSerial 関数 | DateValue 関数 | Hour 関数 | Minute 関数 | Now 関数 | Second 関数 | TimeSerial 関数