この記事を開いてくださったこと、心から感謝しています。Pine Scriptで直近10本の終値をまとめて扱いたいとき、close[1]やclose[2]を並べて書くか、配列に入れて管理するか、迷った人も多いはずです。
結論から言うと、決まった本数を1つずつ見るだけなら変数の履歴参照、直近の値を入れ替えながらまとめて集計したいときは配列が向いています。
この記事では、配列の仕組み・番号の数え方・上限・履歴参照との違い・使い分けを整理し、自分に合う書き方まで踏み込んでまとめます。
Pine Scriptの配列とは、どんな仕組みなのか?
まずは、配列の基本と、ふつうの変数との違いを整理します。
同じ種類の値を、1か所にまとめて持つ入れ物
TradingViewの公式ドキュメントによると、Pine Scriptの配列は、複数の値や参照を、1つの場所にまとめて保存できる、1次元の集まりです。中に入れる値は、すべて同じ種類である必要があります。
- 複数の値を1か所にまとめる
- 中身は同じ種類にそろえる
番号は、0から数え始める
公式ドキュメントでは、配列の番号は0から始まり、要素の数より1小さい値までと説明されています。10個の要素があるなら、番号は0から9までです。1から数える感覚だと、ずれやすいため、注意が必要です。
マイナスの番号で、後ろから数えられる
公式ドキュメントによると、配列の値を取る関数などでは、マイナスの番号も使えます。-1がいちばん最後の要素で、要素の数にマイナスを付けた番号が、最初の要素です。10個の配列なら、-10が最初、-1が最後です。
| 要素が10個の配列 | プラスの番号 | マイナスの番号 |
|---|---|---|
| 最初の要素 | 0 | -10 |
| 最後の要素 | 9 | -1 |
※公式ドキュメントの説明をもとにした整理です。仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
配列には、どんな上限や決まりがあるのか?
使う前に知っておきたい、上限とエラーの決まりを確認します。
要素の合計は、最大10万個まで
公式ドキュメントでは、1つの配列に入れられる要素の合計は、10万個を超えられないと説明されています。直近の数本を扱う使い方なら、まず届かない数ですが、足ごとに追加し続ける使い方では、届く場合があります。
- 1つの配列は最大10万個
- 追加し続けると届く場合がある
足ごとに追加し続けると、何日分で届くのか
1分足で、1本ごとに1つずつ追加し続けるとします。平日24時間取引なら、1週間で7,200本です。10万個に届くのは、100,000÷7,200で、約13.9週間、およそ3.2か月の計算です。長い期間のチャートでは、上限に気をつけましょう。
| チャートの足 | 1週間の本数 | 10万個に届く目安 |
|---|---|---|
| 1分足 | 7,200本 | 約13.9週間(約3.2か月) |
| 1時間足 | 120本 | 約833週間(約16年) |
※平日24時間取引を仮定した、筆者の計算例です。1か月は約4.3週で数えています。
範囲の外の番号を指定すると、エラーになる
公式ドキュメントによると、有効な範囲の外の番号を指定すると、実行時のエラーになります。10個の配列で、番号10を指定すると、範囲の外です。要素の数を確かめてから、番号を指定する習慣をつけましょう。
変数の履歴参照とは、何が違うのか?
closeの1つ前などを指す書き方と、配列の違いを確認します。
変数は、足ごとに履歴を持つ
公式ドキュメントでは、配列の要素は、時系列ではないと説明されています。close[1]のような変数は、足ごとの履歴を横方向に持つのに対し、配列は、各足に存在する、1つの集まりです。
- 変数は足ごとの履歴を持つ
- 配列は1つの集まりとして存在する
配列にも、1つ前の足の配列を呼び出せる
公式ドキュメントによると、配列の変数にも、履歴を参照する演算子が使え、過去の足の配列を返します。たとえば、a[1]は、1本前の足の配列です。ただし、足ごとの配列の履歴は、慎重に扱う必要があります。
- a[1]で1本前の配列を呼べる
- 配列の履歴は慎重に扱う
直近の値を、入れ替えながら持つ書き方
公式ドキュメントの例では、直近の10本の終値を持つために、新しい値を最後に足して、いちばん古い値を、先頭から取り除く書き方が示されています。この入れ替えで、配列の大きさは、10のまま保たれます。
足ごとの配列と、足をまたぐ配列は、別物
配列は、足ごとに作り直される場合と、varで同じものを使い続ける場合で、動きが変わります。足ごとに作り直すなら、その足の中だけの、一時的な集まりです。varを付ければ、足をまたいで、値を積み重ねられます。
どちらを選ぶかは、「その足だけで集計して捨てる」のか、「足をまたいで貯める」のかで決めましょう。
- 足ごとに作り直すなら一時的な集まり
- varなら足をまたいで貯められる
配列を使うと、何がうれしいのか?
配列を使うと、直近の値を、関数でまとめて集計できます。その便利な点を、順番に確認します。
平均や最大値などを、関数で求められる
公式ドキュメントによると、配列には、平均、最小、最大、中央値、標準偏差、合計を求める関数が、用意されています。直近10本の終値を配列に入れれば、平均や最大値を、すぐに求められます。
| 知りたいこと | 配列の関数 |
|---|---|
| 平均 | array.avg |
| 最大・最小 | array.max・array.min |
| 中央値 | array.median |
| 合計 | array.sum |
※公式ドキュメントの説明をもとにした整理です。
通常の数学の関数は、使えない
公式ドキュメントでは、Pineの通常の数学の関数は、配列には使えないと説明されています。配列の集計には、配列専用の関数を使う必要があります。通常の関数と取り違えないよう、注意しましょう。
- 配列には専用の関数を使う
- 通常の数学の関数は使えない
統計の関数で、ばらつきも見られる
公式ドキュメントでは、標準偏差を求める関数も、用意されていると説明されています。直近の値のばらつきを、数字で確かめたいときに、役立ちます。たとえば、直近10本の終値のばらつきが大きいか小さいかを、見られます。
ばらつきの数字は、相場の落ち着き具合を、大まかにつかむ手がかりになります。ただし、数字だけで判断せず、チャートも合わせて確認しましょう。
- 標準偏差でばらつきを見られる
- チャートと合わせて確認する
並べ替えも、できる
公式ドキュメントによると、配列は、整数、小数、文字列の種類なら、並べ替えができます。値の大きい順に並べて、上位3つだけを見る、といった使い方もできます。
- 整数・小数・文字列は並べ替えられる
- 上位だけを見る使い方もできる
実際に、どう使い分ければいいのか?
ここでは、場面ごとに、配列と履歴参照の、どちらを選ぶとよいかの目安を整理します。
2〜3本を比べるだけなら、履歴参照で十分
「今の終値が、1本前の終値より高いか」のような、少ない本数の比較なら、close[1]のような履歴参照で、十分です。配列を作る手間が、いりません。書き方も、短くて分かりやすくなります。

- 少ない本数の比較に向く
- 配列を作る手間がいらない
集計や並べ替えをするなら、配列
直近10本の平均や最大値、上位3つの抽出のように、まとめて集計したいなら、配列が向いています。入れ替えながら持つ書き方なら、いつも最新の10本を保てます。
ループとの組み合わせは、Pine Scriptのforループと組み込み関数ta.smaを比べた記事でも整理しています。
- 平均や最大値をまとめて求められる
- いつも最新の本数を保てる
配列を足ごとに残したいなら、varを使う
公式ドキュメントでは、varを付けた配列の変数は、明示的に別の配列へ入れ直すまで、同じ配列を指し続けると説明されています。
足ごとに1つ追加する使い方なら、最後の足では、大きさが、足の番号+1になります。varの考え方は、Pine Scriptのvarとvaripを比べた記事で整理しています。
運用で気をつけたいことは、何か?
配列のコードを書いたあとに、動きが意図どおりかを確かめるための手順を、順番にまとめます。
要素の数を、確かめる習慣をつける
配列の番号を指定する前に、要素の数を確かめると、範囲外のエラーを防げます。とくに、チャートの最初のほうの足では、まだ要素が少ないため、注意が必要です。
- 要素の数を確かめる
- 番号が範囲内かを見る
- 最初の足の動きも確認する
naが混ざったときの動きを、知っておく
公式ドキュメントによると、配列の集計関数は、一部の要素がnaでも、基本的にはnaを返さず、計算を続けます。ただし、すべての要素がnaのときなど、例外もあります。naが混ざる場面では、結果を見て確かめましょう。


- 一部がnaでも基本は計算を続ける
- すべてnaのときは例外がある
画面の表示は、別の関数で行う
配列の値を、チャートに表示したいときは、別の表示の関数が必要です。目印を出す関数と、文字を出す関数のどちらを選ぶかは、目的で変わります。
チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。



- 表示は別の関数で行う
- 表示の方法も合わせて選ぶ
配列の中身は、あとから確かめやすくする
配列の中身は、そのままでは、チャートに見えません。動きがおかしいと感じたときは、一時的に、中身を文字にして表示して、確かめましょう。要素の数や、最初と最後の値を見るだけでも、原因をつかみやすくなります。
- 要素の数を表示して確かめる
- 最初と最後の値を見る
最初は、小さな配列で試す
最初から大きな配列で試すと、動きが分かりにくくなります。要素が3つ程度の小さな配列で、入れ替えや集計の動きを確かめてから、本数を増やすのが、無理のない進め方です。



- まず3つ程度で動きを確かめる
- 慣れてから本数を増やす
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
配列と変数で、処理の速さは違うのか?
公式ドキュメントの読んだ範囲では、処理の速さについての、はっきりした説明は確認できませんでした。この記事では、速さの比較は、断定しません。最新の公式ドキュメントで、確かめましょう。
配列には、文字列も入れられるのか?
はい、入れられます。公式ドキュメントでは、並べ替えができる種類として、文字列も挙げられています。ただし、1つの配列には、同じ種類の値だけを入れる決まりです。
- 文字列の配列も作れる
- 1つの配列は同じ種類だけ
まとめ:「Pine Scriptの配列と変数の履歴参照、直近の値をまとめて集計できる便利さと少ない本数を素直に書ける分かりやすさどっちを選ぶ?」
少ない本数の比較なら履歴参照、直近の値をまとめて集計したいなら配列が向いています。番号が0から始まる点と、10万個の上限に気をつけましょう。
道具の違いが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトにてご確認ください。










