Difference between revisions of "Manuals/calci/COUPDAYS"

From ZCubes Wiki
Jump to navigation Jump to search
Line 1: Line 1:
 
=COUPDAYS(settlement, maturity, frequency, basis)=
 
=COUPDAYS(settlement, maturity, frequency, basis)=
  
*Where 'settlement' 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),  
*'maturity' 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),  
*'frequency' is the number of coupon payments per year, and  
+
*<math>frequency</math> is the number of coupon payments per year, and  
*'basis' is the type of day count basis to use.
+
*<math>basis</math> is the type of day count basis to use.
  
 
COUPDAYS() calculates the number of days in the coupon period.
 
COUPDAYS() calculates the number of days in the coupon period.
Line 13: Line 13:
  
 
*COUPDAYS() calculates the number of days between the coupon dates surrounding the settlement date.
 
*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.
+
*<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 settlement date ≥ maturity date, Calci displays #N/A error message.
+
*If <math>settlement</math> date ≥ <math>maturity</math> date, Calci displays #N/A error message.
*'coupon' and 'yield' values must be greater than or equal to zero.
+
*The values for <math>frequency</math> should be 1,2 or 4.  
*The values for 'frequency' should be 1,2 or 4.  
 
 
For Annual payment, frequency = 1,
 
For Annual payment, frequency = 1,
  
Line 23: Line 22:
 
For Quarterly payment, frequency = 4.
 
For Quarterly payment, frequency = 4.
  
*'basis' 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 'basis' values:
+
Below table shows the use of <math>basis</math> values:
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 41: Line 40:
 
|}
 
|}
  
*If 'basis' 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:42, 17 January 2014

COUPDAYS(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.

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.
  • 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/365
  • If 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.

See Also

References