Функция STOCKHISTORY в Excel

Функция STOCKHISTORY в Excel извлекает историческую информацию о ценах на акции на основе заданного символа и диапазона дат. Основная цель STOCKHISTORY — получить историю финансового инструмента с течением времени. Результатом является массив значений, которые распределяются на листе по нескольким ячейкам.

Что делает функция STOCKHISTORY в Excel?

Функция STOCKHISTORY в Excel извлекает информацию о цене акций.

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

Массив информации о ценах на акции.

Аргументы

• stock — тикер в двойных кавычках («MSFT», «AAPL», «GOOG» и т. д.).
• start_date — дата начала получения данных.
• end_date — [необязательно] Конечная дата получения данных. По умолчанию — start_date.
• interval — [необязательный] Интервал времени. Ежедневно = 0, еженедельно = 1, ежемесячно = 2. Значение по умолчанию — 0.
• headers — [необязательно] Без заголовка = 0, базовый заголовок = 1, инструмент + заголовок = 2. По умолчанию — 1.
• properties — [необязательно] Дополнительные данные для получения. По умолчанию — Дата и Закрытие. См. ниже.

Синтаксис

=STOCKHISTORY(stock, start_date, [end_date], [interval], [headers], [properties], …)

Примечания по использованию

Функция STOCKHISTORY извлекает историческую информацию о ценах акций на основе заданного символа и диапазона дат. Основная цель функции — получить историю финансового инструмента с течением времени. Хотя название предполагает, что STOCKHISTORY предназначен для работы только с акциями, также может работать с облигациями, индексными фондами, взаимными фондами, облигациями и валютными парами.

STOCKHISTORY получает несколько результатов. Результатом является массив значений, которые распределяются на листе по нескольким ячейкам.

Функция STOCKHISTORY принимает пять основных аргументов и шесть дополнительных аргументов свойств для получения дополнительной информации. Stock и start_date — единственные обязательные аргументы. Каждый аргумент подробно описан ниже.

Примечание. Самый безопасный способ указать начальную_дату и конечную_дату — это ссылку на ячейку, содержащую действительную дату, или с помощью функции DATE. Это связано с тем, что ввод дат в виде текстовых значений иногда может быть неправильно истолкован.

Основные аргументы

• Stock — тикер, используемый для получения исторических цен. Акция должна быть указана в виде текстового значения в двойных кавычках («»), если она жестко запрограммирована, например «MSFT», «GOOG», «AAPL», «TSLA» и т. д. Результаты извлекаются из биржи по умолчанию для инструмента.
• Чтобы запросить информацию от конкретной биржи, добавьте к символу четырехзначный код рыночного идентификатора ISO (MIC), за которым следует двоеточие. Например, чтобы сослаться на Microsoft Corporation на фондовом рынке Nasdaq, используйте «XNAS:MSFT». Чтобы обратиться к корпорации Microsoft на австрийской бирже Wiener Boerse, используйте «XWBO:MSFT».
• Start_date — дата начала получения данных. Обратите внимание, что start_date не обязательно является первой датой, которая появится в результатах. Если для интервала установлено значение ежедневно (0), первой датой в результатах будет первая дата открытия биржи и доступности данных. Если для интервала установлено значение «еженедельно» (1) или «ежемесячно» (2), первой датой будет установлено первое число в периоде, т. е. первый день недели или первый день месяца.
• End_date — дата прекращения получения данных. Как и в случае с start_date, фактическая последняя дата в результатах может отличаться от указанной end_date. Если для интервала установлено значение ежедневно (0), последней датой в результатах будет последняя дата в диапазоне дат, в котором доступны данные.
• Если интервал установлен на еженедельный (1) или ежемесячный (2), последней датой будет последняя дата периода, т. е. последний день недели или последний день месяца. End_date является необязательным и по умолчанию будет иметь значение start_date, если оно не указано.
• Interval — период времени между точками данных. Доступные варианты: Ежедневно (0), Еженедельно (1) и Ежемесячно (2). Интервал является необязательным и по умолчанию равен Ежедневно (0), если он не указан.
• Headers — аргумент headers управляет информацией заголовка, которая будет отображаться в верхней части полученных данных. Доступные варианты: «Без заголовка» (0), «Базовый заголовок» (1) и «Заголовок с информацией о приборе» (2). Заголовки являются необязательными и по умолчанию используются базовый заголовок (1), если они не указаны.
• Properties – свойства1 – свойства5  представляют собой дополнительную информацию, которую можно получить. Подробности смотрите в таблице ниже.

Характеристики

В таблице ниже показана дополнительная информация, которую может получить функция STOCKHISTORY, которая описана как свойства. Свойства обозначаются числовым кодом, указанным в столбце «Код», и могут отображаться в любом порядке. Обратите внимание, что по умолчанию STOCKHISTORY получает дату и дату закрытия.

Код	Оценка	Описание
0	Дата	Первый торговый день периода
1	Закрывать	Цена закрытия в последний торговый день периода
2	Открыть	Цена открытия в последний торговый день периода
3	Высокий	Самая высокая цена за период
4	Низкий	Самая низкая цена за период
5	Объем	Объем торгов за период

Пример №1 – Ежедневные результаты

Чтобы получить дневную цену закрытия Apple («AAPL») за январь 2021 года, в ячейке B4 используется формула:

=STOCKHISTORY("AAPL",DATE(2021,1,1),DATE(2021,1,31))

Интервал не указан, по умолчанию установлено значение «Ежедневно» (0). Заголовки не предоставляются, по умолчанию используются значения «Дата» и «Закрытие». При такой конфигурации функция STOCKHISTORY возвращает 19 результатов. Обратите внимание, что выходные дни исключены, а первая полученная дата — 4 января, поскольку биржа была закрыта 1-3 января. Также обратите внимание, что функция DATE используется для указания дат начала и окончания.

Пример №2 — переменные входные данные

В приведенном ниже примере входные данные для stock, start_date и end_date становятся переменными, отображая их на листе в ячейках F6, F7 и F8. Формула в ячейке B4:

=STOCKHISTORY(F6,F7,F8,2)

Обратите внимание, что четвертый аргумент, интервал , имеет значение 2, что выводит ежемесячные результаты.

Результатом является цена закрытия Tesla («TSLA») за 12 месяцев 2021 года. ЕСЛИ значения в F6:F8 будут изменены, результаты STOCKHISTORY автоматически обновятся.

Пример №3 — дополнительные свойства

Свойствами, возвращаемыми STOCKHISTORY, можно управлять путем настройки и/или изменения порядка чисел, начиная с шестого аргумента ( property1). В примере, показанном ниже, формула в ячейке B4 имеет следующий вид:

=STOCKHISTORY(I6,I7,I8,2,1,0,5,3,4,1)

Результатом является ежемесячная информация о цене акций компании 3M («МММ») за 2021 год. Запрашиваемые свойства включают дату (0), объем (5), максимум (3), минимум (4) и закрытие (1). . Обратите внимание, что это последние 5 аргументов функции.

Пример №4 — горизонтальная компоновка

По умолчанию STOCKHISTORY возвращает информацию в вертикальном расположении. Для отображения результатов в горизонтальном расположении можно использовать функцию TRANSPOSE. В примере, показанном ниже, скопированная формула в C5 выглядит следующим образом:

=TRANSPOSE(STOCKHISTORY(B5,EDATE(TODAY(),-5),TODAY(),2,0,1))

Результатом является скользящая ежемесячная цена закрытия для каждого символа за последние 6 месяцев.

Функция EDATE и функция TODAY используются для создания даты начала на 5 месяцев раньше. Датой окончания является текущая дата, указанная функцией TODAY.

Пример №5 — обмен переменными

Чтобы запросить информацию с конкретной биржи, добавьте к символу четырехзначный  код, за которым следует двоеточие (:). На листе ниже обмен является переменной и введен в ячейку F5. Формула в ячейке B4:

=STOCKHISTORY(F5&":"&F6,F7,F8,2)

Результатом является ежемесячная цена закрытия Caterpillar, Inc. на бирже Wiener-Borse:

Если значение F5 будет изменено на «XNYS», STOCKHISTORY вернет ежемесячную цену закрытия Caterpillar на Нью-Йоркской фондовой бирже.

Пример №6 – курс обмена валюты

Чтобы получить курс обмена валюты для данной валютной пары с помощью STOCKHISTORY, введите два трехбуквенных кода, разделенных двоеточием (:), в качестве аргумента акции . Например, чтобы получить ежемесячный курс обмена валюты между долларом США («USD») и евро («EUR») за период с января 2021 года по март 2021 года, вы можете использовать функцию следующим образом:

=STOCKHISTORY("USD:EUR","1-Jan-2021","1-Mar-2021",2)

Результатом является массив с тарифами за три месяца:

Чтобы изменить направление обмена, просто поменяйте порядок валютных пар:

=STOCKHISTORY("EUR:USD","1-Jan-2021","1-Mar-2021",2).

Примечания

• Если данные за запрошенный период недоступны, STOCKHISTORY возвращает #VALUE! ошибка.
• Если интервал равен ежемесячному (2), функция возвращает последние данные за определенный месяц.