Warning, /office/calligra/sheets/functions/financial.xml is written in an unsupported language. File is not indexed.
0001 <!DOCTYPE KSpreadFunctions>
0002 <KSpreadFunctions>
0003
0004 <Group>
0005 <GroupName>Financial</GroupName>
0006
0007 <Function>
0008 <Name>ACCRINT</Name>
0009 <Type>Float</Type>
0010 <Parameter>
0011 <Comment>Issue date</Comment>
0012 <Type>Date</Type>
0013 </Parameter>
0014 <Parameter>
0015 <Comment>First interest</Comment>
0016 <Type>Date</Type>
0017 </Parameter>
0018 <Parameter>
0019 <Comment>Settlement</Comment>
0020 <Type>Date</Type>
0021 </Parameter>
0022 <Parameter>
0023 <Comment>Annual rate of security</Comment>
0024 <Type>Float</Type>
0025 </Parameter>
0026 <Parameter>
0027 <Comment>Par value</Comment>
0028 <Type>Float</Type>
0029 </Parameter>
0030 <Parameter>
0031 <Comment>Number of payments per year</Comment>
0032 <Type>Float</Type>
0033 </Parameter>
0034 <Parameter optional="true">
0035 <Comment>Day counting basis</Comment>
0036 <Type>Int</Type>
0037 </Parameter>
0038 <Help>
0039 <Text>The ACCRINT function returns accrued interest for a security which pays periodic interest. Allowed frequencies are 1 - annual, 2 - semi-annual or 4 - quarterly. Basis is the type of day counting you want to use: 0: US 30/360 (default), 1: real days, 2: real days/360, 3: real days/365 or 4: European 30/360.</Text>
0040 <Syntax>ACCRINT(issue; first interest; settlement; rate; par; frequency; basis)</Syntax>
0041 <Example>ACCRINT("2/28/2001"; "8/31/2001"; "5/1/2001"; 0.1; 1000; 2; 0) returns 16,944</Example>
0042 <Related>ACCRINTM</Related>
0043 </Help>
0044 </Function>
0045
0046 <Function>
0047 <Name>ACCRINTM</Name>
0048 <Type>Float</Type>
0049 <Parameter>
0050 <Comment>Issue date</Comment>
0051 <Type>Date</Type>
0052 </Parameter>
0053 <Parameter>
0054 <Comment>Settlement</Comment>
0055 <Type>Date</Type>
0056 </Parameter>
0057 <Parameter>
0058 <Comment>Annual rate of security</Comment>
0059 <Type>Float</Type>
0060 </Parameter>
0061 <Parameter>
0062 <Comment>Par value</Comment>
0063 <Type>Float</Type>
0064 </Parameter>
0065 <Parameter optional="true">
0066 <Comment>Day counting basis</Comment>
0067 <Type>Int</Type>
0068 </Parameter>
0069 <Help>
0070 <Text>The ACCRINTM function returns accrued interest for a security which pays interests at maturity date. Basis is the type of day counting you want to use: 0: US 30/360 (default), 1: real days, 2: real days/360, 3: real days/365 or 4: European 30/360.</Text>
0071 <Syntax>ACCRINTM(issue; settlement; rate; par; basis)</Syntax>
0072 <Example>ACCRINTM("2/28/2001"; "8/31/2001"; 0.1; 100) returns 5.0278</Example>
0073 <Related>ACCRINT</Related>
0074 </Help>
0075 </Function>
0076
0077 <Function>
0078 <Name>AMORDEGRC</Name>
0079 <Type>Float</Type>
0080 <Parameter>
0081 <Comment>Cost</Comment>
0082 <Type>Float</Type>
0083 </Parameter>
0084 <Parameter>
0085 <Comment>Pv</Comment>
0086 <Type>Float</Type>
0087 </Parameter>
0088 <Parameter>
0089 <Comment>Fv</Comment>
0090 <Type>Float</Type>
0091 </Parameter>
0092 <Help>
0093 <Text>The AMORDEGRC function calculates the amortization value for the French accounting system using degressive depreciation.</Text>
0094 <Syntax>AMORDEGRC( Cost; purchaseDate; firstPeriodEndDate; salvage; period; rate; basis)</Syntax>
0095 <Example>AMORDEGRC( 1000; "2006-02-01"; "2006-12-31"; 10; 0; 0.1; 1 ) returns 228</Example>
0096 <Related>AMORLINC</Related>
0097 <Related>DB</Related>
0098 <Related>DDB</Related>
0099 <Related>YEARFRAC</Related>
0100 </Help>
0101 </Function>
0102
0103 <Function>
0104 <Name>AMORLINC</Name>
0105 <Type>Float</Type>
0106 <Parameter>
0107 <Comment>P</Comment>
0108 <Type>Int</Type>
0109 </Parameter>
0110 <Parameter>
0111 <Comment>Pv</Comment>
0112 <Type>Float</Type>
0113 </Parameter>
0114 <Parameter>
0115 <Comment>Fv</Comment>
0116 <Type>Float</Type>
0117 </Parameter>
0118 <Help>
0119 <Text>The AMORLINC function calculates the amortization value for the French accounting system using linear depreciation.</Text>
0120 <Syntax>AMORLINC( Cost; purchaseDate; firstPeriodEndDate; salvage; period; rate; basis)</Syntax>
0121 <Example>AMORLINC( 1000; "2004-02-01"; "2004-12-31"; 10; 0; 0.1; 1 ) returns 91.256831</Example>
0122 <Related>AMORDEGRC</Related>
0123 <Related>DB</Related>
0124 <Related>DDB</Related>
0125 <Related>YEARFRAC</Related>
0126 </Help>
0127 </Function>
0128
0129 <Function>
0130 <Name>COMPOUND</Name>
0131 <Type>Float</Type>
0132 <Parameter>
0133 <Comment>Principal</Comment>
0134 <Type>Float</Type>
0135 </Parameter>
0136 <Parameter>
0137 <Comment>Interest rate</Comment>
0138 <Type>Float</Type>
0139 </Parameter>
0140 <Parameter>
0141 <Comment>Periods per year</Comment>
0142 <Type>Float</Type>
0143 </Parameter>
0144 <Parameter>
0145 <Comment>Years</Comment>
0146 <Type>Float</Type>
0147 </Parameter>
0148 <Help>
0149 <Text>The COMPOUND() function returns the value of an investment, given the principal, nominal interest rate, compounding frequency and time. For example: $5000 at 12% interest compounded quarterly for 5 years will become COMPOUND(5000;0.12;4;5) or $9030.56.</Text>
0150 <Syntax>COMPOUND(initial;interest;periods;periods_per_year)</Syntax>
0151 <Example>COMPOUND(5000;0.12;4;5) equals 9030.56</Example>
0152 </Help>
0153 </Function>
0154
0155 <Function>
0156 <Name>CONTINUOUS</Name>
0157 <Type>Float</Type>
0158 <Parameter>
0159 <Comment>Principal</Comment>
0160 <Type>Float</Type>
0161 </Parameter>
0162 <Parameter>
0163 <Comment>Interest rate</Comment>
0164 <Type>Float</Type>
0165 </Parameter>
0166 <Parameter>
0167 <Comment>Years</Comment>
0168 <Type>Float</Type>
0169 </Parameter>
0170 <Help>
0171 <Text>The CONTINUOUS() function calculates the return on continuously compounded interest, given the principal, nominal rate and time in years. For example: $1000 earning 10% for 1 year becomes CONTINUOUS(1000;.1;1) or $1105.17.</Text>
0172 <Syntax>CONTINOUS(principal;interest;years)</Syntax>
0173 <Example>CONTINUOUS(1000;0.1;1) equals 1105.17</Example>
0174 </Help>
0175 </Function>
0176
0177 <Function>
0178 <Name>COUPNUM</Name>
0179 <Type>Float</Type>
0180 <Parameter>
0181 <Comment>Settlement</Comment>
0182 <Type>Date</Type>
0183 </Parameter>
0184 <Parameter>
0185 <Comment>Maturity</Comment>
0186 <Type>Date</Type>
0187 </Parameter>
0188 <Parameter>
0189 <Comment>Frequency</Comment>
0190 <Type>Float</Type>
0191 </Parameter>
0192 <Parameter optional="true">
0193 <Comment>Day counting basis</Comment>
0194 <Type>Int</Type>
0195 </Parameter>
0196 <Help>
0197 <Text>The COUPNUM function returns the number of coupons to be paid between the settlement and the maturity. Basis is the type of day counting you want to use: 0: US 30/360 (default), 1: real days, 2: real days/360, 3: real days/365 or 4: European 30/360.</Text>
0198 <Syntax>COUPNUM(settlement; maturity; frequency; basis)</Syntax>
0199 <Example>COUPNUM("2/28/2001"; "8/31/2001"; 2; 0) returns 1</Example>
0200 <Related>COUPDAYBS</Related>
0201 <Related>COUPDAYS</Related>
0202 <Related>COUPDAYSNC</Related>
0203 <Related>COUPNCD</Related>
0204 <Related>COUPPCD</Related>
0205 </Help>
0206 </Function>
0207
0208 <Function>
0209 <Name>CUMIPMT</Name>
0210 <Type>Float</Type>
0211 <Parameter>
0212 <Comment>rate</Comment>
0213 <Type>Float</Type>
0214 </Parameter>
0215 <Parameter>
0216 <Comment>periods</Comment>
0217 <Type>Float</Type>
0218 </Parameter>
0219 <Parameter>
0220 <Comment>value</Comment>
0221 <Type>Float</Type>
0222 </Parameter>
0223 <Parameter>
0224 <Comment>start</Comment>
0225 <Type>Int</Type>
0226 </Parameter>
0227 <Parameter>
0228 <Comment>end</Comment>
0229 <Type>Int</Type>
0230 </Parameter>
0231 <Parameter>
0232 <Comment>type</Comment>
0233 <Type>Int</Type>
0234 </Parameter>
0235 <Help>
0236 <Text>Calculates the cumulative interest payment.</Text>
0237 <Syntax>CUMIPMT(rate; periods; value; start; end; type)</Syntax>
0238 <Example>CUMIPMT( 0.06/12; 5*12; 100000; 5; 12; 0 ) equals -3562,187023</Example>
0239 <Related>IPMT</Related>
0240 <Related>CUMPRINC</Related>
0241 </Help>
0242 </Function>
0243
0244
0245 <Function>
0246 <Name>CUMPRINC</Name>
0247 <Type>Float</Type>
0248 <Parameter>
0249 <Comment>rate</Comment>
0250 <Type>Float</Type>
0251 </Parameter>
0252 <Parameter>
0253 <Comment>periods</Comment>
0254 <Type>Float</Type>
0255 </Parameter>
0256 <Parameter>
0257 <Comment>value</Comment>
0258 <Type>Float</Type>
0259 </Parameter>
0260 <Parameter>
0261 <Comment>start</Comment>
0262 <Type>Int</Type>
0263 </Parameter>
0264 <Parameter>
0265 <Comment>end</Comment>
0266 <Type>Int</Type>
0267 </Parameter>
0268 <Parameter>
0269 <Comment>type</Comment>
0270 <Type>Int</Type>
0271 </Parameter>
0272 <Help>
0273 <Text>Calculates the cumulative principal payment.</Text>
0274 <Syntax>CUMPRINC(rate; periods; value; start; end; type)</Syntax>
0275 <Example>CUMPRINC( 0.06/12; 5*12; 100000; 5; 12; 0 ) equals -11904.054201</Example>
0276 <Related>PPMT</Related>
0277 <Related>CUMIPMT</Related>
0278 </Help>
0279 </Function>
0280
0281 <Function>
0282 <Name>DB</Name>
0283 <Type>Float</Type>
0284 <Parameter>
0285 <Comment>Cost</Comment>
0286 <Type>Float</Type>
0287 </Parameter>
0288 <Parameter>
0289 <Comment>Salvage</Comment>
0290 <Type>Float</Type>
0291 </Parameter>
0292 <Parameter>
0293 <Comment>Life</Comment>
0294 <Type>Float</Type>
0295 </Parameter>
0296 <Parameter>
0297 <Comment>Period</Comment>
0298 <Type>Float</Type>
0299 </Parameter>
0300 <Parameter>
0301 <Comment>Month</Comment>
0302 <Type>Float</Type>
0303 </Parameter>
0304 <Help>
0305 <Text>The DB() function will calculate the depreciation of an asset for a given period using the fixed-declining balance method. Month is optional, if omitted it is assumed to be 12.</Text>
0306 <Syntax>DB(cost; salvage value; life; period [;month])</Syntax>
0307 <Example>DB(8000;400;6;3) equals 1158.40</Example>
0308 <Example>DB(8000;400;6;3;2) equals 1783.41</Example>
0309 <Related>DDB</Related>
0310 <Related>SLN</Related>
0311 </Help>
0312 </Function>
0313
0314 <Function>
0315 <Name>DDB</Name>
0316 <Type>Float</Type>
0317 <Parameter>
0318 <Comment>Cost</Comment>
0319 <Type>Float</Type>
0320 </Parameter>
0321 <Parameter>
0322 <Comment>Salvage</Comment>
0323 <Type>Float</Type>
0324 </Parameter>
0325 <Parameter>
0326 <Comment>Life</Comment>
0327 <Type>Float</Type>
0328 </Parameter>
0329 <Parameter>
0330 <Comment>Period</Comment>
0331 <Type>Float</Type>
0332 </Parameter>
0333 <Parameter>
0334 <Comment>Factor</Comment>
0335 <Type>Float</Type>
0336 </Parameter>
0337 <Help>
0338 <Text>The DDB() function calculates the depreciation of an asset for a given period using the arithmetic-declining method. The factor is optional, if omitted it is assumed to be 2. All the parameter must be greater than zero.</Text>
0339 <Syntax>DDB(cost; salvage value; life; period [;factor])</Syntax>
0340 <Example>DDB(75000;1;60;12;2) returns 1721.81</Example>
0341 <Related>SLN</Related>
0342 </Help>
0343 </Function>
0344
0345 <Function>
0346 <Name>DISC</Name>
0347 <Type>Float</Type>
0348 <Parameter>
0349 <Comment>Settlement</Comment>
0350 <Type>Date</Type>
0351 </Parameter>
0352 <Parameter>
0353 <Comment>Maturity</Comment>
0354 <Type>Date</Type>
0355 </Parameter>
0356 <Parameter>
0357 <Comment>Price per $100 face value</Comment>
0358 <Type>Float</Type>
0359 </Parameter>
0360 <Parameter>
0361 <Comment>Redemption</Comment>
0362 <Type>Float</Type>
0363 </Parameter>
0364 <Parameter optional="true">
0365 <Comment>Day counting basis</Comment>
0366 <Type>Int</Type>
0367 </Parameter>
0368 <Help>
0369 <Text>The DISC function returns the discount rate for a security. Basis is the type of day counting you want to use: 0: US 30/360 (default), 1: real days, 2: real days/360, 3: real days/365 or 4: European 30/360.</Text>
0370 <Syntax>DISC(settlement; maturity; par; redemption [; basis ] )</Syntax>
0371 <Example>DISC("2/28/2001"; "8/31/2001"; 12; 14) returns 0.2841</Example>
0372 <Related>YEARFRAC</Related>
0373 </Help>
0374 </Function>
0375
0376 <Function>
0377 <Name>DOLLARDE</Name>
0378 <Type>Float</Type>
0379 <Parameter>
0380 <Comment>Fractional Dollar</Comment>
0381 <Type>Float</Type>
0382 </Parameter>
0383 <Parameter>
0384 <Comment>Fraction</Comment>
0385 <Type>Int</Type>
0386 </Parameter>
0387 <Help>
0388 <Text>The DOLLARDE() function returns a dollar price expressed as a decimal number. The fractional dollar is the number to be converted and the fraction is the denominator of the fraction</Text>
0389 <Syntax>DOLLARDE(fractional dollar; fraction)</Syntax>
0390 <Example>DOLLARDE(1.02; 16) - stands for 1 and 2/16 - returns 1.125</Example>
0391 <Related>DOLLARFR</Related>
0392 <Related>TRUNC</Related>
0393 </Help>
0394 </Function>
0395
0396 <Function>
0397 <Name>DOLLARFR</Name>
0398 <Type>Float</Type>
0399 <Parameter>
0400 <Comment>Decimal Dollar</Comment>
0401 <Type>Float</Type>
0402 </Parameter>
0403 <Parameter>
0404 <Comment>Fraction</Comment>
0405 <Type>Int</Type>
0406 </Parameter>
0407 <Help>
0408 <Text>The DOLLARFR() function returns a dollar price expressed as a fraction. The decimal dollar is the number to be converted and the fraction is the denominator of the fraction</Text>
0409 <Syntax>DOLLARFR(fractional dollar; fraction)</Syntax>
0410 <Example>DOLLARFR(1.125; 16) returns 1.02. (1 + 2/16)</Example>
0411 <Related>DOLLARDE</Related>
0412 <Related>TRUNC</Related>
0413 </Help>
0414 </Function>
0415
0416 <Function>
0417 <Name>DURATION</Name>
0418 <Type>Float</Type>
0419 <Parameter>
0420 <Comment>Rate</Comment>
0421 <Type>Float</Type>
0422 </Parameter>
0423 <Parameter>
0424 <Comment>Present value (PV)</Comment>
0425 <Type>Float</Type>
0426 </Parameter>
0427 <Parameter>
0428 <Comment>Future value (FV)</Comment>
0429 <Type>Float</Type>
0430 </Parameter>
0431 <Help>
0432 <Text>Returns the number of periods needed for an investment to retain a desired value.</Text>
0433 <Syntax>DURATION(rate; pv; fv)</Syntax>
0434 <Example>DURATION(0.1; 1000; 2000) returns 7.27</Example>
0435 <Related>FV</Related>
0436 <Related>PV</Related>
0437 </Help>
0438 </Function>
0439
0440 <Function>
0441 <Name>DURATION_ADD</Name>
0442 <Type>Float</Type>
0443 <Parameter>
0444 <Comment>Settlement</Comment>
0445 <Type>Date</Type>
0446 </Parameter>
0447 <Parameter>
0448 <Comment>Maturity</Comment>
0449 <Type>Date</Type>
0450 </Parameter>
0451 <Parameter>
0452 <Comment>Coupon</Comment>
0453 <Type>Float</Type>
0454 </Parameter>
0455 <Parameter>
0456 <Comment>Yield</Comment>
0457 <Type>Float</Type>
0458 </Parameter>
0459 <Parameter>
0460 <Comment>Frequency</Comment>
0461 <Type>Float</Type>
0462 </Parameter>
0463 <Parameter>
0464 <Comment>Basis</Comment>
0465 <Type>Int</Type>
0466 </Parameter>
0467 <Help>
0468 <Text>Returns the Macauley duration of a fixed interest security in years.</Text>
0469 <Syntax>DURATION_ADD(Settlement; Maturity; Coupon; Yield; Frequency; Basis)</Syntax>
0470 <Example>DURATION_ADD( "1998-01-01"; "2006-01-01"; 0.08; 0.09; 2; 1 ) returns 5.9937749555</Example>
0471 <Related>MDURATION</Related>
0472 </Help>
0473 </Function>
0474
0475 <Function>
0476 <Name>EFFECT</Name>
0477 <Type>Float</Type>
0478 <Parameter>
0479 <Comment>Nominal interest rate</Comment>
0480 <Type>Float</Type>
0481 </Parameter>
0482 <Parameter>
0483 <Comment>Periods</Comment>
0484 <Type>Float</Type>
0485 </Parameter>
0486 <Help>
0487 <Text>The EFFECT() function calculates the effective yield for a nominal interest rate (annual rate or APR). For example: 8% interest compounded monthly provides an effective yield of EFFECT(.08;12) or 8.3%.</Text>
0488 <Syntax>EFFECT(nominal;periods)</Syntax>
0489 <Example>EFFECT(0.08;12) equals 0.083</Example>
0490 <Related>EFFECTIVE</Related>
0491 <Related>NOMINAL</Related>
0492 </Help>
0493 </Function>
0494
0495 <Function>
0496 <Name>EFFECTIVE</Name>
0497 <Type>Float</Type>
0498 <Parameter>
0499 <Comment>Nominal interest rate</Comment>
0500 <Type>Float</Type>
0501 </Parameter>
0502 <Parameter>
0503 <Comment>Periods</Comment>
0504 <Type>Float</Type>
0505 </Parameter>
0506 <Help>
0507 <Text>The EFFECTIVE() function calculates the effective yield for a nominal interest rate (annual rate or APR). It is the same as the EFFECT function.</Text>
0508 <Syntax>EFFECTIVE(nominal;periods)</Syntax>
0509 <Related>EFFECT</Related>
0510 </Help>
0511 </Function>
0512
0513 <Function>
0514 <Name>EURO</Name>
0515 <Type>Float</Type>
0516 <Parameter>
0517 <Comment>Currency</Comment>
0518 <Type>String</Type>
0519 </Parameter>
0520 <Help>
0521 <Text>The EURO() function converts one Euro to a given national currency in the European monetary union. Currency is one of the following: ATS (Austria), BEF (Belgium), CYP (Cyprus), DEM (Germany), EEK (Estonia), ESP (Spain), EUR (Euro), FIM (Finland), FRF (France), GRD (Greece), IEP (Ireland), ITL (Italy), LTL (Lithuania), LUF (Luxembourg), LVL (Latvia), MTL (Malta), NLG (Netherlands), PTE (Portugal), SIT (Slovenia), or SKK (Slovakia).</Text>
0522 <Syntax>EURO(currency)</Syntax>
0523 <Example>EURO("DEM") equals 1.95583</Example>
0524 <Related>EUROCONVERT</Related>
0525 </Help>
0526 </Function>
0527
0528 <Function>
0529 <Name>EUROCONVERT</Name>
0530 <Type>Float</Type>
0531 <Parameter>
0532 <Comment>Number</Comment>
0533 <Type>Float</Type>
0534 </Parameter>
0535 <Parameter>
0536 <Comment>Source currency</Comment>
0537 <Type>String</Type>
0538 </Parameter>
0539 <Parameter>
0540 <Comment>Target currency</Comment>
0541 <Type>String</Type>
0542 </Parameter>
0543 <Help>
0544 <Text>The EUROCONVERT() function converts a number from one national currency to another currency in the European monetary union by using EURO an intermediary. Currency is one of the following: ATS (Austria), BEF (Belgium), DEM (Germany), ESP (Spain), EUR (Euro), FIM (Finland), FRF (France), GRD (Greece), IEP (Ireland), ITL (Italy), LUF (Luxembourg), NLG (Netherlands), or PTE (Portugal).</Text>
0545 <Syntax>EUROCONVERT(number; source currency; target currency)</Syntax>
0546 <Example>EUROCONVERT(1; "EUR"; "DEM") equals 1.95583</Example>
0547 <Related>EURO</Related>
0548 </Help>
0549 </Function>
0550
0551 <Function>
0552 <Name>FV</Name>
0553 <Type>Float</Type>
0554 <Parameter>
0555 <Comment>Present value</Comment>
0556 <Type>Float</Type>
0557 </Parameter>
0558 <Parameter>
0559 <Comment>Rate</Comment>
0560 <Type>Float</Type>
0561 </Parameter>
0562 <Parameter>
0563 <Comment>Periods</Comment>
0564 <Type>Float</Type>
0565 </Parameter>
0566 <Help>
0567 <Text>The FV() function returns the future value of an investment, given the yield and the time elapsed. If you have $1000 in a bank account earning 8% interest, after two years you will have FV(1000;0.08;2) or $1166.40.</Text>
0568 <Syntax>FV(present value;yield;periods)</Syntax>
0569 <Example>FV(1000;0.08;2) equals 1166.40</Example>
0570 <Related>PV</Related>
0571 <Related>NPER</Related>
0572 <Related>PMT</Related>
0573 <Related>RATE</Related>
0574 </Help>
0575 </Function>
0576
0577 <Function>
0578 <Name>FV_ANNUITY</Name>
0579 <Type>Float</Type>
0580 <Parameter>
0581 <Comment>Payment per period</Comment>
0582 <Type>Float</Type>
0583 </Parameter>
0584 <Parameter>
0585 <Comment>Interest rate</Comment>
0586 <Type>Float</Type>
0587 </Parameter>
0588 <Parameter>
0589 <Comment>Periods</Comment>
0590 <Type>Float</Type>
0591 </Parameter>
0592 <Help>
0593 <Text>The FV_ANNUITY() function returns the future value of a stream of payments given the amount of the payment, the interest rate and the number of periods. For example: If you receive $500 per year for 20 years, and invest it at 8%, the total after 20 years will be FV_annuity(500;0.08;20) or $22,880.98. This function assumes that payments are made at the end of each period.</Text>
0594 <Syntax>FV_ANNUITY(amount;interest;periods)</Syntax>
0595 <Example>FV_ANNUITY(1000;0.05;5) equals 5525.63</Example>
0596 </Help>
0597 </Function>
0598
0599
0600 <Function>
0601 <Name>INTRATE</Name>
0602 <Type>Float</Type>
0603 <Parameter>
0604 <Comment>Settlement</Comment>
0605 <Type>Date</Type>
0606 </Parameter>
0607 <Parameter>
0608 <Comment>Maturity</Comment>
0609 <Type>Date</Type>
0610 </Parameter>
0611 <Parameter>
0612 <Comment>Investment</Comment>
0613 <Type>Float</Type>
0614 </Parameter>
0615 <Parameter>
0616 <Comment>Redemption</Comment>
0617 <Type>Float</Type>
0618 </Parameter>
0619 <Parameter optional="true">
0620 <Comment>Day counting basis</Comment>
0621 <Type>Int</Type>
0622 </Parameter>
0623 <Help>
0624 <Text>The INTRATE function returns the interest rate for a fully invested security. Basis is the type of day counting you want to use: 0: US 30/360 (default), 1: real days, 2: real days/360, 3: real days/365 or 4: European 30/360.</Text>
0625 <Syntax>INTRATE(settlement; maturity; investment; redemption; basis)</Syntax>
0626 <Example>INTRATE("2/28/2001"; "8/31/2001"; 1000000; 2000000; 1) returns 1.98</Example>
0627 </Help>
0628 </Function>
0629
0630 <Function>
0631 <Name>IPMT</Name>
0632 <Type>Float</Type>
0633 <Parameter>
0634 <Comment>Rate</Comment>
0635 <Type>Float</Type>
0636 </Parameter>
0637 <Parameter>
0638 <Comment>Period</Comment>
0639 <Type>Float</Type>
0640 </Parameter>
0641 <Parameter>
0642 <Comment>Number of periods</Comment>
0643 <Type>Float</Type>
0644 </Parameter>
0645 <Parameter>
0646 <Comment>Present values</Comment>
0647 <Type>Float</Type>
0648 </Parameter>
0649 <Parameter>
0650 <Comment>Future value (optional)</Comment>
0651 <Type>Float</Type>
0652 </Parameter>
0653 <Parameter>
0654 <Comment>Type (optional)</Comment>
0655 <Type>Int</Type>
0656 </Parameter>
0657 <Help>
0658 <Text>IPMT calculates the amount of a payment of an annuity going towards interest.</Text>
0659 <Text>Rate is the periodic interest rate.</Text>
0660 <Text>Period is the amortizement period. 1 for the first and NPER for the last period.</Text>
0661 <Text>NPER is the total number of periods during which annuity is paid.</Text>
0662 <Text>PV is the present value in the sequence of payments.</Text>
0663 <Text>FV (optional) is the desired (future) value. default: 0.</Text>
0664 <Text>Type (optional) defines the due date. 1 for payment at the beginning of a period and 0 (default) for payment at the end of a period.</Text>
0665 <Text>The example shows the interest to pay in the last year of a three year loan. The interest rate is 10 percent.</Text>
0666 <Syntax>IPMT(Rate; Period; NPer; PV; FV; Type)</Syntax>
0667 <Example>IPMT(0.1;3;3;8000) equals -292.45</Example>
0668 <Related>PPMT</Related>
0669 <Related>PV</Related>
0670 <Related>PMT</Related>
0671 </Help>
0672 </Function>
0673
0674 <Function>
0675 <Name>IRR</Name>
0676 <Type>Float</Type>
0677 <Parameter>
0678 <Comment>Values</Comment>
0679 <Type>Float</Type>
0680 </Parameter>
0681 <Parameter>
0682 <Comment>Guess</Comment>
0683 <Type>Float</Type>
0684 </Parameter>
0685 <Help>
0686 <Text>The IRR function calculates the internal rate of return for a series of cash flows.</Text>
0687 <Syntax>IRR( Values[; Guess = 0.1 ] )</Syntax>
0688 <Related>XIRR</Related>
0689 </Help>
0690 </Function>
0691
0692 <Function>
0693 <Name>ISPMT</Name>
0694 <Type>Float</Type>
0695 <Parameter>
0696 <Comment>Rate</Comment>
0697 <Type>Float</Type>
0698 </Parameter>
0699 <Parameter>
0700 <Comment>Period</Comment>
0701 <Type>Int</Type>
0702 </Parameter>
0703 <Parameter>
0704 <Comment>Number of periods</Comment>
0705 <Type>Int</Type>
0706 </Parameter>
0707 <Parameter>
0708 <Comment>Present values (PV)</Comment>
0709 <Type>Float</Type>
0710 </Parameter>
0711 <Help>
0712 <Text>Calculates the interest paid on a given period of an investment.</Text>
0713 <Text>Rate is the periodic interest rate.</Text>
0714 <Text>Period is the amortizement period. 1 for the first and NPer for the last period.</Text>
0715 <Text>NPer is the total number of periods during which annuity is paid.</Text>
0716 <Text>PV is the present value in the sequence of payments.</Text>
0717 <Syntax>ISPMT(Rate; Period; NPer; PV)</Syntax>
0718 <Example>ISPMT(0.1; 1; 3; 8000000) equals -533333</Example>
0719 <Related>PV</Related>
0720 <Related>FV</Related>
0721 <Related>NPER</Related>
0722 <Related>PMT</Related>
0723 <Related>RATE</Related>
0724 </Help>
0725 </Function>
0726
0727 <Function>
0728 <Name>LEVEL_COUPON</Name>
0729 <Type>Float</Type>
0730 <Parameter>
0731 <Comment>Face value</Comment>
0732 <Type>Float</Type>
0733 </Parameter>
0734 <Parameter>
0735 <Comment>Coupon rate</Comment>
0736 <Type>Float</Type>
0737 </Parameter>
0738 <Parameter>
0739 <Comment>Coupons per year</Comment>
0740 <Type>Float</Type>
0741 </Parameter>
0742 <Parameter>
0743 <Comment>Years</Comment>
0744 <Type>Float</Type>
0745 </Parameter>
0746 <Parameter>
0747 <Comment>Market interest rate</Comment>
0748 <Type>Float</Type>
0749 </Parameter>
0750 <Help>
0751 <Text>The LEVEL_COUPON() function calculates the value of a level-coupon bond. For example: if the interest rate is 10%, a $1000 bond with semi-annual coupons at a rate of 13% that matures in 4 years is worth LEVEL_COUPON(1000;.13;2;4;.1) or $1096.95.</Text>
0752 <Syntax>LEVEL_COUPON(face value;coupon rate;coupons per year;years;market rate)</Syntax>
0753 <Example>LEVEL_COUPON(1000;.13;2;4;.1) equals 1096.95</Example>
0754 </Help>
0755 </Function>
0756
0757 <Function>
0758 <Name>MDURATION</Name>
0759 <Type>Float</Type>
0760 <Parameter>
0761 <Comment>Settlement</Comment>
0762 <Type>Float</Type>
0763 </Parameter>
0764 <Parameter>
0765 <Comment>Maturity</Comment>
0766 <Type>Float</Type>
0767 </Parameter>
0768 <Parameter>
0769 <Comment>Coupon</Comment>
0770 <Type>Float</Type>
0771 </Parameter>
0772 <Parameter>
0773 <Comment>Yield</Comment>
0774 <Type>Float</Type>
0775 </Parameter>
0776 <Parameter>
0777 <Comment>Frequency</Comment>
0778 <Type>Float</Type>
0779 </Parameter>
0780 <Parameter>
0781 <Comment>Basis</Comment>
0782 <Type>Int</Type>
0783 </Parameter>
0784 <Help>
0785 <Text>The MDURATION() function will calculate the modified Macauley duration of a fixed interest security in years.</Text>
0786 <Syntax>MDURATION( Settlement; Maturity; Coupon; Yield; Frequency; [ Basis=0 ])</Syntax>
0787 <Example>MDURATION("2004-02-01"; "2004-05-31"; 0.08; 0.09; 2; 0) returns 0.316321106</Example>
0788 <Related>DURATION</Related>
0789 </Help>
0790 </Function>
0791
0792 <Function>
0793 <Name>MIRR</Name>
0794 <Type>Float</Type>
0795 <Parameter>
0796 <Comment>Values</Comment>
0797 <Type>Float</Type>
0798 </Parameter>
0799 <Parameter>
0800 <Comment>Investment</Comment>
0801 <Type>Float</Type>
0802 </Parameter>
0803 <Parameter>
0804 <Comment>Reinvestment</Comment>
0805 <Type>Float</Type>
0806 </Parameter>
0807 <Help>
0808 <Text>The MIRR() function will calculate the modified internal rate of return (IRR) of a series of periodic investments.</Text>
0809 <Syntax>MIRR(values; investment; reinvestment)</Syntax>
0810 <Example>MIRR({100;200;-50;300;-200}, 5%, 6%) equals 34.2823387842%</Example>
0811 <Related>IRR</Related>
0812 </Help>
0813 </Function>
0814
0815 <Function>
0816 <Name>NOMINAL</Name>
0817 <Type>Float</Type>
0818 <Parameter>
0819 <Comment>Effective interest rate</Comment>
0820 <Type>Float</Type>
0821 </Parameter>
0822 <Parameter>
0823 <Comment>Periods</Comment>
0824 <Type>Float</Type>
0825 </Parameter>
0826 <Help>
0827 <Text>The NOMINAL() function calculates the nominal (stated) interest rate for an effective (annualized) interest rate compounded at given intervals. For example: to earn 8% on an account compounded monthly, you need a return of NOMINAL(.08;12) or 7.72%.</Text>
0828 <Syntax>NOMINAL(effective;periods)</Syntax>
0829 <Example>NOMINAL(0.08;12) equals 0.0772</Example>
0830 <Related>EFFECT</Related>
0831 </Help>
0832 </Function>
0833
0834 <Function>
0835 <Name>NPER</Name>
0836 <Type>Float</Type>
0837 <Parameter>
0838 <Comment>Rate</Comment>
0839 <Type>Float</Type>
0840 </Parameter>
0841 <Parameter>
0842 <Comment>Payment</Comment>
0843 <Type>Float</Type>
0844 </Parameter>
0845 <Parameter>
0846 <Comment>Present value (PV)</Comment>
0847 <Type>Float</Type>
0848 </Parameter>
0849 <Parameter>
0850 <Comment>Future value (FV - optional)</Comment>
0851 <Type>Float</Type>
0852 </Parameter>
0853 <Parameter>
0854 <Comment>Type (optional)</Comment>
0855 <Type>Int</Type>
0856 </Parameter>
0857 <Help>
0858 <Text>Returns the number of periods of an investment.</Text>
0859 <Syntax>NPER(rate;payment;pv;fv;type)</Syntax>
0860 <Example>NPER(0.1; -100; 1000) equals 11</Example>
0861 <Example>NPER(0.06; 0; -10000; 20000 ;0) returns 11.906</Example>
0862 <Related>FV</Related>
0863 <Related>RATE</Related>
0864 <Related>PMT</Related>
0865 <Related>PV</Related>
0866 </Help>
0867 </Function>
0868
0869 <Function>
0870 <Name>NPV</Name>
0871 <Type>Float</Type>
0872 <Parameter>
0873 <Comment>Rate</Comment>
0874 <Type>Float</Type>
0875 </Parameter>
0876 <Parameter>
0877 <Comment>Values (array)</Comment>
0878 <Type>Float</Type>
0879 </Parameter>
0880 <Help>
0881 <Text>The net present value (NPV) for a series of periodic cash flows.</Text>
0882 <!--FIXME remove wordwrap, leads to strange looking translation messages-->
0883 <Text>Computes the net present value for a series of periodic cash flows with the
0884 discount rate Rate. Values should be positive if they are received as income, and
0885 negative if the amounts are expenditure.</Text>
0886 <Syntax>NPV(Rate; Values)</Syntax>
0887 <Example>NPV(100%;4;5;7) = 4.125</Example>
0888 <Related>FV</Related>
0889 <Related>IRR</Related>
0890 <Related>NPER</Related>
0891 <Related>PMT</Related>
0892 <Related>PV</Related>
0893 </Help>
0894 </Function>
0895
0896 <Function>
0897 <Name>ODDLPRICE</Name>
0898 <Type>Float</Type>
0899 <Parameter>
0900 <Comment>Settlement</Comment>
0901 <Type>Date</Type>
0902 </Parameter>
0903 <Parameter>
0904 <Comment>Maturity</Comment>
0905 <Type>Date</Type>
0906 </Parameter>
0907 <Parameter>
0908 <Comment>Last</Comment>
0909 <Type>Date</Type>
0910 </Parameter>
0911 <Parameter>
0912 <Comment>Rate</Comment>
0913 <Type>Float</Type>
0914 </Parameter>
0915 <Parameter>
0916 <Comment>AnnualYield</Comment>
0917 <Type>Float</Type>
0918 </Parameter>
0919 <Parameter>
0920 <Comment>Redemption</Comment>
0921 <Type>Float</Type>
0922 </Parameter>
0923 <Parameter>
0924 <Comment>Frequency</Comment>
0925 <Type>Float</Type>
0926 </Parameter>
0927 <Parameter>
0928 <Comment>Basis</Comment>
0929 <Type>Int</Type>
0930 </Parameter>
0931 <Help>
0932 <Text>The ODDLPRICE function calculates the value of the security per 100 currency units of face value. The security has an irregular last interest date.</Text>
0933 <Syntax>ODDLPRICE( Settlement; Maturity; Last; Rate; AnnualYield; Redemption; Frequency [; Basis = 0 ] )</Syntax>
0934 <Example>ODDLPRICE(DATE(1990;6;1);DATE(1995;12;31);DATE(1990;1;1);3%;5%;100;2) returns 90.991042345</Example>
0935 <Related>ODDFPRICE</Related>
0936 </Help>
0937 </Function>
0938
0939 <Function>
0940 <Name>ODDLYIELD</Name>
0941 <Type>Float</Type>
0942 <Parameter>
0943 <Comment>Settlement</Comment>
0944 <Type>Date</Type>
0945 </Parameter>
0946 <Parameter>
0947 <Comment>Maturity</Comment>
0948 <Type>Date</Type>
0949 </Parameter>
0950 <Parameter>
0951 <Comment>Last</Comment>
0952 <Type>Date</Type>
0953 </Parameter>
0954 <Parameter>
0955 <Comment>Rate</Comment>
0956 <Type>Float</Type>
0957 </Parameter>
0958 <Parameter>
0959 <Comment>Price</Comment>
0960 <Type>Float</Type>
0961 </Parameter>
0962 <Parameter>
0963 <Comment>Redemption</Comment>
0964 <Type>Float</Type>
0965 </Parameter>
0966 <Parameter>
0967 <Comment>Frequency</Comment>
0968 <Type>Float</Type>
0969 </Parameter>
0970 <Parameter>
0971 <Comment>Basis</Comment>
0972 <Type>Int</Type>
0973 </Parameter>
0974 <Help>
0975 <Text>The ODDLYIELD function calculates the yield of the security which has an irregular last interest date.</Text>
0976 <Syntax>ODDLYIELD( Settlement; Maturity; Last; Rate; Price; Redemption; Frequency [; Basis = 0 ] )</Syntax>
0977 <Example>ODDLYIELD(DATE(1990;6;1);DATE(1995;12;31);DATE(1990;1;1);3%;91;100;2) returns 4.997775351</Example>
0978 <Related>ODDLPRICE</Related>
0979 <Related>ODDFYIELD</Related>
0980 </Help>
0981 </Function>
0982
0983 <Function>
0984 <Name>PMT</Name>
0985 <Type>Float</Type>
0986 <Parameter>
0987 <Comment>Rate</Comment>
0988 <Type>Float</Type>
0989 </Parameter>
0990 <Parameter>
0991 <Comment>Number of periods (NPer)</Comment>
0992 <Type>Float</Type>
0993 </Parameter>
0994 <Parameter>
0995 <Comment>Present value (PV)</Comment>
0996 <Type>Float</Type>
0997 </Parameter>
0998 <Parameter>
0999 <Comment>Future value (FV - optional)</Comment>
1000 <Type>Float</Type>
1001 </Parameter>
1002 <Parameter>
1003 <Comment>Type (optional)</Comment>
1004 <Type>Int</Type>
1005 </Parameter>
1006 <Help>
1007 <Text>PMT returns the amount of payment for a loan based on a constant interest rate and constant payments (each payment is equal amount).</Text>
1008 <Syntax>PMT(rate; nper ; pv [; fv = 0 [; type = 0 ]] )</Syntax>
1009 <Example>PMT(0.1; 4; 10000) equals -3154.71</Example>
1010 <Related>NPER</Related>
1011 <Related>IPMT</Related>
1012 <Related>PPMT</Related>
1013 <Related>PV</Related>
1014 </Help>
1015 </Function>
1016
1017 <Function>
1018 <Name>PPMT</Name>
1019 <Type>Float</Type>
1020 <Parameter>
1021 <Comment>Rate</Comment>
1022 <Type>Float</Type>
1023 </Parameter>
1024 <Parameter>
1025 <Comment>Period</Comment>
1026 <Type>Float</Type>
1027 </Parameter>
1028 <Parameter>
1029 <Comment>Number of periods</Comment>
1030 <Type>Float</Type>
1031 </Parameter>
1032 <Parameter>
1033 <Comment>Present value</Comment>
1034 <Type>Float</Type>
1035 </Parameter>
1036 <Parameter>
1037 <Comment>Future value (optional)</Comment>
1038 <Type>Float</Type>
1039 </Parameter>
1040 <Parameter>
1041 <Comment>Type (optional)</Comment>
1042 <Type>Int</Type>
1043 </Parameter>
1044 <Help>
1045 <Text>PPMT calculates the amount of a payment of an annuity going towards principal.</Text>
1046 <Text>Rate is the periodic interest rate.</Text>
1047 <Text>Period is the amortizement period. 1 for the first and NPER for the last period.</Text>
1048 <Text>NPER is the total number of periods during which annuity is paid.</Text>
1049 <Text>PV is the present value in the sequence of payments.</Text>
1050 <Text>FV (optional) is the desired (future) value. default: 0.</Text>
1051 <Text>Type (optional) defines the due date. 1 for payment at the beginning of a period and 0 (default) for payment at the end of a period.</Text>
1052 <Syntax>PPMT(Rate; Period; NPer; PV [; FV = 9 [; Type = 0 ]] )</Syntax>
1053 <Example>PPMT(0.0875;1;36;5000;8000;1) equals -18.48</Example>
1054 <Related>IPMT</Related>
1055 <Related>PMT</Related>
1056 <Related>PV</Related>
1057 </Help>
1058 </Function>
1059
1060 <Function>
1061 <Name>PRICEMAT</Name>
1062 <Type>Float</Type>
1063 <Parameter>
1064 <Comment>Settlement</Comment>
1065 <Type>Date</Type>
1066 </Parameter>
1067 <Parameter>
1068 <Comment>Maturity</Comment>
1069 <Type>Date</Type>
1070 </Parameter>
1071 <Parameter>
1072 <Comment>Issue</Comment>
1073 <Type>Date</Type>
1074 </Parameter>
1075 <Parameter>
1076 <Comment>Discount rate</Comment>
1077 <Type>Float</Type>
1078 </Parameter>
1079 <Parameter>
1080 <Comment>Yield</Comment>
1081 <Type>Float</Type>
1082 </Parameter>
1083 <Parameter>
1084 <Comment>Basis</Comment>
1085 <Type>Int</Type>
1086 </Parameter>
1087 <Help>
1088 <Text>PRICEMAT Calculate the price per 100 currency units of face value of the security that pays interest on the maturity date.</Text>
1089 <Text>Basis Calculation method</Text>
1090 <Text> 0 US method, 12 months, each month with 30 days</Text>
1091 <Text> 1 Actual number of days in year, actual number of days in months </Text>
1092 <Text> 2 360 days in a year, actual number of days in months</Text>
1093 <Text> 4 365 days in a year, actual number of days in months</Text>
1094 <Text> 5 European method, 12 months, each month has 30 days</Text>
1095 <Syntax>PRICEMAT(settlement; maturity; issue; rate; yield [; basis = 0 ] )</Syntax>
1096 <Example>PRICEMAT(DATE(1990;6;1);DATE(1995;12;31);DATE(1990;1;1);6%;5%) returns 103.819218241</Example>
1097 <Related>PRICEDISC</Related>
1098 </Help>
1099 </Function>
1100
1101
1102 <Function>
1103 <Name>PV</Name>
1104 <Type>Float</Type>
1105 <Parameter>
1106 <Comment>Future value</Comment>
1107 <Type>Float</Type>
1108 </Parameter>
1109 <Parameter>
1110 <Comment>Interest rate</Comment>
1111 <Type>Float</Type>
1112 </Parameter>
1113 <Parameter>
1114 <Comment>Periods</Comment>
1115 <Type>Float</Type>
1116 </Parameter>
1117 <Help>
1118 <Text>The PV() function returns the present value of an investment -- the value today of a sum of money in the future, given the rate of interest or inflation. For example if you need $1166.40 for your new computer and you want to buy it in two years while earning 8% interest, you need to start with PV(1166.4;0.08;2) or $1000.</Text>
1119 <Syntax>PV(future value;rate;periods)</Syntax>
1120 <Example>PV(1166.4;0.08;2) equals 1000</Example>
1121 </Help>
1122 </Function>
1123
1124 <Function>
1125 <Name>PV_ANNUITY</Name>
1126 <Type>Float</Type>
1127 <Parameter>
1128 <Comment>Payment per period</Comment>
1129 <Type>Float</Type>
1130 </Parameter>
1131 <Parameter>
1132 <Comment>Interest rate</Comment>
1133 <Type>Float</Type>
1134 </Parameter>
1135 <Parameter>
1136 <Comment>Periods</Comment>
1137 <Type>Float</Type>
1138 </Parameter>
1139 <Help>
1140 <Text>The PV_ANNUITY() function returns the present value of an annuity or stream of payments. For example: a "million dollar" lottery ticket that pays $50,000 a year for 20 years, with an interest rate of 5%, is actually worth PV_ANNUITY(50000;0.05;20) or $623,111. This function assumes that payments are made at the end of each period.</Text>
1141 <Syntax>PV_ANNUITY(amount;interest;periods)</Syntax>
1142 <Example>PV_ANNUITY(1000;0.05;5) equals 4329.48</Example>
1143 </Help>
1144 </Function>
1145
1146 <Function>
1147 <Name>RATE</Name>
1148 <Type>Float</Type>
1149 <Parameter>
1150 <Comment>Payment period</Comment>
1151 <Type>Float</Type>
1152 </Parameter>
1153 <Parameter>
1154 <Comment>Regular payments</Comment>
1155 <Type>Float</Type>
1156 </Parameter>
1157 <Parameter>
1158 <Comment>Present value</Comment>
1159 <Type>Float</Type>
1160 </Parameter>
1161 <Parameter>
1162 <Comment>Future value</Comment>
1163 <Type>Float</Type>
1164 </Parameter>
1165 <Parameter>
1166 <Comment>Type</Comment>
1167 <Type>Float</Type>
1168 </Parameter>
1169 <Parameter>
1170 <Comment>Guess</Comment>
1171 <Type>Float</Type>
1172 </Parameter>
1173 <Help>
1174 <Text>The RATE() function computes the constant interest rate per period of an investment.</Text>
1175 <Syntax>RATE(nper;pmt;pv;fv;type;guess)</Syntax>
1176 <Example>RATE(4*12;-200;8000) equals 0.007701472</Example>
1177 </Help>
1178 </Function>
1179
1180 <Function>
1181 <Name>RECEIVED</Name>
1182 <Type>Float</Type>
1183 <Parameter>
1184 <Comment>Settlement</Comment>
1185 <Type>Date</Type>
1186 </Parameter>
1187 <Parameter>
1188 <Comment>Maturity</Comment>
1189 <Type>Date</Type>
1190 </Parameter>
1191 <Parameter>
1192 <Comment>Investment</Comment>
1193 <Type>Float</Type>
1194 </Parameter>
1195 <Parameter>
1196 <Comment>Discount rate</Comment>
1197 <Type>Float</Type>
1198 </Parameter>
1199 <Parameter optional="true">
1200 <Comment>Basis</Comment>
1201 <Type>Int</Type>
1202 </Parameter>
1203 <Help>
1204 <Text>The RECEIVED function returns the amount received at the maturity date for a invested security. Basis is the type of day counting you want to use: 0: US 30/360 (default), 1: real days, 2: real days/360, 3: real days/365 or 4: European 30/360. The settlement date must be before maturity date.</Text>
1205 <Syntax>RECEIVED(settlement; maturity; investment; discount; basis)</Syntax>
1206 <Example>RECEIVED("2/28/2001"; "8/31/2001"; 1000; 0.05; 0) returns 1,025.787</Example>
1207 </Help>
1208 </Function>
1209
1210 <Function>
1211 <Name>RRI</Name>
1212 <Type>Float</Type>
1213 <Parameter>
1214 <Comment>P</Comment>
1215 <Type>Int</Type>
1216 </Parameter>
1217 <Parameter>
1218 <Comment>Pv</Comment>
1219 <Type>Float</Type>
1220 </Parameter>
1221 <Parameter>
1222 <Comment>Fv</Comment>
1223 <Type>Float</Type>
1224 </Parameter>
1225 <Help>
1226 <Text>The RRI function calculates the interest rate resulting from the profit (return) of an investment.</Text>
1227 <Syntax>RRI( P; Pv; Fv)</Syntax>
1228 <Example>RRI(1;100;200) returns 1</Example>
1229 <Related>FV</Related>
1230 <Related>NPER</Related>
1231 <Related>PMT</Related>
1232 <Related>PV</Related>
1233 <Related>RATE</Related>
1234 </Help>
1235 </Function>
1236
1237 <Function>
1238 <Name>SLN</Name>
1239 <Type>Float</Type>
1240 <Parameter>
1241 <Comment>Cost</Comment>
1242 <Type>Float</Type>
1243 </Parameter>
1244 <Parameter>
1245 <Comment>Salvage</Comment>
1246 <Type>Float</Type>
1247 </Parameter>
1248 <Parameter>
1249 <Comment>Life</Comment>
1250 <Type>Float</Type>
1251 </Parameter>
1252 <Help>
1253 <Text>The SLN() function will determine the straight line depreciation of an asset for a single period. Cost is the amount you paid for the asset. Salvage is the value of the asset at the end of the period. Life is the number of periods over which the asset is depreciated. SLN divides the cost evenly over the life of an asset.</Text>
1254 <Syntax>SLN(cost; salvage value; life)</Syntax>
1255 <Example>SLN(10000;700;10) equals 930</Example>
1256 <Related>SYD</Related>
1257 <Related>DDB</Related>
1258 </Help>
1259 </Function>
1260
1261 <Function>
1262 <Name>SYD</Name>
1263 <Type>Float</Type>
1264 <Parameter>
1265 <Comment>Cost</Comment>
1266 <Type>Float</Type>
1267 </Parameter>
1268 <Parameter>
1269 <Comment>Salvage</Comment>
1270 <Type>Float</Type>
1271 </Parameter>
1272 <Parameter>
1273 <Comment>Life</Comment>
1274 <Type>Float</Type>
1275 </Parameter>
1276 <Parameter>
1277 <Comment>Period</Comment>
1278 <Type>Float</Type>
1279 </Parameter>
1280 <Help>
1281 <Text>The SYD() function will calculate the sum-of-years digits depreciation for an asset based on its cost, salvage value, anticipated life, and a particular period. This method accelerates the rate of the depreciation, so that more depreciation expense occurs in earlier periods than in later ones. The depreciable cost is the actual cost minus the salvage value. The useful life is the number of periods (typically years) over which the asset is depreciated.</Text>
1282 <Syntax>SYD(cost; salvage value; life; period)</Syntax>
1283 <Example>SYD(5000; 200; 5; 2) equals 1280</Example>
1284 <Related>SLN</Related>
1285 <Related>DDB</Related>
1286 </Help>
1287 </Function>
1288
1289 <Function>
1290 <Name>TBILLEQ</Name>
1291 <Type>Float</Type>
1292 <Parameter>
1293 <Comment>Settlement</Comment>
1294 <Type>Date</Type>
1295 </Parameter>
1296 <Parameter>
1297 <Comment>Maturity</Comment>
1298 <Type>Date</Type>
1299 </Parameter>
1300 <Parameter>
1301 <Comment>Discount rate</Comment>
1302 <Type>Float</Type>
1303 </Parameter>
1304 <Help>
1305 <Text>The TBILLEQ functions returns the bond equivalent for a treasury bill. The maturity date must be after the settlement date but within 365 days.</Text>
1306 <Syntax>TBILLEQ(settlement; maturity; discount)</Syntax>
1307 <Example>TBILLEQ("2/28/2001"; "8/31/2001"; 0.1) returns 0.1068</Example>
1308 <Related>TBILLPRICE</Related>
1309 <Related>TBILLYIELD</Related>
1310 </Help>
1311 </Function>
1312
1313 <Function>
1314 <Name>TBILLPRICE</Name>
1315 <Type>Float</Type>
1316 <Parameter>
1317 <Comment>Settlement</Comment>
1318 <Type>Date</Type>
1319 </Parameter>
1320 <Parameter>
1321 <Comment>Maturity</Comment>
1322 <Type>Date</Type>
1323 </Parameter>
1324 <Parameter>
1325 <Comment>Discount rate</Comment>
1326 <Type>Float</Type>
1327 </Parameter>
1328 <Help>
1329 <Text>The TBILLPRICE functions returns the price per $100 value for a treasury bill. The maturity date must be after the settlement date but within 365 days. The discount rate must be positive.</Text>
1330 <Syntax>TBILLPRICE(settlement; maturity; discount)</Syntax>
1331 <Example>TBILLPRICE("2/28/2001"; "8/31/2001"; 0.05) returns 97.4444</Example>
1332 <Related>TBILLEQ</Related>
1333 <Related>TBILLYIELD</Related>
1334 </Help>
1335 </Function>
1336
1337 <Function>
1338 <Name>TBILLYIELD</Name>
1339 <Type>Float</Type>
1340 <Parameter>
1341 <Comment>Settlement</Comment>
1342 <Type>Date</Type>
1343 </Parameter>
1344 <Parameter>
1345 <Comment>Maturity</Comment>
1346 <Type>Date</Type>
1347 </Parameter>
1348 <Parameter>
1349 <Comment>Price per $100 face value</Comment>
1350 <Type>Float</Type>
1351 </Parameter>
1352 <Help>
1353 <Text>The TBILLYIELD functions returns the yield for a treasury bill. The maturity date must be after the settlement date but within 365 days. The price must be positive.</Text>
1354 <Syntax>TBILLYIELD(settlement; maturity; price)</Syntax>
1355 <Example>TBILLYIELD("2/28/2001"; "8/31/2001"; 600) returns -1.63</Example>
1356 <Related>TBILLEQ</Related>
1357 <Related>TBILLPRICE</Related>
1358 </Help>
1359 </Function>
1360
1361 <Function>
1362 <Name>VDB</Name>
1363 <Type>Float</Type>
1364 <Parameter>
1365 <Comment>Settlement</Comment>
1366 <Type>Date</Type>
1367 </Parameter>
1368 <Parameter>
1369 <Comment>Maturity</Comment>
1370 <Type>Date</Type>
1371 </Parameter>
1372 <Parameter>
1373 <Comment>Price</Comment>
1374 <Type>Float</Type>
1375 </Parameter>
1376 <Parameter>
1377 <Comment>Redemption</Comment>
1378 <Type>Float</Type>
1379 </Parameter>
1380 <Parameter>
1381 <Comment>Basis</Comment>
1382 <Type>Int</Type>
1383 </Parameter>
1384 <Help>
1385 <Text>VDB calculates the depreciation allowance of an asset with an initial value, an expected useful life, and a final value of salvage for a period specified, using the variable-rate declining balance method.</Text>
1386 <Syntax>VDB(cost; salvage; life; start-period; end-period; [; depreciation-factor = 2 [; switch = false ]] )</Syntax>
1387 <Example>VDB(10000;600;10;0;0.875;1.5) returns 1312.5</Example>
1388 </Help>
1389 </Function>
1390
1391 <Function>
1392 <Name>XIRR</Name>
1393 <Type>Float</Type>
1394 <Parameter>
1395 <Comment>Values</Comment>
1396 <Type>Float</Type>
1397 </Parameter>
1398 <Parameter>
1399 <Comment>Dates</Comment>
1400 <Type>Date</Type>
1401 </Parameter>
1402 <Parameter>
1403 <Comment>Guess</Comment>
1404 <Type>Float</Type>
1405 </Parameter>
1406 <Help>
1407 <Text>The XIRR function calculates the internal rate of return for a non-periodic series of cash flows.</Text>
1408 <Syntax>XIRR( Values; Dates[; Guess = 0.1 ] )</Syntax>
1409 <Example>XIRR(B1:B4;C1:C4) Suppose B1:B4 contains -20000, 4000, 12000, 8000 while C1:C4 contains "=DATE(2000;1;1)", "=DATE(2000;6;1)", "=DATE(2000;12;30)", "=DATE(2001;3;1)" returns 0.2115964</Example>
1410 <Related>IRR</Related>
1411 </Help>
1412 </Function>
1413
1414 <Function>
1415 <Name>XNPV</Name>
1416 <Type>Float</Type>
1417 <Parameter>
1418 <Comment>Rate</Comment>
1419 <Type>Float</Type>
1420 </Parameter>
1421 <Parameter>
1422 <Comment>Values</Comment>
1423 <Type>Float</Type>
1424 </Parameter>
1425 <Parameter>
1426 <Comment>Dates</Comment>
1427 <Type>Date</Type>
1428 </Parameter>
1429 <Help>
1430 <Text>The XNPV function calculates the net present value of a series of cash flows.</Text>
1431 <Syntax>XNPV( Rate; Values; Dates )</Syntax>
1432 <Example>XNPV(5%;B1:B4;C1:C4) suppose B1:B4 contains -20000, 4000, 12000, 8000 while C1:C4 contains "=DATE(2000;1;1)", "=DATE(2000;6;1)", "=DATE(2000;12;30)", "=DATE(2001;3;1)" returns 2907.83187</Example>
1433 <Related>NPV</Related>
1434 </Help>
1435 </Function>
1436
1437 <Function>
1438 <Name>YIELDDISC</Name>
1439 <Type>Float</Type>
1440 <Parameter>
1441 <Comment>Settlement</Comment>
1442 <Type>Date</Type>
1443 </Parameter>
1444 <Parameter>
1445 <Comment>Maturity</Comment>
1446 <Type>Date</Type>
1447 </Parameter>
1448 <Parameter>
1449 <Comment>Price</Comment>
1450 <Type>Float</Type>
1451 </Parameter>
1452 <Parameter>
1453 <Comment>Redemption</Comment>
1454 <Type>Float</Type>
1455 </Parameter>
1456 <Parameter>
1457 <Comment>Basis</Comment>
1458 <Type>Int</Type>
1459 </Parameter>
1460 <Help>
1461 <Text>YIELDDISC calculates the yield of a discounted security per 100 currency units of face value.</Text>
1462 <Syntax>YIELDDISC(settlement; maturity; price, redemp, basis)</Syntax>
1463 <Example>YIELDDISC(DATE(1990;6;1);DATE(1990;12;31);941.66667;1000) returns 0.106194684</Example>
1464 </Help>
1465 </Function>
1466
1467 <Function>
1468 <Name>YIELDMAT</Name>
1469 <Type>Float</Type>
1470 <Parameter>
1471 <Comment>Settlement</Comment>
1472 <Type>Date</Type>
1473 </Parameter>
1474 <Parameter>
1475 <Comment>Maturity</Comment>
1476 <Type>Date</Type>
1477 </Parameter>
1478 <Parameter>
1479 <Comment>Issue</Comment>
1480 <Type>Date</Type>
1481 </Parameter>
1482 <Parameter>
1483 <Comment>Discount rate</Comment>
1484 <Type>Float</Type>
1485 </Parameter>
1486 <Parameter>
1487 <Comment>Price</Comment>
1488 <Type>Float</Type>
1489 </Parameter>
1490 <Parameter>
1491 <Comment>Basis</Comment>
1492 <Type>Int</Type>
1493 </Parameter>
1494 <Help>
1495 <Text>The YIELDMAT function calculates the yield of the security that pays interest on the maturity date.</Text>
1496 <Syntax>YIELDMAT( Settlement; Maturity; Issue; Rate; Price; Basis )</Syntax>
1497 <Example>YIELDMAT(DATE(1990;6;1);DATE(1995;12;31);DATE(1990; 1; 1); 6%;103.819218241) returns 0.050000000</Example>
1498 <Related>PRICE</Related>
1499 <Related>YIELD</Related>
1500 <Related>YIELDDISC</Related>
1501 </Help>
1502 </Function>
1503
1504 <Function>
1505 <Name>ZERO_COUPON</Name>
1506 <Type>Float</Type>
1507 <Parameter>
1508 <Comment>Face value</Comment>
1509 <Type>Float</Type>
1510 </Parameter>
1511 <Parameter>
1512 <Comment>Interest rate</Comment>
1513 <Type>Float</Type>
1514 </Parameter>
1515 <Parameter>
1516 <Comment>Years</Comment>
1517 <Type>Float</Type>
1518 </Parameter>
1519 <Help>
1520 <Text>The ZERO_COUPON() function calculates the value of a zero-coupon (pure discount) bond. For example: if the interest rate is 10%, a $1000 bond that matures in 20 years is worth ZERO_COUPON(1000;.1;20) or $148.64.</Text>
1521 <Syntax>ZERO_COUPON(face value;rate;years)</Syntax>
1522 <Example>ZERO_COUPON(1000;.1;20) equals 148.64</Example>
1523 </Help>
1524 </Function>
1525
1526 </Group>
1527 </KSpreadFunctions>