MENU
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
AIの進化がFXトレーディングに革新を
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
  1. ホーム
  2. FX自動売買と人工知能
  3. MQL5のObjectGetTimeByValueとObjectGetValueByTime、価格から時間を逆算して探せる便利さと時間から価格を読み取れる素直さどっちを選ぶ?
⚠️本内容の引用・転載(画像の再アップロード含む)は自由です。その際は当サイトへのリンク設置をお願いします。

MQL5のObjectGetTimeByValueとObjectGetValueByTime、価格から時間を逆算して探せる便利さと時間から価格を読み取れる素直さどっちを選ぶ?

2026 11/17
PR
FX自動売買と人工知能
2026年11月17日
MQL5のObjectGetTimeByValueとObjectGetValueByTimeの比較

この記事を開いてくださったこと、心から感謝しています。チャートに引いたトレンドラインやチャネルについて、ある価格の時間や、ある時間の価格をプログラムで知りたいと考えた人も多いはずです。

結論から言うと、価格を決めて時間を知りたいならObjectGetTimeByValue、時間を決めて価格を知りたいならObjectGetValueByTimeが向いています。

ただし、失敗したときの値や、存在しない名前を渡したときの動きなどは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。

この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の仕組み・対応するオブジェクト・ライン番号・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。

MQL5のObjectGetTimeByValueとObjectGetValueByTimeの違いをまとめたインフォグラフィック
目次

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から始まるのかどうかは、ページの説明文に記載なしでした。どの番号がどの線に当たるのかも、種類ごとの対応表は記載なしです。範囲外の番号を渡したときの動きも、記載なしでした。

  • 番号が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の記事が参考になります。

価格と時間で、渡すものと返すものが逆になっていると分かって、整理できました。調べてよかったです。
対応するオブジェクトが7種類だけだと分かって、使う前の確認ができて安心しました。
Kenichi
Kenichi
記載なしの点が分かると、試すときの確認項目が増えて、落ち着いて進められます。調べておいてよかったです。
2つを見比べたら、場面ごとの選び方が整理されて、コードを書くのが楽しみになりました。

もう1つのコツは、戻り値が0のときの扱いを、自分のコードで決めておくことです。公式のサンプルにも、0より大きいかを確かめる書き方があります。

  • 戻り値が0のときの扱いを決める
  • ループの中で呼びすぎない
  • 使い終わったオブジェクトは片づける

よくある質問にはどんなものがあるのか?

始める前に、多くの人が気になる疑問を短くまとめます。

水平線や垂直線でも使えるのか?

公式ページの対応一覧には、水平線や垂直線は含まれていませんでした。使えるかどうかは、ページに記載なしです。使いたいときは、自分の環境で試して確かめましょう。

  • 対応一覧には含まれていない
  • 使えるかは記載なし

chart_idに0を渡すと、どうなるのか?

公式ページには、0は現在のチャートを意味する、と書かれています。ほかのチャートを読みたいときは、そのチャートのIDを渡します。

  • 0は現在のチャート
  • ほかのチャートはIDを渡す

この記事の例は、実際の結果なのか?

いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。

  • 仮の前提による例
  • 実際の動きとは異なる場合がある

まとめ:「MQL5のObjectGetTimeByValueとObjectGetValueByTime、価格から時間を逆算して探せる便利さと時間から価格を読み取れる素直さどっちを選ぶ?」

価格を決めて時間を知りたいならObjectGetTimeByValue、時間を決めて価格を知りたいならObjectGetValueByTimeが向いています。記載のない点は、自分の環境で確かめましょう。

  • 価格から時間ならObjectGetTimeByValue
  • 時間から価格ならObjectGetValueByTime
  • 記載なしの点は自分で確かめる

仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。

出典・参照元

  • MQL5 リファレンス(ObjectGetTimeByValue)
  • MQL5 リファレンス(ObjectGetValueByTime)

※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • MQL5のObjectGetIntegerとObjectGetDouble、時間や色など整数系の値をまとめて読み取れる守備範囲の広さと価格やレベル値を小数のまま読み取れる正確さどっちを選ぶ?
  • MQL5のChartIndicatorAddとChartIndicatorDelete、ハンドルを渡すだけでチャートに載せられる手軽さと短縮名を頼りに狙って外せる確実さどっちを選ぶ?

この記事を書いた人

Kenichiのアバター Kenichi

もともとは地方の会社員で、投資とはまったく縁のない生活を送っていました。FXを始めたのは、将来のお金への漠然とした不安がきっかけです。

独学でのスタートだったので、最初の数年は失敗の連続でした。根拠のないエントリー、損切りできずに膨らんだ含み損、勝った翌日に全部returnしてしまう——たぶん初心者がやる失敗はひと通り経験したと思います。

そこから、自分に合うやり方を少しずつ探してきました。今も相場を完璧に読めるわけではありませんし、負ける日も普通にあります。ただ、続けてきたなかで見えてきたことや、遠回りして気づいたことはいくつかあります。

専門家というより「少し先を歩いているだけの人」という距離感で、そういった気づきを共有していけたらと思っています。

関連記事

  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
    2026年11月17日
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
    2026年11月17日
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    2026年11月17日
  • MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    2026年11月17日
  • MQL5のExpertRemoveとIsStoppedの比較
    MQL5のExpertRemoveとIsStopped、自分からプログラムを終わらせられる主導権と外からの終了の合図に気づける安心感どっちを選ぶ?
    2026年11月17日
検索
人気記事
  • FXの裁量とAI自動売買、口座は分けるべきなの?管理で失敗しないコツ
  • FXのグランビルの法則って何?調べてわかった8つのサインと使い方の注意点
  • セントラル短資FXとLIGHT FX、専門性と高スワップどっちを選ぶ?
  • GMOクリック証券とみんなのFX、取引実績とシンプルな使いやすさどっちを選ぶ?
  • FXのテクニカル分析って何?ファンダメンタルズとの違いを調べてみた
カテゴリ
  • FX自動売買と人工知能
新着記事
  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
タグ
AI AIツール AI自動売買 ChatGPT自動売買 DMM FX EA EA自動売買 Exness FX FXツール FX初心者 FX取引 FX口座 FX市場 FX業者 FX自動売買 GMOクリック証券 MT4 MT5 SBI FXトレード TradingView VPSサービス スプレッド ダウ理論 チャートパターン テクニカル分析 トレード リスク管理 レバレッジ ロスカット 信頼できるFX業者 初心者 取引 取引ツール 口座開設 国内FX 投資家 比較 海外FX 移動平均線 自動売買 自動売買ツール 資金管理 通貨ペア 通貨強弱

© FXAI-FXと人工知能の力.

目次