Difference between revisions of "Manuals/calci/COUPNUM"

From ZCubes Wiki
Jump to navigation Jump to search
Line 1: Line 1:
=COUPNUM(settlement, maturity, frequency, basis)=
+
=COUPNUM(Settlement, Maturity, Frequency, Basis)=
  
*Where <math>settlement</math> is the security's settlement date (a date when coupon or a bond is purchased),  
+
*Where <math>Settlement</math> is the security's settlement date (a date when coupon or a bond is purchased),  
*<math>maturity</math> is the security's maturity date (a date when coupon or a bond expires),  
+
*<math>Maturity</math> is the security's maturity date (a date when coupon or a bond expires),  
*<math>frequency</math> is the number of coupon payments per year, and  
+
*<math>Frequency</math> is the number of coupon payments per year, and  
*<math>basis</math> is the type of day count basis to use.
+
*<math>Basis</math> is the type of day count basis to use.
  
 
COUPNUM() calculates the number of coupons to be paid between the settlement date and the maturity date.
 
COUPNUM() calculates the number of coupons to be paid between the settlement date and the maturity date.
Line 10: Line 10:
 
== Description ==
 
== Description ==
  
COUPNUM(settlement, maturity, frequency, basis)
+
COUPNUM(Settlement, Maturity, Frequency, Basis)
  
*<math>settlement</math> and <math>maturity</math> dates should be entered either in 'date format' or 'dates returned using formulas'. If dates are not valid, Calci displays #N/A error message.
+
*<math>Settlement</math> and <math>Maturity</math> 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 <math>settlement</math> date = <math>maturity</math> date, Calci displays #N/A error message.
+
*If <math>Settlement</math> date = <math>Maturity</math> date, Calci displays #N/A error message.
*The values for <math>frequency</math> should be 1,2 or 4.  
+
*The values for <math>Frequency</math> should be 1,2 or 4.  
 
For Annual payment, frequency = 1,
 
For Annual payment, frequency = 1,
  
Line 21: Line 21:
 
For Quarterly payment, frequency = 4.
 
For Quarterly payment, frequency = 4.
  
*<math>basis</math> value is optional. If omitted, Calci assumes it to be 0.  
+
*<math>Basis</math> value is optional. If omitted, Calci assumes it to be 0.  
Below table shows the use of <math>basis</math> values:
+
Below table shows the use of <math>Basis</math> values:
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 39: Line 39:
 
|}
 
|}
  
*If <math>basis</math> value is other than 0 to 4, Calci displays #N/A error message.
+
*If <math>Basis</math> value is other than 0 to 4, Calci displays #N/A error message.
  
 
== Examples ==
 
== Examples ==

Revision as of 16:50, 27 June 2018

COUPNUM(Settlement, Maturity, Frequency, Basis)

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

COUPNUM() calculates the number of coupons to be paid between the settlement date and the maturity date.

Description

COUPNUM(Settlement, Maturity, Frequency, Basis)

  • and 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 date = date, Calci displays #N/A error message.
  • The values for should be 1,2 or 4.

For Annual payment, frequency = 1,

For Semi-annual payment, frequency = 2,

For Quarterly payment, frequency = 4.

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

Below table shows the use of values:

Basis Description
0 US (NASD) 30/360
1 Actual/actual
2 Actual/360
3 Actual/365
4 European 30/360
  • If value is other than 0 to 4, Calci displays #N/A error message.

Examples

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

06/20/2010
12/20/2014
2
1
=COUPNUM(A1,A2,A3,A4) displays 9 as a result.
=COUPNUM(DATE(2012,1,31),DATE(2014,1,6),1,1) displays 2 as a result.

Related Videos

COUPNUM

See Also

References