datemnth

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

Синтаксис

TargetDate = datemnth(StartDate,NumberMonths)
TargetDate = datemnth(___,DayFlag,Basis,EndMonthRule)

Описание

пример

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

Любой вход может содержать несколько значений, но если так, все другие входные параметры должны содержать то же количество значений или одного значения, которое применяется ко всем. Например, если StartDate является n - символьный массив строки векторов символов даты, то NumberMonths должен быть N-by-1 вектор целых чисел или одного целого числа. TargetDate является затем N-by-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-by-1 или 1-by-N вектор с помощью последовательных чисел даты, векторов символов даты или массивов datetime.

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

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

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

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

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

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

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

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

Этот флаг не имеет никакого эффекта, если EndMonthRule установлен в 1.

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

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

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

  •  1 = 30/360 (СИА)

  •  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 = ШИНА/252

Для получения дополнительной информации смотрите основание.

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

Правило конца месяца отмечает в течение месяца, имея 30 или меньше дней, заданных как скаляр с неотрицательным целочисленным 0 или 1, или как N-by-1 или 1-by-N вектор значений 0 или 1.

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

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

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

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

свернуть все

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

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