1<?xml version="1.0" encoding="UTF-8"?>
2<helpdocument version="1.0">
3
4<!--***********************************************************
5 *
6 * Licensed to the Apache Software Foundation (ASF) under one
7 * or more contributor license agreements.  See the NOTICE file
8 * distributed with this work for additional information
9 * regarding copyright ownership.  The ASF licenses this file
10 * to you under the Apache License, Version 2.0 (the
11 * "License"); you may not use this file except in compliance
12 * with the License.  You may obtain a copy of the License at
13 *
14 *   http://www.apache.org/licenses/LICENSE-2.0
15 *
16 * Unless required by applicable law or agreed to in writing,
17 * software distributed under the License is distributed on an
18 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
19 * KIND, either express or implied.  See the License for the
20 * specific language governing permissions and limitations
21 * under the License.
22 *
23 ***********************************************************-->
24
25
26
27
28<meta>
29<topic id="textscalc0104060119xml" indexer="include">
30<title id="tit" xml-lang="en-US">Financial Functions Part Two</title>
31<filename>/text/scalc/01/04060119.xhp</filename>
32</topic>
33</meta>
34<body>
35<paragraph role="heading" id="hd_id3149052" xml-lang="en-US" level="1" l10n="U" oldref="1">Financial Functions Part Two</paragraph>
36<section id="howtoget">
37<embed href="text/scalc/00/00000404.xhp#eikafi"/>
38</section>
39<paragraph role="paragraph" id="par_id3148742" xml-lang="en-US" l10n="U" oldref="343"><link href="text/scalc/01/04060103.xhp" name="Back to Financial Functions Part One">Back to Financial Functions Part One</link></paragraph>
40<paragraph role="paragraph" id="par_id3151341" xml-lang="en-US" l10n="U" oldref="344"><link href="text/scalc/01/04060118.xhp" name="Forward to Financial Functions Part Three">Forward to Financial Functions Part Three</link></paragraph>
41<sort order="asc">
42<section id="ppmt">
43<bookmark xml-lang="en-US" branch="index" id="bm_id3150026"><bookmark_value>PPMT function</bookmark_value>
44</bookmark>
45<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KAPZ" id="bm_id3145827" localize="false"/>
46<paragraph role="heading" id="hd_id3150026" xml-lang="en-US" level="2" l10n="U" oldref="238">PPMT</paragraph>
47<paragraph role="paragraph" id="par_id3146942" xml-lang="en-US" l10n="U" oldref="239"><ahelp hid="HID_FUNC_KAPZ">Returns for a given period the payment on the principal for an investment that is based on periodic and constant payments and a constant interest rate.</ahelp></paragraph>
48<paragraph role="heading" id="hd_id3150459" xml-lang="en-US" level="3" l10n="U" oldref="240">Syntax</paragraph>
49<paragraph role="code" id="par_id3146878" xml-lang="en-US" l10n="U" oldref="241">PPMT(Rate; Period; NPer; PV; FV; Type)</paragraph>
50<paragraph role="paragraph" id="par_id3151228" xml-lang="en-US" l10n="U" oldref="242">
51<emph>Rate</emph> is the periodic interest rate.</paragraph>
52<paragraph role="paragraph" id="par_id3148887" xml-lang="en-US" l10n="U" oldref="243">
53<emph>Period</emph> is the amortizement period. P = 1 for the first and P = NPer for the last period.</paragraph>
54<paragraph role="paragraph" id="par_id3148436" xml-lang="en-US" l10n="U" oldref="244">
55<emph>NPer</emph> is the total number of periods during which annuity is paid.</paragraph>
56<paragraph role="paragraph" id="par_id3153035" xml-lang="en-US" l10n="U" oldref="245">
57<emph>PV</emph> is the present value in the sequence of payments.</paragraph>
58<paragraph role="paragraph" id="par_id3147474" xml-lang="en-US" l10n="U" oldref="246">
59<emph>FV</emph> (optional) is the desired (future) value.</paragraph>
60<paragraph role="paragraph" id="par_id3144744" xml-lang="en-US" l10n="U" oldref="247">
61<emph>Type</emph> (optional) defines the due date. F = 1 for payment at the beginning of a period and F = 0 for payment at the end of a period.</paragraph>
62<paragraph role="paragraph" id="par_idN1067C" xml-lang="en-US" l10n="NEW">
63<embedvar href="text/scalc/00/00000004.xhp#optional"/>
64</paragraph>
65<paragraph role="heading" id="hd_id3148582" xml-lang="en-US" level="3" l10n="U" oldref="248">Example</paragraph>
66<paragraph role="paragraph" id="par_id3154811" xml-lang="en-US" l10n="CHG" oldref="249">How high is the periodic monthly payment at an annual interest rate of 8.75% over a period of 3 years? The cash value is 5,000 currency units and is always paid at the beginning of a period. The future value is 8,000 currency units.</paragraph>
67<paragraph role="paragraph" id="par_id3149246" xml-lang="en-US" l10n="U" oldref="250">
68<item type="input">=PPMT(8.75%/12;1;36;5000;8000;1)</item> = -350.99 currency units.</paragraph>
69</section>
70<section id="cumprinc">
71<bookmark xml-lang="en-US" branch="index" id="bm_id3146139"><bookmark_value>calculating; total amortizement rates</bookmark_value>
72<bookmark_value>total amortizement rates</bookmark_value>
73<bookmark_value>amortization installment</bookmark_value>
74<bookmark_value>repayment installment</bookmark_value>
75<bookmark_value>CUMPRINC function</bookmark_value>
76</bookmark><comment>mw added two entries</comment>
77<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KUMKAPITAL" id="bm_id3148754" localize="false"/>
78<paragraph role="heading" id="hd_id3146139" xml-lang="en-US" level="2" oldref="252">CUMPRINC</paragraph>
79<paragraph role="paragraph" id="par_id3150140" xml-lang="en-US" l10n="U" oldref="253"><ahelp hid="HID_FUNC_KUMKAPITAL">Returns the cumulative interest paid for an investment period with a constant interest rate.</ahelp></paragraph>
80<paragraph role="heading" id="hd_id3149188" xml-lang="en-US" level="3" l10n="U" oldref="254">Syntax</paragraph>
81<paragraph role="code" id="par_id3148733" xml-lang="en-US" l10n="U" oldref="255">CUMPRINC(Rate; NPer; PV; S; E; Type)</paragraph>
82<paragraph role="paragraph" id="par_id3150864" xml-lang="en-US" l10n="U" oldref="256">
83<emph>Rate</emph> is the periodic interest rate.</paragraph>
84<paragraph role="paragraph" id="par_id3166052" xml-lang="en-US" l10n="U" oldref="257">
85<emph>NPer</emph> is the payment period with the total number of periods. NPER can also be a non-integer value.</paragraph>
86<paragraph role="paragraph" id="par_id3150007" xml-lang="en-US" l10n="U" oldref="258">
87<emph>PV</emph> is the current value in the sequence of payments.</paragraph>
88<paragraph role="paragraph" id="par_id3153112" xml-lang="en-US" l10n="U" oldref="259">
89<emph>S</emph> is the first period.</paragraph>
90<paragraph role="paragraph" id="par_id3146847" xml-lang="en-US" l10n="U" oldref="260">
91<emph>E</emph> is the last period.</paragraph>
92<paragraph role="paragraph" id="par_id3145167" xml-lang="en-US" l10n="U" oldref="261">
93<emph>Type</emph> is the due date of the payment at the beginning or end of each period.</paragraph>
94<paragraph role="heading" id="hd_id3154502" xml-lang="en-US" level="3" l10n="U" oldref="262">Example</paragraph>
95<paragraph role="paragraph" id="par_id3153570" xml-lang="en-US" l10n="U" oldref="263">What are the payoff amounts if the yearly interest rate is 5.5% for 36 months? The cash value is 15,000 currency units. The payoff amount is calculated between the 10th and 18th period. The due date is at the end of the period.</paragraph>
96<paragraph role="paragraph" id="par_id3149884" xml-lang="en-US" l10n="U" oldref="264">
97<item type="input">=CUMPRINC(5.5%/12;36;15000;10;18;0)</item> = -3669.74 currency units. The payoff amount between the 10th and 18th period is 3669.74 currency units.</paragraph>
98</section>
99<section id="cumprinc_add">
100<bookmark xml-lang="en-US" branch="index" id="bm_id3150019"><bookmark_value>CUMPRINC_ADD function</bookmark_value>
101</bookmark>
102<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_CUMPRINC" id="bm_id3154330" localize="false"/>
103<paragraph role="heading" id="hd_id3150019" xml-lang="en-US" level="2" oldref="182">CUMPRINC_ADD</paragraph>
104<paragraph role="paragraph" id="par_id3145246" xml-lang="en-US" l10n="U" oldref="183"><ahelp hid="HID_AAI_FUNC_CUMPRINC"> Calculates the cumulative redemption of a loan in a period.</ahelp></paragraph>
105<embed href="text/scalc/01/04060102.xhp#ADD_note"/>
106<paragraph role="heading" id="hd_id3153047" xml-lang="en-US" level="3" l10n="U" oldref="184">Syntax</paragraph>
107<paragraph role="code" id="par_id3157970" xml-lang="en-US" l10n="U" oldref="185">CUMPRINC_ADD(Rate; NPer; PV; StartPeriod; EndPeriod; Type)</paragraph>
108<paragraph role="paragraph" id="par_id3145302" xml-lang="en-US" l10n="U" oldref="186">
109<emph>Rate</emph> is the interest rate for each period.</paragraph>
110<paragraph role="paragraph" id="par_id3151017" xml-lang="en-US" l10n="U" oldref="187">
111<emph>NPer</emph> is the total number of payment periods. The rate and NPER must refer to the same unit, and thus both be calculated annually or monthly.</paragraph>
112<paragraph role="paragraph" id="par_id3155620" xml-lang="en-US" l10n="U" oldref="188">
113<emph>PV</emph> is the current value.</paragraph>
114<paragraph role="paragraph" id="par_id3145352" xml-lang="en-US" l10n="U" oldref="189">
115<emph>StartPeriod</emph> is the first payment period for the calculation.</paragraph>
116<paragraph role="paragraph" id="par_id3157986" xml-lang="en-US" l10n="U" oldref="190">
117<emph>EndPeriod</emph> is the last payment period for the calculation.</paragraph>
118<paragraph role="paragraph" id="par_id3150570" xml-lang="en-US" l10n="U" oldref="191">
119<emph>Type</emph> is the maturity of a payment at the end of each period (Type = 0) or at the start of the period (Type = 1).</paragraph>
120<paragraph role="heading" id="hd_id3150269" xml-lang="en-US" level="3" l10n="U" oldref="192">Example</paragraph>
121<paragraph role="paragraph" id="par_id3148774" xml-lang="en-US" l10n="U" oldref="193">The following mortgage loan is taken out on a house:</paragraph>
122<paragraph role="paragraph" id="par_id3150661" xml-lang="en-US" l10n="U" oldref="194">Rate: 9.00 per cent per annum (9% / 12 = 0.0075), Duration: 30 years (payment periods = 30 * 12 = 360), NPV: 125000 currency units.</paragraph>
123<paragraph role="paragraph" id="par_id3155512" xml-lang="en-US" l10n="U" oldref="195">How much will you repay in the second year of the mortgage (thus from periods 13 to 24)?</paragraph>
124<paragraph role="paragraph" id="par_id3149394" xml-lang="en-US" l10n="U" oldref="196">
125<item type="input">=CUMPRINC_ADD(0.0075;360;125000;13;24;0)</item> returns -934.1071</paragraph>
126<paragraph role="paragraph" id="par_id3149026" xml-lang="en-US" l10n="U" oldref="197">In the first month you will be repaying the following amount:</paragraph>
127<paragraph role="paragraph" id="par_id3154636" xml-lang="en-US" l10n="U" oldref="198">
128<item type="input">=CUMPRINC_ADD(0.0075;360;125000;1;1;0)</item> returns -68.27827</paragraph>
129</section>
130<section id="cumipmt">
131<bookmark xml-lang="en-US" branch="index" id="bm_id3155370"><bookmark_value>calculating; accumulated interests</bookmark_value>
132<bookmark_value>accumulated interests</bookmark_value>
133<bookmark_value>CUMIPMT function</bookmark_value>
134</bookmark>
135<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KUMZINSZ" id="bm_id3148593" localize="false"/>
136<paragraph role="heading" id="hd_id3155370" xml-lang="en-US" level="2" oldref="266">CUMIPMT</paragraph>
137<paragraph role="paragraph" id="par_id3158411" xml-lang="en-US" l10n="U" oldref="267"><ahelp hid="HID_FUNC_KUMZINSZ">Calculates the cumulative interest payments, that is, the total interest, for an investment based on a constant interest rate.</ahelp></paragraph>
138<paragraph role="heading" id="hd_id3155814" xml-lang="en-US" level="3" l10n="U" oldref="268">Syntax</paragraph>
139<paragraph role="code" id="par_id3147536" xml-lang="en-US" l10n="U" oldref="269">CUMIPMT(Rate; NPer; PV; S; E; Type)</paragraph>
140<paragraph role="paragraph" id="par_id3150475" xml-lang="en-US" l10n="U" oldref="270">
141<emph>Rate</emph> is the periodic interest rate.</paragraph>
142<paragraph role="paragraph" id="par_id3153921" xml-lang="en-US" l10n="U" oldref="271">
143<emph>NPer</emph> is the payment period with the total number of periods. NPER can also be a non-integer value.</paragraph>
144<paragraph role="paragraph" id="par_id3153186" xml-lang="en-US" l10n="U" oldref="272">
145<emph>PV</emph> is the current value in the sequence of payments.</paragraph>
146<paragraph role="paragraph" id="par_id3156259" xml-lang="en-US" l10n="U" oldref="273">
147<emph>S</emph> is the first period.</paragraph>
148<paragraph role="paragraph" id="par_id3155990" xml-lang="en-US" l10n="U" oldref="274">
149<emph>E</emph> is the last period.</paragraph>
150<paragraph role="paragraph" id="par_id3149777" xml-lang="en-US" l10n="U" oldref="275">
151<emph>Type</emph> is the due date of the payment at the beginning or end of each period.</paragraph>
152<paragraph role="heading" id="hd_id3153723" xml-lang="en-US" level="3" l10n="U" oldref="276">Example</paragraph>
153<paragraph role="paragraph" id="par_id3147478" xml-lang="en-US" l10n="U" oldref="277">What are the interest payments at a yearly interest rate of 5.5 %, a payment period of monthly payments for 2 years and a current cash value of 5,000 currency units? The start period is the 4th and the end period is the 6th period. The payment is due at the beginning of each period.</paragraph>
154<paragraph role="paragraph" id="par_id3149819" xml-lang="en-US" l10n="U" oldref="278">
155<item type="input">=CUMIPMT(5.5%/12;24;5000;4;6;1)</item> = -57.54 currency units. The interest payments for between the 4th and 6th period are 57.54 currency units.</paragraph>
156</section>
157<section id="cumipmt_add">
158<bookmark xml-lang="en-US" branch="index" id="bm_id3083280"><bookmark_value>CUMIPMT_ADD function</bookmark_value>
159</bookmark>
160<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_CUMIPMT" id="bm_id3154312" localize="false"/>
161<paragraph role="heading" id="hd_id3083280" xml-lang="en-US" level="2" oldref="165">CUMIPMT_ADD</paragraph>
162<paragraph role="paragraph" id="par_id3152482" xml-lang="en-US" l10n="U" oldref="166"><ahelp hid="HID_AAI_FUNC_CUMIPMT">Calculates the accumulated interest for a period.</ahelp></paragraph>
163<embed href="text/scalc/01/04060102.xhp#ADD_note"/>
164<paragraph role="heading" id="hd_id3149713" xml-lang="en-US" level="3" l10n="U" oldref="167">Syntax</paragraph>
165<paragraph role="code" id="par_id3145087" xml-lang="en-US" l10n="U" oldref="168">CUMIPMT_ADD(Rate; NPer; PV; StartPeriod; EndPeriod; Type)</paragraph>
166<paragraph role="paragraph" id="par_id3149277" xml-lang="en-US" l10n="U" oldref="169">
167<emph>Rate</emph> is the interest rate for each period.</paragraph>
168<paragraph role="paragraph" id="par_id3149270" xml-lang="en-US" l10n="U" oldref="170">
169<emph>NPer</emph> is the total number of payment periods. The rate and NPER must refer to the same unit, and thus both be calculated annually or monthly.</paragraph>
170<paragraph role="paragraph" id="par_id3152967" xml-lang="en-US" l10n="U" oldref="171">
171<emph>PV</emph> is the current value.</paragraph>
172<paragraph role="paragraph" id="par_id3156308" xml-lang="en-US" l10n="U" oldref="172">
173<emph>StartPeriod</emph> is the first payment period for the calculation.</paragraph>
174<paragraph role="paragraph" id="par_id3149453" xml-lang="en-US" l10n="U" oldref="173">
175<emph>EndPeriod</emph> is the last payment period for the calculation.</paragraph>
176<paragraph role="paragraph" id="par_id3150962" xml-lang="en-US" l10n="U" oldref="174">
177<emph>Type</emph> is the maturity of a payment at the end of each period (Type = 0) or at the start of the period (Type = 1).</paragraph>
178<paragraph role="heading" id="hd_id3152933" xml-lang="en-US" level="3" l10n="U" oldref="175">Example</paragraph>
179<paragraph role="paragraph" id="par_id3156324" xml-lang="en-US" l10n="U" oldref="176">The following mortgage loan is taken out on a house:</paragraph>
180<paragraph role="paragraph" id="par_id3147566" xml-lang="en-US" l10n="U" oldref="177">Rate: 9.00 per cent per annum (9% / 12 = 0.0075), Duration: 30 years (NPER = 30 * 12 = 360), Pv: 125000 currency units.</paragraph>
181<paragraph role="paragraph" id="par_id3151272" xml-lang="en-US" l10n="U" oldref="178">How much interest must you pay in the second year of the mortgage (thus from periods 13 to 24)?</paragraph>
182<paragraph role="paragraph" id="par_id3156130" xml-lang="en-US" l10n="U" oldref="179">
183<item type="input">=CUMIPMT_ADD(0.0075;360;125000;13;24;0)</item> returns -11135.23.</paragraph>
184<paragraph role="paragraph" id="par_id3150764" xml-lang="en-US" l10n="U" oldref="180">How much interest must you pay in the first month?</paragraph>
185<paragraph role="paragraph" id="par_id3146857" xml-lang="en-US" l10n="U" oldref="181">
186<item type="input">=CUMIPMT_ADD(0.0075;360;125000;1;1;0)</item> returns -937.50.</paragraph>
187</section>
188<section id="price">
189<bookmark xml-lang="en-US" branch="index" id="bm_id3150878"><bookmark_value>PRICE function</bookmark_value>
190<bookmark_value>prices; fixed interest securities</bookmark_value>
191<bookmark_value>sales values;fixed interest securities</bookmark_value>
192</bookmark><comment>mw added two entries</comment>
193<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_PRICE" id="bm_id3153279" localize="false"/>
194<paragraph role="heading" id="hd_id3150878" xml-lang="en-US" level="2" oldref="9">PRICE</paragraph>
195<paragraph role="paragraph" id="par_id3153210" xml-lang="en-US" l10n="U" oldref="10"><ahelp hid="HID_AAI_FUNC_PRICE">Calculates the market value of a fixed interest security with a par value of 100 currency units as a function of the forecast yield.</ahelp></paragraph>
196<paragraph role="heading" id="hd_id3154646" xml-lang="en-US" level="3" l10n="U" oldref="11">Syntax</paragraph>
197<paragraph role="code" id="par_id3152804" xml-lang="en-US" l10n="U" oldref="12">PRICE(Settlement; Maturity; Rate; Yield; Redemption; Frequency; Basis)</paragraph>
198<paragraph role="paragraph" id="par_id3156121" xml-lang="en-US" l10n="U" oldref="13">
199<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
200<paragraph role="paragraph" id="par_id3149983" xml-lang="en-US" l10n="U" oldref="14">
201<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
202<paragraph role="paragraph" id="par_id3153755" xml-lang="en-US" l10n="U" oldref="15">
203<emph>Rate</emph> is the annual nominal rate of interest (coupon interest rate)</paragraph>
204<paragraph role="paragraph" id="par_id3155999" xml-lang="en-US" l10n="U" oldref="16">
205<emph>Yield</emph> is the annual yield of the security.</paragraph>
206<paragraph role="paragraph" id="par_id3156114" xml-lang="en-US" l10n="U" oldref="17">
207<emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph>
208<paragraph role="paragraph" id="par_id3155846" xml-lang="en-US" l10n="U" oldref="18">
209<emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph>
210<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
211<paragraph role="heading" id="hd_id3153148" xml-lang="en-US" level="3" l10n="U" oldref="19">Example</paragraph>
212<paragraph role="paragraph" id="par_id3150260" xml-lang="en-US" l10n="CHG" oldref="20">A security is purchased on 1999-02-15; the maturity date is 2007-11-15. The nominal rate of interest is 5.75%. The yield is 6.5%. The redemption value is 100 currency units. Interest is paid half-yearly (frequency is 2). With calculation on basis 0, the price is as follows:</paragraph>
213<paragraph role="paragraph" id="par_id3147273" xml-lang="en-US" l10n="CHG" oldref="21">=PRICE("1999-02-15"; "2007-11-15"; 0.0575; 0.065; 100; 2; 0) returns 95.04287.</paragraph>
214</section>
215<section id="pricedisc">
216<bookmark xml-lang="en-US" branch="index" id="bm_id3151297"><bookmark_value>PRICEDISC function</bookmark_value>
217<bookmark_value>prices;non-interest-bearing securities</bookmark_value>
218<bookmark_value>sales values;non-interest-bearing securities</bookmark_value>
219</bookmark><comment>mw added two entries</comment>
220<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_PRICEDISC" id="bm_id3143236" localize="false"/>
221<paragraph role="heading" id="hd_id3151297" xml-lang="en-US" level="2" oldref="22">PRICEDISC</paragraph>
222<paragraph role="paragraph" id="par_id3155100" xml-lang="en-US" l10n="U" oldref="23"><ahelp hid="HID_AAI_FUNC_PRICEDISC">Calculates the price per 100 currency units of par value of a non-interest- bearing security.</ahelp></paragraph>
223<paragraph role="heading" id="hd_id3149294" xml-lang="en-US" level="3" l10n="U" oldref="24">Syntax</paragraph>
224<paragraph role="code" id="par_id3146084" xml-lang="en-US" l10n="U" oldref="25">PRICEDISC(Settlement; Maturity; Discount; Redemption; Basis)</paragraph>
225<paragraph role="paragraph" id="par_id3159179" xml-lang="en-US" l10n="U" oldref="26">
226<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
227<paragraph role="paragraph" id="par_id3154304" xml-lang="en-US" l10n="U" oldref="27">
228<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
229<paragraph role="paragraph" id="par_id3156014" xml-lang="en-US" l10n="U" oldref="28">
230<emph>Discount</emph> is the discount of a security as a percentage.</paragraph>
231<paragraph role="paragraph" id="par_id3147489" xml-lang="en-US" l10n="U" oldref="29">
232<emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph>
233<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
234<paragraph role="heading" id="hd_id3152794" xml-lang="en-US" level="3" l10n="U" oldref="30">Example</paragraph>
235<paragraph role="paragraph" id="par_id3149198" xml-lang="en-US" l10n="CHG" oldref="31">A security is purchased on 1999-02-15; the maturity date is 1999-03-01. Discount in per cent is 5.25%. The redemption value is 100. When calculating on basis 2 the price discount is as follows:</paragraph>
236<paragraph role="paragraph" id="par_id3151178" xml-lang="en-US" l10n="CHG" oldref="32">=PRICEDISC("1999-02-15"; "1999-03-01"; 0.0525; 100; 2) returns 99.79583.</paragraph>
237</section>
238<section id="pricemat">
239<bookmark xml-lang="en-US" branch="index" id="bm_id3154693"><bookmark_value>PRICEMAT function</bookmark_value>
240<bookmark_value>prices;interest-bearing securities</bookmark_value>
241</bookmark><comment>mw added one entry</comment>
242<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_PRICEMAT" id="bm_id3150118" localize="false"/>
243<paragraph role="heading" id="hd_id3154693" xml-lang="en-US" level="2" oldref="33">PRICEMAT</paragraph>
244<paragraph role="paragraph" id="par_id3153906" xml-lang="en-US" l10n="U" oldref="34"><ahelp hid="HID_AAI_FUNC_PRICEMAT">Calculates the price per 100 currency units of par value of a security, that pays interest on the maturity date.</ahelp></paragraph>
245<paragraph role="heading" id="hd_id3154933" xml-lang="en-US" level="3" l10n="U" oldref="35">Syntax</paragraph>
246<paragraph role="code" id="par_id3155393" xml-lang="en-US" l10n="U" oldref="36">PRICEMAT(Settlement; Maturity; Issue; Rate; Yield; Basis)</paragraph>
247<paragraph role="paragraph" id="par_id3153102" xml-lang="en-US" l10n="U" oldref="37">
248<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
249<paragraph role="paragraph" id="par_id3150530" xml-lang="en-US" l10n="U" oldref="38">
250<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
251<paragraph role="paragraph" id="par_id3149903" xml-lang="en-US" l10n="U" oldref="39">
252<emph>Issue</emph> is the date of issue of the security.</paragraph>
253<paragraph role="paragraph" id="par_id3148828" xml-lang="en-US" l10n="U" oldref="40">
254<emph>Rate</emph> is the interest rate of the security on the issue date.</paragraph>
255<paragraph role="paragraph" id="par_id3146993" xml-lang="en-US" l10n="U" oldref="41">
256<emph>Yield</emph> is the annual yield of the security.</paragraph>
257<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
258<paragraph role="heading" id="hd_id3150507" xml-lang="en-US" level="3" l10n="U" oldref="42">Example</paragraph>
259<paragraph role="paragraph" id="par_id3154289" xml-lang="en-US" l10n="U" oldref="43">Settlement date: February 15 1999, maturity date: April 13 1999, issue date: November 11 1998. Interest rate: 6.1 per cent, yield: 6.1 per cent, basis: 30/360 = 0.</paragraph>
260<paragraph role="paragraph" id="par_id3154905" xml-lang="en-US" l10n="U" oldref="44">The price is calculated as follows:</paragraph>
261<paragraph role="paragraph" id="par_id3158409" xml-lang="en-US" l10n="CHG" oldref="45">=PRICEMAT("1999-02-15";"1999-04-13";"1998-11-11"; 0.061; 0.061;0) returns 99.98449888.</paragraph>
262</section>
263<section id="duration">
264<bookmark xml-lang="en-US" branch="index" id="bm_id3148448"><bookmark_value>calculating; durations</bookmark_value>
265<bookmark_value>durations;calculating</bookmark_value>
266<bookmark_value>DURATION function</bookmark_value>
267</bookmark>
268<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LAUFZEIT" id="bm_id3154208" localize="false"/>
269<paragraph role="heading" id="hd_id3148448" xml-lang="en-US" level="2" l10n="U" oldref="280">DURATION</paragraph>
270<paragraph role="paragraph" id="par_id3153056" xml-lang="en-US" l10n="CHG" oldref="281"><ahelp hid="HID_FUNC_LAUFZEIT">Calculates the number of periods required by an investment to attain the desired value.</ahelp></paragraph>
271<paragraph role="heading" id="hd_id3145421" xml-lang="en-US" level="3" l10n="U" oldref="282">Syntax</paragraph>
272<paragraph role="code" id="par_id3148933" xml-lang="en-US" l10n="U" oldref="283">DURATION(Rate; PV; FV)</paragraph>
273<paragraph role="paragraph" id="par_id3148801" xml-lang="en-US" l10n="U" oldref="284">
274<emph>Rate</emph> is a constant. The interest rate is to be calculated for the entire duration (duration period). The interest rate per period is calculated by dividing the interest rate by the calculated duration. The internal rate for an annuity is to be entered as Rate/12.</paragraph>
275<paragraph role="paragraph" id="par_id3147239" xml-lang="en-US" l10n="U" oldref="285">
276<emph>PV</emph> is the present (current) value. The cash value is the deposit of cash or the current cash value of an allowance in kind. As a deposit value a positive value must be entered; the deposit must not be 0 or &lt;0.</paragraph>
277<paragraph role="paragraph" id="par_id3147515" xml-lang="en-US" l10n="U" oldref="286">
278<emph>FV</emph> is the expected value. The future value determines the desired (future) value of the deposit.</paragraph>
279<paragraph role="heading" id="hd_id3153579" xml-lang="en-US" level="3" l10n="U" oldref="287">Example</paragraph>
280<paragraph role="paragraph" id="par_id3148480" xml-lang="en-US" l10n="U" oldref="288">At an interest rate of 4.75%, a cash value of 25,000 currency units and a future value of 1,000,000 currency units, a duration of 79.49 payment periods is returned. The periodic payment is the resulting quotient from the future value and the duration, in this case 1,000,000/79.49=12,850.20.</paragraph>
281</section>
282<section id="sln">
283<bookmark xml-lang="en-US" branch="index" id="bm_id3148912"><bookmark_value>calculating;linear depreciations</bookmark_value>
284<bookmark_value>depreciations;linear</bookmark_value>
285<bookmark_value>linear depreciations</bookmark_value>
286<bookmark_value>straight-line depreciations</bookmark_value>
287<bookmark_value>SLN function</bookmark_value>
288</bookmark><comment>mw added one entry</comment>
289<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LIA" id="bm_id3154275" localize="false"/>
290<paragraph role="heading" id="hd_id3148912" xml-lang="en-US" level="2" l10n="U" oldref="290">SLN</paragraph>
291<paragraph role="paragraph" id="par_id3149154" xml-lang="en-US" l10n="U" oldref="291"><ahelp hid="HID_FUNC_LIA">Returns the straight-line depreciation of an asset for one period.</ahelp>The amount of the depreciation is constant during the depreciation period.</paragraph>
292<paragraph role="heading" id="hd_id3153240" xml-lang="en-US" level="3" l10n="U" oldref="292">Syntax</paragraph>
293<paragraph role="code" id="par_id3166456" xml-lang="en-US" l10n="U" oldref="293">SLN(Cost; Salvage; Life)</paragraph>
294<paragraph role="paragraph" id="par_id3146955" xml-lang="en-US" l10n="U" oldref="294">
295<emph>Cost</emph> is the initial cost of an asset.</paragraph>
296<paragraph role="paragraph" id="par_id3149796" xml-lang="en-US" l10n="U" oldref="295">
297<emph>Salvage</emph> is the value of an asset at the end of the depreciation.</paragraph>
298<paragraph role="paragraph" id="par_id3166444" xml-lang="en-US" l10n="U" oldref="296">
299<emph>Life</emph> is the depreciation period determining the number of periods in the depreciation of the asset.</paragraph>
300<paragraph role="heading" id="hd_id3155579" xml-lang="en-US" level="3" l10n="U" oldref="297">Example</paragraph>
301<paragraph role="paragraph" id="par_id3154098" xml-lang="en-US" l10n="U" oldref="298">Office equipment with an initial cost of 50,000 currency units is to be depreciated over 7 years. The value at the end of the depreciation is to be 3,500 currency units.</paragraph>
302<paragraph role="paragraph" id="par_id3153390" xml-lang="en-US" l10n="U" oldref="299">
303<item type="input">=SLN(50000;3,500;84)</item> = 553.57 currency units. The periodic monthly depreciation of the office equipment is 553.57 currency units.</paragraph>
304</section>
305<section id="mduration">
306<bookmark xml-lang="en-US" branch="index" id="bm_id3153739"><bookmark_value>MDURATION function</bookmark_value>
307<bookmark_value>Macauley duration</bookmark_value>
308</bookmark><comment>mw added one entry</comment>
309<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_MDURATION" id="bm_id3153750" localize="false"/>
310<paragraph role="heading" id="hd_id3153739" xml-lang="en-US" level="2" oldref="217">MDURATION</paragraph>
311<paragraph role="paragraph" id="par_id3149923" xml-lang="en-US" l10n="U" oldref="218"><ahelp hid="HID_AAI_FUNC_MDURATION">Calculates the modified Macauley duration of a fixed interest security in years.</ahelp></paragraph>
312<paragraph role="heading" id="hd_id3149964" xml-lang="en-US" level="3" l10n="U" oldref="219">Syntax</paragraph>
313<paragraph role="code" id="par_id3148987" xml-lang="en-US" l10n="U" oldref="220">MDURATION(Settlement; Maturity; Coupon; Yield; Frequency; Basis)</paragraph>
314<paragraph role="paragraph" id="par_id3148619" xml-lang="en-US" l10n="U" oldref="221">
315<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
316<paragraph role="paragraph" id="par_id3149805" xml-lang="en-US" l10n="U" oldref="222">
317<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
318<paragraph role="paragraph" id="par_id3154338" xml-lang="en-US" l10n="U" oldref="223">
319<emph>Coupon</emph> is the annual nominal rate of interest (coupon interest rate)</paragraph>
320<paragraph role="paragraph" id="par_id3148466" xml-lang="en-US" l10n="U" oldref="224">
321<emph>Yield</emph> is the annual yield of the security.</paragraph>
322<paragraph role="paragraph" id="par_id3149423" xml-lang="en-US" l10n="U" oldref="225">
323<emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph>
324<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
325<paragraph role="heading" id="hd_id3154602" xml-lang="en-US" level="3" l10n="U" oldref="226">Example</paragraph>
326<paragraph role="paragraph" id="par_id3148652" xml-lang="en-US" l10n="CHG" oldref="227">A security is purchased on 2001-01-01; the maturity date is 2006-01-01. The nominal rate of interest is 8%. The yield is 9.0%. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how long is the modified duration?</paragraph>
327<paragraph role="paragraph" id="par_id3145378" xml-lang="en-US" l10n="CHG" oldref="228">=MDURATION("2001-01-01"; "2006-01-01"; 0.08; 0.09; 2; 3) returns 4.02 years.</paragraph>
328</section>
329<section id="npv">
330<bookmark xml-lang="en-US" branch="index" id="bm_id3149242"><bookmark_value>calculating;net present values</bookmark_value>
331<bookmark_value>net present values</bookmark_value>
332<bookmark_value>NPV function</bookmark_value>
333</bookmark>
334<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NBW" id="bm_id3148417" localize="false"/>
335<paragraph role="heading" id="hd_id3149242" xml-lang="en-US" level="2" l10n="U" oldref="301">NPV</paragraph>
336<paragraph role="paragraph" id="par_id3145308" xml-lang="en-US" l10n="CHG" oldref="302"><ahelp hid="HID_FUNC_NBW">Returns the present value of an investment based on a series of periodic cash flows and a discount rate. To get the net present value, subtract the cost of the project (the initial cash flow at time zero) from the returned value.</ahelp></paragraph>
337<paragraph role="heading" id="hd_id3149937" xml-lang="en-US" level="3" l10n="U" oldref="303">Syntax</paragraph>
338<paragraph role="code" id="par_id3153321" xml-lang="en-US" l10n="U" oldref="304">NPV(Rate; Value1; Value2; ...)</paragraph>
339<paragraph role="paragraph" id="par_id3150630" xml-lang="en-US" l10n="U" oldref="305">
340<emph>Rate</emph> is the discount rate for a period.</paragraph>
341<paragraph role="paragraph" id="par_id3150427" xml-lang="en-US" l10n="U" oldref="306">
342<emph>Value1;...</emph> are up to 30 values, which represent deposits or withdrawals.</paragraph>
343<paragraph role="heading" id="hd_id3153538" xml-lang="en-US" level="3" l10n="U" oldref="307">Example</paragraph>
344<paragraph role="paragraph" id="par_id3154800" xml-lang="en-US" l10n="CHG" oldref="308">What is the net present value of periodic payments of 10, 20 and 30 currency units with a discount rate of 8.75%. At time zero the costs were payed as -40 currency units.</paragraph>
345<paragraph role="paragraph" id="par_id3143270" xml-lang="en-US" l10n="CHG" oldref="309">
346<item type="input">=NPV(8.75%;10;20;30)</item> = 49.43 currency units. The net present value is the returned value minus the initial costs of 40 currency units, therefore 9.43 currency units.</paragraph>
347</section>
348<section id="nominal">
349<bookmark xml-lang="en-US" branch="index" id="bm_id3149484"><bookmark_value>calculating;nominal interest rates</bookmark_value>
350<bookmark_value>nominal interest rates</bookmark_value>
351<bookmark_value>NOMINAL function</bookmark_value>
352</bookmark><comment>mw made "nominal interest rates;..." a one level entry</comment>
353<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NOMINAL" id="bm_id3145600" localize="false"/>
354<paragraph role="heading" id="hd_id3149484" xml-lang="en-US" level="2" l10n="U" oldref="311">NOMINAL</paragraph>
355<paragraph role="paragraph" id="par_id3149596" xml-lang="en-US" l10n="U" oldref="312"><ahelp hid="HID_FUNC_NOMINAL">Calculates the yearly nominal interest rate, given the effective rate and the number of compounding periods per year.</ahelp></paragraph>
356<paragraph role="heading" id="hd_id3151252" xml-lang="en-US" level="3" l10n="U" oldref="313">Syntax</paragraph>
357<paragraph role="code" id="par_id3152769" xml-lang="en-US" l10n="U" oldref="314">NOMINAL(EffectiveRate; NPerY)</paragraph>
358<paragraph role="paragraph" id="par_id3147521" xml-lang="en-US" l10n="U" oldref="315">
359<emph>EffectiveRate</emph> is the effective interest rate</paragraph>
360<paragraph role="paragraph" id="par_id3156334" xml-lang="en-US" l10n="U" oldref="316">
361<emph>NPerY</emph> is the number of periodic interest payments per year.</paragraph>
362<paragraph role="heading" id="hd_id3154473" xml-lang="en-US" level="3" l10n="U" oldref="317">Example</paragraph>
363<paragraph role="paragraph" id="par_id3147091" xml-lang="en-US" l10n="U" oldref="318">What is the nominal interest per year for an effective interest rate of 13.5% if twelve payments are made per year.</paragraph>
364<paragraph role="paragraph" id="par_id3154831" xml-lang="en-US" l10n="U" oldref="319">
365<item type="input">=NOMINAL(13.5%;12)</item> = 12.73%. The nominal interest rate per year is 12.73%.</paragraph>
366</section>
367<section id="nominal_add">
368<bookmark xml-lang="en-US" branch="index" id="bm_id3155123"><bookmark_value>NOMINAL_ADD function</bookmark_value>
369</bookmark>
370<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_NOMINAL" id="bm_id3158439" localize="false"/>
371<paragraph role="heading" id="hd_id3155123" xml-lang="en-US" level="2" oldref="229">NOMINAL_ADD</paragraph>
372<paragraph role="paragraph" id="par_id3148671" xml-lang="en-US" l10n="U" oldref="230"><ahelp hid="HID_AAI_FUNC_NOMINAL">Calculates the annual nominal rate of interest on the basis of the effective rate and the number of interest payments per annum.</ahelp></paragraph>
373<embed href="text/scalc/01/04060102.xhp#ADD_note"/>
374<paragraph role="heading" id="hd_id3155611" xml-lang="en-US" level="3" l10n="U" oldref="231">Syntax</paragraph>
375<paragraph role="code" id="par_id3156157" xml-lang="en-US" l10n="U" oldref="232">NOMINAL_ADD(EffectiveRate; NPerY)</paragraph>
376<paragraph role="paragraph" id="par_id3153777" xml-lang="en-US" l10n="U" oldref="233">
377<emph>EffectiveRate</emph> is the effective annual rate of interest.</paragraph>
378<paragraph role="paragraph" id="par_id3150409" xml-lang="en-US" l10n="U" oldref="234">
379<emph>NPerY</emph> the number of interest payments per year.</paragraph>
380<paragraph role="heading" id="hd_id3146789" xml-lang="en-US" level="3" l10n="U" oldref="235">Example</paragraph>
381<paragraph role="paragraph" id="par_id3145777" xml-lang="en-US" l10n="U" oldref="236">What is the nominal rate of interest for a 5.3543% effective rate of interest and quarterly payment.</paragraph>
382<paragraph role="paragraph" id="par_id3156146" xml-lang="en-US" l10n="U" oldref="237">
383<item type="input">=NOMINAL_ADD(5.3543%;4)</item> returns 0.0525 or 5.25%.</paragraph>
384</section>
385<section id="dollarfr">
386<bookmark xml-lang="en-US" branch="index" id="bm_id3159087"><bookmark_value>DOLLARFR function</bookmark_value>
387<bookmark_value>converting;decimal fractions, into mixed decimal fractions</bookmark_value>
388</bookmark><comment>mw added one entry</comment>
389<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DOLLARFR" id="bm_id3146907" localize="false"/>
390<paragraph role="heading" id="hd_id3159087" xml-lang="en-US" level="2" oldref="208">DOLLARFR</paragraph>
391<paragraph role="paragraph" id="par_id3150593" xml-lang="en-US" l10n="U" oldref="209"><ahelp hid="HID_AAI_FUNC_DOLLARFR">Converts a quotation that has been given as a decimal number into a mixed decimal fraction.</ahelp></paragraph>
392<paragraph role="heading" id="hd_id3151106" xml-lang="en-US" level="3" l10n="U" oldref="210">Syntax</paragraph>
393<paragraph role="code" id="par_id3152959" xml-lang="en-US" l10n="U" oldref="211">DOLLARFR(DecimalDollar; Fraction)</paragraph>
394<paragraph role="paragraph" id="par_id3149558" xml-lang="en-US" l10n="U" oldref="212">
395<emph>DecimalDollar</emph> is a decimal number.</paragraph>
396<paragraph role="paragraph" id="par_id3153672" xml-lang="en-US" l10n="U" oldref="213">
397<emph>Fraction</emph> is a whole number that is used as the denominator of the decimal fraction.</paragraph>
398<paragraph role="heading" id="hd_id3156274" xml-lang="en-US" level="3" l10n="U" oldref="214">Example</paragraph>
399<paragraph role="paragraph" id="par_id3153795" xml-lang="en-US" l10n="U" oldref="215">
400<item type="input">=DOLLARFR(1.125;16)</item> converts into sixteenths. The result is 1.02 for 1 plus 2/16.</paragraph>
401<paragraph role="paragraph" id="par_id3150995" xml-lang="en-US" l10n="U" oldref="216">
402<item type="input">=DOLLARFR(1.125;8)</item> converts into eighths. The result is 1.1 for 1 plus 1/8.</paragraph>
403</section>
404<section id="dollarde">
405<bookmark xml-lang="en-US" branch="index" id="bm_id3154671"><bookmark_value>fractions; converting</bookmark_value>
406<bookmark_value>converting;decimal fractions, into decimal numbers</bookmark_value>
407<bookmark_value>DOLLARDE function</bookmark_value>
408</bookmark><comment>mw added one entry</comment>
409<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DOLLARDE" id="bm_id3154569" localize="false"/>
410<paragraph role="heading" id="hd_id3154671" xml-lang="en-US" level="2" oldref="199">DOLLARDE</paragraph>
411<paragraph role="paragraph" id="par_id3154418" xml-lang="en-US" l10n="U" oldref="200"><ahelp hid="HID_AAI_FUNC_DOLLARDE">Converts a quotation that has been given as a decimal fraction into a decimal number.</ahelp></paragraph>
412<paragraph role="heading" id="hd_id3146124" xml-lang="en-US" level="3" l10n="U" oldref="201">Syntax</paragraph>
413<paragraph role="code" id="par_id3150348" xml-lang="en-US" l10n="U" oldref="202">DOLLARDE(FractionalDollar; Fraction)</paragraph>
414<paragraph role="paragraph" id="par_id3154111" xml-lang="en-US" l10n="U" oldref="203">
415<emph>FractionalDollar</emph> is a number given as a decimal fraction.</paragraph>
416<paragraph role="paragraph" id="par_id3153695" xml-lang="en-US" l10n="U" oldref="204">
417<emph>Fraction</emph> is a whole number that is used as the denominator of the decimal fraction.</paragraph>
418<paragraph role="heading" id="hd_id3153884" xml-lang="en-US" level="3" l10n="U" oldref="205">Example</paragraph>
419<paragraph role="paragraph" id="par_id3150941" xml-lang="en-US" l10n="U" oldref="206">
420<item type="input">=DOLLARDE(1.02;16)</item> stands for 1 and 2/16. This returns 1.125.</paragraph>
421<paragraph role="paragraph" id="par_id3150830" xml-lang="en-US" l10n="U" oldref="207">
422<item type="input">=DOLLARDE(1.1;8)</item> stands for 1 and 1/8. This returns 1.125.</paragraph>
423</section>
424<section id="mirr">
425<bookmark xml-lang="en-US" branch="index" id="bm_id3148974"><bookmark_value>calculating;modified internal rates of return</bookmark_value>
426<bookmark_value>modified internal rates of return</bookmark_value>
427<bookmark_value>MIRR function</bookmark_value>
428<bookmark_value>internal rates of return;modified</bookmark_value>
429</bookmark><comment>mw added "internal rates of return;..."</comment>
430<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QIKV" id="bm_id3150670" localize="false"/>
431<paragraph role="heading" id="hd_id3148974" xml-lang="en-US" level="2" l10n="U" oldref="321">MIRR</paragraph>
432<paragraph role="paragraph" id="par_id3155497" xml-lang="en-US" l10n="U" oldref="322"><ahelp hid="HID_FUNC_QIKV">Calculates the modified internal rate of return of a series of investments.</ahelp></paragraph>
433<paragraph role="heading" id="hd_id3154354" xml-lang="en-US" level="3" l10n="U" oldref="323">Syntax</paragraph>
434<paragraph role="code" id="par_id3148399" xml-lang="en-US" l10n="U" oldref="324">MIRR(Values; Investment; ReinvestRate)</paragraph>
435<paragraph role="paragraph" id="par_id3155896" xml-lang="en-US" l10n="U" oldref="325">
436<emph>Values</emph> corresponds to the array or the cell reference for cells whose content corresponds to the payments.</paragraph>
437<paragraph role="paragraph" id="par_id3149998" xml-lang="en-US" l10n="U" oldref="326">
438<emph>Investment</emph> is the rate of interest of the investments (the negative values of the array)</paragraph>
439<paragraph role="paragraph" id="par_id3159408" xml-lang="en-US" l10n="U" oldref="327">
440<emph>ReinvestRate</emph>:the rate of interest of the reinvestment (the positive values of the array)</paragraph>
441<paragraph role="heading" id="hd_id3154714" xml-lang="en-US" level="3" l10n="U" oldref="328">Example</paragraph>
442<paragraph role="paragraph" id="par_id3147352" xml-lang="en-US" l10n="U" oldref="329">Assuming a cell content of A1 = <item type="input">-5</item>, A2 = <item type="input">10</item>, A3 = <item type="input">15</item>, and A4 = <item type="input">8</item>, and an investment value of 0.5 and a reinvestment value of 0.1, the result is 94.16%.</paragraph>
443</section>
444<section id="yield">
445<bookmark xml-lang="en-US" branch="index" id="bm_id3149323"><bookmark_value>YIELD function</bookmark_value>
446<bookmark_value>rates of return;securities</bookmark_value>
447<bookmark_value>yields, see also rates of return</bookmark_value>
448</bookmark><comment>mw added two entries</comment>
449<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YIELD" id="bm_id3152460" localize="false"/>
450<paragraph role="heading" id="hd_id3149323" xml-lang="en-US" level="2" oldref="129">YIELD</paragraph>
451<paragraph role="paragraph" id="par_id3150643" xml-lang="en-US" l10n="U" oldref="130"><ahelp hid="HID_AAI_FUNC_YIELD">Calculates the yield of a security.</ahelp></paragraph>
452<paragraph role="heading" id="hd_id3149344" xml-lang="en-US" level="3" l10n="U" oldref="131">Syntax</paragraph>
453<paragraph role="code" id="par_id3149744" xml-lang="en-US" l10n="U" oldref="132">YIELD(Settlement; Maturity; Rate; Price; Redemption; Frequency; Basis)</paragraph>
454<paragraph role="paragraph" id="par_id3154526" xml-lang="en-US" l10n="U" oldref="133">
455<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
456<paragraph role="paragraph" id="par_id3153266" xml-lang="en-US" l10n="U" oldref="134">
457<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
458<paragraph role="paragraph" id="par_id3151284" xml-lang="en-US" l10n="U" oldref="135">
459<emph>Rate</emph> is the annual rate of interest.</paragraph>
460<paragraph role="paragraph" id="par_id3147314" xml-lang="en-US" l10n="U" oldref="136">
461<emph>Price</emph> is the price (purchase price) of the security per 100 currency units of par value.</paragraph>
462<paragraph role="paragraph" id="par_id3145156" xml-lang="en-US" l10n="U" oldref="137">
463<emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph>
464<paragraph role="paragraph" id="par_id3159218" xml-lang="en-US" l10n="U" oldref="138">
465<emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph>
466<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
467<paragraph role="heading" id="hd_id3147547" xml-lang="en-US" level="3" l10n="U" oldref="139">Example</paragraph>
468<paragraph role="paragraph" id="par_id3151214" xml-lang="en-US" l10n="CHG" oldref="140">A security is purchased on 1999-02-15. It matures on 2007-11-15. The rate of interest is 5.75%. The price is 95.04287 currency units per 100 units of par value, the redemption value is 100 units. Interest is paid half-yearly (frequency = 2) and the basis is 0. How high is the yield?</paragraph>
469<paragraph role="paragraph" id="par_id3154194" xml-lang="en-US" l10n="CHG" oldref="141">=YIELD("1999-02-15"; "2007-11-15"; 0.0575 ;95.04287; 100; 2; 0) returns 0.065 or 6.50 per cent.</paragraph>
470</section>
471<section id="yielddisc">
472<bookmark xml-lang="en-US" branch="index" id="bm_id3150100"><bookmark_value>YIELDDISC function</bookmark_value>
473<bookmark_value>rates of return;non-interest-bearing securities</bookmark_value>
474</bookmark><comment>mw added one entry</comment>
475<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YIELDDISC" id="bm_id3156206" localize="false"/>
476<paragraph role="heading" id="hd_id3150100" xml-lang="en-US" level="2" oldref="142">YIELDDISC</paragraph>
477<paragraph role="paragraph" id="par_id3150486" xml-lang="en-US" l10n="U" oldref="143"><ahelp hid="HID_AAI_FUNC_YIELDDISC">Calculates the annual yield of a non-interest-bearing security.</ahelp></paragraph>
478<paragraph role="heading" id="hd_id3149171" xml-lang="en-US" level="3" l10n="U" oldref="144">Syntax</paragraph>
479<paragraph role="code" id="par_id3159191" xml-lang="en-US" l10n="U" oldref="145">YIELDDISC(Settlement; Maturity; Price; Redemption; Basis)</paragraph>
480<paragraph role="paragraph" id="par_id3150237" xml-lang="en-US" l10n="U" oldref="146">
481<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
482<paragraph role="paragraph" id="par_id3146924" xml-lang="en-US" l10n="U" oldref="147">
483<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
484<paragraph role="paragraph" id="par_id3151201" xml-lang="en-US" l10n="U" oldref="148">
485<emph>Price</emph> is the price (purchase price) of the security per 100 currency units of par value.</paragraph>
486<paragraph role="paragraph" id="par_id3156049" xml-lang="en-US" l10n="U" oldref="149">
487<emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph>
488<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
489<paragraph role="heading" id="hd_id3154139" xml-lang="en-US" level="3" l10n="U" oldref="150">Example</paragraph>
490<paragraph role="paragraph" id="par_id3163815" xml-lang="en-US" l10n="CHG" oldref="151">A non-interest-bearing security is purchased on 1999-02-15. It matures on 1999-03-01. The price is 99.795 currency units per 100 units of par value, the redemption value is 100 units. The basis is 2. How high is the yield?</paragraph>
491<paragraph role="paragraph" id="par_id3155187" xml-lang="en-US" l10n="CHG" oldref="152">=YIELDDISC("1999-02-15"; "1999-03-01"; 99.795; 100; 2) returns 0.052823 or 5.2823 per cent.</paragraph>
492</section>
493<section id="yieldmat">
494<bookmark xml-lang="en-US" branch="index" id="bm_id3155140"><bookmark_value>YIELDMAT function</bookmark_value>
495<bookmark_value>rates of return;securities with interest paid on maturity</bookmark_value>
496</bookmark><comment>mw added one entry</comment>
497<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YIELDMAT" id="bm_id3156029" localize="false"/>
498<paragraph role="heading" id="hd_id3155140" xml-lang="en-US" level="2" oldref="153">YIELDMAT</paragraph>
499<paragraph role="paragraph" id="par_id3151332" xml-lang="en-US" l10n="U" oldref="154"><ahelp hid="HID_AAI_FUNC_YIELDMAT">Calculates the annual yield of a security, the interest of which is paid on the date of maturity.</ahelp></paragraph>
500<paragraph role="heading" id="hd_id3159100" xml-lang="en-US" level="3" l10n="U" oldref="155">Syntax</paragraph>
501<paragraph role="code" id="par_id3159113" xml-lang="en-US" l10n="U" oldref="156">YIELDMAT(Settlement; Maturity; Issue; Rate; Price; Basis)</paragraph>
502<paragraph role="paragraph" id="par_id3149309" xml-lang="en-US" l10n="U" oldref="157">
503<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
504<paragraph role="paragraph" id="par_id3151381" xml-lang="en-US" l10n="U" oldref="158">
505<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
506<paragraph role="paragraph" id="par_id3153302" xml-lang="en-US" l10n="U" oldref="159">
507<emph>Issue</emph> is the date of issue of the security.</paragraph>
508<paragraph role="paragraph" id="par_id3147140" xml-lang="en-US" l10n="U" oldref="160">
509<emph>Rate</emph> is the interest rate of the security on the issue date.</paragraph>
510<paragraph role="paragraph" id="par_id3151067" xml-lang="en-US" l10n="U" oldref="161">
511<emph>Price</emph> is the price (purchase price) of the security per 100 currency units of par value.</paragraph>
512<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
513<paragraph role="heading" id="hd_id3155342" xml-lang="en-US" level="3" l10n="U" oldref="162">Example</paragraph>
514<paragraph role="paragraph" id="par_id3163717" xml-lang="en-US" l10n="CHG" oldref="163">A security is purchased on 1999-03-15. It matures on 1999-11-03. The issue date was 1998-11-08. The rate of interest is 6.25%, the price is 100.0123 units. The basis is 0. How high is the yield?</paragraph>
515<paragraph role="paragraph" id="par_id3155311" xml-lang="en-US" l10n="CHG" oldref="164">=YIELDMAT("1999-03-15"; "1999-11-03"; "1998-11-08"; 0.0625; 100.0123; 0) returns 0.060954 or 6.0954 per cent.</paragraph>
516</section>
517<section id="pmt">
518<bookmark xml-lang="en-US" branch="index" id="bm_id3149577"><bookmark_value>calculating;annuities</bookmark_value>
519<bookmark_value>annuities</bookmark_value>
520<bookmark_value>PMT function</bookmark_value>
521</bookmark>
522<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RMZ" id="bm_id3148895" localize="false"/>
523<paragraph role="heading" id="hd_id3149577" xml-lang="en-US" level="2" l10n="U" oldref="330">PMT</paragraph>
524<paragraph role="paragraph" id="par_id3148563" xml-lang="en-US" l10n="U" oldref="331"><ahelp hid="HID_FUNC_RMZ">Returns the periodic payment for an annuity with constant interest rates.</ahelp></paragraph>
525<paragraph role="heading" id="hd_id3145257" xml-lang="en-US" level="3" l10n="U" oldref="332">Syntax</paragraph>
526<paragraph role="code" id="par_id3147278" xml-lang="en-US" l10n="U" oldref="333">PMT(Rate; NPer; PV; FV; Type)</paragraph>
527<paragraph role="paragraph" id="par_id3147291" xml-lang="en-US" l10n="U" oldref="334">
528<emph>Rate</emph> is the periodic interest rate.</paragraph>
529<paragraph role="paragraph" id="par_id3148641" xml-lang="en-US" l10n="U" oldref="335">
530<emph>NPer</emph> is the number of periods in which annuity is paid.</paragraph>
531<paragraph role="paragraph" id="par_id3156360" xml-lang="en-US" l10n="U" oldref="336">
532<emph>PV</emph> is the present value (cash value) in a sequence of payments.</paragraph>
533<paragraph role="paragraph" id="par_id3154920" xml-lang="en-US" l10n="U" oldref="337">
534<emph>FV</emph> (optional) is the desired value (future value) to be reached at the end of the periodic payments.</paragraph>
535<paragraph role="paragraph" id="par_id3156434" xml-lang="en-US" l10n="U" oldref="338">
536<emph>Type</emph> (optional) is the due date for the periodic payments. Type=1 is payment at the beginning and Type=0 is payment at the end of each period.</paragraph>
537<paragraph role="paragraph" id="par_idN11645" xml-lang="en-US" l10n="NEW">
538<embedvar href="text/scalc/00/00000004.xhp#optional"/>
539</paragraph>
540<paragraph role="heading" id="hd_id3152358" xml-lang="en-US" level="3" l10n="U" oldref="339">Example</paragraph>
541<paragraph role="paragraph" id="par_id3154222" xml-lang="en-US" l10n="U" oldref="340">What are the periodic payments at a yearly interest rate of 1.99% if the payment time is 3 years and the cash value is 25,000 currency units. There are 36 months as 36 payment periods, and the interest rate per payment period is 1.99%/12.</paragraph>
542<paragraph role="paragraph" id="par_id3155943" xml-lang="en-US" l10n="U" oldref="341">
543<item type="input">=PMT(1.99%/12;36;25000)</item> = -715.96 currency units. The periodic monthly payment is therefore 715.96 currency units.</paragraph>
544</section>
545<section id="tbilleq">
546<bookmark xml-lang="en-US" branch="index" id="bm_id3155799"><bookmark_value>TBILLEQ function</bookmark_value>
547<bookmark_value>treasury bills;annual return</bookmark_value>
548<bookmark_value>annual return on treasury bills</bookmark_value>
549</bookmark><comment>mw changed "treasury bills;..." and aded one entry</comment>
550<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_TBILLEQ" id="bm_id3147380" localize="false"/>
551<paragraph role="heading" id="hd_id3155799" xml-lang="en-US" level="2" oldref="58">TBILLEQ</paragraph>
552<paragraph role="paragraph" id="par_id3154403" xml-lang="en-US" l10n="U" oldref="59"><ahelp hid="HID_AAI_FUNC_TBILLEQ">Calculates the annual return on a treasury bill ().</ahelp> A treasury bill is purchased on the settlement date and sold at the full par value on the maturity date, that must fall within the same year. A discount is deducted from the purchase price.</paragraph>
553<paragraph role="heading" id="hd_id3155080" xml-lang="en-US" level="3" l10n="U" oldref="60">Syntax</paragraph>
554<paragraph role="code" id="par_id3150224" xml-lang="en-US" l10n="U" oldref="61">TBILLEQ(Settlement; Maturity; Discount)</paragraph>
555<paragraph role="paragraph" id="par_id3156190" xml-lang="en-US" l10n="U" oldref="62">
556<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
557<paragraph role="paragraph" id="par_id3153827" xml-lang="en-US" l10n="U" oldref="63">
558<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
559<paragraph role="paragraph" id="par_id3150310" xml-lang="en-US" l10n="U" oldref="64">
560<emph>Discount</emph> is the percentage discount on acquisition of the security.</paragraph>
561<paragraph role="heading" id="hd_id3150324" xml-lang="en-US" level="3" l10n="U" oldref="65">Example</paragraph>
562<paragraph role="paragraph" id="par_id3153173" xml-lang="en-US" l10n="U" oldref="66">Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9.14 per cent.</paragraph>
563<paragraph role="paragraph" id="par_id3153520" xml-lang="en-US" l10n="U" oldref="67">The return on the treasury bill corresponding to a security is worked out as follows:</paragraph>
564<paragraph role="paragraph" id="par_id3154382" xml-lang="en-US" l10n="CHG" oldref="68">=TBILLEQ("1999-03-31";"1999-06-01"; 0.0914) returns 0.094151 or 9.4151 per cent.</paragraph>
565</section>
566<section id="tbillprice">
567<bookmark xml-lang="en-US" branch="index" id="bm_id3151032"><bookmark_value>TBILLPRICE function</bookmark_value>
568<bookmark_value>treasury bills;prices</bookmark_value>
569<bookmark_value>prices;treasury bills</bookmark_value>
570</bookmark><comment>mw added two entries</comment>
571<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_TBILLPRICE" id="bm_id3150576" localize="false"/>
572<paragraph role="heading" id="hd_id3151032" xml-lang="en-US" level="2" oldref="69">TBILLPRICE</paragraph>
573<paragraph role="paragraph" id="par_id3157887" xml-lang="en-US" l10n="U" oldref="70"><ahelp hid="HID_AAI_FUNC_TBILLPRICE">Calculates the price of a treasury bill per 100 currency units.</ahelp></paragraph>
574<paragraph role="heading" id="hd_id3156374" xml-lang="en-US" level="3" l10n="U" oldref="71">Syntax</paragraph>
575<paragraph role="code" id="par_id3150284" xml-lang="en-US" l10n="U" oldref="72">TBILLPRICE(Settlement; Maturity; Discount)</paragraph>
576<paragraph role="paragraph" id="par_id3154059" xml-lang="en-US" l10n="U" oldref="73">
577<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
578<paragraph role="paragraph" id="par_id3154073" xml-lang="en-US" l10n="U" oldref="74">
579<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
580<paragraph role="paragraph" id="par_id3145765" xml-lang="en-US" l10n="U" oldref="75">
581<emph>Discount</emph> is the percentage discount upon acquisition of the security.</paragraph>
582<paragraph role="heading" id="hd_id3153373" xml-lang="en-US" level="3" l10n="U" oldref="76">Example</paragraph>
583<paragraph role="paragraph" id="par_id3155542" xml-lang="en-US" l10n="U" oldref="77">Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9 per cent.</paragraph>
584<paragraph role="paragraph" id="par_id3154578" xml-lang="en-US" l10n="U" oldref="78">The price of the treasury bill is worked out as follows:</paragraph>
585<paragraph role="paragraph" id="par_id3154592" xml-lang="en-US" l10n="CHG" oldref="79">=TBILLPRICE("1999-03-31";"1999-06-01"; 0.09) returns 98.45.</paragraph>
586</section>
587<section id="tbillyield">
588<bookmark xml-lang="en-US" branch="index" id="bm_id3152912"><bookmark_value>TBILLYIELD function</bookmark_value>
589<bookmark_value>treasury bills;rates of return</bookmark_value>
590<bookmark_value>rates of return of treasury bills</bookmark_value>
591</bookmark><comment>mw added two entries</comment>
592<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_TBILLYIELD" id="bm_id3151346" localize="false"/>
593<paragraph role="heading" id="hd_id3152912" xml-lang="en-US" level="2" oldref="80">TBILLYIELD</paragraph>
594<paragraph role="paragraph" id="par_id3145560" xml-lang="en-US" l10n="U" oldref="81"><ahelp hid="HID_AAI_FUNC_TBILLYIELD">Calculates the yield of a treasury bill.</ahelp></paragraph>
595<paragraph role="heading" id="hd_id3145578" xml-lang="en-US" level="3" l10n="U" oldref="82">Syntax</paragraph>
596<paragraph role="code" id="par_id3156077" xml-lang="en-US" l10n="U" oldref="83">TBILLYIELD(Settlement; Maturity; Price)</paragraph>
597<paragraph role="paragraph" id="par_id3156091" xml-lang="en-US" l10n="U" oldref="84">
598<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
599<paragraph role="paragraph" id="par_id3157856" xml-lang="en-US" l10n="U" oldref="85">
600<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
601<paragraph role="paragraph" id="par_id3149627" xml-lang="en-US" l10n="U" oldref="86">
602<emph>Price</emph> is the price (purchase price) of the treasury bill per 100 currency units of par value.</paragraph>
603<paragraph role="heading" id="hd_id3149642" xml-lang="en-US" level="3" l10n="U" oldref="87">Example</paragraph>
604<paragraph role="paragraph" id="par_id3145178" xml-lang="en-US" l10n="U" oldref="88">Settlement date: March 31 1999, maturity date: June 1 1999, price: 98.45 currency units.</paragraph>
605<paragraph role="paragraph" id="par_id3145193" xml-lang="en-US" l10n="U" oldref="89">The yield of the treasury bill is worked out as follows:</paragraph>
606<paragraph role="paragraph" id="par_id3148528" xml-lang="en-US" l10n="CHG" oldref="90">=TBILLYIELD("1999-03-31";"1999-06-01"; 98.45) returns 0.091417 or 9.1417 per cent.</paragraph>
607</section>
608</sort>
609<paragraph role="paragraph" id="par_id3148546" xml-lang="en-US" l10n="U" oldref="345"><link href="text/scalc/01/04060103.xhp" name="Back to Financial Functions Part One">Back to Financial Functions Part One</link></paragraph>
610<paragraph role="paragraph" id="par_id3146762" xml-lang="en-US" l10n="U" oldref="346"><link href="text/scalc/01/04060118.xhp" name="Forward to Financial Functions Part Three">Forward to Financial Functions Part Three</link></paragraph>
611<embed href="text/scalc/01/04060100.xhp#drking"/>
612</body>
613</helpdocument>
614