この記事を開いてくださったこと、心から感謝しています。チャートに引いたトレンドラインやチャネルについて、ある価格の時間や、ある時間の価格をプログラムで知りたいと考えた人も多いはずです。
結論から言うと、価格を決めて時間を知りたいならObjectGetTimeByValue、時間を決めて価格を知りたいならObjectGetValueByTimeが向いています。
ただし、失敗したときの値や、存在しない名前を渡したときの動きなどは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の仕組み・対応するオブジェクト・ライン番号・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ObjectGetTimeByValueとObjectGetValueByTimeは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。2つは、渡すものと返すものが、ちょうど逆になっています。
ObjectGetTimeByValueは、価格から時間を返す
MQL5公式リファレンスによると、ObjectGetTimeByValueは、指定したオブジェクトについて、指定した価格に対応する時間を返す関数です。戻り値はdatetime型です。
引数は、チャートID・オブジェクト名・価格・ライン番号の4つです。トレンドラインが、ある価格を通る時間を知りたいときに使います。
- 価格を渡して時間を受け取る
- 戻り値はdatetime型
- 引数は4つで、ライン番号を含む
ObjectGetValueByTimeは、時間から価格を返す
ObjectGetValueByTimeは、指定したオブジェクトについて、指定した時間に対応する価格を返す関数です。戻り値はdouble型です。
引数は、チャートID・オブジェクト名・時間・ライン番号の4つです。ライン上の、ある時間の価格を知りたいときに使います。
- 時間を渡して価格を受け取る
- 戻り値はdouble型
- 引数は4つで、ライン番号を含む
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ObjectGetTimeByValue | ObjectGetValueByTime |
|---|---|---|
| 渡すもの | 価格 | 時間 |
| 返すもの | 時間(datetime) | 価格(double) |
| 引数の数 | 4つ | 4つ |
| ライン番号 | 必要 | 必要 |
| 対応するオブジェクト | 7種類(共通) | 7種類(共通) |
※公式の説明をもとにした、筆者の整理です。
対応しているオブジェクトには、どんな種類があるのか?
2つの関数は、すべてのオブジェクトで使えるわけではありません。公式ページには、対応するオブジェクトが限られていると書かれています。
対応しているのは、ライン系の7種類
公式ページに書かれている対応オブジェクトは、トレンドライン、角度によるトレンドライン、ガンライン、等間隔チャネル、線形回帰チャネル、標準偏差チャネル、矢印付きラインの7種類です。
2つの関数で、この一覧は共通です。水平線や垂直線、テキストなどが対応するかどうかは、ページの一覧に含まれていませんでした。
- トレンドライン
- 角度によるトレンドライン
- ガンライン
- 等間隔チャネル(2本)
- 線形回帰チャネル(3本)
- 標準偏差チャネル(3本)
- 矢印付きライン
ラインの本数は、種類によって違う
公式ページには、等間隔チャネルは2本、線形回帰チャネルと標準偏差チャネルは3本のラインを持つ、と書かれています。ほかの種類の本数は、ページの一覧に記載なしでした。
| オブジェクト | ラインの本数(公式の記載) |
|---|---|
| 等間隔チャネル | 2本 |
| 線形回帰チャネル | 3本 |
| 標準偏差チャネル | 3本 |
| そのほか | 記載なし |
※公式の説明から読み取れる内容を、筆者が整理しました。
ライン番号は、なぜ必要なのか
公式ページには、1つのオブジェクトが、同じ価格の座標に複数の値を持つことがあるため、ライン番号を指定する必要がある、と書かれています。チャネルのように、線が複数あるためです。
- 線が複数あるオブジェクトがある
- どの線かを番号で指定する
- サンプルでは0と1を使っている
ライン番号の決まりは、どこまで分かるのか?
ライン番号は、実際にコードを書くときに、いちばん迷いやすい点です。確認できた範囲と、できなかった範囲を分けて整理します。
確認できたこと
サンプルでは、2本のラインを持つ等間隔チャネルに、0と1を渡しています。このことから、2本なら0と1で呼ぶ書き方が読み取れます。
- 2本のチャネルに0と1を渡している
- 結果は、ラインごとに別々に返る
- 両方の関数で書き方は同じ
確認できなかったこと
番号が0から始まるのかどうかは、ページの説明文に記載なしでした。どの番号がどの線に当たるのかも、種類ごとの対応表は記載なしです。範囲外の番号を渡したときの動きも、記載なしでした。
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
呼び出しの重さや、失敗したときの扱いはどうなっているのか?
次に、2つの関数の注意点を整理します。同期呼び出しである点と、失敗時の扱いがポイントです。
同期呼び出しで、待ち時間が出ることがある
公式ページによると、この関数は同期呼び出しです。そのチャートで、この呼び出しより前に積まれたすべての命令の実行を待ってから動くため、時間がかかる場合があります。
チャート上に多くのオブジェクトがあるときは、この特徴を考えに入れる必要がある、と書かれています。ループの中で何度も呼ぶときは、特に注意が必要です。
- 積まれた命令の実行を待つ
- 時間がかかる場合がある
- ループで何度も呼ぶときは要注意
失敗したときの値は、書かれていない
2つのページには、失敗したときの戻り値や、GetLastErrorで調べられるかどうかの説明が、記載なしでした。エラーコードの種類も、記載なしです。
ただし、ObjectGetTimeByValueのサンプルでは、戻り値が0より大きいかを確かめて、時間がないときに「値なし」と表示しています。ページの文章ではなく、サンプルの書き方から読み取れる扱いです。
| 項目 | 公式ページでの扱い |
|---|---|
| 失敗時の戻り値 | 記載なし |
| GetLastErrorの扱い | 記載なし |
| 時間がないときの判定 | サンプルで0より大きいかを確認 |
| 存在しない名前の扱い | 記載なし |
※公式の説明から読み取れる内容を、筆者が整理しました。
公式のサンプルは、どう書かれているのか?
ここでは、公式ページにあるサンプルを見ていきます。どちらも、等間隔チャネルを作ってから、値を読む流れになっています。
ObjectGetTimeByValueのサンプルは、価格を下げながら時間を読む
サンプルは、表示中のチャートの左端の高値から、右端の安値まで、等間隔チャネルを作ります。そのあと、チャートの最高値から最安値まで、100ポイントずつ価格を下げながら、2本のラインの時間を読みます。
結果には、時間が見つかる価格と、「値なし」になる価格が並びます。たとえば、チャネルの範囲より上や下の価格では、値なしになっています。
- チャネルの価格を100ポイントずつ下げる
- 0番と1番のラインの時間を読む
- 見つからないときは値なしと表示
- 最後に5秒待ってから削除する
ObjectGetValueByTimeのサンプルは、足ごとに価格を読む
こちらのサンプルも、同じ形の等間隔チャネルを作ります。そのあと、表示中の左端の足から右端の足まで、足ごとの時間を取り出し、0番と1番のラインの価格を読んで表示します。
結果には、足ごとに、2本のラインの価格が並びます。時間が進むにつれて、価格が少しずつ下がっていく様子が、出力に載っています。
| サンプル | 渡すもの | 読むもの |
|---|---|---|
| ObjectGetTimeByValue | 価格(100ポイント刻み) | 0番・1番ラインの時間 |
| ObjectGetValueByTime | 足ごとの時間 | 0番・1番ラインの価格 |
※公式のサンプルの内容を、筆者が整理しました。
ここから読み取れることと、読み取れないこと
サンプルの結果から、チャネルの範囲の外では、時間が返らない場合があることが読み取れます。ただし、ラインの延長部分が対象なのかどうかは、ページの説明に記載なしでした。
| 確認できること | 確認できないこと |
|---|---|
| 範囲の外では値なしになる例がある | 延長した線が対象かどうか |
| 足ごとに価格が読める | 足と足の間の時間の扱い |
| 最後にオブジェクトを削除している | 時間帯のずれの扱い |
※公式の説明から読み取れる内容を、筆者が整理しました。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、使い方を比べます。実際の結果を示すものではありません。
例の前提を、そろえる
チャートにトレンドラインを1本引いてあり、あとからそのラインの値を調べたい場合を考えます。
- トレンドラインが1本ある
- ある価格の時間と、ある時間の価格を知りたい
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
価格が決まっているなら、時間を知る
ある価格に、ラインがいつ届くのかを知りたいときは、ObjectGetTimeByValueを使います。価格を決めて、時間を受け取る流れです。
- 価格を渡す
- ライン番号を指定する
- 時間を受け取る
時間が決まっているなら、価格を知る
ある時間に、ラインがどの価格にあるのかを知りたいときは、ObjectGetValueByTimeを使います。時間を決めて、価格を受け取る流れです。
| 知りたいこと(仮) | 向いている関数 |
|---|---|
| ある価格に届く時間 | ObjectGetTimeByValue |
| ある時間のライン上の価格 | ObjectGetValueByTime |
| ラインそのものを動かす | ObjectMove |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。結局のところ、手元にあるのが価格か時間かで決まります。
時間を知りたいなら、ObjectGetTimeByValueを選ぶ
価格を起点に、ラインが通る時間を調べたいときは、ObjectGetTimeByValueが向いています。価格を段階的に変えて、時間を並べて見るような使い方に合います。
FX口座・ツールの比較一覧もあわせて確認してみてください。
価格を知りたいなら、ObjectGetValueByTimeを選ぶ
時間を起点に、ライン上の価格を調べたいときは、ObjectGetValueByTimeが向いています。足ごとに回して、価格を並べる使い方に合います。
ラインそのものを動かす関数については、ObjectMoveとObjectSetIntegerの記事で整理しています。読む側と動かす側を、セットで考えると理解しやすくなります。
- 時間を決めて価格を調べたい
- 足ごとに回して並べたい
- ラインの動きを数字で追いたい
小さく試して、動きを確かめる
いきなり多くのオブジェクトで使わず、トレンドラインを1本だけ作って、値を表示するところから始めましょう。使い終わったオブジェクトの片づけは、ObjectDeleteとObjectsDeleteAllの記事が参考になります。









もう1つのコツは、戻り値が0のときの扱いを、自分のコードで決めておくことです。公式のサンプルにも、0より大きいかを確かめる書き方があります。
- 戻り値が0のときの扱いを決める
- ループの中で呼びすぎない
- 使い終わったオブジェクトは片づける
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
水平線や垂直線でも使えるのか?
公式ページの対応一覧には、水平線や垂直線は含まれていませんでした。使えるかどうかは、ページに記載なしです。使いたいときは、自分の環境で試して確かめましょう。
- 対応一覧には含まれていない
- 使えるかは記載なし
chart_idに0を渡すと、どうなるのか?
公式ページには、0は現在のチャートを意味する、と書かれています。ほかのチャートを読みたいときは、そのチャートのIDを渡します。
- 0は現在のチャート
- ほかのチャートはIDを渡す
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のObjectGetTimeByValueとObjectGetValueByTime、価格から時間を逆算して探せる便利さと時間から価格を読み取れる素直さどっちを選ぶ?」
価格を決めて時間を知りたいならObjectGetTimeByValue、時間を決めて価格を知りたいならObjectGetValueByTimeが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










