Manuals/calci/COUPDAYS

COUPDAYS (SettlementDate,MaturityDate,Frequency,Basis)

• Where $SettlementDate$ is the security's settlement date (a date when coupon or a bond is purchased),
• $MaturityDate$ is the security's maturity date (a date when coupon or a bond expires),
• $Frequency$ is the number of coupon payments per year, and
• $Basis$ is the type of day count basis to use.

COUPDAYS(), returns the number of days in the coupon period that contains the settlement date.

Description

COUPDAYS (SettlementDate,MaturityDate,Frequency,Basis)

• COUPDAYS() calculates the number of days between the coupon dates surrounding the settlement date.
• $SettlementDate$ and $MaturityDate$ dates should be entered either in 'date format' or 'dates returned using formulas'. If dates are not valid, Calci displays #N/A error message.
• If $SettlementDate$ ≥ $MaturityDate$ date, Calci displays #N/A error message.
• The values for $Frequency$ should be 1,2 or 4.

For Annual payment, Frequency = 1,

For Semi-annual payment, Frequency = 2,

For Quarterly payment, Frequency = 4.

• $Basis$ value is optional. If omitted, Calci assumes it to be 0.

Below table shows the use of $basis$ values:

Basis	Description
0	US (NASD) 30/360
1	Actual/actual
2	Actual/360
3	Actual/365
4	European 30/360

• If $Basis$ value is other than 0 to 4, Calci displays #N/A error message.

Examples

Consider the following example that shows the use of COUPDAYS function:

06/20/2010
12/20/2014
2
1

=COUPDAYS(A1,A2,A3,A4) displays 183 as a result.
=COUPDAYS(DATE(2012,1,1),DATE(2013,1,1),1,1) displays 366 as a result.

Related Videos

COUPDAYS

See Also

• COUPDAYBS
• COUPDAYSNC

References

• Coupon
• Day Count Basis

• List of Main Z Functions

• Z3 home