StringToTime

Преобразование строки, содержащей время и/или дату в формате "yyyy.mm.dd [hh:mi]", в число типа datetime.

datetime  StringToTime(
   const string  time_string      // строка-дата
   );

Параметры

time_string

[in]  Строка в одном из указанных форматов:

  •  "yyyy.mm.dd [hh:mi]"
  •  "yyyy.mm.dd [hh:mi:ss]"
  •  "yyyymmdd [hh:mi:ss]"
  •  "yyyymmdd [hhmiss]"
  •  "yyyy/mm/dd [hh:mi:ss]"
  •  "yyyy-mm-dd [hh:mi:ss]"

Возвращаемое значение

Значение типа datetime, содержащее количество секунд, прошедших с 01.01.1970.

Примечание

Любая последовательность символов пробела и табуляции между датой и временем считается как один пробел, чтобы не было необходимости в дополнительной обработки строки time_string перед вызовом StringToTime().

Пример:

//--- input parameters
input group    "The date can be entered in any of the formats:"
input group    "yyyy.mm.dd [hh:mi], yyyy.mm.dd [hh:mi:ss]"
input group    "yyyymmdd [hh:mi:ss], yyyymmdd [hhmiss]"
input group    "yyyy/mm/dd [hh:mi:ss], yyyy-mm-dd [hh:mi:ss]"
input string   InpDateStr;    // Please enter the date here as a string
 
//+------------------------------------------------------------------+
//| Script program start function                                    |
//+------------------------------------------------------------------+
void OnStart()
  {
//--- преобразуем введённое во входных параметрах время в виде строки в значение datetime
   datetime time=StringToTime(InpDateStr);
//--- выводим в журнал введённую строку и полученное время
   PrintFormat("Date entered as a string in the form '%s' is converted to datetime in the form '%s'",
               InpDateStrTimeToString(timeTIME_DATE|TIME_MINUTES|TIME_SECONDS));
//--- создаём вертикальную линию на полученной дате-времени и смещаем график в это расположение
   if(CreateVLine(time))
      ChartNavigateToTime(time);
   /*
   результат:
   Date entered as a string in the form '' is converted to datetime in the form '1970.01.01 00:00:00'
   Date entered as a string in the form '2024is converted to datetime in the form '2024.02.24 20:24:00'
   Date entered as a string in the form '202400is converted to datetime in the form '2024.02.24 20:24:00'
   Date entered as a string in the form '20240000is converted to datetime in the form '2024.02.24 00:00:00'
   Date entered as a string in the form '2024022410is converted to datetime in the form '2030.09.06 00:00:00'
   Date entered as a string in the form '20240224 10is converted to datetime in the form '2024.02.24 10:00:00'
   Date entered as a string in the form '20240224 01is converted to datetime in the form '2024.02.24 01:00:00'
   Date entered as a string in the form '20240224 0030is converted to datetime in the form '2024.02.24 23:00:00'
   Date entered as a string in the form '20240224 0100is converted to datetime in the form '2024.02.24 01:00:00'
   */
  }
//+------------------------------------------------------------------+
//| Создаёт объект вертикальную линию                                |
//+------------------------------------------------------------------+
bool CreateVLine(const datetime line_time)
  {
   ResetLastError();
 
   string name=MQLInfoString(MQL_PROGRAM_NAME)+"_VLINE";
   if(!ObjectCreate(0nameOBJ_VLINE0line_time0))
     {
      Print("ObjectCreate() failed. Error code: "GetLastError());
      return(false);
     }
   ObjectSetInteger(0nameOBJPROP_STYLESTYLE_DOT);
   ObjectSetInteger(0nameOBJPROP_SELECTABLEtrue);
 
   return(true);
  }
//+------------------------------------------------------------------+
//| Смещает график на указанное время открытия бара                  |
//+------------------------------------------------------------------+
bool ChartNavigateToTime(const datetime time)
  {
   ChartSetInteger(0CHART_AUTOSCROLLfalse);
   ResetLastError();
 
   int bar=iBarShift(_SymbolPERIOD_CURRENTtime);
   if(bar<0)
     {
      PrintFormat("%s: iBarShift() failed. Error code: %d"__FUNCTION__GetLastError());
      return(false);
     }
 
   long first=0;
   if(!ChartGetInteger(0CHART_FIRST_VISIBLE_BAR0first))
     {
      PrintFormat("%s: ChartGetInteger() failed. Error code: %d"__FUNCTION__GetLastError());
      return(false);
     }
 
   return(ChartNavigate(0CHART_CURRENT_POS, (int)first-bar));
  }

Смотри также

TimeToString, TimeToStruct