Difference between revisions of "Manuals/calci/COUPDAYS"
Jump to navigation
Jump to search
(Created page with "<div id="6SpaceContent" class="zcontent" align="left"> <font face="Arial, sans-serif">'''COUPDAYS(settle, M, F, basis)'''</font> <font face="Arial, sans-serif">W...") |
|||
| (9 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | <div | + | <div style="font-size:25px">'''COUPDAYS (SettlementDate,MaturityDate,Frequency,Basis)'''</div><br/> |
| − | + | *Where <math>SettlementDate</math> is the security's settlement date (a date when coupon or a bond is purchased), | |
| − | + | *<math>MaturityDate</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>Basis</math> 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. | |
| + | *<math>SettlementDate</math> and <math>MaturityDate</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>SettlementDate</math> ≥ <math>MaturityDate</math> date, Calci displays #N/A error message. | ||
| + | *The values for <math>Frequency</math> should be 1,2 or 4. | ||
| + | For Annual payment, Frequency = 1, | ||
| − | + | For Semi-annual payment, Frequency = 2, | |
| − | - | ||
| − | |||
| − | + | For Quarterly payment, Frequency = 4. | |
| − | </ | + | *<math>Basis</math> value is optional. If omitted, Calci assumes it to be 0. |
| − | + | Below table shows the use of <math>Basis</math> values: | |
| − | < | ||
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | ! Basis !! Description | |
| − | + | |- | |
| − | + | | 0 || US (NASD) 30/360 | |
| − | + | |- | |
| − | + | | 1 || Actual/actual | |
| − | + | |- | |
| − | + | | 2 || Actual/360 | |
| − | + | |- | |
| − | + | | 3 || Actual/365 | |
| − | + | |- | |
| − | + | | 4 || European 30/360 | |
| − | + | |} | |
| − | + | *If <math>Basis</math> 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: | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
<div id="2SpaceContent" class="zcontent" align="left"> | <div id="2SpaceContent" class="zcontent" align="left"> | ||
{| id="TABLE3" class="SpreadSheet blue" | {| id="TABLE3" class="SpreadSheet blue" | ||
|- class="even" | |- class="even" | ||
| + | | class=" " | 06/20/2010 | ||
| class=" " | | | class=" " | | ||
| − | + | | class=" " | | |
| − | | class=" | + | |
| − | |||
| − | |||
|- class="odd" | |- class="odd" | ||
| − | | class=" " | | + | | class="sshl_f" | 12/20/2014 |
| − | | class=" | + | | class=" " | |
| − | | class=" | + | | class=" " | |
| − | + | ||
| − | |||
|- class="even" | |- class="even" | ||
| − | | class=" | + | | class=" " | 2 |
| − | | class=" | + | | class=" " | |
| − | | | + | | class=" " | |
| − | | | + | |
| − | |||
|- class="odd" | |- class="odd" | ||
| − | | | + | | class=" " | 1 |
| − | + | | class=" " | | |
| − | + | | class=" " | | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | | class=" " | | ||
| − | | class=" | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | | | ||
|} | |} | ||
| − | + | =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== | ||
| + | |||
| + | {{#ev:youtube|v=Sdod6NuKvOU|280|center|COUPDAYS}} | ||
| + | |||
| + | == See Also == | ||
| + | |||
| + | *[[Manuals/calci/COUPDAYBS | COUPDAYBS]] | ||
| + | *[[Manuals/calci/COUPDAYSNC | COUPDAYSNC]] | ||
| + | |||
| + | == References == | ||
| + | |||
| + | *[http://en.wikipedia.org/wiki/Coupon_(bond) Coupon] | ||
| + | *[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:26, 15 November 2018
COUPDAYS (SettlementDate,MaturityDate,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(), returns the number of days in the coupon period that contains the settlement date.
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.
Description
COUPDAYS (SettlementDate,MaturityDate,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, 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 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
See Also
References