MQL4 時間・日付関数リファレンス｜Year・Hour・TimeCurrent・iBarShift・五当日判定

void DatetimeBasics()
  {
   // datetime リテラル
   datetime dt1 = D'2024.01.15 09:30:00';
   datetime dt2 = D'2024.12.31';  // 時刻省略=00:00:00

   // 現在時刻
   datetime serverTime = TimeCurrent();  // サーバー時刻
   datetime localTime  = TimeLocal();    // PCのローカル時刻
   datetime gmtTime    = TimeGMT();      // GMT/UTC時刻

   Print("サーバー時刻: ", TimeToStr(serverTime, TIME_DATE|TIME_SECONDS));
   Print("ローカル時刻: ", TimeToStr(localTime, TIME_DATE|TIME_SECONDS));
   Print("GMT時刻: ", TimeToStr(gmtTime, TIME_DATE|TIME_SECONDS));

   // 日時の差（秒単位）
   int diffSeconds = (int)(dt2 - dt1);
   int diffDays    = diffSeconds / 86400;
   Print("日数差: ", diffDays, "日");
  }

void PrintBarInfo(int barIndex)
  {
   datetime barTime = Time[barIndex];

   Print("バー[", barIndex, "] の時刻: ", TimeToStr(barTime, TIME_DATE|TIME_MINUTES));
   Print("  年: ", TimeYear(barTime));
   Print("  月: ", TimeMonth(barTime));
   Print("  日: ", TimeDay(barTime));
   Print("  曜日: ", TimeDayOfWeek(barTime), " (0=日, 1=月, ... 5=金)");
   Print("  時: ", TimeHour(barTime));
   Print("  分: ", TimeMinute(barTime));
  }

string TimeToStr(
   datetime value,    // 変換するdatetime
   int      mode = TIME_DATE|TIME_MINUTES  // 表示フォーマット
);
// mode: TIME_DATE(日付), TIME_MINUTES(時分), TIME_SECONDS(時分秒)

datetime StrToTime(
   string value  // "yyyy.mm.dd hh:mi" 形式の文字列
);
// 戻り値: 対応するdatetime

void TimeStringExamples()
  {
   datetime now = TimeCurrent();

   // 各フォーマット
   Print(TimeToStr(now, TIME_DATE));               // "2024.06.15"
   Print(TimeToStr(now, TIME_MINUTES));             // "14:30"
   Print(TimeToStr(now, TIME_SECONDS));             // "14:30:45"
   Print(TimeToStr(now, TIME_DATE|TIME_MINUTES));   // "2024.06.15 14:30"
   Print(TimeToStr(now, TIME_DATE|TIME_SECONDS));   // "2024.06.15 14:30:45"

   // 文字列からdatetimeに変換
   datetime dt = StrToTime("2024.06.15 09:30");
   Print("変換結果: ", TimeToStr(dt, TIME_DATE|TIME_SECONDS));
  }

int iBarShift(
   string   symbol,     // 通貨ペア
   int      timeframe,  // 時間軸
   datetime time,       // 検索する時刻
   bool     exact = false  // 完全一致のみか
);
// 戻り値: バーインデックス（見つからない場合は-1）

void BarShiftExamples()
  {
   // 昨日の始値を取得
   datetime yesterday = TimeCurrent() - 86400;
   int barIndex = iBarShift(NULL, PERIOD_D1, yesterday);
   if(barIndex >= 0)
      Print("昨日の始値: ", iOpen(NULL, PERIOD_D1, barIndex));

   // 特定時刻のバーを検索
   datetime targetTime = StrToTime("2024.06.15 10:00");
   int bar = iBarShift(NULL, PERIOD_H1, targetTime, true);
   if(bar >= 0)
      Print("指定時刻のバー: ", bar);
   else
      Print("完全一致するバーなし");
  }

bool IsGotobi()
  {
   int day = Day();

   // 5の倍数の日
   if(day % 5 == 0)
      return true;

   // 月末日の判定
   int month = Month();
   int year  = Year();
   int lastDay;

   if(month == 2)
      lastDay = (year % 4 == 0 && (year % 100 != 0 || year % 400 == 0)) ? 29 : 28;
   else if(month == 4 || month == 6 || month == 9 || month == 11)
      lastDay = 30;
   else
      lastDay = 31;

   if(day == lastDay)
      return true;

   return false;
  }

// 五当日が土日の場合、前営業日に振替
bool IsGotobiAdjusted()
  {
   // 金曜日かつ翌日/翌々日が五当日 → 振替
   if(DayOfWeek() == 5)
     {
      int nextDay = Day() + 1;
      int nextNextDay = Day() + 2;
      if(nextDay % 5 == 0 || nextNextDay % 5 == 0)
         return true;
     }

   return IsGotobi() && DayOfWeek() >= 1 && DayOfWeek() <= 5;
  }

// サーバー時刻のGMTオフセットを設定（ブローカーにより異なる）
input int GMTOffset = 2;  // GMT+2（多くの海外ブローカー）

enum SESSION_TYPE
  {
   SESSION_TOKYO,     // 東京（GMT 0:00-9:00）
   SESSION_LONDON,    // ロンドン（GMT 7:00-16:00）
   SESSION_NEWYORK,   // ニューヨーク（GMT 12:00-21:00）
   SESSION_OVERLAP    // ロンドン-NY重複（GMT 12:00-16:00）
  };

bool IsInSession(SESSION_TYPE session)
  {
   int gmtHour = (Hour() - GMTOffset + 24) % 24;

   switch(session)
     {
      case SESSION_TOKYO:
         return (gmtHour >= 0 && gmtHour < 9);
      case SESSION_LONDON:
         return (gmtHour >= 7 && gmtHour < 16);
      case SESSION_NEWYORK:
         return (gmtHour >= 12 && gmtHour < 21);
      case SESSION_OVERLAP:
         return (gmtHour >= 12 && gmtHour < 16);
     }
   return false;
  }

// 仲値時間判定（日本時間9:55前後）
bool IsNakaneTime()
  {
   int jpHour   = (Hour() - GMTOffset + 9 + 24) % 24;
   int jpMinute = Minute();

   // 9:30〜10:00
   if(jpHour == 9 && jpMinute >= 30)
      return true;
   if(jpHour == 10 && jpMinute == 0)
      return true;

   return false;
  }

// 米国夏時間（3月第2日曜〜11月第1日曜）
bool IsUSDST()
  {
   int month = Month();
   int day   = Day();
   int dow   = DayOfWeek();

   // 4月〜10月は確実に夏時間
   if(month > 3 && month < 11) return true;
   // 1月,2月,12月は確実に冬時間
   if(month < 3 || month > 11) return false;

   // 3月: 第2日曜以降
   if(month == 3)
     {
      int secondSunday = 14 - (TimeDayOfWeek(StrToTime(StringConcatenate(Year(), ".03.01"))) % 7);
      if(secondSunday > 14) secondSunday -= 7;
      return (day >= secondSunday);
     }

   // 11月: 第1日曜まで
   if(month == 11)
     {
      int firstSunday = 7 - (TimeDayOfWeek(StrToTime(StringConcatenate(Year(), ".11.01"))) % 7);
      if(firstSunday > 7) firstSunday -= 7;
      return (day < firstSunday);
     }

   return false;
  }

// GMTオフセットを動的に計算
int GetGMTOffset()
  {
   // 多くの海外ブローカー: 夏=GMT+3, 冬=GMT+2
   return IsUSDST() ? 3 : 2;
  }

bool IsNewBar()
  {
   static datetime lastBarTime = 0;
   datetime currentBarTime = Time[0];

   if(currentBarTime != lastBarTime)
     {
      lastBarTime = currentBarTime;
      return true;
     }

   return false;
  }

// 特定の時間軸の新バー検出
bool IsNewBar_TF(int timeframe)
  {
   static datetime lastBarTime = 0;
   datetime currentBarTime = iTime(NULL, timeframe, 0);

   if(currentBarTime != lastBarTime)
     {
      lastBarTime = currentBarTime;
      return true;
     }

   return false;
  }