時刻を表すバリアント型 (内部処理形式 Date の Variant) の値を返します。
構文
TimeValue(time)
通常、必須の時間引数は、0:00:00 (午前 12:00:00) から 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 関数を使用して文字列を時刻に変換します。 また、日付リテラルを使用して 、バリアント型 変数または Date 変数に時刻を直接割り当てることもできます (たとえば、MyTime = #4:35:17 PM#)。
Dim MyTime
MyTime = TimeValue("4:35:17 PM") ' Return a time.