Difference between revisions of "Manuals/calci/COUPDAYSNC"

From ZCubes Wiki
Jump to navigation Jump to search
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=COUPDAYSNC(settlement, maturity, frequency, basis)=
+
<div style="font-size:25px">'''COUPDAYSNC(Settlement, Maturity, Frequency, Basis)'''</div><br/>
 
+
*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.
+
**COUPDAYSNC(), returns the number of days from the settlement date to the next coupon date.
 
 
COUPDAYSNC() calculates the number of days from the settlement date to the next coupon date.
 
  
 
== Description ==
 
== Description ==
  
COUPDAYSNC(settlement, maturity, frequency, basis)
+
COUPDAYSNC(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 19:
 
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 37:
 
|}
 
|}
  
*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 ==
Line 71: Line 69:
 
  =COUPDAYSNC(A1,A2,A3,A4) ''displays 183'' as a result.
 
  =COUPDAYSNC(A1,A2,A3,A4) ''displays 183'' as a result.
 
  =COUPDAYSNC(DATE(2012,1,6),DATE(2013,6,6),1,1) ''displays 152'' as a result.
 
  =COUPDAYSNC(DATE(2012,1,6),DATE(2013,6,6),1,1) ''displays 152'' as a result.
 +
 +
==Related Videos==
 +
 +
{{#ev:youtube|v=hZGdzro8GTg|280|center|COUPDAYSNC}}
  
 
== See Also ==
 
== See Also ==
Line 81: Line 83:
 
*[http://en.wikipedia.org/wiki/Coupon_(bond) Coupon]
 
*[http://en.wikipedia.org/wiki/Coupon_(bond) Coupon]
 
*[http://en.wikipedia.org/wiki/Day_count_convention Day Count Basis]
 
*[http://en.wikipedia.org/wiki/Day_count_convention Day Count Basis]
 +
 +
 +
*[[Z_API_Functions | List of Main Z Functions]]
 +
 +
*[[ Z3 |  Z3 home ]]

Latest revision as of 15:37, 15 November 2018

COUPDAYSNC(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.
    • COUPDAYSNC(), returns the number of days from the settlement date to the next coupon date.

Description

COUPDAYSNC(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 COUPDAYSNC function:

06/15/2013
12/15/2014
2
1
=COUPDAYSNC(A1,A2,A3,A4) displays 183 as a result.
=COUPDAYSNC(DATE(2012,1,6),DATE(2013,6,6),1,1) displays 152 as a result.

Related Videos

COUPDAYSNC

See Also

References