MQL4(MT4) OrderCloseTimeの使い方

OrderCloseTime関数は、MetaTrader 4 (MT4) プラットフォームで最後にクローズされた注文のクローズ時間を取得するために使用されるMQL4言語の関数です。この関数は、特に取引の結果を分析したり、取引履歴に基づいて統計情報を収集したりする際に有用です。OrderCloseTimeは、選択された注文がクローズされた正確な時刻（日時）をdatetime型で返します。

OrderCloseTime関数の基本使用法

OrderCloseTime関数は引数を取らず、選択された注文のクローズ時刻をdatetime型で返します。この関数を使用する前に、OrderSelect関数を使用して対象となる注文を選択する必要があります。

使用例

以下の例では、アカウントの最新のクローズされた注文を検索し、そのクローズ時刻を取得して表示します。

void OnStart()
{
    // 最新のクローズされた注文を探す
    for(int i = OrdersHistoryTotal() - 1; i >= 0; i--)
    {
        if(OrderSelect(i, SELECT_BY_POS, MODE_HISTORY)) // 注文履歴から注文を選択
        {
            // クローズされた注文のみを対象
            if(OrderType() <= OP_SELL && OrderCloseTime() > 0)
            {
                // クローズ時刻を取得
                datetime closeTime = OrderCloseTime();

                // 注文情報とクローズ時刻を表示
                Print("注文 #", OrderTicket(), " は ", TimeToString(closeTime, TIME_DATE|TIME_MINUTES), " にクローズされました。");
                break; // 最新のクローズされた注文を見つけたらループを抜ける
            }
        }
    }
}

注意点

• 注文の選択: OrderCloseTimeを使用する前に、OrderSelect関数で適切な注文が選択されていることを確認してください。
• クローズされた注文のみ: OrderCloseTime関数は、クローズされた注文に対してのみ有効です。開いている注文や保留中の注文には使用できません。
• 履歴データの使用: OrderCloseTime関数は、MODE_HISTORYを指定してOrderSelect関数で選択された履歴注文に対してのみ有効です。
• エラーハンドリング: OrderSelect関数がfalseを返した場合、つまり注文の選択に失敗した場合は、GetLastError関数を使用してエラーコードを確認し、問題の原因を特定することが重要です。

OrderCloseTime関数を使用することで、特定の取引戦略の時間的側面を分析したり、取引記録をより詳細に管理したりする際に役立つ情報を得ることができます。