STOCKHISTORY 関数は、金融商品に関する履歴データを取得し、配列として読み込みます。これは、数式の最終結果に合わせて振り分けられます。 つまり、Enter キーを押すと、適切なサイズの配列範囲が動的に作成されます。
重要: STOCKHISTORY 関数には、 Microsoft 365 Personal、 Microsoft 365 Family、 Microsoft 365 Business Standard、または Microsoft 365 Business Premium サブスクリプションが必要です。
技術的詳細
構文
=STOCKHISTORY(stock, start_date, [end_date], [interval], [headers], [property0], [property1], [property2], [property3], [property4], [property5])
STOCKHISTORY 関数の書式には、次の引数があります。
|
引数 |
説明 |
|---|---|
|
stock |
関数は、この値に対応する金融商品に関する価格データの履歴を返します。 ティッカー シンボル (証券コード) を二重引用符で入力する (例: "MSFT")、または 株式 データ型を含むセルへの参照を入力します。 これは、商品の既定の取引所からデータを引き出します。 また、4文字の ISO 市場識別コード (MIC) にコロン、ティッカー シンボル (例: "XNAS:MSFT") を続けて入力すると、特定の取引所を参照することができます。 詳細については、「データソースについて」を参照してください。 |
|
start_date |
データが取得された最も早い日付です。 間隔が 0 (毎日) でない場合、最初のデータポイントは指定された start_date よりも早くなる可能性があることに注意してください。これは、要求された期間の最初の日付になります。 |
|
end_date |
省略可能です。 データが取得される最後の日付です。 既定は start_date です。 |
|
interval |
省略可能です。 各データ値が表す間隔を次のように指定します。 0 = 毎日、 1 = 毎週、 2 = 毎月。 既定値は 0 です。 |
|
ヘッダー |
省略可能です。 見出しを次のように表示するかどうかを指定します。 0 = ヘッダーなし、 1 = ヘッダーを表示します。 2 = インストルメント識別子とヘッダーを表示します。 既定値は 1 です (つまり、[ヘッダーを表示])。 この関数が含まれる場合、ヘッダーは、関数から返された配列の一部であるテキストの行です。 |
|
property0 - property5 |
省略可能です。 ストックごとに取得される列を次に示します。 0 = 日付、 1 = Close、 2 = Open、 3 = High、 4 = Low、 5 = ボリューム。 いずれかが存在する場合は、指定された列のみが指定された順序で返されます。 既定値は 0、1 (始値と終値) です。 |
メモ
-
STOCKHISTORY 関数は、入力されるセルに書式設定を行いません。 数式を削除すると、入力したセルは一般的な形式になります。
-
プロパティの引数を入力する場合は、各プロパティの 0 から 5 までの数値を、表示する順序で入力します。 各プロパティに入力する値は、プロパティ番号に対応しています。 たとえば、"日付"、"始値"、"終値" などを含めるには、"0, 2, 1" と入力します。 これらのプロパティは次のように定義されます。
Value
プロパティ
定義
0
日付
間隔が毎日または毎週の場合、期間内の最初の有効な取引日。間隔が月単位の場合は、取引日であったかどうかに関係なく、月の最初の日。
1
終値
期間内の最終取引日の終値
2
開く
期間の最初の取引日の始値
3
高値
期間の最高日の高値
4
安値
期間内の最低日の安値
5
出来高
期間中に取引された株式数
-
STOCKHISTORY 関数は、関数の検索/行列ファミリに属します。
-
日付の引数には、二重引用符で囲んだ日付を指定することができます (例:"01-01-2020") または数式 (例: TODAY ()) または日付を含むセルへのセル範囲を指定します。
-
返された日付が、指定された日付より前になる場合があります。 たとえば、2019 年 12 月 31 日が開始日に指定され、間隔が月単位である場合、2019 年 12 月 1 日は指定された期間の開始日になり、2019年12月1日が返されます。
-
一部の金融商品は株式データ型として利用できますが、履歴情報は利用できません。 たとえば、これは、S&P 500 を含む最も人気のあるインデックス ファンドの場合です。
Tips (ヒント)
-
3 か月間で最高値を取得する場合は、1 日または毎週の間隔よりも月単位の間隔を使用する方が高速です。 たとえば、 =MAX(STOCKHISTORY("XNAS:MSFT", "1/1/2022", "3/1/2022", 2, 0, 3)) では、3 つのデータポイント (毎月 1 つ) の最大値を計算し、ヘッダーのないデータのみを計算し、各月の最高の取引値を計算します。 代わりに、数式で週単位または日単位の間隔を使用した場合、同じ結果が得られますが、計算で使用されるデータポイントが多くなり、パフォーマンスが低下する可能性があります。
-
52 週間の高値または低値を確認する場合は、多くの場合、これらのプロパティをすぐに使用できる Stocks データ型を使用する方が高速です。 たとえば、"xnas:msft" をセル A1 のストック データ型に変換し、セル B1 で数式 =A1.[52 week high] を記述して値を取得できます。 ここで 説明するように、その値を自動的に更新するようにブックを構成することもできます。
-
STOCKHISTORYは、履歴データを表示する際に、一般に取引日が完了した後にのみ更新されます。 つまり、STOCKHISTORYを使用して、市場が終了した後、または市場に応じてその日が完了するまで、今日の取引の詳細のデータを取得することはできません。
-
自動的に更新する関数 (TODAY など) で STOCKHISTORY を使用し、ブックで自動計算が有効になっている場合、ブックを開くと STOCKHISTORY によってデータが自動的に更新されます。 この更新はバックグラウンドで行われ、この更新の進行中に必要に応じてブックを編集できます。 ブックで多数の STOCKHISTORY 関数呼び出しが使用されている場合、このバックグラウンド更新は、データを更新する必要がある限り続行されます。 必要に応じて、このプロセス中にいつでもブックを閉じることがあります。
