exponenta event banner

datemnth

Дата дня в будущем или прошлом месяце

Описание

пример

TargetDate = datemnth(StartDate,NumberMonths) определяет дату в будущем или прошедшем месяце на основе движения вперед или назад во времени на заданное количество месяцев.

Любой вход может содержать несколько значений, но если это так, все остальные входы должны содержать одинаковое количество значений или одно значение, которое применяется ко всем. Например, если StartDate - символьный массив n-строк векторов символов даты, NumberMonths должно быть Nоколо-1 вектор целых чисел или одно целое число. TargetDate затем является Nоколо-1 вектор номеров дат.

Если StartDate - порядковый номер даты или символьный вектор даты, TargetDate возвращается в виде серийного номера. Использовать datestr преобразование серийных номеров дат в форматированные векторы символов даты.

Если StartDate является массивом datetime, то TargetDate возвращается в виде массива datetime.

пример

TargetDate = datemnth(___,DayFlag,Basis,EndMonthRule) определяет дату в будущем или прошедшем месяце, основываясь на движении вперед или назад во времени на заданное количество месяцев, используя необязательные входные аргументы для DayFlag,Basis, и EndMonthRule.

Примеры

свернуть все

Определите TargetDate в будущем месяце с использованием вектора символов даты для StartDate.

StartDate = '03-Jun-1997';
NumberMonths = 6;
DayFlag = 0;
Basis = 0;
EndMonthRule = 1;
 
TargetDate = datemnth(StartDate, NumberMonths, DayFlag,...
Basis, EndMonthRule)
TargetDate = 729727
datestr(TargetDate)
ans = 
'03-Dec-1997'

Определите TargetDate в будущем месяце с использованием массива datetime для StartDate.

Day = datemnth(datetime('3-jun-2001','Locale','en_US'), 6, 0, 0, 0)
Day = datetime
   03-Dec-2001

Определите TargetDate в будущем месяце с использованием вектора для NumberMonths.

NumberMonths = [1; 3; 5; 7; 9];
TargetDate = datemnth('31-jan-2001', NumberMonths); 
datestr(TargetDate)
ans = 5x11 char array
    '28-Feb-2001'
    '30-Apr-2001'
    '30-Jun-2001'
    '31-Aug-2001'
    '31-Oct-2001'

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

свернуть все

Дата начала, указанная как Nоколо-1 или 1около-N вектор с использованием серийных номеров дат, векторов символов даты или массивов datetime.

Типы данных: double | char | datetime

Количество месяцев в будущем (положительное) или прошлое (отрицательное), указанное как Nоколо-1 или 1около-N вектор, содержащий положительные или отрицательные целые числа.

Типы данных: double

Флажок для определения фактического номера дня для целевой даты в будущем или прошедшем месяце, указанный как Nоколо-1 или 1около-N вектор с использованием цифры со значениями0, 1, или 2.

Возможные значения:

  • 0 (по умолчанию) = номер дня должен быть днем в будущем или прошедшем месяце, соответствующим фактическому номеру дня начальной даты.

  • 1 = номер дня должен быть первым днем будущего или прошедшего месяца.

  • 2 = номер дня должен быть последним днем будущего или прошедшего месяца.

Этот флаг не действует, если EndMonthRule имеет значение 1.

Типы данных: double

Базисное число дней, используемое при определении даты прошлого или будущего, указанное как скалярное значение с целым числом со значением 0 через 13, или Nоколо-1 или 1около-N вектор целых чисел со значениями 0 через 13.

  • 0 = факт/факт (по умолчанию)

  • 1 = 30/360 (SIA)

  • 2 = фактически/360

  • 3 = факт/365

  • 4 = 30/360 (BMA)

  • 5 = 30/360 (ISDA)

  • 6 = 30/360 (европейский)

  • 7 = факт/365 (японский)

  • 8 = факт/факт (ICMA)

  • 9 = факт/360 (ICMA)

  • 10 = факт/365 (ICMA)

  • 11 = 30/360E (ICMA)

  • 12 = факт/365 (ISDA)

  • 13 = BUS/252

Дополнительные сведения см. в разделе Базис.

Типы данных: single | double

Флаг правила конца месяца для месяца, имеющего 30 или менее дней, указанный как скаляр с неотрицательным целым числом 0 или 1, или в качестве Nоколо-1 или 1около-N вектор значений 0 или 1.

  • 0 = Игнорировать правило, что означает, что правило не действует.

  • 1 = Установите правило на, что означает, что если вы начинаете в последний день месяца, и месяц имеет 30 или менее дней, вы будете заканчиваться в последний фактический день будущего или прошлого месяца независимо от того, имеет ли этот месяц 28, 29, 30 или 31 день.

Типы данных: logical

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

свернуть все

Целевая дата в будущем или прошлом месяце, возвращенная как Nоколо-1 или 1около-N вектор, содержащий серийный номер даты (по умолчанию) или datetime (если StartDate - массив datetime) целевой даты.

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