Difference between revisions of "Manuals/calci/PRICE"

From ZCubes Wiki
Jump to navigation Jump to search
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=PRICE(settlement, maturity, rate, yield, redemption, frequency, basis)=
+
<div style="font-size:30px">'''PRICE (Settlement,MaturityDate,Rate,Yield,RedemptionValue,Frequency,Basis)'''</div><br/>
 
+
*where <math>Settlement</math> is security's settlement date (a date when coupon or a bond is purchased),  
*where 'settlement' 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),  
*'maturity' is the security's maturity date (a date when coupon or a bond expires),  
+
*<math>Rate</math> is security's annual coupon rate,  
*'rate' is the security's annual coupon rate,  
+
*<math>Yield</math> is security's annual yield,
*'yield' is the security's annual yield,
+
*<math>RedemptionValue</math> is security's redemption value per &#36;100 face value,
*'redemption' is security's redemption value per $100 face value,
+
*<math>Frequency</math> is the number of coupon payments per year, and  
*'frequency' is the number of coupon payments per year, and  
+
*<math>Basis</math> is the type of day count basis to use.
*'basis' is the type of day count basis to use.
+
**PRICE(), returns the price per $100 face value of a security that pays periodic interest.
 
 
PRICE() calculates the price per &#36;100 face value of security that pays periodic interest.
 
  
 
== Description ==
 
== Description ==
  
PRICE(settlement, maturity, rate, yield, redemption, frequency, basis)
+
PRICE(Settlement,MaturityDate,Rate,Yield,RedemptionValue,Frequency,Basis)
  
 
*The function returns the price per &#36;100 face value of security that pays periodic interest.
 
*The function returns the price per &#36;100 face value of security that pays periodic interest.
*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>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 settlement date ≥ maturity date, Calci displays #N/A error message.
+
*If <math>Settlement</math> date ≥ <math>MaturityDate</math> date, Calci displays #N/A error message.
*'rate' and 'yield' values must be greater than or equal to zero, else Calci displays #N/A error message.
+
*<math>Rate</math> and <math>yield</math> values must be greater than or equal to zero, else Calci displays #N/A error message.
*'redemption' value must be greater than zero, else Calci displays #N/A error message.
+
*<math>RedemptionValue</math> value must be greater than zero, else Calci displays #N/A error message.
*The values for 'frequency' 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, <math>Frequency</math> = 1,
  
For Semi-annual payment, frequency = 2,
+
For Semi-annual payment, <math>Frequency</math> = 2,
  
For Quarterly payment, frequency = 4.
+
For Quarterly payment, <math>Frequency</math> = 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 45: Line 43:
 
|}
 
|}
  
*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 ==
 +
 +
PRICE (Settlement,MaturityDate,Rate,Yield,RedemptionValue,Frequency,Basis)  function with inputs in order is calculated as follows:
  
 
<div id="2SpaceContent" class="zcontent" align="left">
 
<div id="2SpaceContent" class="zcontent" align="left">
Line 70: Line 69:
  
 
|- class="even"
 
|- class="even"
| class="sshl_f" | $100
+
| class="sshl_f" | 100
 
| class="sshl_f" |
 
| class="sshl_f" |
|
+
 
 
|- class="odd"
 
|- class="odd"
 
| class="sshl_f" | 2
 
| class="sshl_f" | 2
Line 83: Line 82:
  
 
  =PRICE(A1,A2,A3,A4,A5,A6,A7) : Calculates the Price Value with the inputs in the range A1 to A7. Returns ''81.36538958112115''.
 
  =PRICE(A1,A2,A3,A4,A5,A6,A7) : Calculates the Price Value with the inputs in the range A1 to A7. Returns ''81.36538958112115''.
 +
 +
==Related Videos==
 +
 +
{{#ev:youtube|tJLR3se4Pa4|280|center|PRICE}}
  
 
== See Also ==
 
== See Also ==
Line 92: Line 95:
  
 
*[http://en.wikipedia.org/wiki/Bond_valuation Bond Valuation]
 
*[http://en.wikipedia.org/wiki/Bond_valuation Bond Valuation]
 +
*[http://en.wikipedia.org/wiki/Day_count_convention Basis Convention]
 +
 +
 +
 +
*[[Z_API_Functions | List of Main Z Functions]]
 +
 +
*[[ Z3 |  Z3 home ]]

Latest revision as of 17:29, 22 August 2018

PRICE (Settlement,MaturityDate,Rate,Yield,RedemptionValue,Frequency,Basis)


  • where is 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 annual coupon rate,
  • is security's annual yield,
  • is security's redemption value per $100 face value,
  • is the number of coupon payments per year, and
  • is the type of day count basis to use.
    • PRICE(), returns the price per $100 face value of a security that pays periodic interest.

Description

PRICE(Settlement,MaturityDate,Rate,Yield,RedemptionValue,Frequency,Basis)

  • The function returns the price per $100 face value of security that pays periodic interest.
  • 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.
  • and values 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.
  • The values for should be 1,2 or 4.

For Annual payment, = 1,

For Semi-annual payment, = 2,

For Quarterly payment, = 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

PRICE (Settlement,MaturityDate,Rate,Yield,RedemptionValue,Frequency,Basis) function with inputs in order is calculated as follows:

2/2/2008
11/2/2016
5%
8%
100
2
0
=PRICE(A1,A2,A3,A4,A5,A6,A7) : Calculates the Price Value with the inputs in the range A1 to A7. Returns 81.36538958112115.

Related Videos

PRICE

See Also

References