Number of days to next coupon date.
Syntax
NumDaysNext = cpndaysn(Settle, Maturity, Period, Basis,
EndMonthRule, IssueDate, FirstCouponDate, LastCouponDate,
StartDate)
Arguments
Settle
|
Settlement date. A vector of serial date numbers or date strings. Settle must be earlier than or equal to Maturity.
|
Maturity
|
Maturity date. A vector of serial date numbers or date strings.
|
Period
|
Coupons per year of the bond. A vector of integers. Allowed values are 1, 2, 3, 4, 6, and 12. Default = 2.
|
Basis
| Day-count basis of the bond. A vector of integers.
0 = actual/actual (default), 1 = 30/360, 2 = actual/360,
3 = actual/365.
|
EndMonthRule
|
End-of-month rule. A vector. This rule applies only when Maturity is an end-of-month date for a month having 30 or fewer days. 0 = ignore rule, meaning that a bond's coupon payment date is always the same numerical day of the month. 1 = set rule on (default), meaning that a bond's coupon payment date is always the last actual day of the month.
|
IssueDate
|
Date when a bond was issued.
|
FirstCouponDate
|
Date when a bond makes its first coupon payment. When FirstCouponDate and LastCouponDate are both specified, FirstCouponDate takes precedence in determining the coupon payment structure.
|
LastCouponDate
|
Last coupon date of a bond prior to the maturity date. In the absence of a specified FirstCouponDate, a specified LastCouponDate determines the coupon structure of the bond. The coupon structure of a bond is truncated at the LastCouponDate regardless of where it falls and will be followed only by the bond's maturity cash flow date.
|
StartDate
|
Date when a bond actually starts (the date from which a bond's cash flows can be considered). To make an instrument forward-starting, specify this date as a future date. If StartDate is not explicitly specified, the effective start date is the settlement date.
|
Settle and Maturity are required arguments. All others are optional.
Required arguments must be N-by-1 or 1-by-N conforming vectors or scalars. Optional arguments must be either N-by-1 or 1-by-N conforming vectors, scalars, or empty matrices.
Description
NumDaysNext = cpndaysn(Settle, Maturity, Period, Basis,
EndMonthRule, IssueDate, FirstCouponDate, LastCouponDate,
StartDate)
returns the number of days from the settlement date to the next coupon date for a bond or set of bonds.
Examples
NumDaysNext = cpndaysn('14 Sep 1997', '30 Jun 1998', 2, 0, 0)
NumDaysNext =
107
NumDaysNext = cpndaysn('14 Sep 1997', '30 Jun 1998', 2, 0, 1)
NumDaysNext =
108
Maturity = ['30 Apr 1998'; '31 May 1998'; '30 Jun 1998'];
NumDaysNext = cpndaysn('14 Sep 1997', Maturity)
NumDaysNext =
47
77
108
See Also
accrfrac, cfamounts, cftimes, cfdates, cpncount, cpndaten, cpndatenq, cpndatep, cpndatepq, cpndaysp, cpnpersz
[ Previous | Help Desk | Next ]