時刻を表すバリアント型 (内部処理形式 Date の Variant) の値を返します。
構文
TimeValue(time)
required time引数は、通常、0:00:00 (12:00:00 A.M.) から 23:59:59 (11:59:59 P.M.) までの時間を表す文字列式です。 ただし、 time は、その範囲内の時間を表す式も指定できます。 time に Null が含まれている場合は、Null が返されます。
解説
有効な時刻を、12 時間制または 24 時間制で入力できます。 たとえば、 "2:24PM" と "14:24" はどちらも有効な 時間 引数です。
time 引数に日付情報が含まれている場合、TimeValue はそれを返しません。 ただし、 時刻 に無効な日付情報が含まれていると、エラーが発生します。
クエリの例
| Expression | 結果 |
|---|---|
| SELECT TimeValue([DateTime]) AS Expr1 FROM ProductSales; | 日付情報なしでフィールド "DateTime" の時刻値を返し、列 Expr1 に表示されます。 |
| SELECT TimeValue([DateTime]) AS JustTime FROM ProductSales; | 日付情報を含まないフィールド "DateTime" の時刻値を返し、列 JustTime に表示されます。 |
VBA の例
注
次の例は、Visual Basic for Applications (VBA) モジュールでのこの関数の使用方法を示しています。 VBA の使用方法の詳細については、[検索] の横にあるドロップダウン リストで [開発者用リファレンス] を選び、検索ボックスに検索する用語を入力します。
この例では、 TimeValue 関数を使用して文字列を時刻に変換します。 日付リテラルを使用して、時刻を バリアント または 日付 変数に直接割り当てることもできます (例: MyTime = #4:35:17 PM#)。
Dim MyTime
MyTime = TimeValue("4:35:17 PM") ' Return a time.