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)