TimeToStruct

Converte um valor de tipo datetime (número de segundos desde 01.01.1970) em uma variável estrutura MqlDateTime.

bool  TimeToStruct(
   datetime      dt,            // data e hora
   MqlDateTime&  dt_struct      // estrutura para a captura de valores
   );

Parâmetros

dt

[in]  Valor de data e hora para conversão.

dt_struct

[out]  Variável de tipo estrutura MqlDateTime.

Valor do Retorno

true se bem sucedido, caso contrário false. Para obter informações sobre o erro, chamar a função GetLastError().

Exemplo:

void OnStart()
  {
//---obtemos a última hora conhecida do servidor, declaramos a estrutura de data/hora e preenchemos os campos da estrutura
   datetime    time=TimeCurrent();
   MqlDateTime tm  ={};
   if(!TimeToStruct(time,tm))
      Print("TimeToStruct() failed. Error ", GetLastError());
   
//--- exibimos no log a hora recebida do servidor e o resultado do preenchimento da estrutura MqlDateTime usando TimeToStruct()
   PrintFormat("Server time: %s\n- Year: %u\n- Month: %02u\n- Day: %02u\n- Hour: %02u\n- Min: %02u\n- Sec: %02u\n- Day of Year: %03u\n- Day of Week: %u (%s)",
               (string)time, tm.year, tm.mon, tm.day, tm.hour, tm.min, tm.sec, tm.day_of_year, tm.day_of_week, EnumToString((ENUM_DAY_OF_WEEK)tm.day_of_week));
  /*
  Resultado
   Server time: 2024.04.18 15:47:27
   - Year: 2024
   - Month: 04
   - Day: 18
   - Hour: 15
   - Min: 47
   - Sec: 27
   - Day of Year: 108
   - Day of Week: 4 (THURSDAY)
  */
  }