Manuals/calci/COUPDAYS

COUPDAYS(settlement, maturity, frequency, basis)

• Where $settlement$ is the security's settlement date (a date when coupon or a bond is purchased),
• $maturity$ 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() calculates the number of days in the coupon period.

Description

COUPDAYS(settlement, maturity, frequency, basis)

• COUPDAYS() calculates the number of days between the coupon dates surrounding the settlement date.
• $settlement$ and $maturity$ 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 $settlement$ date ≥ $maturity$ 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.

• Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle basis} value is optional. If omitted, Calci assumes it to be 0.

Below table shows the use of Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle basis} values:

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

• If Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle 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