Financial Toolbox
  Go to function:
    Search    Help Desk 
cpndatep    Examples   See Also

Previous coupon date for fixed-income security.

Syntax

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

PreviousCouponDate = cpndatep(Settle, Maturity, Period, Basis, EndMonthRule, IssueDate, FirstCouponDate, LastCouponDate, StartDate) returns the serial date number for the previous coupon date for a bond or set of bonds. This function finds the previous coupon date whether or not the coupon structure is synchronized with the maturity date. When the coupon frequency is 0 (a zero coupon bond), the previous coupon date is calculated as if the frequency were semi-annual.

Use the function datestr to convert serial date numbers to formatted date strings.

Examples

See Also

accrfrac, cfamounts, cfdates, cftimes, cpncount, cpndaten, cpndatenq, cpndatepq, cpndaysn, cpndaysp, cpnpersz


[ Previous | Help Desk | Next ]