この記事を開いてくださったこと、心から感謝しています。チャートをクリックした位置の時間や価格を知りたい、あるいは逆に、時間と価格から画面上の位置を知りたいと考えた人も多いはずです。
結論から言うと、画面の座標から時間と価格を知りたいならChartXYToTimePrice、時間と価格から画面の座標を知りたいならChartTimePriceToXYが向いています。
ただし、失敗したときの細かなエラーコードなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・座標の原点・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartXYToTimePriceとChartTimePriceToXYは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。2つは、渡すものと受け取るものが、ちょうど逆の関係にあります。
ChartXYToTimePriceは、座標から時間と価格を求める
MQL5公式リファレンスによると、ChartXYToTimePriceは、チャート上のX座標とY座標を、時間と価格に変換する関数です。戻り値はbool型で、成功すればtrueです。
引数は、チャートID・X・Y・サブウィンドウ番号・時間・価格の6つです。後ろの3つは、結果を受け取るための変数で、関数の中で値が書き込まれます。
- 座標を渡して時間と価格を受け取る
- 引数は6つで、後ろの3つが受け取り用
- 戻り値はbool型(成功ならtrue)
ChartTimePriceToXYは、時間と価格から座標を求める
ChartTimePriceToXYは、チャート上の時間と価格を、X座標とY座標に変換する関数です。戻り値はbool型で、成功すればtrueです。
引数は、チャートID・サブウィンドウ番号・時間・価格・X・Yの6つです。こちらは、後ろの2つが結果を受け取る変数です。
- 時間と価格を渡して座標を受け取る
- 引数は6つで、後ろの2つが受け取り用
- 戻り値はbool型(成功ならtrue)
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartXYToTimePrice | ChartTimePriceToXY |
|---|---|---|
| 渡すもの | X座標とY座標 | 時間と価格 |
| 受け取るもの | サブウィンドウ・時間・価格 | X座標とY座標 |
| サブウィンドウ | 結果として受け取る | 自分で指定する |
| 引数の数 | 6つ | 6つ |
| エラーの調べ方 | GetLastErrorを使う | GetLastErrorを使う |
※公式の説明をもとにした、筆者の整理です。
座標の原点や、サブウィンドウの扱いはどうなっているのか?
座標を扱う関数では、どこを原点にするかが大切です。公式ページに書かれている内容と、書かれていない内容を分けて整理します。
原点は、メインウィンドウの左上
公式ページには、座標の原点は、メインのチャートウィンドウの左上にある、と書かれています。X座標は右へ、Y座標は下へ向かって数える形です。
ただし、単位がピクセルであることや、X・Yが増える向きについて、ページの文章では細かく説明されていません。サンプルの値などから、推測するにとどめます。
- 原点はメインウィンドウの左上
- 単位や向きの細かな説明は記載なし
- サンプルの値から、おおよその感覚はつかめる
サブウィンドウ番号は、受け取るか指定するか
ChartXYToTimePriceでは、サブウィンドウ番号を受け取る変数があり、クリックした位置が、どのウィンドウにあたるかが分かります。0はメインのチャートウィンドウです。
ChartTimePriceToXYでは、反対に、サブウィンドウ番号を自分で指定します。0を渡せば、メインのチャートウィンドウが対象になります。
| 関数 | サブウィンドウ番号の扱い |
|---|---|
| ChartXYToTimePrice | 結果として受け取る |
| ChartTimePriceToXY | 引数として指定する |
| 0の意味 | メインのチャートウィンドウ |
| 範囲外の番号の扱い | 記載なし |
※公式の説明から読み取れる内容を、筆者が整理しました。
チャートIDの0は、現在のチャート
2つの関数とも、チャートIDに0を渡すと、現在のチャートを意味する、と書かれています。別のチャートで使いたいときは、そのチャートのIDを渡します。
- 0は現在のチャート
- ほかのチャートはIDを渡す
失敗したときの扱いは、どうなっているのか?
次に、失敗したときの扱いを整理します。この部分は、公式ページに書かれている範囲が、かなり限られていました。
書かれているのは、GetLastErrorで調べること
2つのページとも、戻り値がfalseのときは、GetLastErrorでエラーの詳細を確認する、と書かれています。具体的なエラーコードの種類は、記載なしです。
- falseならGetLastErrorで調べる
- 具体的なエラーコードは記載なし
- ページに備考の欄は見当たらない
失敗したときの変数の値は、書かれていない
失敗したとき、受け取り用の変数に何が入るのかは、記載なしでした。そのため、falseが返ったときは、受け取った値を使わない書き方が安全です。
| 項目 | 公式ページでの扱い |
|---|---|
| 失敗時の戻り値 | false |
| エラーの詳細 | GetLastErrorで確認 |
| 失敗時の受け取り変数の値 | 記載なし |
| 具体的なエラーコード | 記載なし |
※公式の説明から読み取れる内容を、筆者が整理しました。
公式のサンプルは、どう書かれているのか?
ここでは、公式ページにあるサンプルの流れを見ていきます。それぞれの関数が、どんな場面で使われるかが分かります。
ChartXYToTimePriceのサンプルは、クリック位置に十字線を引く
サンプルは、OnChartEventの中で、チャートがクリックされたときに動きます。クリックしたX座標とY座標を受け取り、時間と価格に変換して、ログに表示します。
そのあと、逆向きの変換も行い、結果を表示します。さらに、同じ位置に垂直線と水平線を引き直して、十字線のように見せたあと、チャートを再描画します。
- クリックの座標を受け取る
- 時間と価格に変換して表示する
- 逆向きの変換も試している
- 垂直線と水平線を引き直す
ChartTimePriceToXYのサンプルは、最新の足の座標を調べる
サンプルは、スクリプトです。CopyRatesで、最新の足を1本だけ取得し、その足の時間と終値を、座標に変換して表示します。
取得に失敗したときや、変換に失敗したときは、エラーコードを表示して終了します。公式の出力例では、ある足の座標が、Xが784、Yが240と表示されています。
| サンプル | やっていること |
|---|---|
| ChartXYToTimePrice | クリック位置を時間と価格に変え、十字線を引く |
| ChartTimePriceToXY | 最新の足の時間と終値を、座標に変える |
※公式のサンプルの内容を、筆者が整理しました。
ここから読み取れることと、読み取れないこと
サンプルから、2つの関数は、行き来できる関係にあると読み取れます。一方で、ChartXYToTimePriceのサンプルには、出力例が載っていない点も確認できました。
| 確認できること | 確認できないこと |
|---|---|
| 2つの変換を行き来できる例がある | クリック位置が範囲外のときの動き |
| 失敗時はエラーコードを表示している | ほかのエラーコードの一覧 |
| 座標の出力例が1つある | ズームや縮尺が変わったときの扱い |
※公式の説明から読み取れる内容を、筆者が整理しました。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、使い方を比べます。実際の結果を示すものではありません。
例の前提を、そろえる
チャートをクリックした位置に印を付け、さらに、ある足の位置に文字を重ねて表示したい場合を考えます。
- クリックした位置に、印を付けたい
- ある足の画面上の位置を知りたい
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
クリック位置に印を付けるなら、座標から変換する
クリックしたときに届く座標を、ChartXYToTimePriceに渡すと、時間と価格が分かります。その値で、線や矢印などのオブジェクトを作る流れです。
- クリックの座標を受け取る
- 時間と価格に変換する
- 変換した値で、オブジェクトを作る
足の位置を知るなら、時間と価格から変換する
ある足の時間と価格が決まっていて、画面上のどこにあるかを知りたいときは、ChartTimePriceToXYを使います。座標が分かれば、画面上の表示を合わせやすくなります。
| 場面(仮) | 向いている関数 |
|---|---|
| クリック位置の時間と価格を知る | ChartXYToTimePrice |
| ある足の画面上の位置を知る | ChartTimePriceToXY |
| オブジェクトの位置を動かす | ObjectMove |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。結局のところ、手元にあるのが座標か、時間と価格かで決まります。
座標から知りたいなら、ChartXYToTimePriceを選ぶ
クリックなどで座標が手に入っていて、そこの時間と価格を知りたいときは、ChartXYToTimePriceが向いています。クリックで操作するツールを作る場面に合います。
FX口座・ツールの比較一覧もあわせて確認してみてください。
時間と価格から知りたいなら、ChartTimePriceToXYを選ぶ
時間と価格が決まっていて、画面上の位置を知りたいときは、ChartTimePriceToXYが向いています。画面上の表示位置を合わせたい場面に合います。
時間と価格でオブジェクトを動かす方法については、ObjectMoveとObjectSetIntegerの記事で整理しています。座標の変換と、オブジェクトの移動を、セットで考えると理解しやすくなります。
- ある足の画面上の位置を知りたい
- 時間と価格から座標を求めたい
- 表示位置を数字で確認したい
小さく試して、動きを確かめる
いきなり複雑なツールを作らず、クリックした位置の時間と価格を、ログに表示するところから始めましょう。表示位置の動かし方は、ChartNavigateとChartSetIntegerの記事が参考になります。









もう1つのコツは、戻り値のboolを必ず確かめ、falseのときはGetLastErrorをログに残すことです。公式のサンプルも、この形で書かれています。
- 戻り値のboolを必ず確認する
- falseなら受け取った値は使わない
- GetLastErrorをログに出す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
どちらの関数も、メインウィンドウ以外で使えるのか?
2つの関数には、サブウィンドウ番号の引数や受け取り用の変数があります。そのため、メイン以外のウィンドウも対象になると読み取れますが、細かな扱いは記載なしです。
- サブウィンドウ番号の引数がある
- 細かな扱いは記載なし
chart_idに0を渡すと、どうなるのか?
公式ページには、0は現在のチャートを意味する、と書かれています。ほかのチャートを対象にしたいときは、そのチャートのIDを渡します。
- 0は現在のチャート
- ほかのチャートはIDを渡す
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartXYToTimePriceとChartTimePriceToXY、クリックした画面の位置から時間と価格を割り出せる便利さと時間と価格から画面上の位置を求められる使いやすさどっちを選ぶ?」
座標から時間と価格を知りたいならChartXYToTimePrice、時間と価格から座標を知りたいならChartTimePriceToXYが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










