getbulkdata

Объемные данные с информацией о заголовке для связи Bloomberg V3

Синтаксис

d = getbulkdata(c,s,f)
d = getbulkdata(c,s,f,o,ov)
d = getbulkdata(c,s,f,o,ov,Name,Value)
[d,sec] = getbulkdata(___)

Описание

пример

d = getbulkdata(c,s,f) возвращается объемные данные для полей f для безопасности перечисляют s.

пример

d = getbulkdata(c,s,f,o,ov) возвращает объемные данные с помощью полей o переопределения с соответствующими значениями переопределения ov.

пример

d = getbulkdata(c,s,f,o,ov,Name,Value) возвращает объемные данные с дополнительными опциями, заданными одним или несколькими аргументами пары "имя-значение" для настроек запроса Bloomberg®.

пример

[d,sec] = getbulkdata(___) дополнительно возвращается, безопасность перечисляют sec с помощью любой из комбинаций входных аргументов в предыдущих синтаксисах.

Примеры

свернуть все

Создайте связь Bloomberg.

c = blp;

Также можно соединиться с Сервером Bloomberg с помощью blpsrv или Bloomberg B-PIPE® с помощью bpipe.

Возвратите историю дивиденда для IBM®.

security = 'IBM US Equity';
field = 'DVD_HIST'; % Dividend history field

[d,sec] = getbulkdata(c,security,field) 
d = 

    DVD_HIST: {{149x7 cell}}

sec = 

    'IBM US Equity'

d является структурой с одним полем, которое содержит массив ячеек с возвращенными объемными данными. sec содержит имя безопасности IBM.

Отобразите историю дивиденда со связанной информацией о заголовке путем доступа к полю DVD_HIST структуры. Это поле является массивом ячеек, который содержит один массив ячеек. Вложенный массив ячеек содержит данные об истории дивиденда. Доступ к содержимому вложенной ячейки, использующей индексацию массива ячеек.

d.DVD_HIST{1}
ans = 

  Columns 1 through 6

    'Declared Date'    'Ex-Date'    'Record Date'    'Payable Date'    'Dividend Amount'    'Dividend Frequency'
    [       735536]    [ 735544]    [     735546]    [      735578]    [         0.95]      'Quarter'           
    [       735445]    [ 735453]    [     735455]    [      735487]    [         0.95]      'Quarter'           
    [       735354]    [ 735362]    [     735364]    [      735395]    [         0.95]      'Quarter'           
    ...

  Column 7

    'Dividend Type'
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash' 
    ...

Первая строка данных об истории дивиденда является информацией о заголовке, которая описывает содержимое каждого столбца.

Закройте связь.

close(c)

Создайте связь Bloomberg.

c = blp;

Также можно соединиться с Сервером Bloomberg с помощью blpsrv или Bloomberg B-PIPE с помощью bpipe.

Возвратите историю дивиденда для IBM с датами дивиденда с 1 января 2004 до 1 января 2005.

security = 'IBM US Equity';
field = 'DVD_HIST';                        % Dividend history field
override = {'DVD_START_DT','DVD_END_DT'};  % Dividend start and 
                                           % End dates
overridevalues = {'20040101','20050101'};

[d,sec] = getbulkdata(c,security,field,override,overridevalues)
d = 

    DVD_HIST: {{5x7 cell}}

sec = 

    'IBM US Equity'

d является структурой с одним полем, которое содержит массив ячеек с возвращенными объемными данными. sec содержит имя безопасности IBM.

Отобразите историю дивиденда со связанной информацией о заголовке путем доступа к полю DVD_HIST структуры. Это поле является массивом ячеек, который содержит один массив ячеек. Вложенный массив ячеек содержит данные об истории дивиденда. Доступ к содержимому вложенной ячейки, использующей индексацию массива ячеек.

d.DVD_HIST{1}
ans = 

  Columns 1 through 6

    'Declared Date'    'Ex-Date'    'Record Date'    'Payable Date'    'Dividend Amount'    'Dividend Frequency'
    [       732246]    [ 732259]    [     732261]    [      732291]    [         0.18]      'Quarter'           
    [       732155]    [ 732165]    [     732169]    [      732200]    [         0.18]      'Quarter'           
    [       732064]    [ 732073]    [     732077]    [      732108]    [         0.18]      'Quarter'           
    [       731973]    [ 731983]    [     731987]    [      732016]    [         0.16]      'Quarter'           

  Column 7

    'Dividend Type'
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash'

Первая строка данных об истории дивиденда является информацией о заголовке, которая описывает содержимое каждого столбца.

Закройте связь.

close(c)

Создайте связь Bloomberg.

c = blp;

Также можно соединиться с Сервером Bloomberg с помощью blpsrv или Bloomberg B-PIPE с помощью bpipe.

Возвратите цену закрытия и историю дивиденда для IBM с датами дивиденда с 1 января 2004 до 1 января 2005. Укажите, что данные возвращают формат как вектор символов путем установки аргумента пары "имя-значение" 'returnFormattedValue' 'true'.

security = 'IBM US Equity';
fields = {'LAST_PRICE','DVD_HIST'};        % Closing price and 
                                           % Dividend history fields
override = {'DVD_START_DT','DVD_END_DT'};  % Dividend start and 
                                           % End dates
overridevalues = {'20040101','20050101'};

[d,sec] = getbulkdata(c,security,fields,override,overridevalues,...
                      'returnFormattedValue',true)
d = 

      DVD_HIST: {{5x7 cell}}
    LAST_PRICE: {'188.74'}

sec = 

    'IBM US Equity'

d является структурой с двумя полями. Первое поле DVD_HIST содержит массив ячеек с историческими данными дивиденда как массив ячеек. Второе поле LAST_PRICE содержит массив ячеек с ценой закрытия как вектор символов. sec содержит имя безопасности IBM.

Отобразите цену закрытия.

d.LAST_PRICE
ans = 

    '188.74'

Отобразите историю дивиденда со связанной информацией о заголовке путем доступа к полю DVD_HIST структуры. Это поле является массивом ячеек, который содержит один массив ячеек. Вложенный массив ячеек содержит данные об истории дивиденда. Доступ к содержимому вложенной ячейки, использующей индексацию массива ячеек.

d.DVD_HIST{1}
ans = 

  Columns 1 through 6

    'Declared Date'    'Ex-Date'    'Record Date'    'Payable Date'    'Dividend Amount'    'Dividend Frequency'
    [       732246]    [ 732259]    [     732261]    [      732291]    [         0.18]      'Quarter'           
    [       732155]    [ 732165]    [     732169]    [      732200]    [         0.18]      'Quarter'           
    [       732064]    [ 732073]    [     732077]    [      732108]    [         0.18]      'Quarter'           
    [       731973]    [ 731983]    [     731987]    [      732016]    [         0.16]      'Quarter'           

  Column 7

    'Dividend Type'
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash'

Первая строка данных об истории дивиденда является информацией о заголовке, которая описывает содержимое каждого столбца.

Закройте связь.

close(c)

Создайте связь Bloomberg®, и затем запросите данные об истории дивиденда. Функция getbulkdata возвращает данные для дат как массив datetime.

Создайте связь Bloomberg.

c = blp;

Также можно соединиться с Сервером Bloomberg с помощью blpsrv или Bloomberg B-PIPE® с помощью bpipe.

Возвратите данные как таблицу путем установки свойства DataReturnFormat объекта связи. Если вы не устанавливаете это свойство, функция getbulkdata возвращает данные как структуру.

Даты возвращения как массив datetime путем установки свойства DatetimeType объекта связи. В этом случае таблица содержит даты в переменных, которые являются массивами datetime.

c.DataReturnFormat = 'table';
c.DatetimeType = 'datetime';

Возвратите историю дивиденда для IBM®.

s = 'IBM US Equity';
f = 'DVD_HIST'; % Dividend history field

d = getbulkdata(c,s,f);

Отобразите первые три строки таблицы.

d.DVD_HIST{1}(1:3,:)
ans =

  3×7 table

        DeclaredDate              ExmDate                RecordDate             PayableDate         DividendAmount    DividendFrequency     DividendType 
    ____________________    ____________________    ____________________    ____________________    ______________    _________________    ______________

    31-Oct-2017 00:00:00    09-Nov-2017 00:00:00    10-Nov-2017 00:00:00    09-Dec-2017 00:00:00         1.5              'Quarter'        'Regular Cash'
    25-Jul-2017 00:00:00    08-Aug-2017 00:00:00    10-Aug-2017 00:00:00    09-Sep-2017 00:00:00         1.5              'Quarter'        'Regular Cash'
    25-Apr-2017 00:00:00    08-May-2017 00:00:00    10-May-2017 00:00:00    10-Jun-2017 00:00:00         1.5              'Quarter'        'Regular Cash'

Отобразите три заявленных даты. Переменная DeclaredDate является массивом datetime.

d.DVD_HIST{1}.DeclaredDate(1:3)
ans = 

  3×1 datetime array

   31-Oct-2017 00:00:00
   25-Jul-2017 00:00:00
   25-Apr-2017 00:00:00

Закройте связь Bloomberg.

close(c)

Входные параметры

свернуть все

Связь Bloomberg, заданная как объект связи, созданный с помощью blp, blpsrv или bpipe.

Список безопасности, заданный как вектор символов или скаляр строки для одной безопасности или массива ячеек из символьных векторов или массива строк для нескольких ценных бумаг. Можно задать безопасность по наименованию или CUSIP, и с или без источника оценки.

Типы данных: char | cell | string

Поля данных Bloomberg, заданные как вектор символов, представляют в виде строки скаляр, массив ячеек из символьных векторов или массив строк. Вектор символов или строка обозначают одно имя поля данных Bloomberg. Массив ячеек из символьных векторов или массив строк обозначают несколько имен поля данных Bloomberg. Для получения дополнительной информации о полях можно задать, видеть, что Руководство разработчика API Bloomberg использует опцию WAPI <GO> от терминала Bloomberg.

Пример: {'LAST_PRICE';'OPEN'}

Типы данных: char | cell | string

Поле переопределения Bloomberg, заданное как вектор символов, представляет в виде строки скаляр, массив ячеек из символьных векторов или массив строк. Вектор символов или строка обозначают одно имя поля переопределения Bloomberg. Массив ячеек из символьных векторов или массив строк обозначают несколько имен полей переопределения Bloomberg. Для получения дополнительной информации о полях можно задать, видеть, что Руководство разработчика API Bloomberg использует опцию WAPI <GO> от терминала Bloomberg.

Пример: 'END_DT'

Типы данных: char | cell | string

Значение поля переопределения Bloomberg, заданное как вектор символов, представляет в виде строки скаляр, массив ячеек из символьных векторов или массив строк. Вектор символов или строка обозначают, что один Bloomberg заменяет значение поля. Массив ячеек из символьных векторов или массив строк обозначают несколько значений полей переопределения Bloomberg. Используйте это значение поля, чтобы отфильтровать набор результатов данных Bloomberg.

Пример: '20100101'

Типы данных: char | cell | string

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'returnFormattedValue',true

Дающие право идентификаторы, заданные как пара, разделенная запятой, состоящая из 'returnEids' и булевской переменной. true добавляет имя и значение для дающего право идентификатора (EID) дата к данным о возврате.

Типы данных: логический

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

Типы данных: логический

Формат даты/времени, заданный как пара, разделенная запятой, состоящая из 'useUTCTime' и булевской переменной. true возвращает значения даты и времени как Всемирное координированное время (UTC) и значения по умолчанию false к настройкам Bloomberg TZDF <GO> просителя.

Типы данных: логический

Последние справочные данные, заданные как пара, разделенная запятой, состоящая из 'forcedDelay' и булевской переменной. true возвращает последние данные до времени задержки, заданного обменом для безопасности.

Типы данных: логический

Выходные аргументы

свернуть все

Данные Bloomberg, возвращенные как структура, таблица или расписание. Тип данных данных Bloomberg зависит от свойств DataReturnFormat и DatetimeType объекта связи. Для получения дополнительной информации о данных, см., что Руководство разработчика API Bloomberg использует опцию WAPI <GO> от терминала Bloomberg.

Список безопасности, возвращенный как массив ячеек из символьных векторов для соответствующих ценных бумаг в s. Содержимое sec идентично в значении и заказывает s. Можно возвратить ценные бумаги с любым из следующих идентификаторов:

  • buid

  • cats

  • cins

  • common

  • cusip

  • isin

  • sedol1

  • sedol2

  • sicovam

  • svm

  • ticker (значение по умолчанию)

  • wpk

Введенный в R2014b

Для просмотра документации необходимо авторизоваться на сайте