Difference between revisions of "Documentation/How Tos/Calc: PRICE function"
From Apache OpenOffice Wiki
< Documentation | How Tos
(→Syntax:) |
|||
Line 5: | Line 5: | ||
=== Syntax: === | === Syntax: === | ||
− | <tt>'''PRICE(settlementdate; maturitydate; rate; | + | <tt>'''PRICE(settlementdate; maturitydate; rate; yield; redemptionvalue; frequency; basis)'''</tt> |
: <tt>'''settlementdate'''</tt>: the settlement (purchase) date of the security. | : <tt>'''settlementdate'''</tt>: the settlement (purchase) date of the security. | ||
: <tt>'''maturitydate'''</tt>: the maturity (redemption) date of the security. | : <tt>'''maturitydate'''</tt>: the maturity (redemption) date of the security. | ||
: <tt>'''rate'''</tt>: the (annual) coupon rate of the security. | : <tt>'''rate'''</tt>: the (annual) coupon rate of the security. | ||
− | : <tt>''' | + | : <tt>'''yield'''</tt>: the required annual rate of return (compounded at each interest payment). |
: <tt>'''redemptionvalue'''</tt>: the redemption value of the security, per 100 par value. | : <tt>'''redemptionvalue'''</tt>: the redemption value of the security, per 100 par value. | ||
: <tt>'''frequency'''</tt>: number of interest payments per year (1, 2 or 4). | : <tt>'''frequency'''</tt>: number of interest payments per year (1, 2 or 4). |
Revision as of 20:56, 5 September 2008
PRICE
Calculates a quoted price for an interest paying security, per 100 currency units par value.
Syntax:
PRICE(settlementdate; maturitydate; rate; yield; redemptionvalue; frequency; basis)
- settlementdate: the settlement (purchase) date of the security.
- maturitydate: the maturity (redemption) date of the security.
- rate: the (annual) coupon rate of the security.
- yield: the required annual rate of return (compounded at each interest payment).
- redemptionvalue: the redemption value of the security, per 100 par value.
- frequency: number of interest payments per year (1, 2 or 4).
- basis: is the calendar system to use. Defaults to 0 if omitted.
- 0 - US method (NASD), 12 months of 30 days each
- 1 - Actual number of days in months, actual number of days in year
- 2 - Actual number of days in month, year has 360 days
- 3 - Actual number of days in month, year has 365 days
- 4 - European method, 12 months of 30 days each
- This function calculates a quoted price for a security (the 'clean' price). The price actually paid (the 'dirty' price) is more, because it includes accrued interest.
- PRICE returns:
- present_value_of_coupon_payments + present_value_of_redemption_payment - accrued_coupon_interest.
- See Derivation of Financial Formulas for a more detailed formula.
Example:
PRICE("2008-02-15"; "2010-11-15"; 5%; 7%; 100; 2; 0)
- returns approximately 95.06.
See also:
Derivation of Financial Formulas
Issues:
- This function calculates present values compounding the required rate of return each coupon period.
- The price is calculated as at the date of settlement (when the money changes hands). The contract to buy the bond (the trade date) may predate that (for example by 3 days).