すべてのコレクション
基本的な使い方
Excelアドインを利用する
Excelアドイン(エクセルアドイン)を使う(関数編)
Excelアドイン(エクセルアドイン)を使う(関数編)
ヘルプデスク avatar
対応者:ヘルプデスク
一週間前以上前にアップデートされました

Excelアドイン関数を使ってデータを取得する方法をご紹介します。

操作方法

※ 事前に日経ValueSearch Excelアドインをインストールしてください。詳しくは、

をご覧ください。

(1)Excelを起動して、任意のセルに、以下のように、入力

  =関数名(引数、...)

  ・先頭は”=”(イコール)

  ・"="の次は関数名  

  ・関数名の後ろに引数(ひきすう)と呼ぶ関数の設定値

  ・引数部分の前後はカッコで囲む

(2)ログイン画面がポップアップ表示されたら、「日経IDでログイン」ボタン押下

※すでにログインしている場合は、上記ログイン画面は表示されません。

※別ウィンドウ(AuthView)で⽇経IDのログイン画⾯が表⽰された場合は、日経ID(メールアドレス)とパスワードを⼊⼒してログインボタンを押下してください。

関数の戻り値が関数名を入力したセルに表示されます。


具体例による説明

まず、Excelアドイン関数を使って、下記の<表1>のB4を埋めることを考えます。

当期利益は財務諸表(国内企業)の項目なので、NVS_FSTM関数を使います。NVS_FSTM関数の引数は8つあるので、B4に、

 =NVS_FSTM(B6, B7, B8, B9, B10, B11, B12, B13)

と入力します。続いて、「Excelアドイン関数仕様書(国内企業)」の<取得項目指定方法>にしたがって、B6("item":取得項目)に当期利益を意味する".091.resultItemValue"、B7("acc":決算期)に"202303"、B8("corpCode":株式コード/日経会社コード)にトヨタ自動車の株式コードの"7203"、B9("largeItemId":財務諸表項目ID(データ種別))に損益計算書を意味する"3"、B10("year":決算年度)に"2022"、B11("accKbn":決算区分)に年度を意味する"1"、B12("accKind":決算種別)に連結優先を意味する"3"、B13("monetaryCode":通貨単位区分)に百万円単位を意味する"1"を入れます。(「Excelアドイン関数仕様書(国内企業)」の説明がわかりにくいときは、Excelアドインテンプレートの計算式を参考にしてください。)

B4に、トヨタ自動車の2023年3月期の当期利益、2,451,318(百万円)が表示されます。

次に、Excelアドイン関数を使って、下記の<表2>のB4~D4を埋めることを考えます。

B4については、<表1>と同じように、B4にNVS_FSTM関数、B6~B13に引数を入れれば、埋めることができます。C4、D4については、B4と違うのは株式コードだけですから、$(絶対指定)を使って、B4の式を

 =NVS_FSTM($B$6, $B$7, B$8, $B$9, $B$10, $B$11, $B$12, $B$13)

と書き換えて、B4をC4、D4にコピー&ペーストし、C8、D8にそれぞれ日産自動車、本田技研工業の株式コードである"7201"、”7267"を入力します。

C4、D4にそれぞれ日産自動車の221,900(百万円)、本田技研工業の695,267(同)が表示されます。

今度は、Excelアドイン関数を使って、下記の<表3>のB4~B6を埋めてみましょう。

B4、B8~B15は<表1>と同じです。今度は決算期と決算年度が違うので、$を使ってB4の式を

 =NVS_FSTM($B$6, B$7, $B$8, $B$9, B$10, $B$11, $B$12, $B$13)

と書き換えて、B4をC4、D4にコピー&ペーストし、C9、D9にそれぞれ、"202203"、"202103"、C12、D12にそれぞれ、"2021"、"2020"と入力します。

C4、D4にそれぞれ、2022年3月期の2,850,110(百万円)、2021年3月期の2,245,261(同)が表示されます。

最後に、B8に任意の株式コードを入れると、自動的に社名や当該企業の直近3期分の当期利益を取って来て、B2に社名、B3~D3に決算期、B4~D4に当期利益を表示する汎用的な<表4>を作ってみましょう。

B4~D4、B6、B9、B11~B13に<表3>と同じ式/テキスト/数値を入力します。

社名の取得にはNVS_OVDS関数を使います。NVS_OVDS関数の2番目の引数("corpCode")は既出(B8)なので、B2に、

 =NVS_OVDS(B14, B8)

と入力し、B14に企業サマリの企業略称を意味する"'corpName"を入れます。

試しにB8に"7751"と入れると、B2に株式コード、7751の会社名、"キャノン"が表示されます。

決算期、決算年度の取得には、当該銘柄の「相対的な」決算期や年度を照会するための関数である,NVS_FSMP関数を使います。NVS_FSMP関数の2番目の引数("corpCode")と5番目の引数("accKind")は既出(B8とB12)で、1期前、2期前は1番目の引数以外は同じなので、B7に、

 =NVS_FSMP(B$15, $B$8, $B$16, $B$17, $B$12)

と入力して、C7、D7にコピー&ペーストします。決算期の取得項目は"'resultPeriod.[n].acc"(n:0(直近期、-1(1期前)、-2(2期前)、...)なので、B15~D15に"'resultPeriod.0.acc"、"'resultPeriod.-1.acc"、"'resultPeriod.-2.acc"と入れます。さらに、B16("accType":決算区分)に年度を意味する"1"、B17("ytFlag":有報/短信フラグ)に有報優先であること意味する"YT"を入力します。

B7~D7にキャノンの直近決算期の202212(YYYYMM表示)、1期前決算期の202112(同)、2期前決算期の202012(同)が表示されます。続いて、決算年度についても、同様に、B10に、

 =NVS_FSMP(B$18, $B$8, $B$16, $B$17, $B$12)

と入力して、B10をC10、D10にコピー&ペースト、B18、C18、D18に"'resultPeriod.0.businessYear"、"'resultPeriod.-1.businessYear"、"'resultPeriod.-2.businessYear"と入れます。

B10~D10にキャノンの直近決算年度の2022(YYYY表示)、1期前決算年度の2021(同)、2期前決算年度の2020(同)、B4~D4にキャノンの2022年12月期の当期利益、243,961(百万円)、2021年12月期の214,718(同)、2020年12月期の83,318(同)が表示されます。

後は、B3~D3をB7~D7からExcelの文字列操作で作成して完成です。


関数名一覧

<国内企業>

・企業サマリ

  NVS_OVDS ("item", "corpCode")

・企業概要情報(主要取引銀行)

  NVS_CGLI ("item", "corpCode")

・国内役員情報

  NVS_OFCR ("item", "corpCode")

・大株主情報

  NVS_MSHR ("item", "corpCode", "from_acc", "to_acc", "acc", "accKind")

・財務諸表(国内企業)

  NVS_FSTM ("item", "acc", "corpCode", "largeItemId", "year", "accKbn" , "accKind", "monetaryCode")

・財務諸表(国内企業)の表示期間情報

  NVS_FSMP ("item", "corpCode", "accType","ytFlag", "accKind")

・バリュエーション(企業価値)

  NVS_EPVL ("item", "corpCode", "acc")

・バリュエーション(投資指標)

  NVS_INDX ("item", "corpCode", "acc")

・ベータ値

  NVS_BETA ("item", "corpCode", "periodType", "period")

・直近株価

  NVS_STLP ("item", "corpCode")

・株価

  NVS_STCD ("item", "corpCode", "shiteibi", "eigyobiFlg", "periodType")

  NVS_STCD ("item", "corpCode", "shiteibi")

・株価一括

  NVS_BATCH_STCD ("item", "corpCode", "startDate", "endDate", "periodType")

・業績予想

  NVS_ENFC ("item", "acc", "corpCode", "expectationType", "accKbn", "accKind")

・業績予想-会社予想達成率

  NVS_EFAR ("item", "acc", "corpCode", "est_source", "item_type", "est_type", "accKind")

・業界集計

  NVS_ISST ("item", "acc", "nkgnCode", "largeItemId")

・業界集計の表示期間情報

  NVS_ISSP ("item", "nkgncode")

・証券営業日

  NVS_SBD ("item", "shiteibi", "periodType", "kikan", "eigyobiFlg")

・企業セグメント情報(事業の種類別セグメント情報)

  NVS_SEGM_BS ("item", "corpCode", "fromAcc", "toAcc", "acc", "accType", "expFlg")

・企業セグメント情報(製品及びサービスごとの情報)

  NVS_SEGM_PDSV ("item", "corpCode", "fromAcc", "toAcc", "acc", "accType", "expFlg")

・企業セグメント情報(海外売上高情報)

  NVS_SEGM_OV ("item", "corpCode", "fromAcc", "toAcc", "acc", "accType", "expFlg")

・企業セグメント情報(所在地別セグメント情報)

  NVS_SEGM_LOC ("item", "corpCode", "fromAcc", "toAcc", "acc", "accType", "expFlg")

・企業セグメント情報(地域ごとの情報)

  NVS_SEGM_AREA ("item", "corpCode", "fromAcc", "toAcc", "acc", "accType", "expFlg")

・コーポレートガバナンス情報

  NVS_GOV ("item", "corpCode")

・働きやすさ情報

  NVS_EASE_WORK ("item", "corpCode", "publishYear")

・労務状況情報

  NVS_LABOR_INFO ("item", "corpCode", "fromAcc", "toAcc", "acc")

・バリュエーション日次系列(国内上場)

  NVS_VLML ("item", "data_id", "corpCode", "date", "dataKind", "freq")

・DCF情報

  NVS_DCF ("item", "corpCode", "acc")

・株価指数取

  NVS_SICD ("item", "indexCode", "shiteibi", "eigyobiFlg", "periodType")

  NVS_SICD ("item", "indexCode", "shiteibi")

<海外企業>

・海外企業ID

  NVS_GET_FS_ID ("inputCode", "getType")

・海外企業サマリ

  NVS_FS_OVDS ("item", "permanentId")

・海外株主情報

  NVS_FS_SHLDR ("item", "permanentId")

・海外財務諸表

  NVS_FS_FSTM ("item", "acc", "permanentId", "largeItemId", "year", "accKbn", "currencyType") ※yearがある場合

  NVS_FS_FSTM ("item", "acc", "permanentId", "largeItemId", "", "accKbn", "currencyType") ※yearがない場合

・海外財務諸表の表示期間情報

  NVS_FS_FSMP ("item", "accKbn", "permanentId")

・海外業績予想

  NVS_FS_ENFC ("item", "permanentId", "currencyType")

・海外セグメント情報

  NVS_FS_SEGM ("item", "acc", "permanentId", "currencyType")

・海外株価

  NVS_FS_STPR("item", "permanentId", "dated") ※datedがある場合

  NVS_FS_STPR("item", "permanentId") ※datedがない場合 

(2024/01)

こちらの回答で解決しましたか?