Financial Toolbox | ![]() ![]() |
Next coupon date for fixed-income security (SIA compliant)
Syntax
NextCouponDate = cpndaten(Settle, Maturity, Period, Basis, EndMonthRule, IssueDate, FirstCouponDate, LastCouponDate)
Arguments
Required arguments must be number of bonds (NUMBONDS
) by 1 or 1-by-NUMBONDS
conforming vectors or scalars. Optional arguments must be either NUMBONDS
-by-1 or 1-by-NUMBONDS
conforming vectors, scalars, or empty matrices.
Description
NextCouponDate = cpndaten(Settle, Maturity, Period, Basis,
EndMonthRule, IssueDate, FirstCouponDate, LastCouponDate)
returns the next coupon date after the settlement date. This function finds the next coupon date whether or not the coupon structure is synchronized with the maturity date.
NextCouponDate
is returned as a serial date number. The function datestr
converts a serial date number to a formatted date string.
Examples
NextCouponDate = cpndaten('14 Mar 1997', '30 Nov 2000', 2, 0, 0); datestr(NextCouponDate) ans = 30-May-1997 NextCouponDate = cpndaten('14 Mar 1997', '30 Nov 2000', 2, 0, 1); datestr(NextCouponDate) ans = 31-May-1997 Maturity = ['30 Sep 2000'; '31 Oct 2000'; '30 Nov 2000']; NextCouponDate = cpndaten('14 Mar 1997', Maturity); datestr(NextCouponDate) ans = 31-Mar-1997 30-Apr-1997 31-May-1997
See Also
accrfrac
, cfamounts
, cfdates
, cftimes
, cpncount
, cpndatenq
, cpndatep
, cpndatepq
, cpndaysn
, cpndaysp
, cpnpersz
![]() | cpncount | cpndatenq | ![]() |