MQL4(MT4) ObjectGetValueByTimeの使い方

ObjectGetValueByTime関数は、MetaTrader 4 (MT4) プラットフォームのMQL4言語で、指定された時間におけるチャート上の特定のグラフィカルオブジェクトの価格値を取得するために使用されます。この関数は、特定の時間点でのオブジェクト（トレンドライン、フィボナッチレベル、チャネルなど）の価格位置を知りたい場合に役立ちます。

ObjectGetValueByTime関数の基本形式

double ObjectGetValueByTime(
   long chart_id,      // チャートID
   string object_name, // オブジェクト名
   datetime time,      // 時間
   int line_id=0       // 線ID
);

• chart_id: オブジェクトを検索するチャートのIDです。現在のチャートのIDを取得するにはChartID()関数を使用します。
• object_name: 価格値を取得したいグラフィカルオブジェクトの名前です。
• time: 価格値を知りたい特定の時間です。
• line_id: オブジェクト内の複数の線のうち、どの線に対して操作を行うかを指定します。多くのオブジェクトでは0がデフォルト値です。

使用例：特定のトレンドライン上の特定の時間での価格値を取得

以下の例では、指定されたチャートIDとトレンドラインオブジェクト名に基づいて、特定の時間点での価格値を取得し、その価格を表示します。

void OnStart()
{
    long chartID = ChartID(); // 現在のチャートIDを取得
    string objectName = "MyTrendLine"; // トレンドラインオブジェクトの名前
    datetime time = TimeCurrent(); // 現在の時間を取得

    double price = ObjectGetValueByTime(chartID, objectName, time, 0);

    // 価格値が正しく取得されたかチェック
    if(price != EMPTY_VALUE)
    {
        // 価格値を表示
        Print("時間 ", TimeToString(time, TIME_DATE|TIME_MINUTES), " における '", objectName, "' の価格は ", price, " です。");
    }
    else
    {
        Print("指定された時間での価格値が見つかりませんでした。");
    }
}

注意点

• オブジェクトの存在: ObjectGetValueByTimeを使用する前に、指定されたオブジェクトがチャート上に存在し、正しいchart_idとobject_nameが指定されていることを確認してください。
• 価格値の有効性: 関数がEMPTY_VALUEを返した場合、指定された時間でオブジェクトの価格値が存在しない、または計算できないことを意味します。これは、時間がオブジェクトの有効範囲外である場合に発生する可能性があります。
• 正確な時間の指定: 指定する時間は、オブジェクトが存在する期間内である必要があります。時間がオブジェクトの範囲外である場合、関数は有効な価格を返せません。

ObjectGetValueByTime関数を適切に使用することで、特定の時間点でのグラフィカルオブジェクトの価格レベルを効果的に把握し、チャート分析や取引戦略の決定に役立てることができます。