テーブルの一番上の行または値の配列を検索し、テーブルまたは配列に指定した行から同じ列の値を返します。 HLookup は、比較値がデータ テーブルの一番上にある行に配置され、指定した行数だけ下に表示する場合は、 LDookup を使用します。 比較値が検索するデータの左側にある列にある場合は、 VLookup を使用します。
構文
式。HLookup (arg1, arg2, arg3, arg4)
式: WorksheetFunction オブジェクトを表す変数。
パラメーター
| 名前 | 必須 / オプション | データ型 | 説明 |
|---|---|---|---|
| Arg1 | 必須 | バリアント型 (Variant) | 検索値: 範囲の上端行で検索する値を指定します。 検索値には、値、セル参照、または文字列を指定します。 |
| Arg2 | 必須 | バリアント型 (Variant) | 範囲: 目的のデータが含まれるテーブルを指定します。 セル範囲の参照、またはセル範囲名を指定します。 |
| Arg3 | 必須 | バリアント型 (Variant) | 行番号: 目的のデータが入力されている行を、範囲内の上端から数えた行数で指定します。 行番号に 1 を指定すると、範囲の上端行の値が返され、行番号に 2 を指定すると、範囲の上から 2 行目の値が返されます。 row_index_numが 1 未満の場合、 HLookup は #VALUE! を返します。 エラー値;row_index_num が table_array の行数より大きい場合、 HLookup は #REF! を返します。 が返されます。 |
| Arg4 | 省略可能 | バリアント型 (Variant) | Range_lookup - HLookup が完全一致を検索するか、近似一致を検索するかを指定する論理値。 True または省略した場合、近似一致が返されます。 つまり、完全一致が見つからない場合は、lookup_value より小さい最も近い大きな値が返されます。 False の場合、HLookup は完全一致を検索します。 見つからない場合は、エラー値 #N/A が返されます。 |
戻り値
Variant
注釈
HLookup で lookup_value が見つからず、range_lookup が True の場合は、lookup_value 未満の最大値が使用されます。
lookup_value が table_array の最初の行の最小値よりも小さい場合、 HLookup は #N/A エラー値を返します。
range_lookup が False で lookup_value がテキストの場合、lookup_value でワイルドカード文字である疑問符 (?) とアスタリスク (*) を使用できます。 ワイルドカード文字の疑問符は任意の 1 文字を表し、アスタリスクは任意の文字列を表します。 ワイルドカード文字ではなく、通常の文字として疑問符やアスタリスクを検索する場合は、その文字の前に、"~*" のように半角のティルダ (~) を付けます。
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。