WorksheetFunction.HLookup メソッド (Excel)

テーブルの先頭行または値の配列内の値を検索し、テーブルまたは配列で指定した行から同じ列の値を返します。 HLookup は、比較値がデータ テーブルの上部の行に配置されていて、指定した数の行を検索する場合に使用します。 検索するデータの左側の列に比較値がある場合は、 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	省略可能	バリアント型	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 のサポートおよびフィードバックを参照してください。