Difference between revisions of "Manuals/calci/PRICEDISC"

From ZCubes Wiki
Jump to navigation Jump to search
(Created page with "<div id="6SpaceContent" class="zcontent" align="left"> '''PRICEDISC'''(SettlementDate, MaturityDate, Discount, Redemption, Basis) where, '''SettlementDate''' - repr...")
 
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<div id="6SpaceContent" class="zcontent" align="left">
+
<div style="font-size:25px">'''PRICEDISC (SettlementDate,MaturityDate,DiscountRate,RedemptionValue,Basis)'''</div><br/>
  
'''PRICEDISC'''(SettlementDate, MaturityDate, Discount, Redemption, Basis)
+
*where <math>SettlementDate</math> is the security's settlement date (a date when coupon or a bond is purchased),  
 +
*<math>MaturityDate</math> is security's maturity date (a date when coupon or a bond expires),  
 +
*<math>DiscountRate</math> is security's discount rate,
 +
*<math>RedemptionValue</math> is security's redemption value per &#36;100 face value, and
 +
*<math>Basis</math> is the type of day count basis to use.
 +
**PRICEDISC(), returns the price per $100 face value of a discounted security.
  
where,
+
== Description ==
  
'''SettlementDate''' - represents the settlement date.
+
PRICEDISC (SettlementDate,MaturityDate,DiscountRate,RedemptionValue,Basis)
  
'''MaturityDate''' - represents the maturity date.
+
*The function returns the price of a discounted security per &#36;100 face value.
 +
*PRICEDISC is calculated by subtracting discounted amount from redemption value.
 +
*<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> , Calci displays #N/A error message.
 +
*<math>DiscountRate</math> value must be greater than or equal to zero, else calci displays #N/A error message.
 +
*<math>RedemptionValue</math> value must be greater than zero, else Calci displays #N/A error message.
 +
*<math>Basis</math> value is optional. If omitted, Calci assumes it to be 0.
 +
Below table shows the use of <math>Basis</math> values:
  
'''Discount''' - represents the discount rate.
+
{| class="wikitable"
 +
|-
 +
! Basis !! Description
 +
|-
 +
| 0 || US (NASD) 30/360
 +
|-
 +
| 1 || Actual/actual
 +
|-
 +
| 2 || Actual/360
 +
|-
 +
| 3 || Actual/365
 +
|-
 +
| 4 || European 30/365
 +
|}
  
'''Redemption''' - represents the redemption value per $100 face value.
+
*If <math>Basis</math> value is other than 0 to 4, Calci displays #N/A error message.
  
'''Basis''' - type of day count basis
+
== Examples ==
  
'''Basis              Day count basis'''
+
<div id="2SpaceContent" class="zcontent" align="left">
  
0 or omitted    US 30/360
+
PRICEDISC (SettlementDate,MaturityDate,DiscountRate,RedemptionValue,Basis) function with inputs in order is calculated as follows:
  
1                     Actual/actual
+
<div id="2SpaceContent" class="zcontent" align="left">
  
2                     Actual/360
+
{| id="TABLE3" class="SpreadSheet blue"
 +
|- class="even"
 +
| class="sshl_f" | 2/2/2008
 +
| class="sshl_f" |
  
3                     Actual/365
+
|- class="odd"
 +
| class="sshl_f" | 11/2/2016
 +
| class="sshl_f" |
  
4                     European 30/360
+
|- class="even"
 +
| class="sshl_f" | 5%
 +
| class="sshl_f" |
  
</div>
+
|- class="odd"
----
+
| class="sshl_f" | 100
<div id="1SpaceContent" class="zcontent" align="left">
+
| class="sshl_f" |
  
It returns the price per $100 face value of a discounted.
+
|- class="even"
 +
| class="sshl_f" | 1
 +
| class="sshl_f" |
  
'''Formula''':-
+
|}
 
 
PRICEDISC =(Redemption-Discount )x Redemption x (D/N)
 
 
 
where,
 
 
 
D - number of days from settlement to maturity.
 
 
 
N - number of days in year
 
 
 
</div>
 
----
 
<div id="7SpaceContent" class="zcontent" align="left">
 
 
 
If Basis &lt; 0 or Basis &gt; 4 , PRICEDISC returns the #ERROR.
 
 
 
If Discount &lt;= 0, it returns the #ERROR.
 
 
 
If SettlementDate &gt;= MaturityDate, PRICEDISC returns #ERRROR.
 
 
 
If Redemption &lt;= 0, PRICEDISC returns the #ERROR.
 
 
 
</div>
 
----
 
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
 
  
PRICEDISC
+
=PRICEDISC(A1,A2,A3,A4,A5) : Calculates the Discounted Price Value with the inputs in the range A1 to A5. Returns ''56.33879781420765''.
  
</div></div>
+
==Related Videos==
----
 
<div id="8SpaceContent" class="zcontent" align="left">
 
  
Lets see an example in (Column2, Row6)
+
{{#ev:youtube|v=zEG9RXcQQr4|280|center|PRICEDISC}}
  
<nowiki>=PRICEDISC(R1C1, R2C1, R3C1, R4C1, R5C1)</nowiki>
+
== See Also ==
  
PRICEDISC returns 97.852841.
+
*[[Manuals/calci/PRICE | PRICE]]
 +
*[[Manuals/calci/PRICEMAT | PRICEMAT]]
  
Consider another example
+
== References ==
  
<nowiki>=PRICEDISC(date(1/1/2027),date(2/2/2008), "5%", 100,2)</nowiki>
+
*[http://en.wikipedia.org/wiki/Bond_valuation Bond Valuation]
 +
*[http://en.wikipedia.org/wiki/Day_count_convention Basis Convention]
  
It returns #ERROR(SettlementDate &gt; MaturityDate).
 
  
</div>
 
----
 
<div id="10SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Syntax </div><div class="ZEditBox"><center></center></div></div>
 
----
 
<div id="4SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Remarks </div></div>
 
----
 
<div id="3SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Examples </div></div>
 
----
 
<div id="11SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Description </div></div>
 
----
 
<div id="2SpaceContent" class="zcontent" align="left">
 
  
{| id="TABLE3" class="SpreadSheet blue"
+
*[[Z_API_Functions | List of Main Z Functions]]
|- class="even"
 
| class=" " |
 
| Column1
 
| class="sshl_f  " | Column2
 
| Column3
 
| Column4
 
|- class="odd"
 
| class=" " | Row1
 
| class=" " | 2/2/2008
 
| class="sshl_f    " |
 
|
 
|
 
|- class="even"
 
| class="  " | Row2
 
| class=" " | 11/2/2008
 
| class="sshl_fSelectTD  SelectTD ChangeBGColor" |
 
|
 
|
 
|- class="odd"
 
| Row3
 
| class=" " | 5%
 
| class="  " |
 
| class="  " |
 
|
 
|- class="even"
 
| Row4
 
| class=" " | 100
 
|
 
|
 
|
 
|- class="odd"
 
| class=" " | Row5
 
| class="sshl_f " | 4
 
|
 
|
 
|
 
|- class="even"
 
| Row6
 
| class="sshl_f" | 96.263889
 
|
 
|
 
|
 
|}
 
  
<div align="left">[[Image:calci1.gif]]</div></div>
+
*[[ Z3 |  Z3 home ]]
----
 

Latest revision as of 15:02, 16 November 2018

PRICEDISC (SettlementDate,MaturityDate,DiscountRate,RedemptionValue,Basis)


  • where is the security's settlement date (a date when coupon or a bond is purchased),
  • is security's maturity date (a date when coupon or a bond expires),
  • is security's discount rate,
  • is security's redemption value per $100 face value, and
  • is the type of day count basis to use.
    • PRICEDISC(), returns the price per $100 face value of a discounted security.

Description

PRICEDISC (SettlementDate,MaturityDate,DiscountRate,RedemptionValue,Basis)

  • The function returns the price of a discounted security per $100 face value.
  • PRICEDISC is calculated by subtracting discounted amount from redemption value.
  • 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 , Calci displays #N/A error message.
  • value must be greater than or equal to zero, else calci displays #N/A error message.
  • value must be greater than zero, else Calci displays #N/A error message.
  • 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

PRICEDISC (SettlementDate,MaturityDate,DiscountRate,RedemptionValue,Basis) function with inputs in order is calculated as follows:

2/2/2008
11/2/2016
5%
100
1
=PRICEDISC(A1,A2,A3,A4,A5) : Calculates the Discounted Price Value with the inputs in the range A1 to A5. Returns 56.33879781420765.

Related Videos

PRICEDISC

See Also

References