時刻を表すバリアント型 (内部処理形式 Date の Variant) の値を返します。
構文
TimeValue ( time )
必須の 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 引数です。
ti me 引数に日付情報が含まれる場合でも、TimeValue はそれを返しません。 ただし、time に無効な日付情報が含まれる場合は、エラーが発生します。
クエリの例
|
式 |
結果 |
|
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 MyTimeMyTime = TimeValue("4:35:17 PM") ' Return a time.
