- CalendarCountryById
- CalendarEventById
- CalendarValueById
- CalendarCountries
- CalendarEventByCountry
- CalendarEventByCurrency
- CalendarValueHistoryByEvent
- CalendarValueHistory
- CalendarValueLastByEvent
- CalendarValueLast
CalendarValueLast
Получает массив значений по всем событиям с фильтрацией по стране и/или валюте с момента состояния базы Календаря с заданным change_id.
int CalendarValueLast(
|
Параметры
change_id
[in][out] Идентификатор изменения.
values[]
[out] Массив типа MqlCalendarValue для получения значений события. Смотри пример обработки событий календаря.
country_code=NULL
[in] Кодовое имя страны согласно ISO 3166-1 alpha-2
currency=NULL
[in] Кодовое наименование валюты страны.
Возвращаемое значение
Количество полученных значений события. Чтобы получить информацию об ошибке, необходимо вызвать функцию GetLastError(). Возможные ошибки:
- 4001 – ERR_INTERNAL_ERROR (общая ошибка исполняющей системы),
- 4004 – ERR_NOT_ENOUGH_MEMORY (не достаточно памяти для выполнения запроса),
- 5401 – ERR_CALENDAR_TIMEOUT (превышен лимит запроса по времени),
- 5400 – ERR_CALENDAR_MORE_DATA (размер массива недостаточен для получения описаний всех значений, поэтому получили только то, что вместилось),
- ошибки неудачного выполнения ArrayResize()
Примечание
Все функции для работы с Экономическим календарем используют время торгового сервера (TimeTradeServer). Это означает, что время в структуре MqlCalendarValue и входящие параметры времени в функциях CalendarValueHistoryByEvent/CalendarValueHistory задаются в таймзоне торгового сервера, а не в локальном времени пользователя.
Если в функцию был передан массив events[] фиксированной длины и в результате запроса не хватило места для сохранения всего результата, будет взведена ошибка ERR_CALENDAR_MORE_DATA (5400).
Если в функцию передан change_id = 0, то функция всегда возвращает ноль, но при этом в change_id возвращается текущее состояние базы Календаря.
Для фильтров country_code и currency значения NULL и "" равносильны – означают отсутствие фильтра.
Для country_code следует использовать поле code структуры MqlCalendarCountry, например "US", "RU" или "EU".
Для currency следует использовать поле currency структуры MqlCalendarCountry, например "USD", "RUB" или "EUR".
Фильтры применяются коньюкцией, т.е. через логическое 'И' выбираются значения только тех событий, для которых удовлетворяются одновременно оба условия – страна и валюта
Функция возвращает массив значений для заданной новости и новое change_id, которые можно использовать для последующих вызовов данной функции, чтобы получить новые значения новости. Таким образом, вызывая эту функцию с последним известным change_id, можно получать обновления значений для заданной новости.ы
Структура MqlCalendarValue предоставляет методы для проверки и получения значений из полей actual_value, forecast_value, prev_value и revised_prev_value. Если значение поля не задано, то поле хранит значение LONG_MIN (-9223372036854775808).
При этом необходимо иметь в виду, что значения в этих полях хранятся увеличенными в миллион раз. Это означает, что при получении значений в MqlCalendarValue функциями CalendarValueById, CalendarValueHistoryByEvent, CalendarValueHistory, CalendarValueLastByEvent и CalendarValueLast, значения этих полей нужно проверять на равенство LONG_MIN, и если значение в поле задано, то для получения значения необходимо разделить значение поля на 1 000 000 (миллион). Другой способ получения значений – делать проверку и получать значения функциями самой структуры MqlCalendarValue.
Пример эксперта, который слушает появление событий Экономического календаря:
#property description "Пример использования функции CalendarValueLast"
|
Смотри также
CalendarValueLast, CalendarValueHistory, CalendarValueHistoryByEvent, CalendarValueById