Функция STOCKHISTORY в Excel извлекает историческую информацию о ценах на акции на основе заданного символа и диапазона дат. Основная цель STOCKHISTORY — получить историю финансового инструмента с течением времени. Результатом является массив значений, которые распределяются на листе по нескольким ячейкам.
- Что делает функция STOCKHISTORY в Excel?
- Возвращаемое значение
- Аргументы
- Синтаксис
- Примечания по использованию
- Основные аргументы
- Характеристики
- Пример №1 – Ежедневные результаты
- Пример №2 — переменные входные данные
- Пример №3 — дополнительные свойства
- Пример №4 — горизонтальная компоновка
- Пример №5 — обмен переменными
- Пример №6 – курс обмена валюты
- Примечания
Что делает функция 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), функция возвращает последние данные за определенный месяц.