Справочник по языку программирования MQL5

Подождите немного. Документ загружается.

Строковые функции

471

StringToLower

Преобразует все символы указанной строки в строчные (маленькие) по месту.

bool StringToLower(

string& string_var // строка для обработки

);

Параметры

string_var

[in][out] Строка.

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

В случае успешного выполнения возвращает true, иначе false. Для получения кода ошибки

нужно вызвать функцию GetLastError().

Строковые функции

472

StringToUpper

Преобразует все символы указанной строки в прописные (большие) по месту.

bool StringToUpper(

string& string_var // строка для обработки

);

Параметры

string_var

[in][out] Строка.

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

В случае успешного выполнения возвращает true, иначе false. Для получения кода ошибки

нужно вызвать функцию GetLastError().

Строковые функции

473

StringTrimLeft

Удаляет символы перевода каретки, пробелы и символы табуляции с начала строки до первого

значимого символа. Строка модифицируется по месту.

int StringTrimLeft(

string& string_var // строка для обрезки

);

Параметры

string_var

[in][out] Строка, которая должна быть обрезана слева.

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

Возвращает количество отрезанных символов.

Строковые функции

474

StringTrimRight

Удаляет символы перевода каретки, пробелы и символы табуляции от последнего значимого

символа до конца строки. Строка модифицируется по месту.

int StringTrimRight(

string& string_var // строка для обрезки

);

Параметры

string_var

[in][out] Строка, которая должна быть обрезана справа.

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

Возвращает количество отрезанных символов.

Дата и время

475

Дата и время

Группа функций, обеспечивающих работу с данными типа datetime (целое число, представляющее

собой количество секунд, прошедших с 0 часов 1 января 1970 года).

Функция

Действие

TimeCurrent

Возвращает последнее известное время

сервера (время прихода последней

котировки) в формате datetime

TimeTradeServer

Возвращает расчетное текущее время

торгового сервера

TimeLocal

Возвращает локальное компьютерное время в

формате datetime

TimeGMT

Возвращает время GMT формате datetime с

учетом перехода на зимнее или летнее время

по локальному времени компьютера, на

котором запущен клиентский терминал

TimeDaylightSavings

Возвращает признак перехода на летнее /

зимнее время

TimeGMTOffset

Возвращает текущую разницу между

временем GMT и локальным временем

компьютера в секундах с учетом перехода на

зимнее или летнее время

TimeToStruct

Производит конвертацию из значения типа

datetime в переменную типа структуры

MqlDateTime

StructToTime

Производит конвертацию из переменной типа

структуры MqlDateTime в значение типа

datetime

Дата и время

476

TimeCurrent

Возвращает последнее известное время сервера, время прихода последней котировки по одному

из выбранных в "Обзоре рынка" символов. В обработчике OnTick() данная функция вернет время

пришедшего обрабатываемого тика. В других случаях (например, вызов в обработчиках OnInit(),

OnDeinit(), OnTimer() и так далее) это – время прихода последней котировки по любому символу,

доступного в окне "Обзор рынка", то самое время, которое показано в заголовке этого окна.

Значение времени формируется на торговом сервере и не зависит от настроек времени на

компьютере пользователя. Существует 2 варианта функции.

Вызов без параметров

datetime TimeCurrent();

Вызов с параметром типа MqlDateTime

datetime TimeCurrent(

MqlDateTime& dt_struct // переменная типа структуры

);

Параметры

dt_struct

[out] Переменная типа структуры MqlDateTime.

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

Значение типа datetime

Примечание

Если в качестве параметра была передана переменная типа структуры MqlDateTime, то она

заполняется соответствующим образом.

Дата и время

477

TimeTradeServer

Возвращает расчетное текущее время торгового сервера. В отличие от функции TimeCurrent(),

расчет значения времени производится в клиентском терминале и зависит от настроек времени на

компьютере пользователя. Существует 2 варианта функции.

Вызов без параметров

datetime TimeTradeServer();

Вызов с параметром типа MqlDateTime

datetime TimeTradeServer(

MqlDateTime& dt_struct // переменная типа структуры

);

Параметры

dt_struct

[out] Переменная типа структуры MqlDateTime.

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

Значение типа datetime

Примечание

Если в качестве параметра была передана переменная типа структуры MqlDateTime, то она

заполняется соответствующим образом.

Дата и время

478

TimeLocal

Возвращает локальное время компьютера, на котором запущен клиентский терминал. Существует

2 варианта функции.

Вызов без параметров

datetime TimeLocal();

Вызов с параметром типа MqlDateTime

datetime TimeLocal(

MqlDateTime& dt_struct // переменная типа структуры

);

Параметры

dt_struct

[out] Переменная типа структуры MqlDateTime.

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

Значение типа datetime

Примечание

Если в качестве параметра была передана переменная типа структуры MqlDateTime, то она

заполняется соответствующим образом.

Дата и время

479

TimeGMT

Возвращает время GMT, которое вычисляется с учётом перехода на зимнее или летнее время по

локальному времени компьютера, на котором запущен клиентский терминал. Существует 2

варианта функции.

Вызов без параметров

datetime TimeGMT();

Вызов с параметром типа MqlDateTime

datetime TimeGMT(

MqlDateTime& dt_struct // переменная типа структуры

);

Параметры

dt_struct

[out] Переменная типа структуры MqlDateTime.

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

Значение типа datetime

Примечание

Если в качестве параметра была передана переменная типа структуры MqlDateTime, то она

заполняется соответствующим образом.

Дата и время

480

TimeDaylightSavings

Возвращает поправку на летнее время в секундах, если был произведен переход на летнее время.

Зависит от настроек времени на компьютере пользователя.

int TimeDaylightSavings();

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

Если был произведен переход на зимнее (стандартное) время, то возвращается 0.