この記事を開いてくださったこと、心から感謝しています。Pine Scriptでチャートのラベルに「現在値は150.250、損切りは149.900」のような文章を出そうとして、プラスでつなぐか、str.formatを使うか、迷った人も多いはずです。
結論から言うと、数値の桁数や見た目まで整えたいならstr.format、短い文字をつなぐだけならプラスでの連結が向いています。
この記事では、2つの書き方の違い・数値の整え方・初期設定の落とし穴・使い分けを整理し、自分に合う書き方まで踏み込んでまとめます。
プラスでの連結とstr.formatは、何が違うのか?
まずは、2つの書き方の基本と、考え方の違いを整理します。
プラスでの連結は、文字列を1つずつつなぐ
TradingViewの公式ドキュメントによると、Pine Scriptの文字列は、あとから変更できません。プラスでつなぐたびに、新しい文字列が作られます。「Hello 」と「world」をつなげば、新しい「Hello world」ができます。
- プラスでつなぐたびに新しい文字列ができる
- 短い文字をつなぐだけなら簡単
str.formatは、型紙に値を差し込む
公式ドキュメントでは、str.formatは、複数の文字列を作って、何度も連結する方法の、より簡単な代わりだと説明されています。書き方は、型紙の文字列のあとに、差し込む値を並べます。型紙の中の0や1といった番号が、あとに並べた値の順番を指します。
数値を文字にするときの見た目が、大きな違いになる
プラスでつなぐときは、数値を先に文字列へ変える必要があります。str.formatなら、型紙の中で、数値の見た目まで、指定できます。数値を含む文章を作るなら、str.formatのほうが、書きやすくなります。
- プラスでは数値を先に文字へ変える
- str.formatは型紙の中で見た目も指定できる
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
数値の見た目は、どう整えるのか?
型紙の中での、数値の書式の指定を確認します。
numberの修飾子に、書式を続ける
公式ドキュメントによると、型紙の中の番号のあとに、numberという修飾子と、書式の型を続けると、数値の見た目を指定できます。書式の型には、シャープ、0、ピリオド、カンマ、最後のパーセントを使います。
- 番号のあとにnumberと書式を続ける
- シャープや0などで桁を指定する
シャープは、0でなければ桁を出す
公式ドキュメントでは、シャープは、その桁が0でないときだけ、数字を出すと説明されています。0は、その桁に、いつも数字を出します。この違いで、末尾の0を出すか出さないかを、選べます。
| 書式 | 1234.5の表示 |
|---|---|
| シャープ(#.##) | 1234.5 |
| 0(0.00) | 1234.50 |
※公式ドキュメントの説明をもとにした、筆者の計算例です。
用意された書式で、手早く整えられる
公式ドキュメントでは、あらかじめ用意された書式として、整数、通貨、パーセントが挙げられています。整数なら、カンマ区切りの整数に丸められ、パーセントなら、100をかけて整数に丸めて、%が付きます。
- 整数・通貨・パーセントが用意されている
- 手早く見た目を整えられる
str.tostringとは、どう使い分けるのか?
数値を文字に変える、もう1つの方法を確認します。
str.tostringは、数値を1つだけ文字にする
公式ドキュメントによると、str.tostringは、数値を文字列に変える関数で、書式として、最小の値動きの単位、パーセント、出来高、または書式の型を指定できます。プラスで連結するときは、この関数で数値を文字にしてから、つなぎます。
- 数値を文字列に変える関数
- 連結の前に使う
最小の値動きの単位に合わせると、価格が自然に見える
公式ドキュメントでは、最小の値動きの単位の書式は、その銘柄の最小の単位に丸めて、末尾の0を付けないと説明されています。価格をラベルに出すときに、銘柄に合った桁数で、自然に表示できます。
パーセントは、掛け算の有無に注意する
公式ドキュメントによると、書式の最後にパーセントを付けると、数値に100をかけて表示します。一方、パーセントの用意された書式の例では、呼び出す前に、自分で100をかけています。使う書式で、掛け算の要否が違うため、注意しましょう。
たとえば、ta.trをcloseで割った値が0.0123のとき、書式を「#.####%」にすれば、100をかけて、1.23%と表示されます。
- 最後のパーセントは100をかけて表示する
- 書式で掛け算の要否が違う
初期設定の落とし穴は、何か?
2つの関数で、初期の見た目が違う点を確認します。
str.tostringの初期値は、小数点以下8桁まで
公式ドキュメントでは、str.tostringの初期の書式は、小数点以下を8桁まで丸め、末尾の0を付けないと説明されています。123.456は、そのまま「123.456」と表示されます。
- 初期は小数点以下8桁まで
- 末尾の0は付かない
str.formatの初期値は、カンマ区切りで3桁まで
公式ドキュメントによると、str.formatの初期の書式は、カンマ区切りで、小数点以下3桁までです。str.tostringとは初期値が異なるため、同じ値でも、見た目が変わる場合があります。
たとえば、1234.5678を、書式を指定せずに、str.formatで表示すると、「1,234.568」になる計算です。str.tostringなら、「1234.5678」のままです。
| 関数 | 初期の書式 | 1234.5678の表示(筆者の計算) |
|---|---|---|
| str.tostring | 小数点以下8桁まで | 1234.5678 |
| str.format | カンマ区切り・3桁まで | 1,234.568 |
※公式ドキュメントの初期の書式をもとにした、筆者の計算例です。
価格に使うなら、書式を必ず指定する
価格のように、桁数が大切な値は、初期の書式に任せず、書式を指定するのが安全です。想定外のカンマや、丸めによる桁のずれを、防げます。
- 書式を指定して桁数をそろえる
- 想定外のカンマを防げる
波かっこと時刻の扱いは、どう違うのか?
つまずきやすい細かな決まりを、確認します。
波かっこは、対になっていないとエラーになる
公式ドキュメントによると、引用されていない左の波かっこには、対応する右の波かっこが必要です。対になっていないと、実行時のエラーになります。波かっこそのものを表示したいときは、アポストロフィで囲む必要があります。
時刻の表示は、str.format_timeが便利
公式ドキュメントでは、str.format_timeは、UNIX時間を、年月日や時分秒の形で表示する関数と説明されています。str.formatがUTCで表示するのに対し、str.format_timeは、どのタイムゾーンでも表現できます。
- UNIX時間を日付や時刻の形にできる
- タイムゾーンを指定して表示できる
置き換えや分割の関数も、役に立つ
公式ドキュメントでは、文字を置き換えるstr.replaceと、すべて置き換えるstr.replace_all、区切りで分けるstr.splitも紹介されています。たとえば、「AAPL,NVDA」を、カンマで分ければ、2つの銘柄名の配列になります。
- 置き換えは1つか全部かを選べる
- 区切りで分けると配列になる
実際に、どう使い分ければいいのか?
ここでは、場面ごとに、どちらを選ぶとよいかの目安を整理します。
短い固定の文字なら、プラスで十分
「買い」や「売り」のような、固定の文字に、短い言葉を足すだけなら、プラスでの連結で、十分です。書き方も短く、読みやすくなります。

- 固定の短い文字をつなぐだけなら簡単
- 短く読みやすい
数値を含む文章なら、str.format
価格や割合を含む文章を作るなら、str.formatが向いています。部品の数が多いほど、差が出ます。たとえば、6つの部品をつなぐ文章なら、プラスでは5回の連結が必要ですが、str.formatなら、型紙1つで済みます。
| 書き方 | 6つの部品をつなぐ文章 |
|---|---|
| プラスでの連結 | プラスが5回 |
| str.format | 型紙が1つ |
※部品が6つという仮定にもとづく、筆者の整理です。
ラベルに出すなら、書式の指定で見た目をそろえる
ラベルに、価格や損切りの目安を出すときは、桁数をそろえると、見た目が整います。ラベルの使い方は、Pine Scriptのplotshapeとlabel.newを比べた記事で整理しています。


- 桁数をそろえて見た目を整える
- ラベルの使い方は別の記事で確認する
書いたあとは、何を確認すればいいのか?
文字の見た目を確かめる、手順をまとめます。
実際のチャートで、表示を確かめる
書式は、頭の中で想像するより、実際のチャートで確かめるほうが、確実です。数値が大きいときや小さいときの、両方の表示を見て、カンマや桁数が、想定どおりか確認しましょう。
- 実際のチャートで表示を見る
- 大きい値と小さい値で試す
- カンマや桁数を確かめる
配列と組み合わせると、一覧も作れる
複数の値を、まとめて文章にしたいときは、配列と組み合わせる方法もあります。配列の考え方は、Pine Scriptの配列と変数の履歴参照を比べた記事で整理しています。チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。



- 配列と組み合わせて一覧を作れる
- 書式の指定を先に決めておく
最初は、短い文章で試す
最初は、数値を1つだけ差し込む、短い文章で試しましょう。差し込みの番号や、書式の動きがつかめてから、部品を増やすのが、無理のない進め方です。



- 数値1つの短い文章で試す
- 慣れてから部品を増やす
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
numberの書式に、ほかの書き方はあるのか?
公式ドキュメントには、通貨記号を付ける書式など、ほかの書き方の例も載っています。この記事では、すべての書式は紹介していません。使いたい書式は、最新の公式ドキュメントで、確認しましょう。
- 通貨記号を付ける書式なども載っている
- 最新の公式ドキュメントで確認する
処理の速さは、プラスとstr.formatで違うのか?
公式ドキュメントの読んだ範囲では、速さの比較は、確認できませんでした。この記事では、速さの優劣は断定しません。最新の公式ドキュメントで、確かめましょう。
まとめ:「Pine Scriptのstr.formatとプラスでの連結、数値の見た目まで整えられる便利さと短く素直に書ける簡単さどっちを選ぶ?」
数値を含む文章ならstr.format、短い固定の文字ならプラスでの連結が向いています。初期の書式が関数で違う点に、気をつけましょう。
文字の整え方が分かると、チャートの表示が少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトにてご確認ください。










