summaryrefslogtreecommitdiffstats
path: root/helpcontent2/source/text/scalc/01/04060119.xhp
blob: ccf3e35ad7010ecc8a034e9a46fa2898f7420629 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">

<!--
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you under the Apache
 *   License, Version 2.0 (the "License"); you may not use this file
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 -->


<meta>
<topic id="textscalc0104060119xml" indexer="include">
<title id="tit" xml-lang="en-US">Financial Functions Part Two</title>
<filename>/text/scalc/01/04060119.xhp</filename>
</topic>
</meta>
<body>
<h1 id="hd_id3149052">Financial Functions Part Two</h1>
<section id="howtoget">
<embed href="text/scalc/00/00000404.xhp#eikafi"/>
</section>
<paragraph role="paragraph" id="par_id3148742" xml-lang="en-US"><link href="text/scalc/01/04060103.xhp" name="Back to Financial Functions Part One">Back to Financial Functions Part One</link></paragraph>
<paragraph role="paragraph" id="par_id3151341" xml-lang="en-US"><link href="text/scalc/01/04060118.xhp" name="Forward to Financial Functions Part Three">Forward to Financial Functions Part Three</link></paragraph>
<sort order="asc" descendant="h2">
<section id="ppmt">
<bookmark xml-lang="en-US" branch="index" id="bm_id3150026"><bookmark_value>PPMT function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KAPZ" id="bm_id3145827" localize="false"/>
<h2 id="hd_id3150026">PPMT</h2>
<paragraph role="paragraph" id="par_id3146942" xml-lang="en-US"><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>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3146878" xml-lang="en-US">PPMT(Rate; Period; NPer; PV [ ; FV [ ; Type ] ])</paragraph>
<paragraph role="paragraph" id="par_id3151228" xml-lang="en-US">
<emph>Rate</emph> is the periodic interest rate.</paragraph>
<paragraph role="paragraph" id="par_id3148887" xml-lang="en-US">
<emph>Period</emph> is the amortizement period. P = 1 for the first and P = NPer for the last period.</paragraph>
<paragraph role="paragraph" id="par_id3148436" xml-lang="en-US">
<emph>NPer</emph> is the total number of periods during which annuity is paid.</paragraph>
<paragraph role="paragraph" id="par_id3153035" xml-lang="en-US">
<emph>PV</emph> is the present value in the sequence of payments.</paragraph>
<paragraph role="paragraph" id="par_id3147474" xml-lang="en-US">
<emph>FV</emph> (optional) is the desired (future) value.</paragraph>
<paragraph role="paragraph" id="par_id3144744" xml-lang="en-US">
<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>
<paragraph role="paragraph" id="par_idN1067C" xml-lang="en-US" localize="false">
	<embedvar href="text/scalc/00/00000004.xhp#optional"/>
</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3154811" xml-lang="en-US">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>
<paragraph role="paragraph" id="par_id3149246" xml-lang="en-US">
<item type="input">=PPMT(8.75%/12;1;36;5000;8000;1)</item> = -350.99 currency units.</paragraph>
</section>
<section id="cumprinc">
<bookmark xml-lang="en-US" branch="index" id="bm_id3146139"><bookmark_value>calculating; total amortizement rates</bookmark_value>
<bookmark_value>total amortizement rates</bookmark_value>
<bookmark_value>amortization installment</bookmark_value>
<bookmark_value>repayment installment</bookmark_value>
<bookmark_value>CUMPRINC function</bookmark_value>
</bookmark><comment>mw added two entries</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KUMKAPITAL" id="bm_id3148754" localize="false"/>
<h2 id="hd_id3146139">CUMPRINC</h2>
<paragraph role="paragraph" id="par_id3150140" xml-lang="en-US"><ahelp hid="HID_FUNC_KUMKAPITAL">Returns the cumulative interest paid for an investment period with a constant interest rate.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3148733" xml-lang="en-US">CUMPRINC(Rate; NPer; PV; S; E; Type)</paragraph>
<paragraph role="paragraph" id="par_id3150864" xml-lang="en-US">
<emph>Rate</emph> is the periodic interest rate.</paragraph>
<paragraph role="paragraph" id="par_id3166052" xml-lang="en-US">
<emph>NPer</emph> is the payment period with the total number of periods. NPER can also be a non-integer value.</paragraph>
<paragraph role="paragraph" id="par_id3150007" xml-lang="en-US">
<emph>PV</emph> is the current value in the sequence of payments.</paragraph>
<paragraph role="paragraph" id="par_id3153112" xml-lang="en-US">
<emph>S</emph> is the first period.</paragraph>
<paragraph role="paragraph" id="par_id3146847" xml-lang="en-US">
<emph>E</emph> is the last period.</paragraph>
<paragraph role="paragraph" id="par_id3145167" xml-lang="en-US">
<emph>Type</emph> is the due date of the payment at the beginning or end of each period.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3153570" xml-lang="en-US">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>
<paragraph role="paragraph" id="par_id3149884" xml-lang="en-US">
<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>
</section>
<section id="cumprinc_add">
<bookmark xml-lang="en-US" branch="index" id="bm_id3150019"><bookmark_value>CUMPRINC_ADD function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_CUMPRINC" id="bm_id3154330" localize="false"/>
<h2 id="hd_id3150019">CUMPRINC_ADD</h2>
<paragraph role="paragraph" id="par_id3145246" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_CUMPRINC"> Calculates the cumulative redemption of a loan in a period.</ahelp></paragraph>
<embed href="text/scalc/01/04060102.xhp#ADD_note"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3157970" xml-lang="en-US">CUMPRINC_ADD(Rate; NPer; PV; StartPeriod; EndPeriod; Type)</paragraph>
<paragraph role="paragraph" id="par_id3145302" xml-lang="en-US">
<emph>Rate</emph> is the interest rate for each period.</paragraph>
<paragraph role="paragraph" id="par_id3151017" xml-lang="en-US">
<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>
<paragraph role="paragraph" id="par_id3155620" xml-lang="en-US">
<emph>PV</emph> is the current value.</paragraph>
<paragraph role="paragraph" id="par_id3145352" xml-lang="en-US">
<emph>StartPeriod</emph> is the first payment period for the calculation.</paragraph>
<paragraph role="paragraph" id="par_id3157986" xml-lang="en-US">
<emph>EndPeriod</emph> is the last payment period for the calculation.</paragraph>
<paragraph role="paragraph" id="par_id3150570" xml-lang="en-US">
<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>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3148774" xml-lang="en-US">The following mortgage loan is taken out on a house:</paragraph>
<paragraph role="paragraph" id="par_id3150661" xml-lang="en-US">Rate: 9.00 per cent per annum (9% / 12 = 0.0075), Duration: 30 years (payment periods = 30 * 12 = 360), NPV: 125000 currency units.</paragraph>
<paragraph role="paragraph" id="par_id3155512" xml-lang="en-US">How much will you repay in the second year of the mortgage (thus from periods 13 to 24)?</paragraph>
<paragraph role="paragraph" id="par_id3149394" xml-lang="en-US">
<item type="input">=CUMPRINC_ADD(0.0075;360;125000;13;24;0)</item> returns -934.1071</paragraph>
<paragraph role="paragraph" id="par_id3149026" xml-lang="en-US">In the first month you will be repaying the following amount:</paragraph>
<paragraph role="paragraph" id="par_id3154636" xml-lang="en-US">
<item type="input">=CUMPRINC_ADD(0.0075;360;125000;1;1;0)</item> returns -68.27827</paragraph>
</section>
<section id="cumipmt">
<bookmark xml-lang="en-US" branch="index" id="bm_id3155370"><bookmark_value>calculating; accumulated interests</bookmark_value>
<bookmark_value>accumulated interests</bookmark_value>
<bookmark_value>CUMIPMT function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KUMZINSZ" id="bm_id3148593" localize="false"/>
<h2 id="hd_id3155370">CUMIPMT</h2>
<paragraph role="paragraph" id="par_id3158411" xml-lang="en-US"><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>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3147536" xml-lang="en-US">CUMIPMT(Rate; NPer; PV; S; E; Type)</paragraph>
<paragraph role="paragraph" id="par_id3150475" xml-lang="en-US">
<emph>Rate</emph> is the periodic interest rate.</paragraph>
<paragraph role="paragraph" id="par_id3153921" xml-lang="en-US">
<emph>NPer</emph> is the payment period with the total number of periods. NPER can also be a non-integer value.</paragraph>
<paragraph role="paragraph" id="par_id3153186" xml-lang="en-US">
<emph>PV</emph> is the current value in the sequence of payments.</paragraph>
<paragraph role="paragraph" id="par_id3156259" xml-lang="en-US">
<emph>S</emph> is the first period.</paragraph>
<paragraph role="paragraph" id="par_id3155990" xml-lang="en-US">
<emph>E</emph> is the last period.</paragraph>
<paragraph role="paragraph" id="par_id3149777" xml-lang="en-US">
<emph>Type</emph> is the due date of the payment at the beginning or end of each period.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3147478" xml-lang="en-US">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>
<paragraph role="paragraph" id="par_id3149819" xml-lang="en-US">
<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>
</section>
<section id="cumipmt_add">
<bookmark xml-lang="en-US" branch="index" id="bm_id3083280"><bookmark_value>CUMIPMT_ADD function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_CUMIPMT" id="bm_id3154312" localize="false"/>
<h2 id="hd_id3083280">CUMIPMT_ADD</h2>
<paragraph role="paragraph" id="par_id3152482" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_CUMIPMT">Calculates the accumulated interest for a period.</ahelp></paragraph>
<embed href="text/scalc/01/04060102.xhp#ADD_note"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3145087" xml-lang="en-US">CUMIPMT_ADD(Rate; NPer; PV; StartPeriod; EndPeriod; Type)</paragraph>
<paragraph role="paragraph" id="par_id3149277" xml-lang="en-US">
<emph>Rate</emph> is the interest rate for each period.</paragraph>
<paragraph role="paragraph" id="par_id3149270" xml-lang="en-US">
<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>
<paragraph role="paragraph" id="par_id3152967" xml-lang="en-US">
<emph>PV</emph> is the current value.</paragraph>
<paragraph role="paragraph" id="par_id3156308" xml-lang="en-US">
<emph>StartPeriod</emph> is the first payment period for the calculation.</paragraph>
<paragraph role="paragraph" id="par_id3149453" xml-lang="en-US">
<emph>EndPeriod</emph> is the last payment period for the calculation.</paragraph>
<paragraph role="paragraph" id="par_id3150962" xml-lang="en-US">
<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>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3156324" xml-lang="en-US">The following mortgage loan is taken out on a house:</paragraph>
<paragraph role="paragraph" id="par_id3147566" xml-lang="en-US">Rate: 9.00 per cent per annum (9% / 12 = 0.0075), Duration: 30 years (NPER = 30 * 12 = 360), Pv: 125000 currency units.</paragraph>
<paragraph role="paragraph" id="par_id3151272" xml-lang="en-US">How much interest must you pay in the second year of the mortgage (thus from periods 13 to 24)?</paragraph>
<paragraph role="paragraph" id="par_id3156130" xml-lang="en-US">
<item type="input">=CUMIPMT_ADD(0.0075;360;125000;13;24;0)</item> returns -11135.23.</paragraph>
<paragraph role="paragraph" id="par_id3150764" xml-lang="en-US">How much interest must you pay in the first month?</paragraph>
<paragraph role="paragraph" id="par_id3146857" xml-lang="en-US">
<item type="input">=CUMIPMT_ADD(0.0075;360;125000;1;1;0)</item> returns -937.50.</paragraph>
</section>
<section id="price">
<bookmark xml-lang="en-US" branch="index" id="bm_id3150878"><bookmark_value>PRICE function</bookmark_value>
<bookmark_value>prices; fixed interest securities</bookmark_value>
<bookmark_value>sales values;fixed interest securities</bookmark_value>
</bookmark><comment>mw added two entries</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_PRICE" id="bm_id3153279" localize="false"/>
<h2 id="hd_id3150878">PRICE</h2>
<paragraph role="paragraph" id="par_id3153210" xml-lang="en-US"><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>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3152804" xml-lang="en-US">PRICE(Settlement; Maturity; Rate; Yield; Redemption; Frequency [; Basis])</paragraph>
<paragraph role="paragraph" id="par_id3156121" xml-lang="en-US">
<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
<paragraph role="paragraph" id="par_id3149983" xml-lang="en-US">
<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
<paragraph role="paragraph" id="par_id3153755" xml-lang="en-US">
<emph>Rate</emph> is the annual nominal rate of interest (coupon interest rate)</paragraph>
<paragraph role="paragraph" id="par_id3155999" xml-lang="en-US">
<emph>Yield</emph> is the annual yield of the security.</paragraph>
<paragraph role="paragraph" id="par_id3156114" xml-lang="en-US">
<emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph>
<paragraph role="paragraph" id="par_id3155846" xml-lang="en-US">
<emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph>
<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3150260" xml-lang="en-US">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>
<paragraph role="paragraph" id="par_id3147273" xml-lang="en-US"><input>=PRICE("1999-02-15"; "2007-11-15"; 0.0575; 0.065; 100; 2; 0)</input>  returns 95.04287.</paragraph>
</section>
<section id="pricedisc">
<bookmark xml-lang="en-US" branch="index" id="bm_id3151297"><bookmark_value>PRICEDISC function</bookmark_value>
<bookmark_value>prices;non-interest-bearing securities</bookmark_value>
<bookmark_value>sales values;non-interest-bearing securities</bookmark_value>
</bookmark><comment>mw added two entries</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_PRICEDISC" id="bm_id3143236" localize="false"/>
<h2 id="hd_id3151297">PRICEDISC</h2>
<paragraph role="paragraph" id="par_id3155100" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_PRICEDISC">Calculates the price per 100 currency units of par value of a non-interest- bearing security.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3146084" xml-lang="en-US">PRICEDISC(Settlement; Maturity; Discount; Redemption [; Basis])</paragraph>
<paragraph role="paragraph" id="par_id3159179" xml-lang="en-US">
<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
<paragraph role="paragraph" id="par_id3154304" xml-lang="en-US">
<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
<paragraph role="paragraph" id="par_id3156014" xml-lang="en-US">
<emph>Discount</emph> is the discount of a security as a percentage.</paragraph>
<paragraph role="paragraph" id="par_id3147489" xml-lang="en-US">
<emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph>
<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3149198" xml-lang="en-US">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>
<paragraph role="paragraph" id="par_id3151178" xml-lang="en-US"><input>=PRICEDISC("1999-02-15"; "1999-03-01"; 0.0525; 100; 2)</input>  returns 99.79583.</paragraph>
</section>
<section id="pricemat">
<bookmark xml-lang="en-US" branch="index" id="bm_id3154693"><bookmark_value>PRICEMAT function</bookmark_value>
<bookmark_value>prices;interest-bearing securities</bookmark_value>
</bookmark><comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_PRICEMAT" id="bm_id3150118" localize="false"/>
<h2 id="hd_id3154693">PRICEMAT</h2>
<paragraph role="paragraph" id="par_id3153906" xml-lang="en-US"><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>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3155393" xml-lang="en-US">PRICEMAT(Settlement; Maturity; Issue; Rate; Yield [; Basis])</paragraph>
<paragraph role="paragraph" id="par_id3153102" xml-lang="en-US">
<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
<paragraph role="paragraph" id="par_id3150530" xml-lang="en-US">
<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
<paragraph role="paragraph" id="par_id3149903" xml-lang="en-US">
<emph>Issue</emph> is the date of issue of the security.</paragraph>
<paragraph role="paragraph" id="par_id3148828" xml-lang="en-US">
<emph>Rate</emph> is the interest rate of the security on the issue date.</paragraph>
<paragraph role="paragraph" id="par_id3146993" xml-lang="en-US">
<emph>Yield</emph> is the annual yield of the security.</paragraph>
<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3154289" xml-lang="en-US">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>
<paragraph role="paragraph" id="par_id3154905" xml-lang="en-US">The price is calculated as follows:</paragraph>
<paragraph role="paragraph" id="par_id3158409" xml-lang="en-US"><input>=PRICEMAT("1999-02-15";"1999-04-13";"1998-11-11"; 0.061; 0.061;0)</input>  returns 99.98449888.</paragraph>
</section>
<section id="pduration">
<bookmark xml-lang="en-US" branch="index" id="bm_id3148448"><bookmark_value>calculating; durations</bookmark_value>
<bookmark_value>durations;calculating</bookmark_value>
<bookmark_value>PDURATION function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LAUFZEIT" id="bm_id3154208" localize="false"/>
<h2 id="hd_id3148448">PDURATION</h2>
<paragraph role="paragraph" id="par_id3153056" xml-lang="en-US"><ahelp hid="HID_FUNC_LAUFZEIT">Calculates the number of periods required by an investment to attain the desired value.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3148933" xml-lang="en-US">PDURATION(Rate; PV; FV)</paragraph>
<paragraph role="paragraph" id="par_id3148801" xml-lang="en-US">
<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>
<paragraph role="paragraph" id="par_id3147239" xml-lang="en-US">
<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>
<paragraph role="paragraph" id="par_id3147515" xml-lang="en-US">
<emph>FV</emph> is the expected value. The future value determines the desired (future) value of the deposit.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3148480" xml-lang="en-US">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>
</section>
<section id="sln">
<bookmark xml-lang="en-US" branch="index" id="bm_id3148912"><bookmark_value>calculating;linear depreciations</bookmark_value>
<bookmark_value>depreciations;linear</bookmark_value>
<bookmark_value>linear depreciations</bookmark_value>
<bookmark_value>straight-line depreciations</bookmark_value>
<bookmark_value>SLN function</bookmark_value>
</bookmark><comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LIA" id="bm_id3154275" localize="false"/>
<h2 id="hd_id3148912">SLN</h2>
<paragraph role="paragraph" id="par_id3149154" xml-lang="en-US"><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>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3166456" xml-lang="en-US">SLN(Cost; Salvage; Life)</paragraph>
<paragraph role="paragraph" id="par_id3146955" xml-lang="en-US">
<emph>Cost</emph> is the initial cost of an asset.</paragraph>
<paragraph role="paragraph" id="par_id3149796" xml-lang="en-US">
<emph>Salvage</emph> is the value of an asset at the end of the depreciation.</paragraph>
<paragraph role="paragraph" id="par_id3166444" xml-lang="en-US">
<emph>Life</emph> is the depreciation period determining the number of periods in the depreciation of the asset.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3154098" xml-lang="en-US">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>
<paragraph role="paragraph" id="par_id3153390" xml-lang="en-US">
<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>
</section>
<section id="mduration">
<bookmark xml-lang="en-US" branch="index" id="bm_id3153739"><bookmark_value>MDURATION function</bookmark_value>
<bookmark_value>Macauley duration</bookmark_value>
</bookmark><comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_MDURATION" id="bm_id3153750" localize="false"/>
<h2 id="hd_id3153739">MDURATION</h2>
<paragraph role="paragraph" id="par_id3149923" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_MDURATION">Calculates the modified Macauley duration of a fixed interest security in years.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3148987" xml-lang="en-US">MDURATION(Settlement; Maturity; Coupon; Yield; Frequency [; Basis])</paragraph>
<paragraph role="paragraph" id="par_id3148619" xml-lang="en-US">
<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
<paragraph role="paragraph" id="par_id3149805" xml-lang="en-US">
<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
<paragraph role="paragraph" id="par_id3154338" xml-lang="en-US">
<emph>Coupon</emph> is the annual nominal rate of interest (coupon interest rate)</paragraph>
<paragraph role="paragraph" id="par_id3148466" xml-lang="en-US">
<emph>Yield</emph> is the annual yield of the security.</paragraph>
<paragraph role="paragraph" id="par_id3149423" xml-lang="en-US">
<emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph>
<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3148652" xml-lang="en-US">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>
<paragraph role="paragraph" id="par_id3145378" xml-lang="en-US"><input>=MDURATION("2001-01-01"; "2006-01-01"; 0.08; 0.09; 2; 3)</input> returns 4.02 years.</paragraph>
</section>
<section id="npv">
<bookmark xml-lang="en-US" branch="index" id="bm_id3149242"><bookmark_value>calculating;net present values</bookmark_value>
<bookmark_value>net present values</bookmark_value>
<bookmark_value>NPV function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NBW" id="bm_id3148417" localize="false"/>
<h2 id="hd_id3149242">NPV</h2>
<paragraph role="paragraph" id="par_id3145308" xml-lang="en-US"><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>
<paragraph id="par_idN111381" role="paragraph" xml-lang="en-US">If the payments take place at irregular intervals, use the <link href="text/scalc/01/04060118.xhp#xnpv" name="XNPV">XNPV</link> function.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>

<paragraph role="code" id="par_id3153321" xml-lang="en-US">NPV(Rate; <embedvar href="text/scalc/01/ful_func.xhp#number254_1" markup="keep"/>)</paragraph>
<paragraph role="paragraph" id="par_id3150630" xml-lang="en-US"><emph>Rate</emph> is the discount rate for a period.</paragraph>
<embed href="text/scalc/01/ful_func.xhp#number254"/>
<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3154800" xml-lang="en-US">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 paid as -40 currency units.</paragraph>
<paragraph role="paragraph" id="par_id3143270" xml-lang="en-US">
<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>
</section>
<section id="nominal">
<bookmark xml-lang="en-US" branch="index" id="bm_id3149484"><bookmark_value>calculating;nominal interest rates</bookmark_value>
<bookmark_value>nominal interest rates</bookmark_value>
<bookmark_value>NOMINAL function</bookmark_value>
</bookmark><comment>mw made "nominal interest rates;..." a one level entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NOMINAL" id="bm_id3145600" localize="false"/>
<h2 id="hd_id3149484">NOMINAL</h2>
<paragraph role="paragraph" id="par_id3149596" xml-lang="en-US"><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>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3152769" xml-lang="en-US">NOMINAL(EffectiveRate; NPerY)</paragraph>
<paragraph role="paragraph" id="par_id3147521" xml-lang="en-US">
<emph>EffectiveRate</emph> is the effective interest rate</paragraph>
<paragraph role="paragraph" id="par_id3156334" xml-lang="en-US">
<emph>NPerY</emph> is the number of periodic interest payments per year.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3147091" xml-lang="en-US">What is the nominal interest per year for an effective interest rate of 13.5% if twelve payments are made per year.</paragraph>
<paragraph role="paragraph" id="par_id3154831" xml-lang="en-US">
<item type="input">=NOMINAL(13.5%;12)</item> = 12.73%. The nominal interest rate per year is 12.73%.</paragraph>
</section>
<section id="nominal_add">
<bookmark xml-lang="en-US" branch="index" id="bm_id3155123"><bookmark_value>NOMINAL_ADD function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_NOMINAL" id="bm_id3158439" localize="false"/>
<h2 id="hd_id3155123">NOMINAL_ADD</h2>
<paragraph role="paragraph" id="par_id3148671" xml-lang="en-US"><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>
<embed href="text/scalc/01/04060102.xhp#ADD_note"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3156157" xml-lang="en-US">NOMINAL_ADD(EffectiveRate; NPerY)</paragraph>
<paragraph role="paragraph" id="par_id3153777" xml-lang="en-US">
<emph>EffectiveRate</emph> is the effective annual rate of interest.</paragraph>
<paragraph role="paragraph" id="par_id3150409" xml-lang="en-US">
<emph>NPerY</emph> the number of interest payments per year.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3145777" xml-lang="en-US">What is the nominal rate of interest for a 5.3543% effective rate of interest and quarterly payment.</paragraph>
<paragraph role="paragraph" id="par_id3156146" xml-lang="en-US">
<item type="input">=NOMINAL_ADD(5.3543%;4)</item> returns 0.0525 or 5.25%.</paragraph>
</section>
<section id="dollarfr">
<bookmark xml-lang="en-US" branch="index" id="bm_id3159087"><bookmark_value>DOLLARFR function</bookmark_value>
<bookmark_value>converting;decimal fractions, into mixed decimal fractions</bookmark_value>
</bookmark><comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DOLLARFR" id="bm_id3146907" localize="false"/>
<h2 id="hd_id3159087">DOLLARFR</h2>
<paragraph role="paragraph" id="par_id3150593" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DOLLARFR">Converts a quotation that has been given as a decimal number into a mixed decimal fraction.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3152959" xml-lang="en-US">DOLLARFR(DecimalDollar; Fraction)</paragraph>
<paragraph role="paragraph" id="par_id3149558" xml-lang="en-US">
<emph>DecimalDollar</emph> is a decimal number.</paragraph>
<paragraph role="paragraph" id="par_id3153672" xml-lang="en-US">
<emph>Fraction</emph> is a whole number that is used as the denominator of the decimal fraction.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3153795" xml-lang="en-US">
<item type="input">=DOLLARFR(1.125;16)</item> converts into sixteenths. The result is 1.02 for 1 plus 2/16.</paragraph>
<paragraph role="paragraph" id="par_id3150995" xml-lang="en-US">
<item type="input">=DOLLARFR(1.125;8)</item> converts into eighths. The result is 1.1 for 1 plus 1/8.</paragraph>
</section>
<section id="dollarde">
<bookmark xml-lang="en-US" branch="index" id="bm_id3154671"><bookmark_value>fractions; converting</bookmark_value>
<bookmark_value>converting;decimal fractions, into decimal numbers</bookmark_value>
<bookmark_value>DOLLARDE function</bookmark_value>
</bookmark><comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DOLLARDE" id="bm_id3154569" localize="false"/>
<h2 id="hd_id3154671">DOLLARDE</h2>
<paragraph role="paragraph" id="par_id3154418" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DOLLARDE">Converts a quotation that has been given as a decimal fraction into a decimal number.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3150348" xml-lang="en-US">DOLLARDE(FractionalDollar; Fraction)</paragraph>
<paragraph role="paragraph" id="par_id3154111" xml-lang="en-US">
<emph>FractionalDollar</emph> is a number given as a decimal fraction.</paragraph>
<paragraph role="paragraph" id="par_id3153695" xml-lang="en-US">
<emph>Fraction</emph> is a whole number that is used as the denominator of the decimal fraction.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3150941" xml-lang="en-US">
<item type="input">=DOLLARDE(1.02;16)</item> stands for 1 and 2/16. This returns 1.125.</paragraph>
<paragraph role="paragraph" id="par_id3150830" xml-lang="en-US">
<item type="input">=DOLLARDE(1.1;8)</item> stands for 1 and 1/8. This returns 1.125.</paragraph>
</section>
<section id="mirr">
<bookmark xml-lang="en-US" branch="index" id="bm_id3148974"><bookmark_value>calculating;modified internal rates of return</bookmark_value>
<bookmark_value>modified internal rates of return</bookmark_value>
<bookmark_value>MIRR function</bookmark_value>
<bookmark_value>internal rates of return;modified</bookmark_value>
</bookmark><comment>mw added "internal rates of return;..."</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QIKV" id="bm_id3150670" localize="false"/>
<h2 id="hd_id3148974">MIRR</h2>
<paragraph role="paragraph" id="par_id3155497" xml-lang="en-US"><ahelp hid="HID_FUNC_QIKV">Calculates the modified internal rate of return of a series of investments.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3148399" xml-lang="en-US">MIRR(Values; Investment; ReinvestRate)</paragraph>
<paragraph role="paragraph" id="par_id3155896" xml-lang="en-US">
<emph>Values</emph> corresponds to the array or the cell reference for cells whose content corresponds to the payments.</paragraph>
<paragraph role="paragraph" id="par_id3149998" xml-lang="en-US">
<emph>Investment</emph> is the rate of interest of the investments (the negative values of the array)</paragraph>
<paragraph role="paragraph" id="par_id3159408" xml-lang="en-US">
<emph>ReinvestRate</emph>:the rate of interest of the reinvestment (the positive values of the array)</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3147352" xml-lang="en-US">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>
</section>
<section id="yield">
<bookmark xml-lang="en-US" branch="index" id="bm_id3149323"><bookmark_value>YIELD function</bookmark_value>
<bookmark_value>rates of return;securities</bookmark_value>
<bookmark_value>yields, see also rates of return</bookmark_value>
</bookmark><comment>mw added two entries</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YIELD" id="bm_id3152460" localize="false"/>
<h2 id="hd_id3149323">YIELD</h2>
<paragraph role="paragraph" id="par_id3150643" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_YIELD">Calculates the yield of a security.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3149744" xml-lang="en-US">YIELD(Settlement; Maturity; Rate; Price; Redemption; Frequency [; Basis])</paragraph>
<paragraph role="paragraph" id="par_id3154526" xml-lang="en-US">
<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
<paragraph role="paragraph" id="par_id3153266" xml-lang="en-US">
<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
<paragraph role="paragraph" id="par_id3151284" xml-lang="en-US">
<emph>Rate</emph> is the annual rate of interest.</paragraph>
<paragraph role="paragraph" id="par_id3147314" xml-lang="en-US">
<emph>Price</emph> is the price (purchase price) of the security per 100 currency units of par value.</paragraph>
<paragraph role="paragraph" id="par_id3145156" xml-lang="en-US">
<emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph>
<paragraph role="paragraph" id="par_id3159218" xml-lang="en-US">
<emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph>
<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3151214" xml-lang="en-US">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>
<paragraph role="paragraph" id="par_id3154194" xml-lang="en-US"><input>=YIELD("1999-02-15"; "2007-11-15"; 0.0575 ;95.04287; 100; 2; 0)</input>  returns 0.065 or 6.50 per cent.</paragraph>
</section>
<section id="yielddisc">
<bookmark xml-lang="en-US" branch="index" id="bm_id3150100"><bookmark_value>YIELDDISC function</bookmark_value>
<bookmark_value>rates of return;non-interest-bearing securities</bookmark_value>
</bookmark><comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YIELDDISC" id="bm_id3156206" localize="false"/>
<h2 id="hd_id3150100">YIELDDISC</h2>
<paragraph role="paragraph" id="par_id3150486" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_YIELDDISC">Calculates the annual yield of a non-interest-bearing security.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3159191" xml-lang="en-US">YIELDDISC(Settlement; Maturity; Price; Redemption [; Basis])</paragraph>
<paragraph role="paragraph" id="par_id3150237" xml-lang="en-US">
<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
<paragraph role="paragraph" id="par_id3146924" xml-lang="en-US">
<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
<paragraph role="paragraph" id="par_id3151201" xml-lang="en-US">
<emph>Price</emph> is the price (purchase price) of the security per 100 currency units of par value.</paragraph>
<paragraph role="paragraph" id="par_id3156049" xml-lang="en-US">
<emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph>
<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3163815" xml-lang="en-US">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>
<paragraph role="paragraph" id="par_id3155187" xml-lang="en-US"><input>=YIELDDISC("1999-02-15"; "1999-03-01"; 99.795; 100; 2)</input> returns 0.052823 or 5.2823 per cent.</paragraph>
</section>
<section id="yieldmat">
<bookmark xml-lang="en-US" branch="index" id="bm_id3155140"><bookmark_value>YIELDMAT function</bookmark_value>
<bookmark_value>rates of return;securities with interest paid on maturity</bookmark_value>
</bookmark><comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YIELDMAT" id="bm_id3156029" localize="false"/>
<h2 id="hd_id3155140">YIELDMAT</h2>
<paragraph role="paragraph" id="par_id3151332" xml-lang="en-US"><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>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3159113" xml-lang="en-US">YIELDMAT(Settlement; Maturity; Issue; Rate; Price [; Basis])</paragraph>
<paragraph role="paragraph" id="par_id3149309" xml-lang="en-US">
<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
<paragraph role="paragraph" id="par_id3151381" xml-lang="en-US">
<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
<paragraph role="paragraph" id="par_id3153302" xml-lang="en-US">
<emph>Issue</emph> is the date of issue of the security.</paragraph>
<paragraph role="paragraph" id="par_id3147140" xml-lang="en-US">
<emph>Rate</emph> is the interest rate of the security on the issue date.</paragraph>
<paragraph role="paragraph" id="par_id3151067" xml-lang="en-US">
<emph>Price</emph> is the price (purchase price) of the security per 100 currency units of par value.</paragraph>
<embed href="text/scalc/01/func_yearfrac.xhp#basis"/>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3163717" xml-lang="en-US">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>
<paragraph role="paragraph" id="par_id3155311" xml-lang="en-US"><input>=YIELDMAT("1999-03-15"; "1999-11-03"; "1998-11-08"; 0.0625; 100.0123; 0)</input>  returns 0.060954 or 6.0954 per cent.</paragraph>
</section>
<section id="pmt">
<bookmark xml-lang="en-US" branch="index" id="bm_id3149577"><bookmark_value>calculating;annuities</bookmark_value>
<bookmark_value>annuities</bookmark_value>
<bookmark_value>PMT function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RMZ" id="bm_id3148895" localize="false"/>
<h2 id="hd_id3149577">PMT</h2>
<paragraph role="paragraph" id="par_id3148563" xml-lang="en-US"><ahelp hid="HID_FUNC_RMZ">Returns the periodic payment for an annuity with constant interest rates.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3147278" xml-lang="en-US">PMT(Rate; NPer; PV [ ; [ FV ] [ ; Type ] ])</paragraph>
<paragraph role="paragraph" id="par_id3147291" xml-lang="en-US">
<emph>Rate</emph> is the periodic interest rate.</paragraph>
<paragraph role="paragraph" id="par_id3148641" xml-lang="en-US">
<emph>NPer</emph> is the number of periods in which annuity is paid.</paragraph>
<paragraph role="paragraph" id="par_id3156360" xml-lang="en-US">
<emph>PV</emph> is the present value (cash value) in a sequence of payments.</paragraph>
<paragraph role="paragraph" id="par_id3154920" xml-lang="en-US">
<emph>FV</emph> (optional) is the desired value (future value) to be reached at the end of the periodic payments.</paragraph>
<paragraph role="paragraph" id="par_id3156434" xml-lang="en-US">
<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>
<paragraph role="paragraph" id="par_idN11645" xml-lang="en-US" localize="false">
	<embedvar href="text/scalc/00/00000004.xhp#optional"/>
</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3154222" xml-lang="en-US">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>
<paragraph role="paragraph" id="par_id3155943" xml-lang="en-US">
<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>
</section>
<section id="tbilleq">
<bookmark xml-lang="en-US" branch="index" id="bm_id3155799"><bookmark_value>TBILLEQ function</bookmark_value>
<bookmark_value>treasury bills;annual return</bookmark_value>
<bookmark_value>annual return on treasury bills</bookmark_value>
</bookmark><comment>mw changed "treasury bills;..." and added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_TBILLEQ" id="bm_id3147380" localize="false"/>
<h2 id="hd_id3155799">TBILLEQ</h2>
<paragraph role="paragraph" id="par_id3154403" xml-lang="en-US"><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>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3150224" xml-lang="en-US">TBILLEQ(Settlement; Maturity; Discount)</paragraph>
<paragraph role="paragraph" id="par_id3156190" xml-lang="en-US">
<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
<paragraph role="paragraph" id="par_id3153827" xml-lang="en-US">
<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
<paragraph role="paragraph" id="par_id3150310" xml-lang="en-US">
<emph>Discount</emph> is the percentage discount on acquisition of the security.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3153173" xml-lang="en-US">Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9.14 per cent.</paragraph>
<paragraph role="paragraph" id="par_id3153520" xml-lang="en-US">The return on the treasury bill corresponding to a security is worked out as follows:</paragraph>
<paragraph role="paragraph" id="par_id3154382" xml-lang="en-US"><input>=TBILLEQ("1999-03-31";"1999-06-01"; 0.0914)</input>  returns 0.094151 or 9.4151 per cent.</paragraph>
</section>
<section id="tbillprice">
<bookmark xml-lang="en-US" branch="index" id="bm_id3151032"><bookmark_value>TBILLPRICE function</bookmark_value>
<bookmark_value>treasury bills;prices</bookmark_value>
<bookmark_value>prices;treasury bills</bookmark_value>
</bookmark><comment>mw added two entries</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_TBILLPRICE" id="bm_id3150576" localize="false"/>
<h2 id="hd_id3151032">TBILLPRICE</h2>
<paragraph role="paragraph" id="par_id3157887" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_TBILLPRICE">Calculates the price of a treasury bill per 100 currency units.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3150284" xml-lang="en-US">TBILLPRICE(Settlement; Maturity; Discount)</paragraph>
<paragraph role="paragraph" id="par_id3154059" xml-lang="en-US">
<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
<paragraph role="paragraph" id="par_id3154073" xml-lang="en-US">
<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
<paragraph role="paragraph" id="par_id3145765" xml-lang="en-US">
<emph>Discount</emph> is the percentage discount upon acquisition of the security.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3155542" xml-lang="en-US">Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9 per cent.</paragraph>
<paragraph role="paragraph" id="par_id3154578" xml-lang="en-US">The price of the treasury bill is worked out as follows:</paragraph>
<paragraph role="paragraph" id="par_id3154592" xml-lang="en-US"><input>=TBILLPRICE("1999-03-31";"1999-06-01"; 0.09)</input> returns 98.45.</paragraph>
</section>
<section id="tbillyield">
<bookmark xml-lang="en-US" branch="index" id="bm_id3152912"><bookmark_value>TBILLYIELD function</bookmark_value>
<bookmark_value>treasury bills;rates of return</bookmark_value>
<bookmark_value>rates of return of treasury bills</bookmark_value>
</bookmark><comment>mw added two entries</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_TBILLYIELD" id="bm_id3151346" localize="false"/>
<h2 id="hd_id3152912">TBILLYIELD</h2>
<paragraph role="paragraph" id="par_id3145560" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_TBILLYIELD">Calculates the yield of a treasury bill.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id3156077" xml-lang="en-US">TBILLYIELD(Settlement; Maturity; Price)</paragraph>
<paragraph role="paragraph" id="par_id3156091" xml-lang="en-US">
<emph>Settlement</emph> is the date of purchase of the security.</paragraph>
<paragraph role="paragraph" id="par_id3157856" xml-lang="en-US">
<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph>
<paragraph role="paragraph" id="par_id3149627" xml-lang="en-US">
<emph>Price</emph> is the price (purchase price) of the treasury bill per 100 currency units of par value.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id3145178" xml-lang="en-US">Settlement date: March 31 1999, maturity date: June 1 1999, price: 98.45 currency units.</paragraph>
<paragraph role="paragraph" id="par_id3145193" xml-lang="en-US">The yield of the treasury bill is worked out as follows:</paragraph>
<paragraph role="paragraph" id="par_id3148528" xml-lang="en-US"><input>=TBILLYIELD("1999-03-31";"1999-06-01"; 98.45)</input> returns 0.091417 or 9.1417 per cent.</paragraph>
</section>
</sort>
<paragraph role="paragraph" id="par_id3148546" xml-lang="en-US"><link href="text/scalc/01/04060103.xhp" name="Back to Financial Functions Part One">Back to Financial Functions Part One</link></paragraph>
<paragraph role="paragraph" id="par_id3146762" xml-lang="en-US"><link href="text/scalc/01/04060118.xhp" name="Forward to Financial Functions Part Three">Forward to Financial Functions Part Three</link></paragraph>
<embed href="text/scalc/01/04060100.xhp#drking"/>
</body>
</helpdocument>