toannual

Преобразование в годовой

toannual не рекомендуется. Использовать convert2annual вместо этого.

Синтаксис

newfts = toannual(oldfts)
newfts = toannual(oldfts,'ParameterName',ParameterValue, ...)

Аргументы

oldfts

Объект финансовых временных рядов.

Описание

newfts = toannual(oldfts) преобразует финансовые временные ряды любой частоты в одну из годовых частот. Конец года по умолчанию является последним рабочим днем декабря. toannual использует holidays.m для определения действительных торговых дней.

Примечание

Если oldfts содержит информацию о времени суток, newfts отображает время суток следующим '00:00' для тех дней, которые ранее не существовали в oldfts.

Пустой ([ ]) прошли как входы для значений пары параметров для toannual инициирует использование значений по умолчанию.

newfts = toannual(oldfts,'ParameterName',ParameterValue, ...) принимает в качестве входных параметров пары имя/значение параметра, как указано в следующей таблице.

Имя параметра	Значение параметров	Описание
`CalcMethod`	`CumSum`	Возвращает совокупную сумму значений в течение каждого года. Данным для отсутствующих дат присваивается значение `0`.
`CalcMethod`	`Exact`	Возвращает точное значение на дату конца года. Манипуляций с данными не происходит.
`CalcMethod`	`Nearest`	(По умолчанию) Возвращает значения, расположенные на дату конца года. Если отсутствуют данные, `Nearest` возвращает ближайшую точку данных, предшествующую дате конца года.
`CalcMethod`	`SimpAvg`	Возвращает среднее годовое значение, которое учитывает только даты с данными (не - `NaN`) в течение каждого года.
`CalcMethod`	`v21x`	Этот режим совместим с предыдущими версиями этой функции (версия 2.1.x и более ранние версии). Среднее значение в конце года возвращается с помощью предыдущего `toannual` алгоритм. Этот алгоритм учитывает все даты и данные. Для дат, которые не содержат никаких данных, данные приняты `0`.
Примечание Если вы задаете `CalcMethod` на `v21x`, настройки для всех следующих пар имя/значение параметра не поддерживаются.
`BusDays`	`0`	Возвращает финансовые временные ряды, который находится в диапазоне от (или между) первой датой до последней даты в `oldfts` (включая NYSE-дни небизнеса и праздничные дни).
`BusDays`	`1`	(По умолчанию) Генерирует ежемесячные финансовые временные ряды, который варьируется от первой даты до последней даты в `oldfts` (исключает NYSE-дни небизнеса и праздничные и выходные дни на основе `AltHolidays` и `Weekend`). Если дата окончания месяца приходится на день небизнеса или праздник NYSE, возвращается последний рабочий день месяца. Закрытие рынка NYSE, праздники и выходные дни наблюдаются, если `AltHolidays` и `Weekend` не поставляются и не пусты (`[]`).
`DateFilter`	`Absolute`	(По умолчанию) Возвращает все годовые даты между начальной и конечной датами `oldfts`. Некоторые даты могут быть проигнорированы, если `BusDays = 1`. Примечание По умолчанию необходимо создать временные ряды с каждой датой с заданной периодичностью, которая с `DateFilter` = `Absolute`. Если вы используете `DateFilter` = `Relative`эффекты конечной точки не применяются, так как только ваши данные определяют, какие даты появляются в объекте выходных временных рядов.
`DateFilter`	`Relative`	Возвращает только те годовые даты, которые существуют в `oldfts`. Некоторые даты могут быть проигнорированы, если `BusDays = 1`.
`ED`	`0`	Годовой период заканчивается в последний или последний рабочий день месяца.
`ED`	`1 - 31`	Задает определенный годовой день. Месяцы, не содержащие указанного дня возврата последнего дня (или последнего рабочего дня) месяца (для примера, `ED = 31` не существует в феврале.)
`EM`	`1 - 12`	(По умолчанию) Годовой период заканчивается в последний день (или последний рабочий день) указанного месяца. Все последующие годовые даты рассчитываются с этого месяца. Годовым месяцем по умолчанию является декабрь (`12`).
`EndPtTol`	[`Begin`, `End`]	Обозначает минимальное количество дней, составляющих нечетный годовой период в конечных точках временных рядов (до даты первого временного ряда и после последней даты конца года). `Begin` и `End` должен быть `-1` или любое положительное целое число, больше или равное `0`. Один вход значения для `'EndPtTol'` является тем же самым, что и установка одинарного значения для `Begin` и `End`. `-1` Исключить нечетные даты годового периода и данные из расчетов. `0` (По умолчанию) Включить нечетные даты годового периода и данные в вычисления. `n` Количество дней (любое положительное целое число), которые составляют нечетный годовой период. Если для полного года недостаточно дней, данные конечной точки игнорируются.
Следующая схема является общим изображением факторов, участвующих в определении конечных точек для этой функции.
`TimeSpec`	`First`	Возвращает только наблюдение, которое происходит в первое (самое раннее) время для определенной даты.
`TimeSpec`	`Last`	(По умолчанию) Возвращает только наблюдение, которое происходит в последнее (последнее) время для определенной даты.
`AltHolidays`		Вектор дат, определяющий альтернативный набор дат закрытия рынка.
`AltHolidays`	`-1`	Исключает все праздничные дни.
`Weekend`		Вектор длины 7, содержащий 0 и 1. Значение `1` указывает на выходной день. Первый элемент этого вектора соответствует воскресению. Например, когда суббота и воскресенье являются днями выходных (по умолчанию), тогда `Weekend = [1 0 0 0 0 0 1]`.

Примеры

свернуть все

Преобразуйте объект временных рядов из еженедельного в годовые значения

Открыть Live Script

В этом примере показано, как преобразовать объект временных рядов из еженедельных в годовые значения.

Загрузите данные из файла predict_ret_data.mat и используйте fints функция для создания объекта временных рядов с еженедельной частотой.

load predict_ret_data.mat
x0 = fints(expdates, expdata, {'Metric'}, 'w', 'Index')

Warning: FINTS is not recommended. Use TIMETABLE instead. For more information, see <a href="matlab:web(fullfile(docroot, 'finance/convert-from-fints-to-timetables.html'))">Convert Financial Time Series Objects (fints) to Timetables</a>.

 
x0 = 
 
    desc:  Index
    freq:  Weekly (2)

    {'dates:  (53)'}    {'Metric:  (53)'}
    {'01-Jan-1999' }    {[      97.8872]}
    {'08-Jan-1999' }    {[      97.0847]}
    {'15-Jan-1999' }    {[     109.6312]}
    {'22-Jan-1999' }    {[     105.5743]}
    {'29-Jan-1999' }    {[     108.4028]}
    {'05-Feb-1999' }    {[     134.4882]}
    {'12-Feb-1999' }    {[     117.5581]}
    {'19-Feb-1999' }    {[     106.6683]}
    {'26-Feb-1999' }    {[     118.2912]}
    {'05-Mar-1999' }    {[     105.6835]}
    {'12-Mar-1999' }    {[     128.5836]}
    {'19-Mar-1999' }    {[     115.1746]}
    {'26-Mar-1999' }    {[     131.2854]}
    {'02-Apr-1999' }    {[     130.7116]}
    {'09-Apr-1999' }    {[     123.1684]}
    {'16-Apr-1999' }    {[     107.2975]}
    {'23-Apr-1999' }    {[      91.5625]}
    {'30-Apr-1999' }    {[      78.5738]}
    {'07-May-1999' }    {[      65.2904]}
    {'14-May-1999' }    {[      70.8581]}
    {'21-May-1999' }    {[      72.4807]}
    {'28-May-1999' }    {[      72.9190]}
    {'04-Jun-1999' }    {[      64.3460]}
    {'11-Jun-1999' }    {[      59.8743]}
    {'18-Jun-1999' }    {[      55.0026]}
    {'25-Jun-1999' }    {[      49.4032]}
    {'02-Jul-1999' }    {[      49.9485]}
    {'09-Jul-1999' }    {[      47.8061]}
    {'16-Jul-1999' }    {[      61.0517]}
    {'23-Jul-1999' }    {[      58.9313]}
    {'30-Jul-1999' }    {[      53.9584]}
    {'06-Aug-1999' }    {[      44.8472]}
    {'13-Aug-1999' }    {[      45.0463]}
    {'20-Aug-1999' }    {[      45.1088]}
    {'27-Aug-1999' }    {[      56.4897]}
    {'03-Sep-1999' }    {[      61.2449]}
    {'10-Sep-1999' }    {[      58.1012]}
    {'17-Sep-1999' }    {[      50.8974]}
    {'24-Sep-1999' }    {[      46.5143]}
    {'01-Oct-1999' }    {[      38.0806]}
    {'08-Oct-1999' }    {[      33.6664]}
    {'15-Oct-1999' }    {[      34.2992]}
    {'22-Oct-1999' }    {[      33.4202]}
    {'29-Oct-1999' }    {[      36.9287]}
    {'05-Nov-1999' }    {[      35.1278]}
    {'12-Nov-1999' }    {[      41.8128]}
    {'19-Nov-1999' }    {[      35.8199]}
    {'26-Nov-1999' }    {[      36.9495]}
    {'03-Dec-1999' }    {[      36.2880]}
    {'10-Dec-1999' }    {[      33.8457]}
    {'17-Dec-1999' }    {[      33.3868]}
    {'24-Dec-1999' }    {[      32.7737]}
    {'31-Dec-1999' }    {[      28.5665]}

Использование toannual для получения годовой совокупности по x0 временные ряды.

x1 = toannual(x0)

Warning: FINTS is not recommended. Use convert2annual instead.

 
x1 = 
 
    desc:  TOANNUAL: Index
    freq:  Annual (6)

    {'dates:  (1)'}    {'Metric:  (1)'}
    {'31-Dec-1999'}    {[     28.5665]}

См. также

Темы

Преобразование данных и преобразование частоты

Представлено до R2006a

Документация