Warning, /office/calligra/doc/sheets/functions.docbook is written in an unsupported language. File is not indexed.
0001 <chapter id="functions">
0002 <!--
0003 *************************** DO NOT EDIT MANUALLY ************************
0004
0005 This file is autogenerated from *.xml files in calligra/tables/functions/
0006 all changes will be overwritten on the next script run
0007 -->
0008 <title>Functions</title>
0009 <para>&sheets; has a huge range of built in mathematical and other functions that can be used in a formula cell.</para>
0010 <sect1 id="supported-functions">
0011 <title>Supported Functions</title>
0012 <para>This chapter holds a brief overview of all supported functions in the following groups:</para>
0013 <simplelist>
0014 <member><link linkend="Bit-Operations">Bit Operations</link> </member>
0015 <member><link linkend="Conversion">Conversion</link> </member>
0016 <member><link linkend="Database">Database</link> </member>
0017 <member><link linkend="Date---Time">Date & Time</link> </member>
0018 <member><link linkend="Engineering">Engineering</link> </member>
0019 <member><link linkend="Financial">Financial</link> </member>
0020 <member><link linkend="Information">Information</link> </member>
0021 <member><link linkend="Logical">Logical</link> </member>
0022 <member><link linkend="Lookup---Reference">Lookup & Reference</link> </member>
0023 <member><link linkend="Math">Math</link> </member>
0024 <member><link linkend="Statistical">Statistical</link> </member>
0025 <member><link linkend="Text">Text</link> </member>
0026 <member><link linkend="Trigonometric">Trigonometric</link> </member>
0027 </simplelist>
0028 <!--
0029 <para>OpenFormula groups (small, medium, and large, more)? Which are supported by Sheets?</para>
0030 <para>Something about interoperablity / spread sheet exchange / known issues, incompabitilites, errors?</para>
0031 -->
0032 <sect2 id="Bit-Operations">
0033 <title>Bit Operations</title>
0034
0035 <sect3 id="BITAND">
0036 <title>BITAND</title>
0037 <para>The BITAND() function performs a bit-wise AND operation for the two integer parameters.</para>
0038 <para><segmentedlist><segtitle>Return type</segtitle>
0039 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
0040 <variablelist>
0041 <varlistentry><term>Syntax</term>
0042 <listitem><para>BITAND(value; value)</para></listitem>
0043 </varlistentry>
0044 <varlistentry><term>Parameters</term>
0045 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0046 <seglistitem><seg>First number</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
0047 <seglistitem><seg>Second number</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
0048 </varlistentry>
0049 <varlistentry><term>Examples</term>
0050 <listitem><para>BITAND(12;10) returns 8 (because decimal 12 is binary 1100, and decimal 10 is binary 1010; and 1100 "anded" with 1010 is 1000, which is integer 8).</para></listitem>
0051 </varlistentry>
0052 <varlistentry><term>Related Functions</term>
0053 <listitem><simplelist>
0054 <member><link linkend="BITOR">BITOR</link> </member>
0055 <member><link linkend="BITXOR">BITXOR</link> </member>
0056 </simplelist></listitem>
0057 </varlistentry>
0058 </variablelist>
0059 </sect3>
0060
0061 <sect3 id="BITLSHIFT">
0062 <title>BITLSHIFT</title>
0063 <para>The BITLSHIFT() function performs a bit-wise left shift operation of the first parameter. The number of bits to shift by is specified by the second parameter. Note that a negative number of bits to left shift by becomes a right shift. </para>
0064 <para><segmentedlist><segtitle>Return type</segtitle>
0065 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
0066 <variablelist>
0067 <varlistentry><term>Syntax</term>
0068 <listitem><para>BITLSHIFT(value; shift size)</para></listitem>
0069 </varlistentry>
0070 <varlistentry><term>Parameters</term>
0071 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0072 <seglistitem><seg>First number</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
0073 <seglistitem><seg>Amount to left shift by</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
0074 </varlistentry>
0075 <varlistentry><term>Related Functions</term>
0076 <listitem><simplelist>
0077 <member><link linkend="BITLSHIFT">BITLSHIFT</link> </member>
0078 </simplelist></listitem>
0079 </varlistentry>
0080 </variablelist>
0081 </sect3>
0082
0083 <sect3 id="BITOR">
0084 <title>BITOR</title>
0085 <para>The BITOR() function performs a bit-wise OR operation for the two integer parameters. </para>
0086 <para><segmentedlist><segtitle>Return type</segtitle>
0087 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
0088 <variablelist>
0089 <varlistentry><term>Syntax</term>
0090 <listitem><para>BITOR(value; value)</para></listitem>
0091 </varlistentry>
0092 <varlistentry><term>Parameters</term>
0093 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0094 <seglistitem><seg>First number</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
0095 <seglistitem><seg>Second number</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
0096 </varlistentry>
0097 <varlistentry><term>Examples</term>
0098 <listitem><para>BITOR(12;10) returns 14 (because decimal 12 is binary 1100, and decimal 10 is binary 1010; and 1100 "ored" with 1010 is 1110, which is integer 14).</para></listitem>
0099 </varlistentry>
0100 <varlistentry><term>Related Functions</term>
0101 <listitem><simplelist>
0102 <member><link linkend="BITAND">BITAND</link> </member>
0103 <member><link linkend="BITXOR">BITXOR</link> </member>
0104 </simplelist></listitem>
0105 </varlistentry>
0106 </variablelist>
0107 </sect3>
0108
0109 <sect3 id="BITRSHIFT">
0110 <title>BITRSHIFT</title>
0111 <para>The BITRSHIFT() function performs a bit-wise right shift operation of the first parameter. The number of bits to shift by is specified by the second parameter. Note that a negative number of bits to right shift by becomes a left shift. </para>
0112 <para><segmentedlist><segtitle>Return type</segtitle>
0113 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
0114 <variablelist>
0115 <varlistentry><term>Syntax</term>
0116 <listitem><para>BITRSHIFT(value; shift size)</para></listitem>
0117 </varlistentry>
0118 <varlistentry><term>Parameters</term>
0119 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0120 <seglistitem><seg>First number</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
0121 <seglistitem><seg>Amount to right shift by</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
0122 </varlistentry>
0123 <varlistentry><term>Related Functions</term>
0124 <listitem><simplelist>
0125 <member><link linkend="BITLSHIFT">BITLSHIFT</link> </member>
0126 </simplelist></listitem>
0127 </varlistentry>
0128 </variablelist>
0129 </sect3>
0130
0131 <sect3 id="BITXOR">
0132 <title>BITXOR</title>
0133 <para>The BITXOR() function performs a bit-wise exclusive-OR operation for the two integer parameters. </para>
0134 <para><segmentedlist><segtitle>Return type</segtitle>
0135 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
0136 <variablelist>
0137 <varlistentry><term>Syntax</term>
0138 <listitem><para>BITXOR(value; value)</para></listitem>
0139 </varlistentry>
0140 <varlistentry><term>Parameters</term>
0141 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0142 <seglistitem><seg>First number</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
0143 <seglistitem><seg>Second number</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
0144 </varlistentry>
0145 <varlistentry><term>Examples</term>
0146 <listitem><para>BITXOR(12;10) returns 6 (because decimal 12 is binary 1100, and decimal 10 is binary 1010; and 1100 "xored" with 1010 is 0110, which is integer 6).</para></listitem>
0147 </varlistentry>
0148 <varlistentry><term>Related Functions</term>
0149 <listitem><simplelist>
0150 <member><link linkend="BITAND">BITAND</link> </member>
0151 <member><link linkend="BITOR">BITOR</link> </member>
0152 </simplelist></listitem>
0153 </varlistentry>
0154 </variablelist>
0155 </sect3>
0156
0157 </sect2><sect2 id="Conversion">
0158 <title>Conversion</title>
0159
0160 <sect3 id="ARABIC">
0161 <title>ARABIC</title>
0162 <para>The ARABIC() function converts a roman numeral into a number.</para>
0163 <para><segmentedlist><segtitle>Return type</segtitle>
0164 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
0165 <variablelist>
0166 <varlistentry><term>Syntax</term>
0167 <listitem><para>ARABIC(Numeral)</para></listitem>
0168 </varlistentry>
0169 <varlistentry><term>Parameters</term>
0170 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0171 <seglistitem><seg>Numeral</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
0172 </varlistentry>
0173 <varlistentry><term>Examples</term>
0174 <listitem><para>ARABIC("IV") returns 4</para></listitem>
0175 </varlistentry>
0176 <varlistentry><term>Examples</term>
0177 <listitem><para>ARABIC("XCIX") returns 99</para></listitem>
0178 </varlistentry>
0179 <varlistentry><term>Related Functions</term>
0180 <listitem><simplelist>
0181 <member><link linkend="ROMAN">ROMAN</link> </member>
0182 </simplelist></listitem>
0183 </varlistentry>
0184 </variablelist>
0185 </sect3>
0186
0187 <sect3 id="ASCIITOCHAR">
0188 <title>ASCIITOCHAR</title>
0189 <para>The ASCIITOCHAR() function returns the character for each given ASCII code</para>
0190 <para><segmentedlist><segtitle>Return type</segtitle>
0191 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
0192 <variablelist>
0193 <varlistentry><term>Syntax</term>
0194 <listitem><para>ASCIITOCHAR(value)</para></listitem>
0195 </varlistentry>
0196 <varlistentry><term>Parameters</term>
0197 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0198 <seglistitem><seg>The ASCII values to convert</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
0199 </varlistentry>
0200 <varlistentry><term>Examples</term>
0201 <listitem><para>ASCIITOCHAR(118) returns "v"</para></listitem>
0202 </varlistentry>
0203 <varlistentry><term>Examples</term>
0204 <listitem><para>ASCIITOCHAR(75; 68; 69) returns "KDE"</para></listitem>
0205 </varlistentry>
0206 </variablelist>
0207 </sect3>
0208
0209 <sect3 id="BOOL2INT">
0210 <title>BOOL2INT</title>
0211 <para>The BOOL2INT() function returns an integer value for a given boolean value. This method is intended for using a boolean value in methods which require an integer.</para>
0212 <para><segmentedlist><segtitle>Return type</segtitle>
0213 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
0214 <variablelist>
0215 <varlistentry><term>Syntax</term>
0216 <listitem><para>BOOL2INT(value)</para></listitem>
0217 </varlistentry>
0218 <varlistentry><term>Parameters</term>
0219 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0220 <seglistitem><seg>Bool value to convert</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
0221 </varlistentry>
0222 <varlistentry><term>Examples</term>
0223 <listitem><para>BOOL2INT(True) returns 1</para></listitem>
0224 </varlistentry>
0225 <varlistentry><term>Examples</term>
0226 <listitem><para>BOOL2INT(False) returns 0</para></listitem>
0227 </varlistentry>
0228 <varlistentry><term>Related Functions</term>
0229 <listitem><simplelist>
0230 <member><link linkend="INT2BOOL">INT2BOOL</link> </member>
0231 </simplelist></listitem>
0232 </varlistentry>
0233 </variablelist>
0234 </sect3>
0235
0236 <sect3 id="BOOL2STRING">
0237 <title>BOOL2STRING</title>
0238 <para>The BOOL2STRING() function returns a string value for a given boolean value. This method is intended for using a boolean in methods which require a string</para>
0239 <para><segmentedlist><segtitle>Return type</segtitle>
0240 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
0241 <variablelist>
0242 <varlistentry><term>Syntax</term>
0243 <listitem><para>BOOL2STRING(value)</para></listitem>
0244 </varlistentry>
0245 <varlistentry><term>Parameters</term>
0246 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0247 <seglistitem><seg>Bool value to convert</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
0248 </varlistentry>
0249 <varlistentry><term>Examples</term>
0250 <listitem><para>BOOL2STRING(true) returns "True"</para></listitem>
0251 </varlistentry>
0252 <varlistentry><term>Examples</term>
0253 <listitem><para>BOOL2STRING(false) returns "False"</para></listitem>
0254 </varlistentry>
0255 <varlistentry><term>Examples</term>
0256 <listitem><para>upper(BOOL2STRING(find("nan";"banana"))) returns TRUE</para></listitem>
0257 </varlistentry>
0258 </variablelist>
0259 </sect3>
0260
0261 <sect3 id="CARX">
0262 <title>CARX</title>
0263 <para>The CARX() function returns the X position corresponding to the position of a point in a polar landmark.</para>
0264 <para><segmentedlist><segtitle>Return type</segtitle>
0265 <seglistitem><seg>Double</seg></seglistitem></segmentedlist></para>
0266 <variablelist>
0267 <varlistentry><term>Syntax</term>
0268 <listitem><para>CARX(Radius;Angle)</para></listitem>
0269 </varlistentry>
0270 <varlistentry><term>Parameters</term>
0271 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0272 <seglistitem><seg>Radius</seg><seg>Double</seg></seglistitem>
0273 <seglistitem><seg>Angle (radians)</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
0274 </varlistentry>
0275 <varlistentry><term>Examples</term>
0276 <listitem><para>CARX(12;1.5707) returns 0.00115592</para></listitem>
0277 </varlistentry>
0278 <varlistentry><term>Examples</term>
0279 <listitem><para>CARX(12;0) returns 12</para></listitem>
0280 </varlistentry>
0281 <varlistentry><term>Related Functions</term>
0282 <listitem><simplelist>
0283 <member><link linkend="CARY">CARY</link> </member>
0284 <member><link linkend="POLA">POLA</link> </member>
0285 <member><link linkend="POLR">POLR</link> </member>
0286 </simplelist></listitem>
0287 </varlistentry>
0288 </variablelist>
0289 </sect3>
0290
0291 <sect3 id="CARY">
0292 <title>CARY</title>
0293 <para>The CARY() function returns the Y position corresponding to the position of a point in a polar landmark.</para>
0294 <para><segmentedlist><segtitle>Return type</segtitle>
0295 <seglistitem><seg>Double</seg></seglistitem></segmentedlist></para>
0296 <variablelist>
0297 <varlistentry><term>Syntax</term>
0298 <listitem><para>CARY(Radius;Angle)</para></listitem>
0299 </varlistentry>
0300 <varlistentry><term>Parameters</term>
0301 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0302 <seglistitem><seg>Radius</seg><seg>Double</seg></seglistitem>
0303 <seglistitem><seg>Angle (radians)</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
0304 </varlistentry>
0305 <varlistentry><term>Examples</term>
0306 <listitem><para>CARY(12;1.5707) returns 12</para></listitem>
0307 </varlistentry>
0308 <varlistentry><term>Examples</term>
0309 <listitem><para>CARY(12;0) returns 0</para></listitem>
0310 </varlistentry>
0311 <varlistentry><term>Related Functions</term>
0312 <listitem><simplelist>
0313 <member><link linkend="CARX">CARX</link> </member>
0314 <member><link linkend="POLA">POLA</link> </member>
0315 <member><link linkend="POLR">POLR</link> </member>
0316 </simplelist></listitem>
0317 </varlistentry>
0318 </variablelist>
0319 </sect3>
0320
0321 <sect3 id="CHARTOASCII">
0322 <title>CHARTOASCII</title>
0323 <para>The CHARTOASCII() function returns the ASCII code for the given character.</para>
0324 <para><segmentedlist><segtitle>Return type</segtitle>
0325 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
0326 <variablelist>
0327 <varlistentry><term>Syntax</term>
0328 <listitem><para>CHARTOASCII(value)</para></listitem>
0329 </varlistentry>
0330 <varlistentry><term>Parameters</term>
0331 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0332 <seglistitem><seg>A one character string to convert</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
0333 </varlistentry>
0334 <varlistentry><term>Examples</term>
0335 <listitem><para>CHARTOASCII("v") returns 118</para></listitem>
0336 </varlistentry>
0337 <varlistentry><term>Examples</term>
0338 <listitem><para>CHARTOASCII(r) is an error. The character must be in quotes.</para></listitem>
0339 </varlistentry>
0340 </variablelist>
0341 </sect3>
0342
0343 <sect3 id="DECSEX">
0344 <title>DECSEX</title>
0345 <para>The DECSEX() function converts a double value to a time value.</para>
0346 <para><segmentedlist><segtitle>Return type</segtitle>
0347 <seglistitem><seg>Double</seg></seglistitem></segmentedlist></para>
0348 <variablelist>
0349 <varlistentry><term>Syntax</term>
0350 <listitem><para>DECSEX(double)</para></listitem>
0351 </varlistentry>
0352 <varlistentry><term>Parameters</term>
0353 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0354 <seglistitem><seg>Value</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
0355 </varlistentry>
0356 <varlistentry><term>Examples</term>
0357 <listitem><para>DECSEX(1.6668) returns 1:40 </para></listitem>
0358 </varlistentry>
0359 <varlistentry><term>Examples</term>
0360 <listitem><para>DECSEX(7.8) returns 7:47</para></listitem>
0361 </varlistentry>
0362 </variablelist>
0363 </sect3>
0364
0365 <sect3 id="INT2BOOL">
0366 <title>INT2BOOL</title>
0367 <para>The INT2BOOL() function returns a boolean value for a given integer number. This method is intended for using an integer in methods which require a boolean. It only accepts 0 or 1. If any other value is given, false is returned.</para>
0368 <para><segmentedlist><segtitle>Return type</segtitle>
0369 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
0370 <variablelist>
0371 <varlistentry><term>Syntax</term>
0372 <listitem><para>INT2BOOL(value)</para></listitem>
0373 </varlistentry>
0374 <varlistentry><term>Parameters</term>
0375 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0376 <seglistitem><seg>Integer value to convert</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
0377 </varlistentry>
0378 <varlistentry><term>Examples</term>
0379 <listitem><para>INT2BOOL(1) returns true</para></listitem>
0380 </varlistentry>
0381 <varlistentry><term>Examples</term>
0382 <listitem><para>INT2BOOL(0) returns false</para></listitem>
0383 </varlistentry>
0384 <varlistentry><term>Examples</term>
0385 <listitem><para>OR(INT2BOOL(1); false) returns true</para></listitem>
0386 </varlistentry>
0387 <varlistentry><term>Related Functions</term>
0388 <listitem><simplelist>
0389 <member><link linkend="BOOL2INT">BOOL2INT</link> </member>
0390 </simplelist></listitem>
0391 </varlistentry>
0392 </variablelist>
0393 </sect3>
0394
0395 <sect3 id="NUM2STRING">
0396 <title>NUM2STRING</title>
0397 <para>The NUM2STRING() function returns a string value for a given number. Note that &sheets; can auto-convert numbers to strings if needed, so this function should rarely be needed.</para>
0398 <para><segmentedlist><segtitle>Return type</segtitle>
0399 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
0400 <variablelist>
0401 <varlistentry><term>Syntax</term>
0402 <listitem><para>NUM2STRING(value)</para></listitem>
0403 </varlistentry>
0404 <varlistentry><term>Parameters</term>
0405 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0406 <seglistitem><seg>Number to convert into string</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
0407 </varlistentry>
0408 <varlistentry><term>Examples</term>
0409 <listitem><para>NUM2STRING(10) returns "10"</para></listitem>
0410 </varlistentry>
0411 <varlistentry><term>Examples</term>
0412 <listitem><para>NUM2STRING(2.05) returns "2.05"</para></listitem>
0413 </varlistentry>
0414 <varlistentry><term>Examples</term>
0415 <listitem><para>=find("101";NUM2STRING(A1)) (A1 = 2.010102) returns True</para></listitem>
0416 </varlistentry>
0417 <varlistentry><term>Related Functions</term>
0418 <listitem><simplelist>
0419 <member><link linkend="STRING">STRING</link> </member>
0420 </simplelist></listitem>
0421 </varlistentry>
0422 </variablelist>
0423 </sect3>
0424
0425 <sect3 id="POLA">
0426 <title>POLA</title>
0427 <para>The POLA() function returns the angle (in radians) corresponding to the position of a point in a cartesian landmark.</para>
0428 <para><segmentedlist><segtitle>Return type</segtitle>
0429 <seglistitem><seg>Double</seg></seglistitem></segmentedlist></para>
0430 <variablelist>
0431 <varlistentry><term>Syntax</term>
0432 <listitem><para>POLA(X;Y)</para></listitem>
0433 </varlistentry>
0434 <varlistentry><term>Parameters</term>
0435 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0436 <seglistitem><seg>Value in X</seg><seg>Double</seg></seglistitem>
0437 <seglistitem><seg>Value in Y</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
0438 </varlistentry>
0439 <varlistentry><term>Examples</term>
0440 <listitem><para>POLA(12;12) returns 0.78539816</para></listitem>
0441 </varlistentry>
0442 <varlistentry><term>Examples</term>
0443 <listitem><para>POLA(12;0) returns 0</para></listitem>
0444 </varlistentry>
0445 <varlistentry><term>Examples</term>
0446 <listitem><para>POLA(0;12) returns 1.5707</para></listitem>
0447 </varlistentry>
0448 <varlistentry><term>Related Functions</term>
0449 <listitem><simplelist>
0450 <member><link linkend="POLR">POLR</link> </member>
0451 <member><link linkend="CARX">CARX</link> </member>
0452 <member><link linkend="CARY">CARY</link> </member>
0453 </simplelist></listitem>
0454 </varlistentry>
0455 </variablelist>
0456 </sect3>
0457
0458 <sect3 id="POLR">
0459 <title>POLR</title>
0460 <para>The POLR() function returns the radius corresponding to the position of a point in a cartesian landmark.</para>
0461 <para><segmentedlist><segtitle>Return type</segtitle>
0462 <seglistitem><seg>Double</seg></seglistitem></segmentedlist></para>
0463 <variablelist>
0464 <varlistentry><term>Syntax</term>
0465 <listitem><para>POLR(X;Y)</para></listitem>
0466 </varlistentry>
0467 <varlistentry><term>Parameters</term>
0468 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0469 <seglistitem><seg>Value in X</seg><seg>Double</seg></seglistitem>
0470 <seglistitem><seg>Value in Y</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
0471 </varlistentry>
0472 <varlistentry><term>Examples</term>
0473 <listitem><para>POLR(12;12) returns 16.9705</para></listitem>
0474 </varlistentry>
0475 <varlistentry><term>Examples</term>
0476 <listitem><para>POLR(12;0) returns 12</para></listitem>
0477 </varlistentry>
0478 <varlistentry><term>Related Functions</term>
0479 <listitem><simplelist>
0480 <member><link linkend="POLA">POLA</link> </member>
0481 <member><link linkend="CARX">CARX</link> </member>
0482 <member><link linkend="CARY">CARY</link> </member>
0483 </simplelist></listitem>
0484 </varlistentry>
0485 </variablelist>
0486 </sect3>
0487
0488 <sect3 id="ROMAN">
0489 <title>ROMAN</title>
0490 <para>The ROMAN() function returns the number in Roman format. Only positive whole numbers can be converted. The optional Format argument specifies the level of conciseness, and defaults to 0.</para>
0491 <para><segmentedlist><segtitle>Return type</segtitle>
0492 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
0493 <variablelist>
0494 <varlistentry><term>Syntax</term>
0495 <listitem><para>ROMAN(Number)</para></listitem>
0496
0497 </varlistentry>
0498 <varlistentry><term>Parameters</term>
0499 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0500 <seglistitem><seg>Number</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
0501 <seglistitem><seg>Format</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
0502 </varlistentry>
0503 <varlistentry><term>Examples</term>
0504 <listitem><para>ROMAN(99) returns "XCIX"</para></listitem>
0505 </varlistentry>
0506 <varlistentry><term>Examples</term>
0507 <listitem><para>ROMAN(-55) returns "Err"</para></listitem>
0508 </varlistentry>
0509 <varlistentry><term>Related Functions</term>
0510 <listitem><simplelist>
0511 <member><link linkend="ARABIC">ARABIC</link> </member>
0512 </simplelist></listitem>
0513 </varlistentry>
0514 </variablelist>
0515 </sect3>
0516
0517 <sect3 id="SEXDEC">
0518 <title>SEXDEC</title>
0519 <para>The SEXDEC() function returns a decimal value. You can also supply a time value.</para>
0520 <para><segmentedlist><segtitle>Return type</segtitle>
0521 <seglistitem><seg>Double</seg></seglistitem></segmentedlist></para>
0522 <variablelist>
0523 <varlistentry><term>Syntax</term>
0524 <listitem><para>SEXDEC(time value) or SEXDEC(hours;minutes;seconds)</para></listitem>
0525 </varlistentry>
0526 <varlistentry><term>Parameters</term>
0527 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0528 <seglistitem><seg>Hours</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
0529 <seglistitem><seg>Minutes</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
0530 <seglistitem><seg>Seconds</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
0531 </varlistentry>
0532 <varlistentry><term>Examples</term>
0533 <listitem><para>SEXDEC(1;5;7) returns 1.0852778 </para></listitem>
0534 </varlistentry>
0535 <varlistentry><term>Examples</term>
0536 <listitem><para>DECSEX("8:05") returns 8.08333333</para></listitem>
0537 </varlistentry>
0538 </variablelist>
0539 </sect3>
0540
0541 <sect3 id="STRING">
0542 <title>STRING</title>
0543 <para>The STRING() function returns a string value for a given number. It is the same as the NUM2STRING function.</para>
0544 <para><segmentedlist><segtitle>Return type</segtitle>
0545 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
0546 <variablelist>
0547 <varlistentry><term>Syntax</term>
0548 <listitem><para></para></listitem>
0549 </varlistentry>
0550 <varlistentry><term>Parameters</term>
0551 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0552 <seglistitem><seg>Number to convert into string</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
0553 </varlistentry>
0554 <varlistentry><term>Related Functions</term>
0555 <listitem><simplelist>
0556 <member><link linkend="NUM2STRING">NUM2STRING</link> </member>
0557 </simplelist></listitem>
0558 </varlistentry>
0559 </variablelist>
0560 </sect3>
0561
0562 </sect2><sect2 id="Database">
0563 <title>Database</title>
0564
0565 <sect3 id="DAVERAGE">
0566 <title>DAVERAGE</title>
0567 <para>Calculates the average in a column of a database specified by a set of conditions for values that are numbers</para>
0568 <para><segmentedlist><segtitle>Return type</segtitle>
0569 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0570 <variablelist>
0571 <varlistentry><term>Syntax</term>
0572 <listitem><para>DAVERAGE(Database; "Header"; Conditions)</para></listitem>
0573 </varlistentry>
0574 <varlistentry><term>Parameters</term>
0575 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0576 <seglistitem><seg>Range marking the database</seg><seg>A range of strings</seg></seglistitem>
0577 <seglistitem><seg>String marking the column in the database</seg><seg>Text</seg></seglistitem>
0578 <seglistitem><seg>Range marking the conditions</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
0579 </varlistentry>
0580 <varlistentry><term>Examples</term>
0581 <listitem><para>DAVERAGE(A1:C5; "Salary"; A9:A11)</para></listitem>
0582 </varlistentry>
0583 </variablelist>
0584 </sect3>
0585
0586 <sect3 id="DCOUNT">
0587 <title>DCOUNT</title>
0588 <para>Counts the cells containing numeric values in a column of a database specified by a set of conditions.</para>
0589 <para><segmentedlist><segtitle>Return type</segtitle>
0590 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0591 <variablelist>
0592 <varlistentry><term>Syntax</term>
0593 <listitem><para>DCOUNT(Database; "Header"; Conditions)</para></listitem>
0594 </varlistentry>
0595 <varlistentry><term>Parameters</term>
0596 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0597 <seglistitem><seg>Range marking the database</seg><seg>A range of strings</seg></seglistitem>
0598 <seglistitem><seg>String marking the column in the database</seg><seg>Text</seg></seglistitem>
0599 <seglistitem><seg>Range marking the conditions</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
0600 </varlistentry>
0601 <varlistentry><term>Examples</term>
0602 <listitem><para>DCOUNT(A1:C5; "Salary"; A9:A11)</para></listitem>
0603 </varlistentry>
0604 <varlistentry><term>Related Functions</term>
0605 <listitem><simplelist>
0606 <member><link linkend="DCOUNTA">DCOUNTA</link> </member>
0607 </simplelist></listitem>
0608 </varlistentry>
0609 </variablelist>
0610 </sect3>
0611
0612 <sect3 id="DCOUNTA">
0613 <title>DCOUNTA</title>
0614 <para>Counts the cells containing numeric or alphanumeric values in a column of a database specified by a set of conditions.</para>
0615 <para><segmentedlist><segtitle>Return type</segtitle>
0616 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0617 <variablelist>
0618 <varlistentry><term>Syntax</term>
0619 <listitem><para>DCOUNTA(Database; "Header"; Conditions)</para></listitem>
0620 </varlistentry>
0621 <varlistentry><term>Parameters</term>
0622 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0623 <seglistitem><seg>Range marking the database</seg><seg>A range of strings</seg></seglistitem>
0624 <seglistitem><seg>String marking the column in the database</seg><seg>Text</seg></seglistitem>
0625 <seglistitem><seg>Range marking the conditions</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
0626 </varlistentry>
0627 <varlistentry><term>Examples</term>
0628 <listitem><para>DCOUNTA(A1:C5; "Salary"; A9:A11)</para></listitem>
0629 </varlistentry>
0630 <varlistentry><term>Related Functions</term>
0631 <listitem><simplelist>
0632 <member><link linkend="DCOUNT">DCOUNT</link> </member>
0633 </simplelist></listitem>
0634 </varlistentry>
0635 </variablelist>
0636 </sect3>
0637
0638 <sect3 id="DGET">
0639 <title>DGET</title>
0640 <para>Returns a single value from a column of a database specified by a set of conditions. This function returns an error if no value or more than one value exist.</para>
0641 <para><segmentedlist><segtitle>Return type</segtitle>
0642 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0643 <variablelist>
0644 <varlistentry><term>Syntax</term>
0645 <listitem><para>DGET(Database; "Header"; Conditions)</para></listitem>
0646 </varlistentry>
0647 <varlistentry><term>Parameters</term>
0648 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0649 <seglistitem><seg>Range marking the database</seg><seg>A range of strings</seg></seglistitem>
0650 <seglistitem><seg>String marking the column in the database</seg><seg>Text</seg></seglistitem>
0651 <seglistitem><seg>Range marking the conditions</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
0652 </varlistentry>
0653 <varlistentry><term>Examples</term>
0654 <listitem><para>DGET(A1:C5; "Salary"; A9:A11)</para></listitem>
0655 </varlistentry>
0656 </variablelist>
0657 </sect3>
0658
0659 <sect3 id="DMAX">
0660 <title>DMAX</title>
0661 <para>Returns the largest value in a column of a database specified by a set of conditions.</para>
0662 <para><segmentedlist><segtitle>Return type</segtitle>
0663 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0664 <variablelist>
0665 <varlistentry><term>Syntax</term>
0666 <listitem><para>DMAX(Database; "Header"; Conditions)</para></listitem>
0667 </varlistentry>
0668 <varlistentry><term>Parameters</term>
0669 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0670 <seglistitem><seg>Range marking the database</seg><seg>A range of strings</seg></seglistitem>
0671 <seglistitem><seg>String marking the column in the database</seg><seg>Text</seg></seglistitem>
0672 <seglistitem><seg>Range marking the conditions</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
0673 </varlistentry>
0674 <varlistentry><term>Examples</term>
0675 <listitem><para>DMAX(A1:C5; "Salary"; A9:A11)</para></listitem>
0676 </varlistentry>
0677 <varlistentry><term>Related Functions</term>
0678 <listitem><simplelist>
0679 <member><link linkend="DMIN">DMIN</link> </member>
0680 </simplelist></listitem>
0681 </varlistentry>
0682 </variablelist>
0683 </sect3>
0684
0685 <sect3 id="DMIN">
0686 <title>DMIN</title>
0687 <para>Returns the smallest values in a column of a database specified by a set of conditions.</para>
0688 <para><segmentedlist><segtitle>Return type</segtitle>
0689 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0690 <variablelist>
0691 <varlistentry><term>Syntax</term>
0692 <listitem><para>DMIN(Database; "Header"; Conditions)</para></listitem>
0693 </varlistentry>
0694 <varlistentry><term>Parameters</term>
0695 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0696 <seglistitem><seg>Range marking the database</seg><seg>A range of strings</seg></seglistitem>
0697 <seglistitem><seg>String marking the column in the database</seg><seg>Text</seg></seglistitem>
0698 <seglistitem><seg>Range marking the conditions</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
0699 </varlistentry>
0700 <varlistentry><term>Examples</term>
0701 <listitem><para>DMIN(A1:C5; "Salary"; A9:A11)</para></listitem>
0702 </varlistentry>
0703 <varlistentry><term>Related Functions</term>
0704 <listitem><simplelist>
0705 <member><link linkend="DMAX">DMAX</link> </member>
0706 </simplelist></listitem>
0707 </varlistentry>
0708 </variablelist>
0709 </sect3>
0710
0711 <sect3 id="DPRODUCT">
0712 <title>DPRODUCT</title>
0713 <para>Returns the product of all numeric values in a column of a database specified by a set of conditions.</para>
0714 <para><segmentedlist><segtitle>Return type</segtitle>
0715 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0716 <variablelist>
0717 <varlistentry><term>Syntax</term>
0718 <listitem><para>DPRODUCT(Database; "Header"; Conditions)</para></listitem>
0719 </varlistentry>
0720 <varlistentry><term>Parameters</term>
0721 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0722 <seglistitem><seg>Range marking the database</seg><seg>A range of strings</seg></seglistitem>
0723 <seglistitem><seg>String marking the column in the database</seg><seg>Text</seg></seglistitem>
0724 <seglistitem><seg>Range marking the conditions</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
0725 </varlistentry>
0726 <varlistentry><term>Examples</term>
0727 <listitem><para>DPRODUCT(A1:C5; "Salary"; A9:A11)</para></listitem>
0728 </varlistentry>
0729 </variablelist>
0730 </sect3>
0731
0732 <sect3 id="DSTDEV">
0733 <title>DSTDEV</title>
0734 <para>Returns the estimate of the standard deviation of a population based on a sample using all numeric values in a column of a database specified by a set of conditions.</para>
0735 <para><segmentedlist><segtitle>Return type</segtitle>
0736 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0737 <variablelist>
0738 <varlistentry><term>Syntax</term>
0739 <listitem><para>DSTDEV(Database; "Header"; Conditions)</para></listitem>
0740 </varlistentry>
0741 <varlistentry><term>Parameters</term>
0742 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0743 <seglistitem><seg>Range marking the database</seg><seg>A range of strings</seg></seglistitem>
0744 <seglistitem><seg>String marking the column in the database</seg><seg>Text</seg></seglistitem>
0745 <seglistitem><seg>Range marking the conditions</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
0746 </varlistentry>
0747 <varlistentry><term>Examples</term>
0748 <listitem><para>DSTDEV(A1:C5; "Salary"; A9:A11)</para></listitem>
0749 </varlistentry>
0750 <varlistentry><term>Related Functions</term>
0751 <listitem><simplelist>
0752 <member><link linkend="DSTDEVP">DSTDEVP</link> </member>
0753 </simplelist></listitem>
0754 </varlistentry>
0755 </variablelist>
0756 </sect3>
0757
0758 <sect3 id="DSTDEVP">
0759 <title>DSTDEVP</title>
0760 <para>Returns the standard deviation of a population based on the entire population using all numeric values in a column of a database specified by a set of conditions.</para>
0761 <para><segmentedlist><segtitle>Return type</segtitle>
0762 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0763 <variablelist>
0764 <varlistentry><term>Syntax</term>
0765 <listitem><para>DSTDEVP(Database; "Header"; Conditions)</para></listitem>
0766 </varlistentry>
0767 <varlistentry><term>Parameters</term>
0768 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0769 <seglistitem><seg>Range marking the database</seg><seg>A range of strings</seg></seglistitem>
0770 <seglistitem><seg>String marking the column in the database</seg><seg>Text</seg></seglistitem>
0771 <seglistitem><seg>Range marking the conditions</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
0772 </varlistentry>
0773 <varlistentry><term>Examples</term>
0774 <listitem><para>DSTDEVP(A1:C5; "Salary"; A9:A11)</para></listitem>
0775 </varlistentry>
0776 <varlistentry><term>Related Functions</term>
0777 <listitem><simplelist>
0778 <member><link linkend="DSTDEV">DSTDEV</link> </member>
0779 </simplelist></listitem>
0780 </varlistentry>
0781 </variablelist>
0782 </sect3>
0783
0784 <sect3 id="DSUM">
0785 <title>DSUM</title>
0786 <para>Sums up the numbers in a column of a database specified by a set of conditions.</para>
0787 <para><segmentedlist><segtitle>Return type</segtitle>
0788 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0789 <variablelist>
0790 <varlistentry><term>Syntax</term>
0791 <listitem><para>DSUM(Database; "Header"; Conditions)</para></listitem>
0792 </varlistentry>
0793 <varlistentry><term>Parameters</term>
0794 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0795 <seglistitem><seg>Range marking the database</seg><seg>A range of strings</seg></seglistitem>
0796 <seglistitem><seg>String marking the column in the database</seg><seg>Text</seg></seglistitem>
0797 <seglistitem><seg>Range marking the conditions</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
0798 </varlistentry>
0799 <varlistentry><term>Examples</term>
0800 <listitem><para>DSUM(A1:C5; "Salary"; A9:A11)</para></listitem>
0801 </varlistentry>
0802 </variablelist>
0803 </sect3>
0804
0805 <sect3 id="DVAR">
0806 <title>DVAR</title>
0807 <para>Returns the estimate of the variance of a population based on a sample using all numeric values in a column of a database specified by a set of conditions.</para>
0808 <para><segmentedlist><segtitle>Return type</segtitle>
0809 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0810 <variablelist>
0811 <varlistentry><term>Syntax</term>
0812 <listitem><para>DVAR(Database; "Header"; Conditions)</para></listitem>
0813 </varlistentry>
0814 <varlistentry><term>Parameters</term>
0815 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0816 <seglistitem><seg>Range marking the database</seg><seg>A range of strings</seg></seglistitem>
0817 <seglistitem><seg>String marking the column in the database</seg><seg>Text</seg></seglistitem>
0818 <seglistitem><seg>Range marking the conditions</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
0819 </varlistentry>
0820 <varlistentry><term>Examples</term>
0821 <listitem><para>DVAR(A1:C5; "Salary"; A9:A11)</para></listitem>
0822 </varlistentry>
0823 <varlistentry><term>Related Functions</term>
0824 <listitem><simplelist>
0825 <member><link linkend="DVARP">DVARP</link> </member>
0826 </simplelist></listitem>
0827 </varlistentry>
0828 </variablelist>
0829 </sect3>
0830
0831 <sect3 id="DVARP">
0832 <title>DVARP</title>
0833 <para>Returns the variance of a population based on the entire population using all numeric values in a column of a database specified by a set of conditions.</para>
0834 <para><segmentedlist><segtitle>Return type</segtitle>
0835 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0836 <variablelist>
0837 <varlistentry><term>Syntax</term>
0838 <listitem><para>DVARP(Database; "Header"; Conditions)</para></listitem>
0839 </varlistentry>
0840 <varlistentry><term>Parameters</term>
0841 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0842 <seglistitem><seg>Range marking the database</seg><seg>A range of strings</seg></seglistitem>
0843 <seglistitem><seg>String marking the column in the database</seg><seg>Text</seg></seglistitem>
0844 <seglistitem><seg>Range marking the conditions</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
0845 </varlistentry>
0846 <varlistentry><term>Examples</term>
0847 <listitem><para>DVARP(A1:C5; "Salary"; A9:A11)</para></listitem>
0848 </varlistentry>
0849 <varlistentry><term>Related Functions</term>
0850 <listitem><simplelist>
0851 <member><link linkend="DVAR">DVAR</link> </member>
0852 </simplelist></listitem>
0853 </varlistentry>
0854 </variablelist>
0855 </sect3>
0856
0857 <sect3 id="GETPIVOTDATA">
0858 <title>GETPIVOTDATA</title>
0859 <para>Fetches summary data from a pivot table.</para>
0860 <para><segmentedlist><segtitle>Return type</segtitle>
0861 <seglistitem><seg>FLOAT</seg></seglistitem></segmentedlist></para>
0862 <variablelist>
0863 <varlistentry><term>Syntax</term>
0864 <listitem><para>GETPIVOTDATA(Database; "Sales")</para></listitem>
0865 </varlistentry>
0866 <varlistentry><term>Parameters</term>
0867 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0868 <seglistitem><seg>Range containing the pivot table</seg><seg>A range of strings</seg></seglistitem>
0869 <seglistitem><seg>Name of the field of which you want the summary data</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
0870 </varlistentry>
0871 </variablelist>
0872 </sect3>
0873
0874 </sect2><sect2 id="Date---Time">
0875 <title>Date & Time</title>
0876
0877 <sect3 id="CURRENTDATE">
0878 <title>CURRENTDATE</title>
0879 <para>The CURRENTDATE() function returns the current date. It is equivalent to the TODAY function.</para>
0880 <para><segmentedlist><segtitle>Return type</segtitle>
0881 <seglistitem><seg>Date</seg></seglistitem></segmentedlist></para>
0882 <variablelist>
0883 <varlistentry><term>Syntax</term>
0884 <listitem><para>CURRENTDATE()</para></listitem>
0885 </varlistentry>
0886 <varlistentry><term>Parameters</term>
0887 <listitem><para></para></listitem>
0888 </varlistentry>
0889 <varlistentry><term>Examples</term>
0890 <listitem><para>CURRENTDATE() returns "Saturday 13 April 2002"</para></listitem>
0891 </varlistentry>
0892 <varlistentry><term>Related Functions</term>
0893 <listitem><simplelist>
0894 <member><link linkend="CURRENTTIME">CURRENTTIME</link> </member>
0895 <member><link linkend="TODAY">TODAY</link> </member>
0896 </simplelist></listitem>
0897 </varlistentry>
0898 </variablelist>
0899 </sect3>
0900
0901 <sect3 id="CURRENTDATETIME">
0902 <title>CURRENTDATETIME</title>
0903 <para>The CURRENTDATETIME() function returns the current date and time.</para>
0904 <para><segmentedlist><segtitle>Return type</segtitle>
0905 <seglistitem><seg>Date</seg></seglistitem></segmentedlist></para>
0906 <variablelist>
0907 <varlistentry><term>Syntax</term>
0908 <listitem><para>CURRENTDATETIME()</para></listitem>
0909 </varlistentry>
0910 <varlistentry><term>Parameters</term>
0911 <listitem><para></para></listitem>
0912 </varlistentry>
0913 <varlistentry><term>Examples</term>
0914 <listitem><para>CURRENTDATETIME() returns "Saturday 13 April 2002 19:12:01"</para></listitem>
0915 </varlistentry>
0916 </variablelist>
0917 </sect3>
0918
0919 <sect3 id="CURRENTTIME">
0920 <title>CURRENTTIME</title>
0921 <para>The CURRENTTIME() function returns the current time formatted with local parameters.</para>
0922 <para><segmentedlist><segtitle>Return type</segtitle>
0923 <seglistitem><seg>Date</seg></seglistitem></segmentedlist></para>
0924 <variablelist>
0925 <varlistentry><term>Syntax</term>
0926 <listitem><para>CURRENTTIME()</para></listitem>
0927 </varlistentry>
0928 <varlistentry><term>Parameters</term>
0929 <listitem><para></para></listitem>
0930 </varlistentry>
0931 <varlistentry><term>Examples</term>
0932 <listitem><para>CURRENTTIME() returns "19:12:01"</para></listitem>
0933 </varlistentry>
0934 </variablelist>
0935 </sect3>
0936
0937 <sect3 id="DATE">
0938 <title>DATE</title>
0939 <para>The DATE() function returns the date formatted with local parameters.</para>
0940 <para><segmentedlist><segtitle>Return type</segtitle>
0941 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
0942 <variablelist>
0943 <varlistentry><term>Syntax</term>
0944 <listitem><para>DATE(year;month;date)</para></listitem>
0945 </varlistentry>
0946 <varlistentry><term>Parameters</term>
0947 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0948 <seglistitem><seg>Year</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
0949 <seglistitem><seg>Month</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
0950 <seglistitem><seg>Day</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
0951 </varlistentry>
0952 <varlistentry><term>Examples</term>
0953 <listitem><para>DATE(2000;5;5) returns Friday 05 May 2000</para></listitem>
0954 </varlistentry>
0955 </variablelist>
0956 </sect3>
0957
0958 <sect3 id="DATE2UNIX">
0959 <title>DATE2UNIX</title>
0960 <para>DATE2UNIX() function converts a date and time value to unix time.</para>
0961 <para>A unix time is the number of seconds after midnight January 1st, 1970.</para>
0962 <para><segmentedlist><segtitle>Return type</segtitle>
0963 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
0964 <variablelist>
0965 <varlistentry><term>Syntax</term>
0966 <listitem><para>DATE2UNIX(date)</para></listitem>
0967 </varlistentry>
0968 <varlistentry><term>Parameters</term>
0969 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0970 <seglistitem><seg>Date</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
0971 </varlistentry>
0972 <varlistentry><term>Examples</term>
0973 <listitem><para>DATE2UNIX("01/01/2000") returns 946,684,800</para></listitem>
0974 </varlistentry>
0975 </variablelist>
0976 </sect3>
0977
0978 <sect3 id="DATEDIF">
0979 <title>DATEDIF</title>
0980 <para>The DATEDIF() function returns the difference between two dates.</para>
0981 <para>Interval must be one of the following: "m": month; "d": days; "y": complete years; "ym": month excluding years; "yd": days excluding years; "md": days excluding months and years</para>
0982 <para><segmentedlist><segtitle>Return type</segtitle>
0983 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
0984 <variablelist>
0985 <varlistentry><term>Syntax</term>
0986 <listitem><para>DATEDIF(first date; second date; interval)</para></listitem>
0987 </varlistentry>
0988 <varlistentry><term>Parameters</term>
0989 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
0990 <seglistitem><seg>First date</seg><seg>Text</seg></seglistitem>
0991 <seglistitem><seg>Second date</seg><seg>Text</seg></seglistitem>
0992 <seglistitem><seg>interval</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
0993 </varlistentry>
0994 <varlistentry><term>Examples</term>
0995 <listitem><para>DATEDIF(A1;A2;"d") A1 is "1st of January 1995" and A2 is "15th of June 1999" returns number of days 1626</para></listitem>
0996 </varlistentry>
0997
0998 <varlistentry><term>Examples</term>
0999 <listitem><para>DATEDIF(A1;A2;"m") A1 is "1st of January 1995" and A2 is "15th of June 1999" returns number of months 53</para></listitem>
1000 </varlistentry>
1001 </variablelist>
1002 </sect3>
1003
1004 <sect3 id="DATEVALUE">
1005 <title>DATEVALUE</title>
1006 <para>The DATEVALUE function returns a number representing the day, i.e the number of days elapsed since December 31, 1899.</para>
1007 <para><segmentedlist><segtitle>Return type</segtitle>
1008 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1009 <variablelist>
1010 <varlistentry><term>Syntax</term>
1011 <listitem><para>DATEVALUE(date)</para></listitem>
1012 </varlistentry>
1013 <varlistentry><term>Parameters</term>
1014 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1015 <seglistitem><seg>Date</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1016 </varlistentry>
1017 <varlistentry><term>Examples</term>
1018 <listitem><para>DATEVALUE("2/22/2002") returns 37309</para></listitem>
1019 </varlistentry>
1020 <varlistentry><term>Related Functions</term>
1021 <listitem><simplelist>
1022 <member><link linkend="TIMEVALUE">TIMEVALUE</link> </member>
1023 </simplelist></listitem>
1024 </varlistentry>
1025 </variablelist>
1026 </sect3>
1027
1028 <sect3 id="DAY">
1029 <title>DAY</title>
1030 <para>The DAY functions returns the day of a date. If no parameter is specified the current day gets returned.</para>
1031 <para><segmentedlist><segtitle>Return type</segtitle>
1032 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1033 <variablelist>
1034 <varlistentry><term>Syntax</term>
1035 <listitem><para>DAY(date)</para></listitem>
1036 </varlistentry>
1037 <varlistentry><term>Parameters</term>
1038 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1039 <seglistitem><seg>Date</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1040 </varlistentry>
1041 <varlistentry><term>Examples</term>
1042 <listitem><para>DAY("2/22/2002") returns 22</para></listitem>
1043 </varlistentry>
1044 <varlistentry><term>Examples</term>
1045 <listitem><para>DAY(2323.1285) returns 11</para></listitem>
1046 </varlistentry>
1047 <varlistentry><term>Related Functions</term>
1048 <listitem><simplelist>
1049 <member><link linkend="MONTH">MONTH</link> </member>
1050 <member><link linkend="YEAR">YEAR</link> </member>
1051 </simplelist></listitem>
1052 </varlistentry>
1053 </variablelist>
1054 </sect3>
1055
1056 <sect3 id="DAYNAME">
1057 <title>DAYNAME</title>
1058 <para>The DAYNAME() function returns the name of the day of the week (1..7). In some countries the first day of the week is Monday, while in others the first day of the week is Sunday.</para>
1059 <para><segmentedlist><segtitle>Return type</segtitle>
1060 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
1061 <variablelist>
1062 <varlistentry><term>Syntax</term>
1063 <listitem><para>DAYNAME(weekday)</para></listitem>
1064 </varlistentry>
1065 <varlistentry><term>Parameters</term>
1066 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1067 <seglistitem><seg>Number of day in week (1..7)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1068 </varlistentry>
1069 <varlistentry><term>Examples</term>
1070 <listitem><para>DAYNAME(1) returns Monday (if the week starts on Monday)</para></listitem>
1071 </varlistentry>
1072 <varlistentry><term>Related Functions</term>
1073 <listitem><simplelist>
1074 <member><link linkend="WEEKDAY">WEEKDAY</link> </member>
1075 </simplelist></listitem>
1076 </varlistentry>
1077 </variablelist>
1078 </sect3>
1079
1080 <sect3 id="DAYOFYEAR">
1081 <title>DAYOFYEAR</title>
1082 <para>The DAYOFYEAR() function returns the number of the day in the year (1...365).</para>
1083 <para><segmentedlist><segtitle>Return type</segtitle>
1084 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1085 <variablelist>
1086 <varlistentry><term>Syntax</term>
1087 <listitem><para>DAYOFYEAR(year;month;date)</para></listitem>
1088 </varlistentry>
1089 <varlistentry><term>Parameters</term>
1090 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1091 <seglistitem><seg>Year</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
1092 <seglistitem><seg>Month</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
1093 <seglistitem><seg>Day</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1094 </varlistentry>
1095 <varlistentry><term>Examples</term>
1096 <listitem><para>DAYOFYEAR(2000;12;1) returns 336</para></listitem>
1097 </varlistentry>
1098 <varlistentry><term>Examples</term>
1099 <listitem><para>DAYOFYEAR(2000;2;29) returns 60</para></listitem>
1100 </varlistentry>
1101 </variablelist>
1102 </sect3>
1103
1104 <sect3 id="DAYS">
1105 <title>DAYS</title>
1106 <para>The DAYS() function returns the difference between two dates in days.</para>
1107 <para><segmentedlist><segtitle>Return type</segtitle>
1108 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1109 <variablelist>
1110 <varlistentry><term>Syntax</term>
1111 <listitem><para>DAYS(date2; date1)</para></listitem>
1112 </varlistentry>
1113 <varlistentry><term>Parameters</term>
1114 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1115 <seglistitem><seg>First (earlier) date value</seg><seg>Text</seg></seglistitem>
1116 <seglistitem><seg>Second date value</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1117 </varlistentry>
1118 <varlistentry><term>Examples</term>
1119 <listitem><para>DAYS("2002-02-22"; "2002-02-26") returns 4</para></listitem>
1120 </varlistentry>
1121 </variablelist>
1122 </sect3>
1123
1124 <sect3 id="DAYS360">
1125 <title>DAYS360</title>
1126 <para>The DAYS360() function returns the number of days from date1 to date2 using a 360-day calendar in which all months are assumed to have 30 days. If method is false (default) the US method will be used, the European otherwise.</para>
1127 <para><segmentedlist><segtitle>Return type</segtitle>
1128 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1129 <variablelist>
1130 <varlistentry><term>Syntax</term>
1131 <listitem><para>DAYS360(date1; date2; method)</para></listitem>
1132 </varlistentry>
1133 <varlistentry><term>Parameters</term>
1134 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1135 <seglistitem><seg>Date1</seg><seg>Text</seg></seglistitem>
1136 <seglistitem><seg>Date2</seg><seg>Text</seg></seglistitem>
1137 <seglistitem><seg>Method</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
1138 </varlistentry>
1139 <varlistentry><term>Examples</term>
1140 <listitem><para>DAYS360("2/22/2002"; "4/21/2002"; FALSE) returns 59</para></listitem>
1141 </varlistentry>
1142 <varlistentry><term>Related Functions</term>
1143 <listitem><simplelist>
1144 <member><link linkend="DAYS">DAYS</link> </member>
1145 <member><link linkend="MONTHS">MONTHS</link> </member>
1146 <member><link linkend="WEEKS">WEEKS</link> </member>
1147 <member><link linkend="YEARS">YEARS</link> </member>
1148 </simplelist></listitem>
1149 </varlistentry>
1150 </variablelist>
1151 </sect3>
1152
1153 <sect3 id="DAYSINMONTH">
1154 <title>DAYSINMONTH</title>
1155 <para>The function DAYSINMONTH() returns the number of days in the given year and month.</para>
1156 <para><segmentedlist><segtitle>Return type</segtitle>
1157 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1158 <variablelist>
1159 <varlistentry><term>Syntax</term>
1160 <listitem><para>DAYSINMONTH(year;month)</para></listitem>
1161 </varlistentry>
1162 <varlistentry><term>Parameters</term>
1163 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1164 <seglistitem><seg>Year</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
1165 <seglistitem><seg>Month</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1166 </varlistentry>
1167 <varlistentry><term>Examples</term>
1168 <listitem><para>DAYSINMONTH(2000;2) returns 29</para></listitem>
1169 </varlistentry>
1170 </variablelist>
1171 </sect3>
1172
1173 <sect3 id="DAYSINYEAR">
1174 <title>DAYSINYEAR</title>
1175 <para>The function DAYSINYEAR() returns the number of days in the given year.</para>
1176 <para><segmentedlist><segtitle>Return type</segtitle>
1177 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1178 <variablelist>
1179 <varlistentry><term>Syntax</term>
1180 <listitem><para>DAYSINYEAR(year)</para></listitem>
1181 </varlistentry>
1182 <varlistentry><term>Parameters</term>
1183 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1184 <seglistitem><seg>Year</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1185 </varlistentry>
1186 <varlistentry><term>Examples</term>
1187 <listitem><para>DAYSINYEAR(2000) returns 366</para></listitem>
1188 </varlistentry>
1189 </variablelist>
1190 </sect3>
1191
1192 <sect3 id="EASTERSUNDAY">
1193 <title>EASTERSUNDAY</title>
1194 <para>The EASTERSUNDAY() function returns the date which corresponds to Easter Sunday in the year given as the parameter.</para>
1195 <para><segmentedlist><segtitle>Return type</segtitle>
1196 <seglistitem><seg>Date</seg></seglistitem></segmentedlist></para>
1197 <variablelist>
1198 <varlistentry><term>Syntax</term>
1199 <listitem><para>EASTERSUNDAY(year)</para></listitem>
1200 </varlistentry>
1201 <varlistentry><term>Parameters</term>
1202 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1203 <seglistitem><seg>Year</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1204 </varlistentry>
1205 <varlistentry><term>Examples</term>
1206 <listitem><para>EASTERSUNDAY(2003) returns "20th April 2003"</para></listitem>
1207 </varlistentry>
1208 </variablelist>
1209 </sect3>
1210
1211 <sect3 id="EDATE">
1212 <title>EDATE</title>
1213 <para>The EDATE functions returns the date that is specified by a given date and a number of months before or after that date.</para>
1214 <para><segmentedlist><segtitle>Return type</segtitle>
1215 <seglistitem><seg>Date</seg></seglistitem></segmentedlist></para>
1216 <variablelist>
1217 <varlistentry><term>Syntax</term>
1218 <listitem><para>EDATE(date; months)</para></listitem>
1219 </varlistentry>
1220 <varlistentry><term>Parameters</term>
1221 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1222 <seglistitem><seg>Date</seg><seg>Text</seg></seglistitem>
1223 <seglistitem><seg>Months</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1224 </varlistentry>
1225 <varlistentry><term>Examples</term>
1226 <listitem><para>EDATE("2/22/2002"; 3) returns "5/22/2002"</para></listitem>
1227 </varlistentry>
1228 <varlistentry><term>Examples</term>
1229 <listitem><para>EDATE("3/31/2002"; -1) returns "2/28/2002"</para></listitem>
1230 </varlistentry>
1231 <varlistentry><term>Related Functions</term>
1232 <listitem><simplelist>
1233 <member><link linkend="DATE">DATE</link> </member>
1234 <member><link linkend="EOMONTH">EOMONTH</link> </member>
1235 </simplelist></listitem>
1236 </varlistentry>
1237 </variablelist>
1238 </sect3>
1239
1240 <sect3 id="EOMONTH">
1241 <title>EOMONTH</title>
1242 <para>The EOMONTH functions returns the last day in the month specified by a date and the number of months from that date.</para>
1243 <para><segmentedlist><segtitle>Return type</segtitle>
1244 <seglistitem><seg>Date</seg></seglistitem></segmentedlist></para>
1245 <variablelist>
1246 <varlistentry><term>Syntax</term>
1247 <listitem><para>EOMONTH(date; months)</para></listitem>
1248 </varlistentry>
1249 <varlistentry><term>Parameters</term>
1250 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1251 <seglistitem><seg>Date</seg><seg>Text</seg></seglistitem>
1252 <seglistitem><seg>Months</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1253 </varlistentry>
1254 <varlistentry><term>Examples</term>
1255 <listitem><para>EOMONTH("2/22/2002"; 3) returns "5/31/2002"</para></listitem>
1256 </varlistentry>
1257 <varlistentry><term>Examples</term>
1258 <listitem><para>EOMONTH("3/12/2002"; -1) returns "2/28/2002"</para></listitem>
1259 </varlistentry>
1260 <varlistentry><term>Examples</term>
1261 <listitem><para>EOMONTH("3/12/2002"; 0) returns "3/31/2002"</para></listitem>
1262 </varlistentry>
1263 <varlistentry><term>Related Functions</term>
1264 <listitem><simplelist>
1265 <member><link linkend="EDATE">EDATE</link> </member>
1266 <member><link linkend="MONTH">MONTH</link> </member>
1267 </simplelist></listitem>
1268 </varlistentry>
1269 </variablelist>
1270 </sect3>
1271
1272 <sect3 id="HOUR">
1273 <title>HOUR</title>
1274 <para>The HOUR functions returns the hour of a time. If no parameter is specified the current hour gets returned.</para>
1275 <para><segmentedlist><segtitle>Return type</segtitle>
1276 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1277 <variablelist>
1278 <varlistentry><term>Syntax</term>
1279 <listitem><para>HOUR(time)</para></listitem>
1280 </varlistentry>
1281 <varlistentry><term>Parameters</term>
1282 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1283 <seglistitem><seg>Time</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1284 </varlistentry>
1285 <varlistentry><term>Examples</term>
1286 <listitem><para>HOUR("22:10:12") returns 22</para></listitem>
1287 </varlistentry>
1288 <varlistentry><term>Examples</term>
1289 <listitem><para>HOUR(0.1285) returns 3</para></listitem>
1290 </varlistentry>
1291 <varlistentry><term>Related Functions</term>
1292 <listitem><simplelist>
1293 <member><link linkend="MINUTE">MINUTE</link> </member>
1294 <member><link linkend="SECOND">SECOND</link> </member>
1295 </simplelist></listitem>
1296 </varlistentry>
1297 </variablelist>
1298 </sect3>
1299
1300 <sect3 id="HOURS">
1301 <title>HOURS</title>
1302 <para>The HOURS() function returns the value of the hours in a time expression.</para>
1303 <para><segmentedlist><segtitle>Return type</segtitle>
1304 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1305 <variablelist>
1306 <varlistentry><term>Syntax</term>
1307 <listitem><para>HOURS(time)</para></listitem>
1308 </varlistentry>
1309 <varlistentry><term>Parameters</term>
1310 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1311 <seglistitem><seg>Time</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1312 </varlistentry>
1313 <varlistentry><term>Examples</term>
1314 <listitem><para>HOURS("10:5:2") returns 10</para></listitem>
1315 </varlistentry>
1316 </variablelist>
1317 </sect3>
1318
1319 <sect3 id="ISLEAPYEAR">
1320 <title>ISLEAPYEAR</title>
1321 <para>The function ISLEAPYEAR() returns True if the given year is leap.</para>
1322 <para><segmentedlist><segtitle>Return type</segtitle>
1323 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
1324 <variablelist>
1325 <varlistentry><term>Syntax</term>
1326 <listitem><para>ISLEAPYEAR(year)</para></listitem>
1327 </varlistentry>
1328 <varlistentry><term>Parameters</term>
1329 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1330 <seglistitem><seg>Year</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1331 </varlistentry>
1332 <varlistentry><term>Examples</term>
1333 <listitem><para>ISLEAPYEAR(2000) returns True</para></listitem>
1334 </varlistentry>
1335 </variablelist>
1336 </sect3>
1337
1338 <sect3 id="ISOWEEKNUM">
1339 <title>ISOWEEKNUM</title>
1340 <para>The ISOWEEKNUM() function returns number of the week which the date falls into. Note that this function is compliant with the ISO8601 standard: a week always begins on a Monday, and ends on a Sunday. The first week of a year is that week which contains the first Thursday of the year.</para>
1341 <para><segmentedlist><segtitle>Return type</segtitle>
1342 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1343 <variablelist>
1344 <varlistentry><term>Syntax</term>
1345 <listitem><para>ISOWEEKNUM(date)</para></listitem>
1346 </varlistentry>
1347 <varlistentry><term>Parameters</term>
1348 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1349 <seglistitem><seg>Date</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1350 </varlistentry>
1351 <varlistentry><term>Examples</term>
1352 <listitem><para>ISOWEEKNUM(A1) returns 51 when A1 is "21st of Dec".</para></listitem>
1353 </varlistentry>
1354 <varlistentry><term>Related Functions</term>
1355 <listitem><simplelist>
1356 <member><link linkend="WEEKNUM">WEEKNUM</link> </member>
1357 </simplelist></listitem>
1358 </varlistentry>
1359 </variablelist>
1360 </sect3>
1361
1362 <sect3 id="MINUTE">
1363 <title>MINUTE</title>
1364 <para>The MINUTE functions returns the minutes of a time. If no parameter is specified the current minute is returned.</para>
1365 <para><segmentedlist><segtitle>Return type</segtitle>
1366 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1367 <variablelist>
1368 <varlistentry><term>Syntax</term>
1369 <listitem><para>MINUTE(time)</para></listitem>
1370 </varlistentry>
1371 <varlistentry><term>Parameters</term>
1372 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1373 <seglistitem><seg>Time</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1374 </varlistentry>
1375 <varlistentry><term>Examples</term>
1376 <listitem><para>MINUTE("22:10:12") returns 10</para></listitem>
1377 </varlistentry>
1378 <varlistentry><term>Examples</term>
1379 <listitem><para>MINUTE(0.1234) returns 57</para></listitem>
1380 </varlistentry>
1381 <varlistentry><term>Related Functions</term>
1382 <listitem><simplelist>
1383 <member><link linkend="HOUR">HOUR</link> </member>
1384 <member><link linkend="SECOND">SECOND</link> </member>
1385 </simplelist></listitem>
1386 </varlistentry>
1387 </variablelist>
1388 </sect3>
1389
1390 <sect3 id="MINUTES">
1391 <title>MINUTES</title>
1392 <para>The MINUTES() function returns the value of the minutes in a time expression.</para>
1393 <para><segmentedlist><segtitle>Return type</segtitle>
1394 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1395 <variablelist>
1396 <varlistentry><term>Syntax</term>
1397 <listitem><para>MINUTES(time)</para></listitem>
1398 </varlistentry>
1399 <varlistentry><term>Parameters</term>
1400 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1401 <seglistitem><seg>Time</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1402 </varlistentry>
1403 <varlistentry><term>Examples</term>
1404 <listitem><para>MINUTES("10:5:2") returns 5</para></listitem>
1405 </varlistentry>
1406 </variablelist>
1407 </sect3>
1408
1409 <sect3 id="MONTH">
1410 <title>MONTH</title>
1411 <para>The MONTH functions returns the month of a date. If no parameter is specified the current month gets returned.</para>
1412 <para><segmentedlist><segtitle>Return type</segtitle>
1413 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1414 <variablelist>
1415 <varlistentry><term>Syntax</term>
1416 <listitem><para>MONTH(date)</para></listitem>
1417 </varlistentry>
1418 <varlistentry><term>Parameters</term>
1419 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1420 <seglistitem><seg>Date</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1421 </varlistentry>
1422 <varlistentry><term>Examples</term>
1423 <listitem><para>MONTH("2/22/2002") returns 2</para></listitem>
1424 </varlistentry>
1425 <varlistentry><term>Examples</term>
1426 <listitem><para>MONTH(2323.1285) returns 5</para></listitem>
1427 </varlistentry>
1428 <varlistentry><term>Related Functions</term>
1429 <listitem><simplelist>
1430 <member><link linkend="DAY">DAY</link> </member>
1431 <member><link linkend="YEAR">YEAR</link> </member>
1432 </simplelist></listitem>
1433 </varlistentry>
1434 </variablelist>
1435 </sect3>
1436
1437 <sect3 id="MONTHNAME">
1438 <title>MONTHNAME</title>
1439 <para>The MONTHNAME() function returns the name of the month (1...12).</para>
1440 <para><segmentedlist><segtitle>Return type</segtitle>
1441 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
1442 <variablelist>
1443 <varlistentry><term>Syntax</term>
1444 <listitem><para>MONTHNAME(number)</para></listitem>
1445 </varlistentry>
1446 <varlistentry><term>Parameters</term>
1447 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1448 <seglistitem><seg>Number of month (1..12)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1449 </varlistentry>
1450 <varlistentry><term>Examples</term>
1451 <listitem><para>MONTHNAME(5) returns May</para></listitem>
1452 </varlistentry>
1453 </variablelist>
1454 </sect3>
1455
1456 <sect3 id="MONTHS">
1457 <title>MONTHS</title>
1458 <para>The MONTHS() function returns the difference between two dates in months.The third parameter indicates the calculation mode: if the mode is 0, MONTHS() returns the maximal possible number of months between those days. If the mode is 1, it only returns the number of complete months in between.</para>
1459 <para><segmentedlist><segtitle>Return type</segtitle>
1460 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1461 <variablelist>
1462 <varlistentry><term>Syntax</term>
1463 <listitem><para>MONTHS(date2; date1; mode)</para></listitem>
1464 </varlistentry>
1465 <varlistentry><term>Parameters</term>
1466 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1467 <seglistitem><seg>First (earlier) date value</seg><seg>Text</seg></seglistitem>
1468 <seglistitem><seg>Second date value</seg><seg>Text</seg></seglistitem>
1469 <seglistitem><seg>Calculation mode</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1470 </varlistentry>
1471 <varlistentry><term>Examples</term>
1472 <listitem><para>MONTHS("2002-01-18"; "2002-02-26"; 0) returns 1, because there is 1 month and 8 days in between</para></listitem>
1473 </varlistentry>
1474 <varlistentry><term>Examples</term>
1475 <listitem><para>MONTHS("2002-01-19"; "2002-02-26"; 1) returns 0, because there is not a whole month in between, starting at the first day of the month</para></listitem>
1476 </varlistentry>
1477 </variablelist>
1478 </sect3>
1479
1480 <sect3 id="NETWORKDAY">
1481 <title>NETWORKDAY</title>
1482 <para>The NETWORKDAY() function returns the number of working days between startdate and enddate.</para>
1483 <para>Holidays must be one of the following: number = days to add, a single date or an array of dates.</para>
1484 <para><segmentedlist><segtitle>Return type</segtitle>
1485 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1486 <variablelist>
1487 <varlistentry><term>Syntax</term>
1488 <listitem><para>NETWORKDAY(start date; end date; holidays)</para></listitem>
1489 </varlistentry>
1490 <varlistentry><term>Parameters</term>
1491 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1492 <seglistitem><seg>Start date</seg><seg>Text</seg></seglistitem>
1493 <seglistitem><seg>End date</seg><seg>Text</seg></seglistitem>
1494 <seglistitem><seg>Holidays</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1495
1496 </varlistentry>
1497 <varlistentry><term>Examples</term>
1498 <listitem><para>NETWORKDAY("01/01/2001";"01/08/2001") returns 5 workdays</para></listitem>
1499 </varlistentry>
1500 <varlistentry><term>Examples</term>
1501 <listitem><para>NETWORKDAY("01/01/2001";"01/08/2001";2) returns 3 workdays</para></listitem>
1502 </varlistentry>
1503 </variablelist>
1504 </sect3>
1505
1506 <sect3 id="NOW">
1507 <title>NOW</title>
1508 <para>The NOW() function returns the current date and time. It is identical with CURRENTDATETIME and provided for compatibility with other applications.</para>
1509 <para><segmentedlist><segtitle>Return type</segtitle>
1510 <seglistitem><seg>Date</seg></seglistitem></segmentedlist></para>
1511 <variablelist>
1512 <varlistentry><term>Syntax</term>
1513 <listitem><para>NOW()</para></listitem>
1514 </varlistentry>
1515 <varlistentry><term>Parameters</term>
1516 <listitem><para></para></listitem>
1517 </varlistentry>
1518 <varlistentry><term>Examples</term>
1519 <listitem><para>NOW() returns "Saturday 13 April 2002 19:12:01"</para></listitem>
1520 </varlistentry>
1521 <varlistentry><term>Related Functions</term>
1522 <listitem><simplelist>
1523 <member><link linkend="CURRENTTIME">CURRENTTIME</link> </member>
1524 <member><link linkend="TODAY">TODAY</link> </member>
1525 </simplelist></listitem>
1526 </varlistentry>
1527 </variablelist>
1528 </sect3>
1529
1530 <sect3 id="SECOND">
1531 <title>SECOND</title>
1532 <para>The SECOND functions returns the seconds of a time. If no parameter is specified the current second is returned.</para>
1533 <para><segmentedlist><segtitle>Return type</segtitle>
1534 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1535 <variablelist>
1536 <varlistentry><term>Syntax</term>
1537 <listitem><para>SECOND(time)</para></listitem>
1538 </varlistentry>
1539 <varlistentry><term>Parameters</term>
1540 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1541 <seglistitem><seg>Time</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1542 </varlistentry>
1543 <varlistentry><term>Examples</term>
1544 <listitem><para>SECOND("22:10:12") returns 12</para></listitem>
1545 </varlistentry>
1546 <varlistentry><term>Examples</term>
1547 <listitem><para>SECOND(0.1234) returns 42</para></listitem>
1548 </varlistentry>
1549 <varlistentry><term>Related Functions</term>
1550 <listitem><simplelist>
1551 <member><link linkend="HOUR">HOUR</link> </member>
1552 <member><link linkend="MINUTE">MINUTE</link> </member>
1553 </simplelist></listitem>
1554 </varlistentry>
1555 </variablelist>
1556 </sect3>
1557
1558 <sect3 id="SECONDS">
1559 <title>SECONDS</title>
1560 <para>The SECONDS() function returns the value of the seconds in a time expression.</para>
1561 <para><segmentedlist><segtitle>Return type</segtitle>
1562 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1563 <variablelist>
1564 <varlistentry><term>Syntax</term>
1565 <listitem><para>SECONDS(time)</para></listitem>
1566 </varlistentry>
1567 <varlistentry><term>Parameters</term>
1568 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1569 <seglistitem><seg>Time</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1570 </varlistentry>
1571 <varlistentry><term>Examples</term>
1572 <listitem><para>SECONDS("10:5:2") returns 2</para></listitem>
1573 </varlistentry>
1574 </variablelist>
1575 </sect3>
1576
1577 <sect3 id="TIME">
1578 <title>TIME</title>
1579 <para>The TIME() function returns the time formatted with local parameters.</para>
1580 <para><segmentedlist><segtitle>Return type</segtitle>
1581 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
1582 <variablelist>
1583 <varlistentry><term>Syntax</term>
1584 <listitem><para>TIME(hours;minutes;seconds)</para></listitem>
1585 </varlistentry>
1586 <varlistentry><term>Parameters</term>
1587 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1588 <seglistitem><seg>Hours</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
1589 <seglistitem><seg>Minutes</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
1590 <seglistitem><seg>Seconds</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1591 </varlistentry>
1592 <varlistentry><term>Examples</term>
1593 <listitem><para>TIME(10;2;2) returns 10:02:02</para></listitem>
1594 </varlistentry>
1595 <varlistentry><term>Examples</term>
1596 <listitem><para>TIME(10;70;0) returns 11:10:0</para></listitem>
1597 </varlistentry>
1598 <varlistentry><term>Examples</term>
1599 <listitem><para>TIME(10;-40;0) returns 9:20:0</para></listitem>
1600 </varlistentry>
1601 </variablelist>
1602 </sect3>
1603
1604 <sect3 id="TIMEVALUE">
1605 <title>TIMEVALUE</title>
1606 <para>The TIMEVALUE() function returns a number (between 0 and 1) representing the time of day.</para>
1607 <para><segmentedlist><segtitle>Return type</segtitle>
1608 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
1609 <variablelist>
1610 <varlistentry><term>Syntax</term>
1611 <listitem><para>TIMEVALUE(time)</para></listitem>
1612 </varlistentry>
1613 <varlistentry><term>Parameters</term>
1614 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1615 <seglistitem><seg>Time</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1616 </varlistentry>
1617 <varlistentry><term>Examples</term>
1618 <listitem><para>TIMEVALUE("10:05:02") returns 0.42</para></listitem>
1619 </varlistentry>
1620 <varlistentry><term>Related Functions</term>
1621 <listitem><simplelist>
1622 <member><link linkend="DATEVALUE">DATEVALUE</link> </member>
1623 </simplelist></listitem>
1624 </varlistentry>
1625 </variablelist>
1626 </sect3>
1627
1628 <sect3 id="TODAY">
1629 <title>TODAY</title>
1630 <para>The TODAY() function returns the current date.</para>
1631 <para><segmentedlist><segtitle>Return type</segtitle>
1632 <seglistitem><seg>Date</seg></seglistitem></segmentedlist></para>
1633 <variablelist>
1634 <varlistentry><term>Syntax</term>
1635 <listitem><para>TODAY()</para></listitem>
1636 </varlistentry>
1637 <varlistentry><term>Parameters</term>
1638 <listitem><para></para></listitem>
1639 </varlistentry>
1640 <varlistentry><term>Examples</term>
1641 <listitem><para>TODAY() returns "Saturday 13 April 2002"</para></listitem>
1642 </varlistentry>
1643 <varlistentry><term>Related Functions</term>
1644 <listitem><simplelist>
1645 <member><link linkend="CURRENTTIME">CURRENTTIME</link> </member>
1646 <member><link linkend="NOW">NOW</link> </member>
1647 </simplelist></listitem>
1648 </varlistentry>
1649 </variablelist>
1650 </sect3>
1651
1652 <sect3 id="UNIX2DATE">
1653 <title>UNIX2DATE</title>
1654 <para>UNIX2DATE() function converts unix time to a date and time value.</para>
1655 <para>A unix time is the number of seconds after midnight January 1st, 1970.</para>
1656 <para><segmentedlist><segtitle>Return type</segtitle>
1657 <seglistitem><seg>Date</seg></seglistitem></segmentedlist></para>
1658 <variablelist>
1659 <varlistentry><term>Syntax</term>
1660 <listitem><para>UNIX2DATE(unixtime)</para></listitem>
1661 </varlistentry>
1662 <varlistentry><term>Parameters</term>
1663 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1664 <seglistitem><seg>Unixtime</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1665 </varlistentry>
1666 <varlistentry><term>Examples</term>
1667 <listitem><para>UNIX2DATE(0) returns 1970-01-01</para></listitem>
1668 </varlistentry>
1669 </variablelist>
1670 </sect3>
1671
1672 <sect3 id="WEEKDAY">
1673 <title>WEEKDAY</title>
1674 <para>The WEEKDAY() function returns the weekday of given date. If the method is 1 (default) WEEKDAY() returns 1 for sunday, 2 for monday,.. If the method is 2, monday is 1, tuesday 2, ... and if the method is 3 WEEKDAY() returns 0 for monday, 1 for tuesday,...</para>
1675 <para><segmentedlist><segtitle>Return type</segtitle>
1676 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1677 <variablelist>
1678 <varlistentry><term>Syntax</term>
1679 <listitem><para>WEEKDAY(date; method)</para></listitem>
1680 </varlistentry>
1681 <varlistentry><term>Parameters</term>
1682 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1683 <seglistitem><seg>Date</seg><seg>Text</seg></seglistitem>
1684 <seglistitem><seg>Method (optional)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1685 </varlistentry>
1686 <varlistentry><term>Examples</term>
1687 <listitem><para>WEEKDAY("2002-02-22"; 2) returns 5</para></listitem>
1688 </varlistentry>
1689 <varlistentry><term>Related Functions</term>
1690 <listitem><simplelist>
1691 <member><link linkend="DAYNAME">DAYNAME</link> </member>
1692 </simplelist></listitem>
1693 </varlistentry>
1694 </variablelist>
1695 </sect3>
1696
1697 <sect3 id="WEEKNUM">
1698 <title>WEEKNUM</title>
1699 <para>The WEEKNUM() function returns the non-ISO week number in which the date falls into.</para>
1700 <para><segmentedlist><segtitle>Return type</segtitle>
1701 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1702 <variablelist>
1703 <varlistentry><term>Syntax</term>
1704 <listitem><para>WEEKNUM(date; method)</para></listitem>
1705 </varlistentry>
1706 <varlistentry><term>Parameters</term>
1707 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1708 <seglistitem><seg>Date</seg><seg>Text</seg></seglistitem>
1709 <seglistitem><seg>Method (optional)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1710 </varlistentry>
1711 <varlistentry><term>Examples</term>
1712 <listitem><para>WEEKNUM(A1; 1) returns 11 when A1 is "9th of March 2008". Number of the week in the year, with a week beginning on Sunday (1, this is the default if Method is omitted.)</para></listitem>
1713 </varlistentry>
1714 <varlistentry><term>Examples</term>
1715 <listitem><para>WEEKNUM(A1; 2) returns 10 when A1 is "9th of March 2008". Number of the week in the year, with a week beginning on Monday (2)</para></listitem>
1716 </varlistentry>
1717 <varlistentry><term>Related Functions</term>
1718 <listitem><simplelist>
1719 <member><link linkend="ISOWEEKNUM">ISOWEEKNUM</link> </member>
1720 </simplelist></listitem>
1721 </varlistentry>
1722 </variablelist>
1723 </sect3>
1724
1725 <sect3 id="WEEKS">
1726 <title>WEEKS</title>
1727 <para>The WEEKS() function returns the difference between two dates in weeks.The third parameter indicates the calculation mode: if the mode is 0, WEEKS() returns the maximal possible number of weeks between those days. If the mode is 1, it only returns the number of whole weeks in between.</para>
1728 <para><segmentedlist><segtitle>Return type</segtitle>
1729 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1730 <variablelist>
1731 <varlistentry><term>Syntax</term>
1732 <listitem><para>WEEKS(date2; date1; mode)</para></listitem>
1733 </varlistentry>
1734 <varlistentry><term>Parameters</term>
1735 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1736 <seglistitem><seg>First (earlier) date value</seg><seg>Text</seg></seglistitem>
1737 <seglistitem><seg>Second date value</seg><seg>Text</seg></seglistitem>
1738 <seglistitem><seg>Calculation mode</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1739 </varlistentry>
1740 <varlistentry><term>Examples</term>
1741 <listitem><para>WEEKS("2002-02-18"; "2002-02-26"; 0) returns 1, because there is one week and 1 day in between</para></listitem>
1742 </varlistentry>
1743 <varlistentry><term>Examples</term>
1744 <listitem><para>WEEKS("2002-19-02"; "2002-19-02"; 1) returns 0, because there is not a whole week in between, starting at the first day of the week (monday or sunday, depending on your local settings)</para></listitem>
1745 </varlistentry>
1746 </variablelist>
1747 </sect3>
1748
1749 <sect3 id="WEEKSINYEAR">
1750 <title>WEEKSINYEAR</title>
1751 <para>The function WEEKSINYEAR() returns the number of weeks in the given year.</para>
1752 <para><segmentedlist><segtitle>Return type</segtitle>
1753 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1754 <variablelist>
1755 <varlistentry><term>Syntax</term>
1756 <listitem><para>WEEKSINYEAR(year)</para></listitem>
1757 </varlistentry>
1758 <varlistentry><term>Parameters</term>
1759 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1760 <seglistitem><seg>Year</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1761 </varlistentry>
1762 <varlistentry><term>Examples</term>
1763 <listitem><para>WEEKSINYEAR(2000) returns 52</para></listitem>
1764 </varlistentry>
1765 </variablelist>
1766 </sect3>
1767
1768 <sect3 id="WORKDAY">
1769 <title>WORKDAY</title>
1770 <para>The WORKDAY() function returns the date which is working days from the start date.</para>
1771 <para>Holidays must be one of the following: number = days to add, a single date or an array of dates.</para>
1772 <para><segmentedlist><segtitle>Return type</segtitle>
1773 <seglistitem><seg>Date</seg></seglistitem></segmentedlist></para>
1774 <variablelist>
1775 <varlistentry><term>Syntax</term>
1776 <listitem><para>WORKDAY(start date; days; holidays)</para></listitem>
1777 </varlistentry>
1778 <varlistentry><term>Parameters</term>
1779 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1780 <seglistitem><seg>Start date</seg><seg>Text</seg></seglistitem>
1781 <seglistitem><seg>Working days</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
1782 <seglistitem><seg>Holidays</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1783 </varlistentry>
1784 <varlistentry><term>Examples</term>
1785 <listitem><para>if B9 is "01/01/2001", D3 is "01/03/2001", D4 is "01/04/2001" then WORKDAY(B9;2;D3:D4) returns "Fri Jan 5 2001"</para></listitem>
1786 </varlistentry>
1787 </variablelist>
1788 </sect3>
1789
1790 <sect3 id="YEAR">
1791 <title>YEAR</title>
1792 <para>The YEAR functions returns the year of a date. If no parameter is specified the current year gets returned.</para>
1793 <para><segmentedlist><segtitle>Return type</segtitle>
1794 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1795 <variablelist>
1796 <varlistentry><term>Syntax</term>
1797 <listitem><para>YEAR(date)</para></listitem>
1798 </varlistentry>
1799 <varlistentry><term>Parameters</term>
1800 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1801 <seglistitem><seg>Date</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1802 </varlistentry>
1803 <varlistentry><term>Examples</term>
1804 <listitem><para>YEAR("2/22/2002") returns 2002</para></listitem>
1805 </varlistentry>
1806 <varlistentry><term>Examples</term>
1807 <listitem><para>YEAR(2323.1285) returns 1906</para></listitem>
1808 </varlistentry>
1809 <varlistentry><term>Related Functions</term>
1810 <listitem><simplelist>
1811 <member><link linkend="DAY">DAY</link> </member>
1812 <member><link linkend="MONTH">MONTH</link> </member>
1813 </simplelist></listitem>
1814 </varlistentry>
1815 </variablelist>
1816 </sect3>
1817
1818 <sect3 id="YEARFRAC">
1819 <title>YEARFRAC</title>
1820 <para>The YEARFRAC() function returns the number of full days between start date and end date according to the basis.</para>
1821 <para>Basis must be one of the following: 0 = 30/360 US, 1 = Actual/actual, 2 = Actual/360, 3 = Actual/365, 4 = European 30/360</para>
1822 <para><segmentedlist><segtitle>Return type</segtitle>
1823 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1824 <variablelist>
1825 <varlistentry><term>Syntax</term>
1826 <listitem><para>YEARFRAC(start date; end date; basis)</para></listitem>
1827 </varlistentry>
1828 <varlistentry><term>Parameters</term>
1829 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1830 <seglistitem><seg>First date</seg><seg>Text</seg></seglistitem>
1831 <seglistitem><seg>Second date</seg><seg>Text</seg></seglistitem>
1832 <seglistitem><seg>interval</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
1833 </varlistentry>
1834 </variablelist>
1835 </sect3>
1836
1837 <sect3 id="YEARS">
1838 <title>YEARS</title>
1839 <para>The YEARS() function returns the difference between two dates in years. The third parameter indicates the calculation mode: if the mode is 0, YEARS() returns the maximal possible number of years between those days. If the mode is 1, it only returns whole years, starting at the 1st Jan and ending on the 31st Dec.</para>
1840 <para><segmentedlist><segtitle>Return type</segtitle>
1841 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1842 <variablelist>
1843 <varlistentry><term>Syntax</term>
1844 <listitem><para>YEARS(date2; date1; mode)</para></listitem>
1845 </varlistentry>
1846 <varlistentry><term>Parameters</term>
1847 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1848 <seglistitem><seg>First (earlier) date value</seg><seg>Text</seg></seglistitem>
1849 <seglistitem><seg>Second date value</seg><seg>Text</seg></seglistitem>
1850 <seglistitem><seg>Calculation mode</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1851 </varlistentry>
1852 <varlistentry><term>Examples</term>
1853 <listitem><para>YEARS("2001-02-19"; "2002-02-26"; 0) returns 1, because there is one year and 7 days in between</para></listitem>
1854 </varlistentry>
1855 <varlistentry><term>Examples</term>
1856 <listitem><para>YEARS("2002-02-19"; "2002-02-26"; 1) returns 0, because there is not a whole year in between, starting at the first day of the year</para></listitem>
1857 </varlistentry>
1858 </variablelist>
1859 </sect3>
1860
1861 </sect2><sect2 id="Engineering">
1862 <title>Engineering</title>
1863
1864 <sect3 id="BASE">
1865 <title>BASE</title>
1866 <para>The BASE() function converts a number from base-10 to a string value in a target base from 2 to 36.</para>
1867 <para><segmentedlist><segtitle>Return type</segtitle>
1868 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
1869 <variablelist>
1870 <varlistentry><term>Syntax</term>
1871 <listitem><para>BASE(number;base;prec)</para></listitem>
1872 </varlistentry>
1873 <varlistentry><term>Parameters</term>
1874 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1875 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
1876 <seglistitem><seg>Base</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
1877 <seglistitem><seg>MinLength</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1878 </varlistentry>
1879 <varlistentry><term>Examples</term>
1880 <listitem><para>BASE(128;8) returns "200"</para></listitem>
1881 </varlistentry>
1882 </variablelist>
1883 </sect3>
1884
1885 <sect3 id="BESSELI">
1886 <title>BESSELI</title>
1887 <para>The BESSELI() function returns the modified Bessel function In(x).</para>
1888 <para><segmentedlist><segtitle>Return type</segtitle>
1889 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
1890 <variablelist>
1891 <varlistentry><term>Syntax</term>
1892 <listitem><para>BESSELI(X;N)</para></listitem>
1893 </varlistentry>
1894 <varlistentry><term>Parameters</term>
1895 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1896 <seglistitem><seg>Where the function is evaluated</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
1897 <seglistitem><seg>Order of the function</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1898 </varlistentry>
1899 <varlistentry><term>Examples</term>
1900 <listitem><para>BESSELI(0.7;3) returns 0.007367374</para></listitem>
1901 </varlistentry>
1902 <varlistentry><term>Related Functions</term>
1903 <listitem><simplelist>
1904 <member><link linkend="BESSELJ">BESSELJ</link> </member>
1905 <member><link linkend="BESSELK">BESSELK</link> </member>
1906 <member><link linkend="BESSELY">BESSELY</link> </member>
1907 </simplelist></listitem>
1908 </varlistentry>
1909 </variablelist>
1910 </sect3>
1911
1912 <sect3 id="BESSELJ">
1913 <title>BESSELJ</title>
1914 <para>The BESSELJ() function returns the Bessel function.</para>
1915 <para><segmentedlist><segtitle>Return type</segtitle>
1916 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
1917 <variablelist>
1918 <varlistentry><term>Syntax</term>
1919 <listitem><para>BESSELJ(X;N)</para></listitem>
1920 </varlistentry>
1921 <varlistentry><term>Parameters</term>
1922 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1923 <seglistitem><seg>Where the function is evaluated</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
1924 <seglistitem><seg>Order of the function</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1925 </varlistentry>
1926 <varlistentry><term>Examples</term>
1927 <listitem><para>BESSELJ(0.89;3) returns 0.013974004</para></listitem>
1928 </varlistentry>
1929 <varlistentry><term>Related Functions</term>
1930 <listitem><simplelist>
1931 <member><link linkend="BESSELI">BESSELI</link> </member>
1932 <member><link linkend="BESSELK">BESSELK</link> </member>
1933 <member><link linkend="BESSELY">BESSELY</link> </member>
1934 </simplelist></listitem>
1935 </varlistentry>
1936 </variablelist>
1937 </sect3>
1938
1939 <sect3 id="BESSELK">
1940 <title>BESSELK</title>
1941 <para>The BESSELK() function returns the modified Bessel function, which is equivalent to the Bessel function evaluated for purely imaginary arguments.</para>
1942 <para><segmentedlist><segtitle>Return type</segtitle>
1943 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
1944 <variablelist>
1945 <varlistentry><term>Syntax</term>
1946 <listitem><para>BESSELK(X;N)</para></listitem>
1947 </varlistentry>
1948 <varlistentry><term>Parameters</term>
1949 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1950 <seglistitem><seg>Where the function is evaluated</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
1951 <seglistitem><seg>Order of the function</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1952 </varlistentry>
1953 <varlistentry><term>Examples</term>
1954 <listitem><para>BESSELK(3;9) returns 397.95880</para></listitem>
1955 </varlistentry>
1956 <varlistentry><term>Related Functions</term>
1957 <listitem><simplelist>
1958 <member><link linkend="BESSELI">BESSELI</link> </member>
1959 <member><link linkend="BESSELJ">BESSELJ</link> </member>
1960 <member><link linkend="BESSELY">BESSELY</link> </member>
1961 </simplelist></listitem>
1962 </varlistentry>
1963 </variablelist>
1964 </sect3>
1965
1966 <sect3 id="BESSELY">
1967 <title>BESSELY</title>
1968 <para>The BESSELY() function returns the Bessel function, which is also called the Weber function or the Neumann function.</para>
1969 <para><segmentedlist><segtitle>Return type</segtitle>
1970 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
1971 <variablelist>
1972 <varlistentry><term>Syntax</term>
1973 <listitem><para>BESSELY(X;N)</para></listitem>
1974 </varlistentry>
1975 <varlistentry><term>Parameters</term>
1976 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
1977 <seglistitem><seg>Where the function is evaluated</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
1978 <seglistitem><seg>Order of the function</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
1979 </varlistentry>
1980 <varlistentry><term>Examples</term>
1981 <listitem><para>BESSELY(4;2) equals 0.215903595</para></listitem>
1982 </varlistentry>
1983 <varlistentry><term>Related Functions</term>
1984 <listitem><simplelist>
1985 <member><link linkend="BESSELI">BESSELI</link> </member>
1986 <member><link linkend="BESSELJ">BESSELJ</link> </member>
1987 <member><link linkend="BESSELK">BESSELK</link> </member>
1988 </simplelist></listitem>
1989 </varlistentry>
1990 </variablelist>
1991
1992 </sect3>
1993
1994 <sect3 id="BIN2DEC">
1995 <title>BIN2DEC</title>
1996 <para>The BIN2DEC() function returns the value formatted as a decimal number.</para>
1997 <para><segmentedlist><segtitle>Return type</segtitle>
1998 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
1999 <variablelist>
2000 <varlistentry><term>Syntax</term>
2001 <listitem><para>BIN2DEC(value)</para></listitem>
2002 </varlistentry>
2003 <varlistentry><term>Parameters</term>
2004 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2005 <seglistitem><seg>The value to convert</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
2006 </varlistentry>
2007 <varlistentry><term>Examples</term>
2008 <listitem><para>BIN2DEC("1010") returns 10 </para></listitem>
2009 </varlistentry>
2010 <varlistentry><term>Examples</term>
2011 <listitem><para>BIN2DEC("11111") returns 31 </para></listitem>
2012 </varlistentry>
2013 </variablelist>
2014 </sect3>
2015
2016 <sect3 id="BIN2HEX">
2017 <title>BIN2HEX</title>
2018 <para>The BIN2HEX() function returns the value formatted as a hexadecimal number.</para>
2019 <para><segmentedlist><segtitle>Return type</segtitle>
2020 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2021 <variablelist>
2022 <varlistentry><term>Syntax</term>
2023 <listitem><para>BIN2HEX(value)</para></listitem>
2024 </varlistentry>
2025 <varlistentry><term>Parameters</term>
2026 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2027 <seglistitem><seg>The value to convert</seg><seg>Text</seg></seglistitem>
2028 <seglistitem><seg>The minimum length of the output</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
2029 </varlistentry>
2030 <varlistentry><term>Examples</term>
2031 <listitem><para>BIN2HEX("1010") returns "a"</para></listitem>
2032 </varlistentry>
2033 <varlistentry><term>Examples</term>
2034 <listitem><para>BIN2HEX("11111") returns "1f"</para></listitem>
2035 </varlistentry>
2036 </variablelist>
2037 </sect3>
2038
2039 <sect3 id="BIN2OCT">
2040 <title>BIN2OCT</title>
2041 <para>The BIN2OCT() function returns the value formatted as an octal number.</para>
2042 <para><segmentedlist><segtitle>Return type</segtitle>
2043 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2044 <variablelist>
2045 <varlistentry><term>Syntax</term>
2046 <listitem><para>BIN2OCT(value)</para></listitem>
2047 </varlistentry>
2048 <varlistentry><term>Parameters</term>
2049 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2050 <seglistitem><seg>The value to convert</seg><seg>Text</seg></seglistitem>
2051 <seglistitem><seg>The minimum length of the output</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
2052 </varlistentry>
2053 <varlistentry><term>Examples</term>
2054 <listitem><para>BIN2OCT("1010") returns "12" </para></listitem>
2055 </varlistentry>
2056 <varlistentry><term>Examples</term>
2057 <listitem><para>BIN2OCT("11111") returns "37" </para></listitem>
2058 </varlistentry>
2059 </variablelist>
2060 </sect3>
2061
2062 <sect3 id="COMPLEX">
2063 <title>COMPLEX</title>
2064 <para>The COMPLEX(real;imag) returns a complex number of form x+yi.</para>
2065 <para><segmentedlist><segtitle>Return type</segtitle>
2066 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2067 <variablelist>
2068 <varlistentry><term>Syntax</term>
2069 <listitem><para>COMPLEX(real;imag)</para></listitem>
2070 </varlistentry>
2071 <varlistentry><term>Parameters</term>
2072 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2073 <seglistitem><seg>Real coefficient</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
2074 <seglistitem><seg>Imaginary coefficient</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
2075 </varlistentry>
2076 <varlistentry><term>Examples</term>
2077 <listitem><para>COMPLEX(1.2;3.4) returns "1.2+3.4i"</para></listitem>
2078 </varlistentry>
2079 <varlistentry><term>Examples</term>
2080 <listitem><para>COMPLEX(0;-1) returns "-i"</para></listitem>
2081 </varlistentry>
2082 </variablelist>
2083 </sect3>
2084
2085 <sect3 id="CONVERT">
2086 <title>CONVERT</title>
2087 <para>The CONVERT() function returns a conversion from one measurement system to another.</para>
2088 <para>Supported mass units: g (gram), sg (pieces), lbm (pound), u (atomic mass), ozm (ounce), stone, ton, grain, pweight (pennyweight), hweight (hundredweight).</para>
2089 <para>Supported distance units: m (meter), in (inch), ft (feet), mi (mile), Nmi (nautical mile), ang (Angstrom), parsec, lightyear.</para>
2090 <para>Supported pressure units: Pa (Pascal), atm (atmosphere), mmHg (mm of Mercury), psi, Torr.</para>
2091 <para>Supported force units: N (Newton), dyn, pound.</para>
2092 <para>Supported energy units: J (Joule), e (erg), c (Thermodynamic calorie), cal (IT calorie), eV (electronvolt), HPh (Horsepower-hour), Wh (Watt-hour), flb (foot-pound), BTU.</para>
2093 <para>Supported power units: W (Watt), HP (horsepower), PS (Pferdestaerke).</para>
2094 <para>Supported magnetism units: T (Tesla), ga (Gauss).</para>
2095 <para>Supported temperature units: C (Celsius), F (Fahrenheit), K (Kelvin).</para>
2096 <para>Supported volume units: l (liter), tsp (teaspoon), tbs (tablespoon), oz (ounce liquid), cup, pt (pint), qt (quart), gal (gallon), barrel, m3 (cubic meter), mi3 (cubic mile), Nmi3 (cubic Nautical mile), in3 (cubic inch), ft3 (cubic foot), yd3 (cubic yard), GRT or regton (gross register ton).</para>
2097 <para>Supported area units: m2 (square meter), mi2 (square mile), Nmi2 (square Nautical mile), in2 (square inch), ft2 (square foot), yd2 (square yard), acre, ha (hectare).</para>
2098 <para>Supported speed units: m/s (meters per second), m/h (meters per hour), mph (miles per hour), kn (knot).</para>
2099 <para>For metric units any of the following prefixes can be used: E (exa, 1E+18), P (peta, 1E+15), T (tera, 1E+12), G (giga, 1E+09), M (mega, 1E+06), k (kilo, 1E+03), h (hecto, 1E+02), e (dekao, 1E+01), d (deci, 1E-01), c (centi, 1E-02), m (milli, 1E-03), u (micro, 1E-06), n (nano, 1E-09), p (pico, 1E-12), f (femto, 1E-15), a (atto, 1E-18).</para>
2100 <para><segmentedlist><segtitle>Return type</segtitle>
2101 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
2102 <variablelist>
2103 <varlistentry><term>Syntax</term>
2104 <listitem><para>CONVERT(Number; From Unit; To Unit)</para></listitem>
2105 </varlistentry>
2106 <varlistentry><term>Parameters</term>
2107 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2108 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
2109 <seglistitem><seg>From unit</seg><seg>Text</seg></seglistitem>
2110 <seglistitem><seg>To unit</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2111 </varlistentry>
2112 <varlistentry><term>Examples</term>
2113 <listitem><para>CONVERT(32;"C";"F") equals 89.6</para></listitem>
2114 </varlistentry>
2115 <varlistentry><term>Examples</term>
2116 <listitem><para>CONVERT(3;"lbm";"kg") equals 1.3608</para></listitem>
2117 </varlistentry>
2118 <varlistentry><term>Examples</term>
2119 <listitem><para>CONVERT(7.9;"cal";"J") equals 33.0757</para></listitem>
2120 </varlistentry>
2121 </variablelist>
2122 </sect3>
2123
2124 <sect3 id="DEC2BIN">
2125 <title>DEC2BIN</title>
2126 <para>The DEC2BIN() function returns the value formatted as a binary number.</para>
2127 <para><segmentedlist><segtitle>Return type</segtitle>
2128 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2129 <variablelist>
2130 <varlistentry><term>Syntax</term>
2131 <listitem><para>DEC2BIN(value)</para></listitem>
2132 </varlistentry>
2133 <varlistentry><term>Parameters</term>
2134 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2135 <seglistitem><seg>The value to convert</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
2136 <seglistitem><seg>The minimum length of the output</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
2137 </varlistentry>
2138 <varlistentry><term>Examples</term>
2139 <listitem><para>DEC2BIN(12) returns "1100"</para></listitem>
2140 </varlistentry>
2141 <varlistentry><term>Examples</term>
2142 <listitem><para>DEC2BIN(55) returns "110111"</para></listitem>
2143 </varlistentry>
2144 </variablelist>
2145 </sect3>
2146
2147 <sect3 id="DEC2HEX">
2148 <title>DEC2HEX</title>
2149 <para>The DEC2HEX() function returns the value formatted as a hexadecimal number.</para>
2150 <para><segmentedlist><segtitle>Return type</segtitle>
2151 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2152 <variablelist>
2153 <varlistentry><term>Syntax</term>
2154 <listitem><para>DEC2HEX(value)</para></listitem>
2155 </varlistentry>
2156 <varlistentry><term>Parameters</term>
2157 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2158 <seglistitem><seg>The value to convert</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
2159 <seglistitem><seg>The minimum length of the output</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
2160 </varlistentry>
2161 <varlistentry><term>Examples</term>
2162 <listitem><para>DEC2HEX(12) returns "c"</para></listitem>
2163 </varlistentry>
2164 <varlistentry><term>Examples</term>
2165 <listitem><para>DEC2HEX(55) returns "37"</para></listitem>
2166 </varlistentry>
2167 </variablelist>
2168 </sect3>
2169
2170 <sect3 id="DEC2OCT">
2171 <title>DEC2OCT</title>
2172 <para>The DEC2OCT() function returns the value formatted as an octal number.</para>
2173 <para><segmentedlist><segtitle>Return type</segtitle>
2174 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2175 <variablelist>
2176 <varlistentry><term>Syntax</term>
2177 <listitem><para>DEC2OCT(value)</para></listitem>
2178 </varlistentry>
2179 <varlistentry><term>Parameters</term>
2180 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2181 <seglistitem><seg>The value to convert</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
2182 <seglistitem><seg>The minimum length of the output</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
2183 </varlistentry>
2184 <varlistentry><term>Examples</term>
2185 <listitem><para>DEC2OCT(12) returns "14"</para></listitem>
2186 </varlistentry>
2187 <varlistentry><term>Examples</term>
2188 <listitem><para>DEC2OCT(55) returns "67"</para></listitem>
2189 </varlistentry>
2190 </variablelist>
2191 </sect3>
2192
2193 <sect3 id="DELTA">
2194 <title>DELTA</title>
2195 <para>The DELTA() function returns 1 if x equals y, otherwise returns 0. y defaults to 0.</para>
2196 <para><segmentedlist><segtitle>Return type</segtitle>
2197 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
2198 <variablelist>
2199 <varlistentry><term>Syntax</term>
2200 <listitem><para>DELTA(x; y)</para></listitem>
2201 </varlistentry>
2202 <varlistentry><term>Parameters</term>
2203 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2204 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
2205 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
2206 </varlistentry>
2207 <varlistentry><term>Examples</term>
2208 <listitem><para>DELTA(1.2; 3.4) returns 0</para></listitem>
2209 </varlistentry>
2210 <varlistentry><term>Examples</term>
2211 <listitem><para>DELTA(3; 3) returns 1</para></listitem>
2212 </varlistentry>
2213 <varlistentry><term>Examples</term>
2214 <listitem><para>DELTA(1; TRUE) returns 1</para></listitem>
2215 </varlistentry>
2216 </variablelist>
2217 </sect3>
2218
2219 <sect3 id="ERF">
2220 <title>ERF</title>
2221 <para>The ERF() function returns the error function. With a single argument, ERF() returns the error function between 0 and that argument.</para>
2222 <para><segmentedlist><segtitle>Return type</segtitle>
2223 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
2224 <variablelist>
2225 <varlistentry><term>Syntax</term>
2226 <listitem><para>ERF(Lower limit; Upper limit)</para></listitem>
2227 </varlistentry>
2228 <varlistentry><term>Parameters</term>
2229 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2230 <seglistitem><seg>Lower limit</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
2231 <seglistitem><seg>Upper limit</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
2232 </varlistentry>
2233 <varlistentry><term>Examples</term>
2234 <listitem><para>ERF(0.4) equals 0.42839236</para></listitem>
2235 </varlistentry>
2236 <varlistentry><term>Related Functions</term>
2237 <listitem><simplelist>
2238 <member><link linkend="ERFC">ERFC</link> </member>
2239 </simplelist></listitem>
2240 </varlistentry>
2241 </variablelist>
2242 </sect3>
2243
2244 <sect3 id="ERFC">
2245 <title>ERFC</title>
2246 <para>The ERFC() function returns the complementary error function.</para>
2247 <para><segmentedlist><segtitle>Return type</segtitle>
2248 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
2249 <variablelist>
2250 <varlistentry><term>Syntax</term>
2251 <listitem><para>ERFC(Lower limit; Upper limit)</para></listitem>
2252 </varlistentry>
2253 <varlistentry><term>Parameters</term>
2254 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2255 <seglistitem><seg>Lower limit</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
2256 <seglistitem><seg>Upper limit</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
2257 </varlistentry>
2258 <varlistentry><term>Examples</term>
2259 <listitem><para>ERFC(0.4) equals 0.57160764</para></listitem>
2260 </varlistentry>
2261 <varlistentry><term>Related Functions</term>
2262 <listitem><simplelist>
2263 <member><link linkend="ERF">ERF</link> </member>
2264 </simplelist></listitem>
2265 </varlistentry>
2266 </variablelist>
2267 </sect3>
2268
2269 <sect3 id="GESTEP">
2270 <title>GESTEP</title>
2271 <para>The GESTEP() function returns 1 if x greater or equals y, otherwise returns 0. y defaults to 0.</para>
2272 <para><segmentedlist><segtitle>Return type</segtitle>
2273 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
2274 <variablelist>
2275 <varlistentry><term>Syntax</term>
2276 <listitem><para>GESTEP(x; y)</para></listitem>
2277 </varlistentry>
2278 <varlistentry><term>Parameters</term>
2279 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2280 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
2281 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
2282 </varlistentry>
2283 <varlistentry><term>Examples</term>
2284 <listitem><para>GESTEP(1.2; 3.4) returns 0</para></listitem>
2285 </varlistentry>
2286 <varlistentry><term>Examples</term>
2287 <listitem><para>GESTEP(3; 3) returns 1</para></listitem>
2288 </varlistentry>
2289 <varlistentry><term>Examples</term>
2290 <listitem><para>GESTEP(0.4; TRUE) returns 0</para></listitem>
2291 </varlistentry>
2292 <varlistentry><term>Examples</term>
2293 <listitem><para>GESTEP(4; 3) returns 1</para></listitem>
2294 </varlistentry>
2295 </variablelist>
2296 </sect3>
2297
2298 <sect3 id="HEX2BIN">
2299 <title>HEX2BIN</title>
2300 <para>The HEX2BIN() function returns the value formatted as a binary number.</para>
2301 <para><segmentedlist><segtitle>Return type</segtitle>
2302 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2303 <variablelist>
2304 <varlistentry><term>Syntax</term>
2305 <listitem><para>HEX2BIN(value)</para></listitem>
2306 </varlistentry>
2307 <varlistentry><term>Parameters</term>
2308 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2309 <seglistitem><seg>The value to convert</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2310 </varlistentry>
2311 <varlistentry><term>Examples</term>
2312 <listitem><para>HEX2BIN("a") returns "1010"</para></listitem>
2313 </varlistentry>
2314 <varlistentry><term>Examples</term>
2315 <listitem><para>HEX2BIN("37") returns "110111"</para></listitem>
2316 </varlistentry>
2317 </variablelist>
2318 </sect3>
2319
2320 <sect3 id="HEX2DEC">
2321 <title>HEX2DEC</title>
2322 <para>The HEX2DEC() function returns the value formatted as a decimal number.</para>
2323 <para><segmentedlist><segtitle>Return type</segtitle>
2324 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
2325 <variablelist>
2326 <varlistentry><term>Syntax</term>
2327 <listitem><para>HEX2DEC(value)</para></listitem>
2328 </varlistentry>
2329 <varlistentry><term>Parameters</term>
2330 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2331 <seglistitem><seg>The value to convert</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2332 </varlistentry>
2333 <varlistentry><term>Examples</term>
2334 <listitem><para>HEX2DEC("a") returns 10 </para></listitem>
2335 </varlistentry>
2336 <varlistentry><term>Examples</term>
2337 <listitem><para>HEX2DEC("37") returns 55 </para></listitem>
2338 </varlistentry>
2339 </variablelist>
2340 </sect3>
2341
2342 <sect3 id="HEX2OCT">
2343 <title>HEX2OCT</title>
2344 <para>The HEX2OCT() function returns the value formatted as an octal number.</para>
2345 <para><segmentedlist><segtitle>Return type</segtitle>
2346 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2347 <variablelist>
2348 <varlistentry><term>Syntax</term>
2349 <listitem><para>HEX2OCT(value)</para></listitem>
2350 </varlistentry>
2351 <varlistentry><term>Parameters</term>
2352 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2353 <seglistitem><seg>The value to convert</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2354 </varlistentry>
2355 <varlistentry><term>Examples</term>
2356 <listitem><para>HEX2OCT("a") returns "12" </para></listitem>
2357 </varlistentry>
2358 <varlistentry><term>Examples</term>
2359 <listitem><para>HEX2OCT("37") returns "67" </para></listitem>
2360 </varlistentry>
2361 </variablelist>
2362 </sect3>
2363
2364 <sect3 id="IMABS">
2365 <title>IMABS</title>
2366 <para>The IMABS(complex number) returns the norm of a complex number of form x+yi.</para>
2367 <para><segmentedlist><segtitle>Return type</segtitle>
2368 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
2369 <variablelist>
2370 <varlistentry><term>Syntax</term>
2371 <listitem><para>IMABS(complex number)</para></listitem>
2372 </varlistentry>
2373 <varlistentry><term>Parameters</term>
2374 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2375 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2376 </varlistentry>
2377 <varlistentry><term>Examples</term>
2378 <listitem><para>IMABS("1.2+5i") returns 5.1419</para></listitem>
2379 </varlistentry>
2380 <varlistentry><term>Examples</term>
2381 <listitem><para>IMABS("-i") returns 1</para></listitem>
2382 </varlistentry>
2383 <varlistentry><term>Examples</term>
2384 <listitem><para>IMABS("12") returns 12</para></listitem>
2385 </varlistentry>
2386 </variablelist>
2387 </sect3>
2388
2389 <sect3 id="IMAGINARY">
2390 <title>IMAGINARY</title>
2391 <para>The IMAGINARY(string) returns the imaginary coefficient of a complex.</para>
2392 <para><segmentedlist><segtitle>Return type</segtitle>
2393 <seglistitem><seg>Double</seg></seglistitem></segmentedlist></para>
2394 <variablelist>
2395 <varlistentry><term>Syntax</term>
2396 <listitem><para>IMAGINARY(string)</para></listitem>
2397 </varlistentry>
2398 <varlistentry><term>Parameters</term>
2399 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2400 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2401 </varlistentry>
2402 <varlistentry><term>Examples</term>
2403 <listitem><para>IMAGINARY("1.2+3.4i") returns 3.4</para></listitem>
2404 </varlistentry>
2405 <varlistentry><term>Examples</term>
2406 <listitem><para>IMAGINARY("1.2") returns 0 </para></listitem>
2407 </varlistentry>
2408 </variablelist>
2409 </sect3>
2410
2411 <sect3 id="IMARGUMENT">
2412 <title>IMARGUMENT</title>
2413 <para>The IMARGUMENT(complex number) returns the argument of a complex number of form x+yi.</para>
2414 <para><segmentedlist><segtitle>Return type</segtitle>
2415 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2416 <variablelist>
2417 <varlistentry><term>Syntax</term>
2418 <listitem><para>IMARGUMENT(complex number)</para></listitem>
2419 </varlistentry>
2420 <varlistentry><term>Parameters</term>
2421 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2422 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2423 </varlistentry>
2424 <varlistentry><term>Examples</term>
2425 <listitem><para>IMARGUMENT("1.2+5i") returns 0.6072</para></listitem>
2426 </varlistentry>
2427 <varlistentry><term>Examples</term>
2428 <listitem><para>IMARGUMENT("-i") returns -1.57079633 </para></listitem>
2429 </varlistentry>
2430 <varlistentry><term>Examples</term>
2431 <listitem><para>IMARGUMENT("12") returns "#Div/0"</para></listitem>
2432 </varlistentry>
2433 </variablelist>
2434 </sect3>
2435
2436 <sect3 id="IMCONJUGATE">
2437 <title>IMCONJUGATE</title>
2438 <para>The IMCONJUGATE(complex number) returns the conjugate of a complex number of form x+yi.</para>
2439 <para><segmentedlist><segtitle>Return type</segtitle>
2440 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2441 <variablelist>
2442 <varlistentry><term>Syntax</term>
2443 <listitem><para>IMCONJUGATE(complex number)</para></listitem>
2444 </varlistentry>
2445 <varlistentry><term>Parameters</term>
2446 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2447 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2448 </varlistentry>
2449 <varlistentry><term>Examples</term>
2450 <listitem><para>IMCONJUGATE("1.2+5i") returns "1.2-5i"</para></listitem>
2451 </varlistentry>
2452 <varlistentry><term>Examples</term>
2453 <listitem><para>IMCONJUGATE("-i") returns "i"</para></listitem>
2454 </varlistentry>
2455 <varlistentry><term>Examples</term>
2456 <listitem><para>IMCONJUGATE("12") returns "12"</para></listitem>
2457 </varlistentry>
2458 </variablelist>
2459 </sect3>
2460
2461 <sect3 id="IMCOS">
2462 <title>IMCOS</title>
2463 <para>The IMCOS(string) returns the cosine of a complex number.</para>
2464 <para><segmentedlist><segtitle>Return type</segtitle>
2465 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2466 <variablelist>
2467 <varlistentry><term>Syntax</term>
2468 <listitem><para>IMCOS(string)</para></listitem>
2469 </varlistentry>
2470 <varlistentry><term>Parameters</term>
2471 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2472 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2473 </varlistentry>
2474 <varlistentry><term>Examples</term>
2475 <listitem><para>IMCOS("1+i") returns "0.83373-0.988898i"</para></listitem>
2476 </varlistentry>
2477 <varlistentry><term>Examples</term>
2478 <listitem><para>IMCOS("12i") returns 81 377.4 </para></listitem>
2479 </varlistentry>
2480 </variablelist>
2481 </sect3>
2482
2483 <sect3 id="IMCOSH">
2484 <title>IMCOSH</title>
2485 <para>The IMCOSH(string) returns the hyperbolic cosine of a complex number.</para>
2486 <para><segmentedlist><segtitle>Return type</segtitle>
2487 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2488 <variablelist>
2489 <varlistentry><term>Syntax</term>
2490
2491 <listitem><para>IMCOSH(string)</para></listitem>
2492 </varlistentry>
2493 <varlistentry><term>Parameters</term>
2494 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2495 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2496 </varlistentry>
2497 <varlistentry><term>Examples</term>
2498 <listitem><para>IMCOSH("1+i") returns "0.83373+0.988898i"</para></listitem>
2499 </varlistentry>
2500 <varlistentry><term>Examples</term>
2501 <listitem><para>IMCOSH("12i") returns 0.84358 </para></listitem>
2502 </varlistentry>
2503 </variablelist>
2504 </sect3>
2505
2506 <sect3 id="IMCOT">
2507 <title>IMCOT</title>
2508 <para>The IMCOT(string) returns the cotangent of a complex number.</para>
2509 <para><segmentedlist><segtitle>Return type</segtitle>
2510 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2511 <variablelist>
2512 <varlistentry><term>Syntax</term>
2513 <listitem><para>IMCOT(string)</para></listitem>
2514 </varlistentry>
2515 <varlistentry><term>Parameters</term>
2516 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2517 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2518 </varlistentry>
2519 <varlistentry><term>Examples</term>
2520 <listitem><para>IMCOT("1+i") returns "0.21762-0.86801i"</para></listitem>
2521 </varlistentry>
2522 </variablelist>
2523 </sect3>
2524
2525 <sect3 id="IMCSC">
2526 <title>IMCSC</title>
2527 <para>The IMCSC(string) returns the cosecant of a complex number.</para>
2528 <para><segmentedlist><segtitle>Return type</segtitle>
2529 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2530 <variablelist>
2531 <varlistentry><term>Syntax</term>
2532 <listitem><para>IMCSC(string)</para></listitem>
2533 </varlistentry>
2534 <varlistentry><term>Parameters</term>
2535 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2536 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2537 </varlistentry>
2538 <varlistentry><term>Examples</term>
2539 <listitem><para>IMCSC("1+i") returns "0.62151-0.30393i"</para></listitem>
2540 </varlistentry>
2541 </variablelist>
2542 </sect3>
2543
2544 <sect3 id="IMCSCH">
2545 <title>IMCSCH</title>
2546 <para>The IMCSCH(string) returns the hyperbolic cosecant of a complex number.</para>
2547 <para><segmentedlist><segtitle>Return type</segtitle>
2548 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2549 <variablelist>
2550 <varlistentry><term>Syntax</term>
2551 <listitem><para>IMCSCH(string)</para></listitem>
2552 </varlistentry>
2553 <varlistentry><term>Parameters</term>
2554 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2555 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2556 </varlistentry>
2557 <varlistentry><term>Examples</term>
2558 <listitem><para>IMCSCH("1+i") returns "0.30393-i0.62151"</para></listitem>
2559 </varlistentry>
2560 </variablelist>
2561 </sect3>
2562
2563 <sect3 id="IMDIV">
2564 <title>IMDIV</title>
2565 <para>The IMDIV() returns the division of several complex numbers of form x+yi.</para>
2566 <para><segmentedlist><segtitle>Return type</segtitle>
2567 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2568 <variablelist>
2569 <varlistentry><term>Syntax</term>
2570 <listitem><para>IMDIV(value;value;...)</para></listitem>
2571 </varlistentry>
2572 <varlistentry><term>Parameters</term>
2573 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2574 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2575 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2576 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2577 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2578 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
2579 </varlistentry>
2580 <varlistentry><term>Examples</term>
2581 <listitem><para>IMDIV(1.2;"3.4+5i") returns "0.111597-0.164114i"</para></listitem>
2582 </varlistentry>
2583 <varlistentry><term>Examples</term>
2584 <listitem><para>IMDIV("12+i";"12-i") returns "0.986207+0.16551i"</para></listitem>
2585 </varlistentry>
2586 </variablelist>
2587 </sect3>
2588
2589 <sect3 id="IMEXP">
2590 <title>IMEXP</title>
2591 <para>The IMEXP(string) returns the exponential of a complex number.</para>
2592 <para><segmentedlist><segtitle>Return type</segtitle>
2593 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2594 <variablelist>
2595 <varlistentry><term>Syntax</term>
2596 <listitem><para>IMEXP(string)</para></listitem>
2597 </varlistentry>
2598 <varlistentry><term>Parameters</term>
2599 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2600 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2601 </varlistentry>
2602 <varlistentry><term>Examples</term>
2603 <listitem><para>IMEXP("2-i") returns "3.99232-6.21768i"</para></listitem>
2604 </varlistentry>
2605 <varlistentry><term>Examples</term>
2606 <listitem><para>IMEXP("12i") returns "0.843854-0.536573i" </para></listitem>
2607 </varlistentry>
2608 </variablelist>
2609 </sect3>
2610
2611 <sect3 id="IMLN">
2612 <title>IMLN</title>
2613 <para>The IMLN(string) returns the natural logarithm of a complex number.</para>
2614 <para><segmentedlist><segtitle>Return type</segtitle>
2615 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2616 <variablelist>
2617 <varlistentry><term>Syntax</term>
2618 <listitem><para>IMLN(string)</para></listitem>
2619 </varlistentry>
2620 <varlistentry><term>Parameters</term>
2621 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2622 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2623 </varlistentry>
2624 <varlistentry><term>Examples</term>
2625 <listitem><para>IMLN("3-i") returns "1.15129-0.321751i"</para></listitem>
2626 </varlistentry>
2627 <varlistentry><term>Examples</term>
2628 <listitem><para>IMLN("12") returns 2.48491 </para></listitem>
2629 </varlistentry>
2630 </variablelist>
2631 </sect3>
2632
2633 <sect3 id="IMLOG10">
2634 <title>IMLOG10</title>
2635 <para>The IMLOG10(string) returns the base-10 logarithm of a complex number.</para>
2636 <para><segmentedlist><segtitle>Return type</segtitle>
2637 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2638 <variablelist>
2639 <varlistentry><term>Syntax</term>
2640 <listitem><para>IMLOG10(string)</para></listitem>
2641 </varlistentry>
2642 <varlistentry><term>Parameters</term>
2643 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2644 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2645 </varlistentry>
2646 <varlistentry><term>Examples</term>
2647 <listitem><para>IMLOG10("3+4i") returns "0.69897+0.402719i"</para></listitem>
2648 </varlistentry>
2649 </variablelist>
2650 </sect3>
2651
2652 <sect3 id="IMLOG2">
2653 <title>IMLOG2</title>
2654 <para>The IMLOG2(string) returns the base-2 logarithm of a complex number.</para>
2655 <para><segmentedlist><segtitle>Return type</segtitle>
2656 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2657 <variablelist>
2658 <varlistentry><term>Syntax</term>
2659 <listitem><para>IMLOG2(string)</para></listitem>
2660 </varlistentry>
2661 <varlistentry><term>Parameters</term>
2662 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2663 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2664 </varlistentry>
2665 <varlistentry><term>Examples</term>
2666 <listitem><para>IMLOG2("3+4i") returns "2.321928+1.337804i"</para></listitem>
2667 </varlistentry>
2668 </variablelist>
2669 </sect3>
2670
2671 <sect3 id="IMPOWER">
2672 <title>IMPOWER</title>
2673 <para>The IMPOWER(string) returns a complex number raised to a power.</para>
2674 <para><segmentedlist><segtitle>Return type</segtitle>
2675 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2676 <variablelist>
2677 <varlistentry><term>Syntax</term>
2678 <listitem><para>IMPOWER(string)</para></listitem>
2679 </varlistentry>
2680 <varlistentry><term>Parameters</term>
2681 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2682 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem>
2683 <seglistitem><seg>Power</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
2684 </varlistentry>
2685 <varlistentry><term>Examples</term>
2686 <listitem><para>IMPOWER("4-i";2) returns "15-8i"</para></listitem>
2687 </varlistentry>
2688 <varlistentry><term>Examples</term>
2689 <listitem><para>IMPOWER("1.2";2) returns 1.44 </para></listitem>
2690 </varlistentry>
2691 </variablelist>
2692 </sect3>
2693
2694 <sect3 id="IMPRODUCT">
2695 <title>IMPRODUCT</title>
2696 <para>The IMPRODUCT() returns the product of several complex numbers of form x+yi.</para>
2697 <para><segmentedlist><segtitle>Return type</segtitle>
2698 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2699 <variablelist>
2700 <varlistentry><term>Syntax</term>
2701 <listitem><para>IMPRODUCT(value;value;...)</para></listitem>
2702 </varlistentry>
2703 <varlistentry><term>Parameters</term>
2704 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2705 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2706 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2707 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2708 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2709 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
2710 </varlistentry>
2711 <varlistentry><term>Examples</term>
2712 <listitem><para>IMPRODUCT(1.2;"3.4+5i") returns "4.08+6i"</para></listitem>
2713 </varlistentry>
2714 <varlistentry><term>Examples</term>
2715 <listitem><para>IMPRODUCT(1.2;"1i") returns "+1.2i"</para></listitem>
2716 </varlistentry>
2717 </variablelist>
2718 </sect3>
2719
2720 <sect3 id="IMREAL">
2721 <title>IMREAL</title>
2722 <para>The IMREAL(string) returns the real coefficient of a complex.</para>
2723 <para><segmentedlist><segtitle>Return type</segtitle>
2724 <seglistitem><seg>Double</seg></seglistitem></segmentedlist></para>
2725 <variablelist>
2726 <varlistentry><term>Syntax</term>
2727 <listitem><para>IMREAL(string)</para></listitem>
2728 </varlistentry>
2729 <varlistentry><term>Parameters</term>
2730 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2731 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2732 </varlistentry>
2733 <varlistentry><term>Examples</term>
2734 <listitem><para>IMREAL("1.2+3.4i") returns 1.2</para></listitem>
2735 </varlistentry>
2736 <varlistentry><term>Examples</term>
2737 <listitem><para>IMREAL("1.2i") returns 0 </para></listitem>
2738 </varlistentry>
2739 </variablelist>
2740 </sect3>
2741
2742 <sect3 id="IMSEC">
2743 <title>IMSEC</title>
2744 <para>The IMSEC(string) returns the secant of a complex number.</para>
2745 <para><segmentedlist><segtitle>Return type</segtitle>
2746 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2747 <variablelist>
2748 <varlistentry><term>Syntax</term>
2749 <listitem><para>IMSEC(string)</para></listitem>
2750 </varlistentry>
2751 <varlistentry><term>Parameters</term>
2752 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2753 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2754 </varlistentry>
2755 <varlistentry><term>Examples</term>
2756 <listitem><para>IMSEC("1+i") returns "0.49833+i0.59108"</para></listitem>
2757 </varlistentry>
2758 </variablelist>
2759 </sect3>
2760
2761 <sect3 id="IMSECH">
2762 <title>IMSECH</title>
2763 <para>The IMSECH(string) returns the hyperbolic secant of a complex number.</para>
2764 <para><segmentedlist><segtitle>Return type</segtitle>
2765 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2766 <variablelist>
2767 <varlistentry><term>Syntax</term>
2768 <listitem><para>IMSECH(string)</para></listitem>
2769 </varlistentry>
2770 <varlistentry><term>Parameters</term>
2771 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2772 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2773 </varlistentry>
2774 <varlistentry><term>Examples</term>
2775 <listitem><para>IMSECH("1+i") returns "0.49833-i0.59108"</para></listitem>
2776 </varlistentry>
2777 </variablelist>
2778 </sect3>
2779
2780 <sect3 id="IMSIN">
2781 <title>IMSIN</title>
2782 <para>The IMSIN(string) function returns the sine of a complex number.</para>
2783 <para><segmentedlist><segtitle>Return type</segtitle>
2784 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2785 <variablelist>
2786 <varlistentry><term>Syntax</term>
2787 <listitem><para>IMSIN(string)</para></listitem>
2788 </varlistentry>
2789 <varlistentry><term>Parameters</term>
2790 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2791 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2792 </varlistentry>
2793 <varlistentry><term>Examples</term>
2794 <listitem><para>IMSIN("1+i") returns "1.29846+0.634964i"</para></listitem>
2795 </varlistentry>
2796 <varlistentry><term>Examples</term>
2797 <listitem><para>IMSIN("1.2") returns -0.536573 </para></listitem>
2798 </varlistentry>
2799 </variablelist>
2800 </sect3>
2801
2802 <sect3 id="IMSINH">
2803 <title>IMSINH</title>
2804 <para>The IMSINH(string) function returns the hyperbolic sine of a complex number.</para>
2805 <para><segmentedlist><segtitle>Return type</segtitle>
2806 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2807 <variablelist>
2808 <varlistentry><term>Syntax</term>
2809 <listitem><para>IMSINH(string)</para></listitem>
2810 </varlistentry>
2811 <varlistentry><term>Parameters</term>
2812 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2813 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2814 </varlistentry>
2815 <varlistentry><term>Examples</term>
2816 <listitem><para>IMSINH("1+i") returns "0.63496+1.29846i"</para></listitem>
2817 </varlistentry>
2818 <varlistentry><term>Examples</term>
2819 <listitem><para>IMSINH("1.2") returns 1.50946 </para></listitem>
2820 </varlistentry>
2821 </variablelist>
2822 </sect3>
2823
2824 <sect3 id="IMSQRT">
2825 <title>IMSQRT</title>
2826 <para>The IMSQRT(string) returns the square root of a complex number.</para>
2827 <para><segmentedlist><segtitle>Return type</segtitle>
2828 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2829 <variablelist>
2830 <varlistentry><term>Syntax</term>
2831 <listitem><para>IMSQRT(string)</para></listitem>
2832 </varlistentry>
2833 <varlistentry><term>Parameters</term>
2834 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2835 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2836 </varlistentry>
2837 <varlistentry><term>Examples</term>
2838 <listitem><para>IMSQRT("1+i") returns "1.09868+0.45509i"</para></listitem>
2839 </varlistentry>
2840 <varlistentry><term>Examples</term>
2841 <listitem><para>IMSQRT("1.2i") returns "0.774597+0.774597i" </para></listitem>
2842 </varlistentry>
2843 </variablelist>
2844 </sect3>
2845
2846 <sect3 id="IMSUB">
2847 <title>IMSUB</title>
2848 <para>The IMSUB() returns the difference of several complex numbers of form x+yi.</para>
2849 <para><segmentedlist><segtitle>Return type</segtitle>
2850 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2851 <variablelist>
2852 <varlistentry><term>Syntax</term>
2853 <listitem><para>IMSUB(value;value;...)</para></listitem>
2854 </varlistentry>
2855 <varlistentry><term>Parameters</term>
2856 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2857 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2858 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2859 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2860 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2861 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
2862 </varlistentry>
2863 <varlistentry><term>Examples</term>
2864 <listitem><para>IMSUB(1.2;"3.4+5i") returns "-2.2-5i"</para></listitem>
2865 </varlistentry>
2866 <varlistentry><term>Examples</term>
2867 <listitem><para>IMSUB(1.2;"1i") returns "1.2-i"</para></listitem>
2868 </varlistentry>
2869 </variablelist>
2870 </sect3>
2871
2872 <sect3 id="IMSUM">
2873 <title>IMSUM</title>
2874 <para>The IMSUM() returns the sum of several complex numbers of form x+yi.</para>
2875 <para><segmentedlist><segtitle>Return type</segtitle>
2876 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2877 <variablelist>
2878 <varlistentry><term>Syntax</term>
2879 <listitem><para>IMSUM(value;value;...)</para></listitem>
2880 </varlistentry>
2881 <varlistentry><term>Parameters</term>
2882 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2883 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2884 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2885 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2886 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem>
2887 <seglistitem><seg>Complex number</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
2888 </varlistentry>
2889 <varlistentry><term>Examples</term>
2890 <listitem><para>IMSUM(1.2;"3.4+5i") returns "4.6+5i"</para></listitem>
2891 </varlistentry>
2892 <varlistentry><term>Examples</term>
2893 <listitem><para>IMSUM(1.2;"1i") returns "1.2+i"</para></listitem>
2894 </varlistentry>
2895 </variablelist>
2896 </sect3>
2897
2898 <sect3 id="IMTAN">
2899 <title>IMTAN</title>
2900 <para>The IMTAN(string) function returns the tangent of a complex number.</para>
2901 <para><segmentedlist><segtitle>Return type</segtitle>
2902 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2903 <variablelist>
2904 <varlistentry><term>Syntax</term>
2905 <listitem><para>IMTAN(string)</para></listitem>
2906 </varlistentry>
2907 <varlistentry><term>Parameters</term>
2908 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2909 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2910 </varlistentry>
2911 <varlistentry><term>Examples</term>
2912 <listitem><para>IMTAN("1+i") returns "0.27175+1.08392i"</para></listitem>
2913 </varlistentry>
2914 <varlistentry><term>Examples</term>
2915 <listitem><para>IMTAN("1.2") returns 2.57215</para></listitem>
2916 </varlistentry>
2917 </variablelist>
2918 </sect3>
2919
2920 <sect3 id="IMTANH">
2921 <title>IMTANH</title>
2922 <para>The IMTANH(string) function returns the hyperbolic tangent of a complex number.</para>
2923 <para><segmentedlist><segtitle>Return type</segtitle>
2924 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2925 <variablelist>
2926 <varlistentry><term>Syntax</term>
2927 <listitem><para>IMTANH(string)</para></listitem>
2928 </varlistentry>
2929 <varlistentry><term>Parameters</term>
2930 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2931 <seglistitem><seg>Complex number</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2932 </varlistentry>
2933 <varlistentry><term>Examples</term>
2934 <listitem><para>IMTANH("1+i") returns "1.08392+0.27175i"</para></listitem>
2935 </varlistentry>
2936 <varlistentry><term>Examples</term>
2937 <listitem><para>IMTANH("1.2") returns 0.83365</para></listitem>
2938 </varlistentry>
2939 </variablelist>
2940 </sect3>
2941
2942 <sect3 id="OCT2BIN">
2943 <title>OCT2BIN</title>
2944 <para>The OCT2BIN() function returns the value formatted as a binary number.</para>
2945 <para><segmentedlist><segtitle>Return type</segtitle>
2946 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2947 <variablelist>
2948 <varlistentry><term>Syntax</term>
2949 <listitem><para>OCT2BIN(value)</para></listitem>
2950 </varlistentry>
2951 <varlistentry><term>Parameters</term>
2952 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2953 <seglistitem><seg>The value to convert</seg><seg>Text</seg></seglistitem>
2954 <seglistitem><seg>The minimum length of the output</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
2955 </varlistentry>
2956 <varlistentry><term>Examples</term>
2957 <listitem><para>OCT2BIN("12") returns "1010"</para></listitem>
2958 </varlistentry>
2959 <varlistentry><term>Examples</term>
2960 <listitem><para>OCT2BIN("55") returns "101101"</para></listitem>
2961 </varlistentry>
2962 </variablelist>
2963 </sect3>
2964
2965 <sect3 id="OCT2DEC">
2966 <title>OCT2DEC</title>
2967 <para>The OCT2DEC() function returns the value formatted as a decimal number.</para>
2968 <para><segmentedlist><segtitle>Return type</segtitle>
2969 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
2970 <variablelist>
2971 <varlistentry><term>Syntax</term>
2972 <listitem><para>OCT2DEC(value)</para></listitem>
2973 </varlistentry>
2974 <varlistentry><term>Parameters</term>
2975 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2976 <seglistitem><seg>The value to convert</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
2977 </varlistentry>
2978 <varlistentry><term>Examples</term>
2979 <listitem><para>OCT2DEC("12") returns 10 </para></listitem>
2980 </varlistentry>
2981 <varlistentry><term>Examples</term>
2982 <listitem><para>OCT2DEC("55") returns 45 </para></listitem>
2983 </varlistentry>
2984 </variablelist>
2985 </sect3>
2986
2987 <sect3 id="OCT2HEX">
2988 <title>OCT2HEX</title>
2989 <para>The OCT2HEX() function returns the value formatted as a hexadecimal number.</para>
2990 <para><segmentedlist><segtitle>Return type</segtitle>
2991
2992 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
2993 <variablelist>
2994 <varlistentry><term>Syntax</term>
2995 <listitem><para>OCT2HEX(value)</para></listitem>
2996 </varlistentry>
2997 <varlistentry><term>Parameters</term>
2998 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
2999 <seglistitem><seg>The value to convert</seg><seg>Text</seg></seglistitem>
3000 <seglistitem><seg>The minimum length of the output</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3001 </varlistentry>
3002 <varlistentry><term>Examples</term>
3003 <listitem><para>OCT2HEX("12") returns "A"</para></listitem>
3004 </varlistentry>
3005 <varlistentry><term>Examples</term>
3006 <listitem><para>OCT2HEX("55") returns "2D"</para></listitem>
3007 </varlistentry>
3008 </variablelist>
3009 </sect3>
3010
3011 </sect2><sect2 id="Financial">
3012 <title>Financial</title>
3013
3014 <sect3 id="ACCRINT">
3015 <title>ACCRINT</title>
3016 <para>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/365.</para>
3017 <para><segmentedlist><segtitle>Return type</segtitle>
3018 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3019 <variablelist>
3020 <varlistentry><term>Syntax</term>
3021 <listitem><para>ACCRINT(issue; first interest; settlement; rate; par; frequency; basis)</para></listitem>
3022 </varlistentry>
3023 <varlistentry><term>Parameters</term>
3024 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3025 <seglistitem><seg>Issue date</seg><seg>Date</seg></seglistitem>
3026 <seglistitem><seg>First interest</seg><seg>Date</seg></seglistitem>
3027 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
3028 <seglistitem><seg>Annual rate of security</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3029 <seglistitem><seg>Par value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3030 <seglistitem><seg>Number of payments per year</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3031 <seglistitem><seg>Day counting basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3032 </varlistentry>
3033 <varlistentry><term>Examples</term>
3034 <listitem><para>ACCRINT("2/28/2001"; "8/31/2001"; "5/1/2001"; 0.1; 1000; 2; 0) returns 16,944</para></listitem>
3035 </varlistentry>
3036 <varlistentry><term>Related Functions</term>
3037 <listitem><simplelist>
3038 <member><link linkend="ACCRINTM">ACCRINTM</link> </member>
3039 </simplelist></listitem>
3040 </varlistentry>
3041 </variablelist>
3042 </sect3>
3043
3044 <sect3 id="ACCRINTM">
3045 <title>ACCRINTM</title>
3046 <para>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/365.</para>
3047 <para><segmentedlist><segtitle>Return type</segtitle>
3048 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3049 <variablelist>
3050 <varlistentry><term>Syntax</term>
3051 <listitem><para>ACCRINTM(issue; settlement; rate; par; basis)</para></listitem>
3052 </varlistentry>
3053 <varlistentry><term>Parameters</term>
3054 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3055 <seglistitem><seg>Issue date</seg><seg>Date</seg></seglistitem>
3056 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
3057 <seglistitem><seg>Annual rate of security</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3058 <seglistitem><seg>Par value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3059 <seglistitem><seg>Day counting basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3060 </varlistentry>
3061 <varlistentry><term>Examples</term>
3062 <listitem><para>ACCRINTM("2/28/2001"; "8/31/2001"; 0.1; 100) returns 5.0278</para></listitem>
3063 </varlistentry>
3064 <varlistentry><term>Related Functions</term>
3065 <listitem><simplelist>
3066 <member><link linkend="ACCRINT">ACCRINT</link> </member>
3067 </simplelist></listitem>
3068 </varlistentry>
3069 </variablelist>
3070 </sect3>
3071
3072 <sect3 id="AMORDEGRC">
3073 <title>AMORDEGRC</title>
3074 <para>The AMORDEGRC function calculates the amortization value for the French accounting system using degressive depreciation.</para>
3075 <para><segmentedlist><segtitle>Return type</segtitle>
3076 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3077 <variablelist>
3078 <varlistentry><term>Syntax</term>
3079 <listitem><para>AMORDEGRC( Cost; purchaseDate; firstPeriodEndDate; salvage; period; rate; basis)</para></listitem>
3080 </varlistentry>
3081 <varlistentry><term>Parameters</term>
3082 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3083 <seglistitem><seg>Cost</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3084 <seglistitem><seg>Pv</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3085 <seglistitem><seg>Fv</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3086 </varlistentry>
3087 <varlistentry><term>Examples</term>
3088 <listitem><para>AMORDEGRC( 1000; "2006-02-01"; "2006-12-31"; 10; 0; 0.1; 1 ) returns 228</para></listitem>
3089 </varlistentry>
3090 <varlistentry><term>Related Functions</term>
3091 <listitem><simplelist>
3092 <member><link linkend="AMORLINC">AMORLINC</link> </member>
3093 <member><link linkend="DB">DB</link> </member>
3094 <member><link linkend="DDB">DDB</link> </member>
3095 <member><link linkend="YEARFRAC">YEARFRAC</link> </member>
3096 </simplelist></listitem>
3097 </varlistentry>
3098 </variablelist>
3099 </sect3>
3100
3101 <sect3 id="AMORLINC">
3102 <title>AMORLINC</title>
3103 <para>The AMORLINC function calculates the amortization value for the French accounting system using linear depreciation.</para>
3104 <para><segmentedlist><segtitle>Return type</segtitle>
3105 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3106 <variablelist>
3107 <varlistentry><term>Syntax</term>
3108 <listitem><para>AMORLINC( Cost; purchaseDate; firstPeriodEndDate; salvage; period; rate; basis)</para></listitem>
3109 </varlistentry>
3110 <varlistentry><term>Parameters</term>
3111 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3112 <seglistitem><seg>P</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
3113 <seglistitem><seg>Pv</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3114 <seglistitem><seg>Fv</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3115 </varlistentry>
3116 <varlistentry><term>Examples</term>
3117 <listitem><para>AMORLINC( 1000; "2004-02-01"; "2004-12-31"; 10; 0; 0.1; 1 ) returns 91.256831</para></listitem>
3118 </varlistentry>
3119 <varlistentry><term>Related Functions</term>
3120 <listitem><simplelist>
3121 <member><link linkend="AMORDEGRC">AMORDEGRC</link> </member>
3122 <member><link linkend="DB">DB</link> </member>
3123 <member><link linkend="DDB">DDB</link> </member>
3124 <member><link linkend="YEARFRAC">YEARFRAC</link> </member>
3125 </simplelist></listitem>
3126 </varlistentry>
3127 </variablelist>
3128 </sect3>
3129
3130 <sect3 id="COMPOUND">
3131 <title>COMPOUND</title>
3132 <para>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.</para>
3133 <para><segmentedlist><segtitle>Return type</segtitle>
3134 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3135 <variablelist>
3136 <varlistentry><term>Syntax</term>
3137 <listitem><para>COMPOUND(initial;interest;periods;periods_per_year)</para></listitem>
3138 </varlistentry>
3139 <varlistentry><term>Parameters</term>
3140 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3141 <seglistitem><seg>Principal</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3142 <seglistitem><seg>Interest rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3143 <seglistitem><seg>Periods per year</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3144 <seglistitem><seg>Years</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3145 </varlistentry>
3146 <varlistentry><term>Examples</term>
3147 <listitem><para>COMPOUND(5000;0.12;4;5) equals 9030.56</para></listitem>
3148 </varlistentry>
3149 </variablelist>
3150 </sect3>
3151
3152 <sect3 id="CONTINUOUS">
3153 <title>CONTINUOUS</title>
3154 <para>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.</para>
3155 <para><segmentedlist><segtitle>Return type</segtitle>
3156 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3157 <variablelist>
3158 <varlistentry><term>Syntax</term>
3159 <listitem><para>CONTINOUS(principal;interest;years)</para></listitem>
3160 </varlistentry>
3161 <varlistentry><term>Parameters</term>
3162 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3163 <seglistitem><seg>Principal</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3164 <seglistitem><seg>Interest rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3165 <seglistitem><seg>Years</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3166 </varlistentry>
3167 <varlistentry><term>Examples</term>
3168 <listitem><para>CONTINUOUS(1000;0.1;1) equals 1105.17</para></listitem>
3169 </varlistentry>
3170 </variablelist>
3171 </sect3>
3172
3173 <sect3 id="COUPNUM">
3174 <title>COUPNUM</title>
3175 <para>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/365.</para>
3176 <para><segmentedlist><segtitle>Return type</segtitle>
3177 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3178 <variablelist>
3179 <varlistentry><term>Syntax</term>
3180 <listitem><para>COUPNUM(settlement; maturity; frequency; basis)</para></listitem>
3181 </varlistentry>
3182 <varlistentry><term>Parameters</term>
3183 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3184 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
3185 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
3186 <seglistitem><seg>Frequency</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3187 <seglistitem><seg>Day counting basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3188 </varlistentry>
3189 <varlistentry><term>Examples</term>
3190 <listitem><para>COUPNUM("2/28/2001"; "8/31/2001"; 2; 0) returns 1</para></listitem>
3191 </varlistentry>
3192 </variablelist>
3193 </sect3>
3194
3195 <sect3 id="CUMIPMT">
3196 <title>CUMIPMT</title>
3197 <para>Calculates the cumulative interest payment.</para>
3198 <para><segmentedlist><segtitle>Return type</segtitle>
3199 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3200 <variablelist>
3201 <varlistentry><term>Syntax</term>
3202 <listitem><para>CUMIPMT(rate, periods, value, start, end, type)</para></listitem>
3203 </varlistentry>
3204 <varlistentry><term>Parameters</term>
3205 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3206 <seglistitem><seg>rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3207 <seglistitem><seg>periods</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3208 <seglistitem><seg>value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3209 <seglistitem><seg>start</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
3210 <seglistitem><seg>end</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
3211 <seglistitem><seg>type</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3212 </varlistentry>
3213 <varlistentry><term>Examples</term>
3214 <listitem><para>CUMIPMT( 0.06/12; 5*12; 100000; 5; 12; 0 ) equals -3562,187023</para></listitem>
3215 </varlistentry>
3216 <varlistentry><term>Related Functions</term>
3217 <listitem><simplelist>
3218 <member><link linkend="IPMT">IPMT</link> </member>
3219 <member><link linkend="CUMPRINC">CUMPRINC</link> </member>
3220 </simplelist></listitem>
3221 </varlistentry>
3222 </variablelist>
3223 </sect3>
3224
3225 <sect3 id="CUMPRINC">
3226 <title>CUMPRINC</title>
3227 <para>Calculates the cumulative principal payment.</para>
3228 <para><segmentedlist><segtitle>Return type</segtitle>
3229 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3230 <variablelist>
3231 <varlistentry><term>Syntax</term>
3232 <listitem><para>CUMPRINC(rate, periods, value, start, end, type)</para></listitem>
3233 </varlistentry>
3234 <varlistentry><term>Parameters</term>
3235 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3236 <seglistitem><seg>rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3237 <seglistitem><seg>periods</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3238 <seglistitem><seg>value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3239 <seglistitem><seg>start</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
3240 <seglistitem><seg>end</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
3241 <seglistitem><seg>type</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3242 </varlistentry>
3243 <varlistentry><term>Examples</term>
3244 <listitem><para>CUMPRINC( 0.06/12; 5*12; 100000; 5; 12; 0 ) equals -11904.054201</para></listitem>
3245 </varlistentry>
3246 <varlistentry><term>Related Functions</term>
3247 <listitem><simplelist>
3248 <member><link linkend="PPMT">PPMT</link> </member>
3249 <member><link linkend="CUMIPMT">CUMIPMT</link> </member>
3250 </simplelist></listitem>
3251 </varlistentry>
3252 </variablelist>
3253 </sect3>
3254
3255 <sect3 id="DB">
3256 <title>DB</title>
3257 <para>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.</para>
3258 <para><segmentedlist><segtitle>Return type</segtitle>
3259 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3260 <variablelist>
3261 <varlistentry><term>Syntax</term>
3262 <listitem><para>DB(cost; salvage value; life; period [;month])</para></listitem>
3263 </varlistentry>
3264 <varlistentry><term>Parameters</term>
3265 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3266 <seglistitem><seg>Cost</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3267 <seglistitem><seg>Salvage</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3268 <seglistitem><seg>Life</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3269 <seglistitem><seg>Period</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3270 <seglistitem><seg>Month</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3271 </varlistentry>
3272 <varlistentry><term>Examples</term>
3273 <listitem><para>DB(8000;400;6;3) equals 1158.40</para></listitem>
3274 </varlistentry>
3275 <varlistentry><term>Examples</term>
3276 <listitem><para>DB(8000;400;6;3;2) equals 1783.41</para></listitem>
3277 </varlistentry>
3278 <varlistentry><term>Related Functions</term>
3279 <listitem><simplelist>
3280 <member><link linkend="DDB">DDB</link> </member>
3281 <member><link linkend="SLN">SLN</link> </member>
3282 </simplelist></listitem>
3283 </varlistentry>
3284 </variablelist>
3285 </sect3>
3286
3287 <sect3 id="DDB">
3288 <title>DDB</title>
3289 <para>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.</para>
3290 <para><segmentedlist><segtitle>Return type</segtitle>
3291 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3292 <variablelist>
3293 <varlistentry><term>Syntax</term>
3294 <listitem><para>DDB(cost; salvage value; life; period [;factor])</para></listitem>
3295 </varlistentry>
3296 <varlistentry><term>Parameters</term>
3297 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3298 <seglistitem><seg>Cost</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3299 <seglistitem><seg>Salvage</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3300 <seglistitem><seg>Life</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3301 <seglistitem><seg>Period</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3302 <seglistitem><seg>Factor</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3303 </varlistentry>
3304 <varlistentry><term>Examples</term>
3305 <listitem><para>DDB(75000;1;60;12;2) returns 1721.81</para></listitem>
3306 </varlistentry>
3307 <varlistentry><term>Related Functions</term>
3308 <listitem><simplelist>
3309 <member><link linkend="SLN">SLN</link> </member>
3310 </simplelist></listitem>
3311 </varlistentry>
3312 </variablelist>
3313 </sect3>
3314
3315 <sect3 id="DISC">
3316 <title>DISC</title>
3317 <para>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/365.</para>
3318 <para><segmentedlist><segtitle>Return type</segtitle>
3319 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3320 <variablelist>
3321 <varlistentry><term>Syntax</term>
3322 <listitem><para>DISC(settlement; maturity; par; redemption [; basis ] )</para></listitem>
3323 </varlistentry>
3324 <varlistentry><term>Parameters</term>
3325 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3326 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
3327 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
3328 <seglistitem><seg>Price per $100 face value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3329 <seglistitem><seg>Redemption</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3330 <seglistitem><seg>Day counting basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3331 </varlistentry>
3332 <varlistentry><term>Examples</term>
3333 <listitem><para>DISC("2/28/2001"; "8/31/2001"; 12; 14) returns 0.2841</para></listitem>
3334 </varlistentry>
3335 <varlistentry><term>Related Functions</term>
3336 <listitem><simplelist>
3337 <member><link linkend="YEARFRAC">YEARFRAC</link> </member>
3338 </simplelist></listitem>
3339 </varlistentry>
3340 </variablelist>
3341 </sect3>
3342
3343 <sect3 id="DOLLARDE">
3344 <title>DOLLARDE</title>
3345 <para>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</para>
3346 <para><segmentedlist><segtitle>Return type</segtitle>
3347 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3348 <variablelist>
3349 <varlistentry><term>Syntax</term>
3350 <listitem><para>DOLLARDE(fractional dollar; fraction)</para></listitem>
3351 </varlistentry>
3352 <varlistentry><term>Parameters</term>
3353 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3354 <seglistitem><seg>Fractional Dollar</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3355 <seglistitem><seg>Fraction</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3356 </varlistentry>
3357 <varlistentry><term>Examples</term>
3358 <listitem><para>DOLLARDE(1.02; 16) - stands for 1 and 2/16 - returns 1.125</para></listitem>
3359 </varlistentry>
3360 <varlistentry><term>Related Functions</term>
3361 <listitem><simplelist>
3362 <member><link linkend="DOLLARFR">DOLLARFR</link> </member>
3363 <member><link linkend="TRUNC">TRUNC</link> </member>
3364 </simplelist></listitem>
3365 </varlistentry>
3366 </variablelist>
3367 </sect3>
3368
3369 <sect3 id="DOLLARFR">
3370 <title>DOLLARFR</title>
3371 <para>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</para>
3372 <para><segmentedlist><segtitle>Return type</segtitle>
3373 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3374 <variablelist>
3375 <varlistentry><term>Syntax</term>
3376 <listitem><para>DOLLARFR(fractional dollar; fraction)</para></listitem>
3377 </varlistentry>
3378 <varlistentry><term>Parameters</term>
3379 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3380 <seglistitem><seg>Decimal Dollar</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3381 <seglistitem><seg>Fraction</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3382 </varlistentry>
3383 <varlistentry><term>Examples</term>
3384 <listitem><para>DOLLARFR(1.125; 16) returns 1.02. (1 + 2/16)</para></listitem>
3385 </varlistentry>
3386 <varlistentry><term>Related Functions</term>
3387 <listitem><simplelist>
3388 <member><link linkend="DOLLARDE">DOLLARDE</link> </member>
3389 <member><link linkend="TRUNC">TRUNC</link> </member>
3390 </simplelist></listitem>
3391 </varlistentry>
3392 </variablelist>
3393 </sect3>
3394
3395 <sect3 id="DURATION">
3396 <title>DURATION</title>
3397 <para>Returns the number of periods needed for an investment to retain a desired value.</para>
3398 <para><segmentedlist><segtitle>Return type</segtitle>
3399 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3400 <variablelist>
3401 <varlistentry><term>Syntax</term>
3402 <listitem><para>DURATION(rate; pv; fv)</para></listitem>
3403 </varlistentry>
3404 <varlistentry><term>Parameters</term>
3405 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3406 <seglistitem><seg>Rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3407 <seglistitem><seg>Present value (PV)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3408 <seglistitem><seg>Future value (FV)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3409 </varlistentry>
3410 <varlistentry><term>Examples</term>
3411 <listitem><para>DURATION(0.1; 1000; 2000) returns 7.27</para></listitem>
3412 </varlistentry>
3413 <varlistentry><term>Related Functions</term>
3414 <listitem><simplelist>
3415 <member><link linkend="FV">FV</link> </member>
3416 <member><link linkend="PV">PV</link> </member>
3417 </simplelist></listitem>
3418 </varlistentry>
3419 </variablelist>
3420 </sect3>
3421
3422 <sect3 id="DURATION_ADD">
3423 <title>DURATION_ADD</title>
3424 <para>Returns the Macauley duration of a fixed interest security in years.</para>
3425 <para><segmentedlist><segtitle>Return type</segtitle>
3426 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3427 <variablelist>
3428 <varlistentry><term>Syntax</term>
3429 <listitem><para>DURATION_ADD(Settlement; Maturity; Coupon; Yield; Frequency; Basis)</para></listitem>
3430 </varlistentry>
3431 <varlistentry><term>Parameters</term>
3432 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3433 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
3434 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
3435 <seglistitem><seg>Coupon</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3436 <seglistitem><seg>Yield</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3437 <seglistitem><seg>Frequency</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3438 <seglistitem><seg>Basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3439 </varlistentry>
3440 <varlistentry><term>Examples</term>
3441 <listitem><para>DURATION_ADD( "1998-01-01"; "2006-01-01"; 0.08; 0.09; 2; 1 ) returns 5.9937749555</para></listitem>
3442 </varlistentry>
3443 <varlistentry><term>Related Functions</term>
3444 <listitem><simplelist>
3445 <member><link linkend="MDURATION">MDURATION</link> </member>
3446 </simplelist></listitem>
3447 </varlistentry>
3448 </variablelist>
3449 </sect3>
3450
3451 <sect3 id="EFFECT">
3452 <title>EFFECT</title>
3453 <para>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%.</para>
3454 <para><segmentedlist><segtitle>Return type</segtitle>
3455 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3456 <variablelist>
3457 <varlistentry><term>Syntax</term>
3458 <listitem><para>EFFECT(nominal;periods)</para></listitem>
3459 </varlistentry>
3460 <varlistentry><term>Parameters</term>
3461 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3462 <seglistitem><seg>Nominal interest rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3463 <seglistitem><seg>Periods</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3464 </varlistentry>
3465 <varlistentry><term>Examples</term>
3466 <listitem><para>EFFECT(0.08;12) equals 0.083</para></listitem>
3467 </varlistentry>
3468 <varlistentry><term>Related Functions</term>
3469 <listitem><simplelist>
3470 <member><link linkend="EFFECTIVE">EFFECTIVE</link> </member>
3471 <member><link linkend="NOMINAL">NOMINAL</link> </member>
3472 </simplelist></listitem>
3473 </varlistentry>
3474
3475 </variablelist>
3476 </sect3>
3477
3478 <sect3 id="EFFECTIVE">
3479 <title>EFFECTIVE</title>
3480 <para>The EFFECTIVE() function calculates the effective yield for a nominal interest rate (annual rate or APR). It is the same as the EFFECT function.</para>
3481 <para><segmentedlist><segtitle>Return type</segtitle>
3482 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3483 <variablelist>
3484 <varlistentry><term>Syntax</term>
3485 <listitem><para>EFFECTIVE(nominal;periods)</para></listitem>
3486 </varlistentry>
3487 <varlistentry><term>Parameters</term>
3488 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3489 <seglistitem><seg>Nominal interest rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3490 <seglistitem><seg>Periods</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3491 </varlistentry>
3492 <varlistentry><term>Related Functions</term>
3493 <listitem><simplelist>
3494 <member><link linkend="EFFECT">EFFECT</link> </member>
3495 </simplelist></listitem>
3496 </varlistentry>
3497 </variablelist>
3498 </sect3>
3499
3500 <sect3 id="EURO">
3501 <title>EURO</title>
3502 <para>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), DEM (Germany), ESP (Spain), EUR (Euro), FIM (Finland), FRF (France), GRD (Greece), IEP (Ireland), ITL (Italy), LUF (Luxembourg), NLG (Netherlands), or PTE (Portugal).</para>
3503 <para><segmentedlist><segtitle>Return type</segtitle>
3504 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3505 <variablelist>
3506 <varlistentry><term>Syntax</term>
3507 <listitem><para>EURO(currency)</para></listitem>
3508 </varlistentry>
3509 <varlistentry><term>Parameters</term>
3510 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3511 <seglistitem><seg>Currency</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
3512 </varlistentry>
3513 <varlistentry><term>Examples</term>
3514 <listitem><para>EURO("DEM") equals 1.95583</para></listitem>
3515 </varlistentry>
3516 <varlistentry><term>Related Functions</term>
3517 <listitem><simplelist>
3518 <member><link linkend="EUROCONVERT">EUROCONVERT</link> </member>
3519 </simplelist></listitem>
3520 </varlistentry>
3521 </variablelist>
3522 </sect3>
3523
3524 <sect3 id="EUROCONVERT">
3525 <title>EUROCONVERT</title>
3526 <para>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).</para>
3527 <para><segmentedlist><segtitle>Return type</segtitle>
3528 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3529 <variablelist>
3530 <varlistentry><term>Syntax</term>
3531 <listitem><para>EUROCONVERT(number; source currency; target currency)</para></listitem>
3532 </varlistentry>
3533 <varlistentry><term>Parameters</term>
3534 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3535 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3536 <seglistitem><seg>Source currency</seg><seg>Text</seg></seglistitem>
3537 <seglistitem><seg>Target currency</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
3538 </varlistentry>
3539 <varlistentry><term>Examples</term>
3540 <listitem><para>EUROCONVERT(1; "EUR"; "DEM") equals 1.95583</para></listitem>
3541 </varlistentry>
3542 <varlistentry><term>Related Functions</term>
3543 <listitem><simplelist>
3544 <member><link linkend="EURO">EURO</link> </member>
3545 </simplelist></listitem>
3546 </varlistentry>
3547 </variablelist>
3548 </sect3>
3549
3550 <sect3 id="FV">
3551 <title>FV</title>
3552 <para>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.</para>
3553 <para><segmentedlist><segtitle>Return type</segtitle>
3554 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3555 <variablelist>
3556 <varlistentry><term>Syntax</term>
3557 <listitem><para>FV(present value;yield;periods)</para></listitem>
3558 </varlistentry>
3559 <varlistentry><term>Parameters</term>
3560 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3561 <seglistitem><seg>Present value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3562 <seglistitem><seg>Rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3563 <seglistitem><seg>Periods</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3564 </varlistentry>
3565 <varlistentry><term>Examples</term>
3566 <listitem><para>FV(1000;0.08;2) equals 1166.40</para></listitem>
3567 </varlistentry>
3568 <varlistentry><term>Related Functions</term>
3569 <listitem><simplelist>
3570 <member><link linkend="PV">PV</link> </member>
3571 <member><link linkend="NPER">NPER</link> </member>
3572 <member><link linkend="PMT">PMT</link> </member>
3573 <member><link linkend="RATE">RATE</link> </member>
3574 </simplelist></listitem>
3575 </varlistentry>
3576 </variablelist>
3577 </sect3>
3578
3579 <sect3 id="FV_ANNUITY">
3580 <title>FV_ANNUITY</title>
3581 <para>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.</para>
3582 <para><segmentedlist><segtitle>Return type</segtitle>
3583 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3584 <variablelist>
3585 <varlistentry><term>Syntax</term>
3586 <listitem><para>FV_ANNUITY(amount;interest;periods)</para></listitem>
3587 </varlistentry>
3588 <varlistentry><term>Parameters</term>
3589 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3590 <seglistitem><seg>Payment per period</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3591 <seglistitem><seg>Interest rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3592 <seglistitem><seg>Periods</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3593 </varlistentry>
3594 <varlistentry><term>Examples</term>
3595 <listitem><para>FV_ANNUITY(1000;0.05;5) equals 5525.63</para></listitem>
3596 </varlistentry>
3597 </variablelist>
3598 </sect3>
3599
3600 <sect3 id="INTRATE">
3601 <title>INTRATE</title>
3602 <para>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/365.</para>
3603 <para><segmentedlist><segtitle>Return type</segtitle>
3604 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3605 <variablelist>
3606 <varlistentry><term>Syntax</term>
3607 <listitem><para>INTRATE(settlement; maturity; investment; redemption; basis)</para></listitem>
3608 </varlistentry>
3609 <varlistentry><term>Parameters</term>
3610 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3611 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
3612 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
3613 <seglistitem><seg>Investment</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3614 <seglistitem><seg>Redemption</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3615 <seglistitem><seg>Day counting basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3616 </varlistentry>
3617 <varlistentry><term>Examples</term>
3618 <listitem><para>INTRATE("2/28/2001"; "8/31/2001"; 1000000; 2000000; 1) returns 1.98</para></listitem>
3619 </varlistentry>
3620 </variablelist>
3621 </sect3>
3622
3623 <sect3 id="IPMT">
3624 <title>IPMT</title>
3625 <para>IPMT calculates the amount of a payment of an annuity going towards interest.</para>
3626 <para>Rate is the periodic interest rate.</para>
3627 <para>Period is the amortizement period. 1 for the first and NPER for the last period.</para>
3628 <para>NPER is the total number of periods during which annuity is paid.</para>
3629 <para>PV is the present value in the sequence of payments.</para>
3630 <para>FV (optional) is the desired (future) value. default: 0.</para>
3631 <para>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.</para>
3632 <para>The example shows the interest to pay in the last year of a three year loan. The interest rate is 10 percent.</para>
3633 <para><segmentedlist><segtitle>Return type</segtitle>
3634 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3635 <variablelist>
3636 <varlistentry><term>Syntax</term>
3637 <listitem><para>IPMT(Rate; Period; NPer; PV; FV; Type)</para></listitem>
3638 </varlistentry>
3639 <varlistentry><term>Parameters</term>
3640 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3641 <seglistitem><seg>Rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3642 <seglistitem><seg>Period</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3643 <seglistitem><seg>Number of periods</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3644 <seglistitem><seg>Present values</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3645 <seglistitem><seg>Future value (optional)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3646 <seglistitem><seg>Type (optional)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3647 </varlistentry>
3648 <varlistentry><term>Examples</term>
3649 <listitem><para>IPMT(0.1;3;3;8000) equals -292.45</para></listitem>
3650 </varlistentry>
3651 <varlistentry><term>Related Functions</term>
3652 <listitem><simplelist>
3653 <member><link linkend="PPMT">PPMT</link> </member>
3654 <member><link linkend="PV">PV</link> </member>
3655 <member><link linkend="PMT">PMT</link> </member>
3656 </simplelist></listitem>
3657 </varlistentry>
3658 </variablelist>
3659 </sect3>
3660
3661 <sect3 id="IRR">
3662 <title>IRR</title>
3663 <para>The IRR function calculates the internal rate of return for a series of cash flows.</para>
3664 <para><segmentedlist><segtitle>Return type</segtitle>
3665 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3666 <variablelist>
3667 <varlistentry><term>Syntax</term>
3668 <listitem><para>IRR( Values[; Guess = 0.1 ] )</para></listitem>
3669 </varlistentry>
3670 <varlistentry><term>Parameters</term>
3671 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3672 <seglistitem><seg>Values</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3673 <seglistitem><seg>Guess</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3674 </varlistentry>
3675 <varlistentry><term>Related Functions</term>
3676 <listitem><simplelist>
3677 <member><link linkend="XIRR">XIRR</link> </member>
3678 </simplelist></listitem>
3679 </varlistentry>
3680 </variablelist>
3681 </sect3>
3682
3683 <sect3 id="ISPMT">
3684 <title>ISPMT</title>
3685 <para>Calculates the interest paid on a given period of an investment.</para>
3686 <para>Rate is the periodic interest rate.</para>
3687 <para>Period is the amortizement period. 1 for the first and NPer for the last period.</para>
3688 <para>NPer is the total number of periods during which annuity is paid.</para>
3689 <para>PV is the present value in the sequence of payments.</para>
3690 <para><segmentedlist><segtitle>Return type</segtitle>
3691 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3692 <variablelist>
3693 <varlistentry><term>Syntax</term>
3694 <listitem><para>ISPMT(Rate; Period; NPer; PV)</para></listitem>
3695 </varlistentry>
3696 <varlistentry><term>Parameters</term>
3697 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3698 <seglistitem><seg>Rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3699 <seglistitem><seg>Period</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
3700 <seglistitem><seg>Number of periods</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
3701 <seglistitem><seg>Present values (PV)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3702 </varlistentry>
3703 <varlistentry><term>Examples</term>
3704 <listitem><para>ISPMT(0.1; 1; 3; 8000000) equals -533333</para></listitem>
3705 </varlistentry>
3706 <varlistentry><term>Related Functions</term>
3707 <listitem><simplelist>
3708 <member><link linkend="PV">PV</link> </member>
3709 <member><link linkend="FV">FV</link> </member>
3710 <member><link linkend="NPER">NPER</link> </member>
3711 <member><link linkend="PMT">PMT</link> </member>
3712 <member><link linkend="RATE">RATE</link> </member>
3713 </simplelist></listitem>
3714 </varlistentry>
3715 </variablelist>
3716 </sect3>
3717
3718 <sect3 id="LEVEL_COUPON">
3719 <title>LEVEL_COUPON</title>
3720 <para>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.</para>
3721 <para><segmentedlist><segtitle>Return type</segtitle>
3722 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3723 <variablelist>
3724 <varlistentry><term>Syntax</term>
3725 <listitem><para>LEVEL_COUPON(face value;coupon rate;coupons per year;years;market rate)</para></listitem>
3726 </varlistentry>
3727 <varlistentry><term>Parameters</term>
3728 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3729 <seglistitem><seg>Face value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3730 <seglistitem><seg>Coupon rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3731 <seglistitem><seg>Coupons per year</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3732 <seglistitem><seg>Years</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3733 <seglistitem><seg>Market interest rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3734 </varlistentry>
3735 <varlistentry><term>Examples</term>
3736 <listitem><para>LEVEL_COUPON(1000;.13;2;4;.1) equals 1096.95</para></listitem>
3737 </varlistentry>
3738 </variablelist>
3739 </sect3>
3740
3741 <sect3 id="MDURATION">
3742 <title>MDURATION</title>
3743 <para>The MDURATION() function will calculate the modified Macauley duration of a fixed interest security in years.</para>
3744 <para><segmentedlist><segtitle>Return type</segtitle>
3745 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3746 <variablelist>
3747 <varlistentry><term>Syntax</term>
3748 <listitem><para>MDURATION( Settlement; Maturity; Coupon; Yield; Frequency; [ Basis=0 ])</para></listitem>
3749 </varlistentry>
3750 <varlistentry><term>Parameters</term>
3751 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3752 <seglistitem><seg>Settlement</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3753 <seglistitem><seg>Maturity</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3754 <seglistitem><seg>Coupon</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3755 <seglistitem><seg>Yield</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3756 <seglistitem><seg>Frequency</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3757 <seglistitem><seg>Basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3758 </varlistentry>
3759 <varlistentry><term>Examples</term>
3760 <listitem><para>MDURATION("2004-02-01"; "2004-05-31"; 0.08; 0.09; 2; 0) returns 0.316321106</para></listitem>
3761 </varlistentry>
3762 <varlistentry><term>Related Functions</term>
3763 <listitem><simplelist>
3764 <member><link linkend="DURATION">DURATION</link> </member>
3765 </simplelist></listitem>
3766 </varlistentry>
3767 </variablelist>
3768 </sect3>
3769
3770 <sect3 id="MIRR">
3771 <title>MIRR</title>
3772 <para>The MIRR() function will calculate the modified internal rate of return (IRR) of a series of periodic investments.</para>
3773 <para><segmentedlist><segtitle>Return type</segtitle>
3774 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3775 <variablelist>
3776 <varlistentry><term>Syntax</term>
3777 <listitem><para>MIRR(values; investment; reinvestment)</para></listitem>
3778 </varlistentry>
3779 <varlistentry><term>Parameters</term>
3780 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3781 <seglistitem><seg>Values</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3782 <seglistitem><seg>Investment</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3783 <seglistitem><seg>Reinvestment</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3784 </varlistentry>
3785 <varlistentry><term>Examples</term>
3786 <listitem><para>MIRR({100;200;-50;300;-200}, 5%, 6%) equals 34.2823387842%</para></listitem>
3787 </varlistentry>
3788 <varlistentry><term>Related Functions</term>
3789 <listitem><simplelist>
3790 <member><link linkend="IRR">IRR</link> </member>
3791 </simplelist></listitem>
3792 </varlistentry>
3793 </variablelist>
3794 </sect3>
3795
3796 <sect3 id="NOMINAL">
3797 <title>NOMINAL</title>
3798 <para>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%.</para>
3799 <para><segmentedlist><segtitle>Return type</segtitle>
3800 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3801 <variablelist>
3802 <varlistentry><term>Syntax</term>
3803 <listitem><para>NOMINAL(effective;periods)</para></listitem>
3804 </varlistentry>
3805 <varlistentry><term>Parameters</term>
3806 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3807 <seglistitem><seg>Effective interest rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3808 <seglistitem><seg>Periods</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3809 </varlistentry>
3810 <varlistentry><term>Examples</term>
3811 <listitem><para>NOMINAL(0.08;12) equals 0.0772</para></listitem>
3812 </varlistentry>
3813 <varlistentry><term>Related Functions</term>
3814 <listitem><simplelist>
3815 <member><link linkend="EFFECT">EFFECT</link> </member>
3816 </simplelist></listitem>
3817 </varlistentry>
3818 </variablelist>
3819 </sect3>
3820
3821 <sect3 id="NPER">
3822 <title>NPER</title>
3823 <para>Returns the number of periods of an investment.</para>
3824 <para><segmentedlist><segtitle>Return type</segtitle>
3825 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3826 <variablelist>
3827 <varlistentry><term>Syntax</term>
3828 <listitem><para>NPER(rate;payment;pv;fv;type)</para></listitem>
3829 </varlistentry>
3830 <varlistentry><term>Parameters</term>
3831 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3832 <seglistitem><seg>Rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3833 <seglistitem><seg>Payment</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3834 <seglistitem><seg>Present value (PV)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3835 <seglistitem><seg>Future value (FV - optional)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3836 <seglistitem><seg>Type (optional)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3837 </varlistentry>
3838 <varlistentry><term>Examples</term>
3839 <listitem><para>NPER(0.1; -100; 1000) equals 11</para></listitem>
3840 </varlistentry>
3841 <varlistentry><term>Examples</term>
3842 <listitem><para>NPER(0.06; 0; -10000; 20000 ;0) returns 11.906</para></listitem>
3843 </varlistentry>
3844 <varlistentry><term>Related Functions</term>
3845 <listitem><simplelist>
3846 <member><link linkend="FV">FV</link> </member>
3847 <member><link linkend="RATE">RATE</link> </member>
3848 <member><link linkend="PMT">PMT</link> </member>
3849 <member><link linkend="PV">PV</link> </member>
3850 </simplelist></listitem>
3851 </varlistentry>
3852 </variablelist>
3853 </sect3>
3854
3855 <sect3 id="NPV">
3856 <title>NPV</title>
3857 <para>The net present value (NPV) for a series of periodic cash flows.</para>
3858 <para>Computes the net present value for a series of periodic cash flows with the
3859 discount rate Rate. Values should be positive if they are received as income, and
3860 negative if the amounts are expenditure.</para>
3861 <para><segmentedlist><segtitle>Return type</segtitle>
3862 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3863 <variablelist>
3864 <varlistentry><term>Syntax</term>
3865 <listitem><para>NPV(Rate; Values)</para></listitem>
3866 </varlistentry>
3867 <varlistentry><term>Parameters</term>
3868 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3869 <seglistitem><seg>Rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3870 <seglistitem><seg>Values (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
3871 </varlistentry>
3872 <varlistentry><term>Examples</term>
3873 <listitem><para>NPV(100%;4;5;7) = 4.125</para></listitem>
3874 </varlistentry>
3875 <varlistentry><term>Related Functions</term>
3876 <listitem><simplelist>
3877 <member><link linkend="FV">FV</link> </member>
3878 <member><link linkend="IRR">IRR</link> </member>
3879 <member><link linkend="NPER">NPER</link> </member>
3880 <member><link linkend="PMT">PMT</link> </member>
3881 <member><link linkend="PV">PV</link> </member>
3882 </simplelist></listitem>
3883 </varlistentry>
3884 </variablelist>
3885 </sect3>
3886
3887 <sect3 id="ODDLPRICE">
3888 <title>ODDLPRICE</title>
3889 <para>The ODDLPRICE function calculates the value of the security per 100 currency units of face value. The security has an irregular last interest date.</para>
3890 <para><segmentedlist><segtitle>Return type</segtitle>
3891 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3892 <variablelist>
3893 <varlistentry><term>Syntax</term>
3894 <listitem><para>ODDLPRICE( Settlement; Maturity; Last; Rate; AnnualYield; Redemption; Frequency [; Basis = 0 ] )</para></listitem>
3895 </varlistentry>
3896 <varlistentry><term>Parameters</term>
3897 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3898 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
3899 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
3900 <seglistitem><seg>Last</seg><seg>Date</seg></seglistitem>
3901 <seglistitem><seg>Rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3902 <seglistitem><seg>AnnualYield</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3903 <seglistitem><seg>Redemption</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3904 <seglistitem><seg>Frequency</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3905 <seglistitem><seg>Basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3906 </varlistentry>
3907 <varlistentry><term>Examples</term>
3908 <listitem><para>ODDLPRICE(DATE(1990;6;1);DATE(1995;12;31);DATE(1990;1;1);3%;5%;100;2) returns 90.991042345</para></listitem>
3909 </varlistentry>
3910 </variablelist>
3911 </sect3>
3912
3913 <sect3 id="ODDLYIELD">
3914 <title>ODDLYIELD</title>
3915 <para>The ODDLYIELD function calculates the yield of the security which has an irregular last interest date.</para>
3916 <para><segmentedlist><segtitle>Return type</segtitle>
3917 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3918 <variablelist>
3919 <varlistentry><term>Syntax</term>
3920 <listitem><para>ODDLYIELD( Settlement; Maturity; Last; Rate; Price; Redemption; Frequency [; Basis = 0 ] )</para></listitem>
3921 </varlistentry>
3922 <varlistentry><term>Parameters</term>
3923 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3924 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
3925 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
3926 <seglistitem><seg>Last</seg><seg>Date</seg></seglistitem>
3927 <seglistitem><seg>Rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3928 <seglistitem><seg>Price</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3929 <seglistitem><seg>Redemption</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3930 <seglistitem><seg>Frequency</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3931 <seglistitem><seg>Basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3932 </varlistentry>
3933 <varlistentry><term>Examples</term>
3934 <listitem><para>ODDLYIELD(DATE(1990;6;1);DATE(1995;12;31);DATE(1990;1;1);3%;91;100;2) returns 4.997775351</para></listitem>
3935 </varlistentry>
3936 <varlistentry><term>Related Functions</term>
3937 <listitem><simplelist>
3938 <member><link linkend="ODDLPRICE">ODDLPRICE</link> </member>
3939 </simplelist></listitem>
3940 </varlistentry>
3941 </variablelist>
3942 </sect3>
3943
3944 <sect3 id="PMT">
3945 <title>PMT</title>
3946 <para>PMT returns the amount of payment for a loan based on a constant interest rate and constant payments (each payment is equal amount).</para>
3947 <para><segmentedlist><segtitle>Return type</segtitle>
3948 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3949 <variablelist>
3950 <varlistentry><term>Syntax</term>
3951 <listitem><para>PMT(rate; nper ; pv [; fv = 0 [; type = 0 ]] )</para></listitem>
3952 </varlistentry>
3953 <varlistentry><term>Parameters</term>
3954 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3955 <seglistitem><seg>Rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3956 <seglistitem><seg>Number of periods (NPer)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3957 <seglistitem><seg>Present value (PV)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3958 <seglistitem><seg>Future value (FV - optional)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3959 <seglistitem><seg>Type (optional)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3960
3961 </varlistentry>
3962 <varlistentry><term>Examples</term>
3963 <listitem><para>PMT(0.1; 4; 10000) equals -3154.71</para></listitem>
3964 </varlistentry>
3965 <varlistentry><term>Related Functions</term>
3966 <listitem><simplelist>
3967 <member><link linkend="NPER">NPER</link> </member>
3968 <member><link linkend="IPMT">IPMT</link> </member>
3969 <member><link linkend="PPMT">PPMT</link> </member>
3970 <member><link linkend="PV">PV</link> </member>
3971 </simplelist></listitem>
3972 </varlistentry>
3973 </variablelist>
3974 </sect3>
3975
3976 <sect3 id="PPMT">
3977 <title>PPMT</title>
3978 <para>PPMT calculates the amount of a payment of an annuity going towards principal.</para>
3979 <para>Rate is the periodic interest rate.</para>
3980 <para>Period is the amortizement period. 1 for the first and NPER for the last period.</para>
3981 <para>NPER is the total number of periods during which annuity is paid.</para>
3982 <para>PV is the present value in the sequence of payments.</para>
3983 <para>FV (optional) is the desired (future) value. default: 0.</para>
3984 <para>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.</para>
3985 <para><segmentedlist><segtitle>Return type</segtitle>
3986 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
3987 <variablelist>
3988 <varlistentry><term>Syntax</term>
3989 <listitem><para>PPMT(Rate; Period; NPer; PV [; FV = 9 [; Type = 0 ]] )</para></listitem>
3990 </varlistentry>
3991 <varlistentry><term>Parameters</term>
3992 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
3993 <seglistitem><seg>Rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3994 <seglistitem><seg>Period</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3995 <seglistitem><seg>Number of periods</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3996 <seglistitem><seg>Present value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3997 <seglistitem><seg>Future value (optional)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
3998 <seglistitem><seg>Type (optional)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
3999 </varlistentry>
4000 <varlistentry><term>Examples</term>
4001 <listitem><para>PPMT(0.0875;1;36;5000;8000;1) equals -18.48</para></listitem>
4002 </varlistentry>
4003 <varlistentry><term>Related Functions</term>
4004 <listitem><simplelist>
4005 <member><link linkend="IPMT">IPMT</link> </member>
4006 <member><link linkend="PMT">PMT</link> </member>
4007 <member><link linkend="PV">PV</link> </member>
4008 </simplelist></listitem>
4009 </varlistentry>
4010 </variablelist>
4011 </sect3>
4012
4013 <sect3 id="PRICEMAT">
4014 <title>PRICEMAT</title>
4015 <para>PRICEMAT Calculate the price per 100 currency units of face value of the security that pays interest on the maturity date.</para>
4016 <para>Basis Calculation method</para>
4017 <para> 0 US method, 12 months, each month with 30 days</para>
4018 <para> 1 Actual number of days in year, actual number of days in months </para>
4019 <para> 2 360 days in a year, actual number of days in months</para>
4020 <para> 4 365 days in a year, actual number of days in months</para>
4021 <para> 5 European method, 12 months, each month has 30 days</para>
4022 <para><segmentedlist><segtitle>Return type</segtitle>
4023 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4024 <variablelist>
4025 <varlistentry><term>Syntax</term>
4026 <listitem><para>PRICEMAT(settlement; maturity; issue; rate; yield [; basis = 0 ] )</para></listitem>
4027 </varlistentry>
4028 <varlistentry><term>Parameters</term>
4029 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4030 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
4031 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
4032 <seglistitem><seg>Issue</seg><seg>Date</seg></seglistitem>
4033 <seglistitem><seg>Discount rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4034 <seglistitem><seg>Yield</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4035 <seglistitem><seg>Basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
4036 </varlistentry>
4037 <varlistentry><term>Examples</term>
4038 <listitem><para>PRICEMAT(DATE(1990;6;1);DATE(1995;12;31);DATE(1990;1;1);6%;5%) returns 103.819218241</para></listitem>
4039 </varlistentry>
4040 </variablelist>
4041 </sect3>
4042
4043 <sect3 id="PV">
4044 <title>PV</title>
4045 <para>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.</para>
4046 <para><segmentedlist><segtitle>Return type</segtitle>
4047 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4048 <variablelist>
4049 <varlistentry><term>Syntax</term>
4050 <listitem><para>PV(future value;rate;periods)</para></listitem>
4051 </varlistentry>
4052 <varlistentry><term>Parameters</term>
4053 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4054 <seglistitem><seg>Future value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4055 <seglistitem><seg>Interest rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4056 <seglistitem><seg>Periods</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
4057 </varlistentry>
4058 <varlistentry><term>Examples</term>
4059 <listitem><para>PV(1166.4;0.08;2) equals 1000</para></listitem>
4060 </varlistentry>
4061 </variablelist>
4062 </sect3>
4063
4064 <sect3 id="PV_ANNUITY">
4065 <title>PV_ANNUITY</title>
4066 <para>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.</para>
4067 <para><segmentedlist><segtitle>Return type</segtitle>
4068 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4069 <variablelist>
4070 <varlistentry><term>Syntax</term>
4071 <listitem><para>PV_ANNUITY(amount;interest;periods)</para></listitem>
4072 </varlistentry>
4073 <varlistentry><term>Parameters</term>
4074 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4075 <seglistitem><seg>Payment per period</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4076 <seglistitem><seg>Interest rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4077 <seglistitem><seg>Periods</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
4078 </varlistentry>
4079 <varlistentry><term>Examples</term>
4080 <listitem><para>PV_ANNUITY(1000;0.05;5) equals 4329.48</para></listitem>
4081 </varlistentry>
4082 </variablelist>
4083 </sect3>
4084
4085 <sect3 id="RATE">
4086 <title>RATE</title>
4087 <para>The RATE() function computes the constant interest rate per period of an investment.</para>
4088 <para><segmentedlist><segtitle>Return type</segtitle>
4089 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4090 <variablelist>
4091 <varlistentry><term>Syntax</term>
4092 <listitem><para>RATE(nper;pmt;pv;fv;type;guess)</para></listitem>
4093 </varlistentry>
4094 <varlistentry><term>Parameters</term>
4095 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4096 <seglistitem><seg>Payment period</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4097 <seglistitem><seg>Regular payments</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4098 <seglistitem><seg>Present value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4099 <seglistitem><seg>Future value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4100 <seglistitem><seg>Type</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4101 <seglistitem><seg>Guess</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
4102 </varlistentry>
4103 <varlistentry><term>Examples</term>
4104 <listitem><para>RATE(4*12;-200;8000) equals 0.007701472</para></listitem>
4105 </varlistentry>
4106 </variablelist>
4107 </sect3>
4108
4109 <sect3 id="RECEIVED">
4110 <title>RECEIVED</title>
4111 <para>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/365. The settlement date must be before maturity date.</para>
4112 <para><segmentedlist><segtitle>Return type</segtitle>
4113 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4114 <variablelist>
4115 <varlistentry><term>Syntax</term>
4116 <listitem><para>RECEIVED(settlement; maturity; investment; discount; basis)</para></listitem>
4117 </varlistentry>
4118 <varlistentry><term>Parameters</term>
4119 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4120 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
4121 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
4122 <seglistitem><seg>Investment</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4123 <seglistitem><seg>Discount rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4124 <seglistitem><seg>Basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
4125 </varlistentry>
4126 <varlistentry><term>Examples</term>
4127 <listitem><para>RECEIVED("2/28/2001"; "8/31/2001"; 1000; 0.05; 0) returns 1,025.787</para></listitem>
4128 </varlistentry>
4129 </variablelist>
4130 </sect3>
4131
4132 <sect3 id="RRI">
4133 <title>RRI</title>
4134 <para>The RRI function calculates the interest rate resulting from the profit (return) of an investment.</para>
4135 <para><segmentedlist><segtitle>Return type</segtitle>
4136 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4137 <variablelist>
4138 <varlistentry><term>Syntax</term>
4139 <listitem><para>RRI( P; Pv; Fv)</para></listitem>
4140 </varlistentry>
4141 <varlistentry><term>Parameters</term>
4142 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4143 <seglistitem><seg>P</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
4144 <seglistitem><seg>Pv</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4145 <seglistitem><seg>Fv</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
4146 </varlistentry>
4147 <varlistentry><term>Examples</term>
4148 <listitem><para>RRI(1;100;200) returns 1</para></listitem>
4149 </varlistentry>
4150 <varlistentry><term>Related Functions</term>
4151 <listitem><simplelist>
4152 <member><link linkend="FV">FV</link> </member>
4153 <member><link linkend="NPER">NPER</link> </member>
4154 <member><link linkend="PMT">PMT</link> </member>
4155 <member><link linkend="PV">PV</link> </member>
4156 <member><link linkend="RATE">RATE</link> </member>
4157 </simplelist></listitem>
4158 </varlistentry>
4159 </variablelist>
4160 </sect3>
4161
4162 <sect3 id="SLN">
4163 <title>SLN</title>
4164 <para>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.</para>
4165 <para><segmentedlist><segtitle>Return type</segtitle>
4166 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4167 <variablelist>
4168 <varlistentry><term>Syntax</term>
4169 <listitem><para>SLN(cost; salvage value; life)</para></listitem>
4170 </varlistentry>
4171 <varlistentry><term>Parameters</term>
4172 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4173 <seglistitem><seg>Cost</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4174 <seglistitem><seg>Salvage</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4175 <seglistitem><seg>Life</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
4176 </varlistentry>
4177 <varlistentry><term>Examples</term>
4178 <listitem><para>SLN(10000;700;10) equals 930</para></listitem>
4179 </varlistentry>
4180 <varlistentry><term>Related Functions</term>
4181 <listitem><simplelist>
4182 <member><link linkend="SYD">SYD</link> </member>
4183 <member><link linkend="DDB">DDB</link> </member>
4184 </simplelist></listitem>
4185 </varlistentry>
4186 </variablelist>
4187 </sect3>
4188
4189 <sect3 id="SYD">
4190 <title>SYD</title>
4191 <para>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.</para>
4192 <para><segmentedlist><segtitle>Return type</segtitle>
4193 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4194 <variablelist>
4195 <varlistentry><term>Syntax</term>
4196 <listitem><para>SYD(cost; salvage value; life; period)</para></listitem>
4197 </varlistentry>
4198 <varlistentry><term>Parameters</term>
4199 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4200 <seglistitem><seg>Cost</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4201 <seglistitem><seg>Salvage</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4202 <seglistitem><seg>Life</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4203 <seglistitem><seg>Period</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
4204 </varlistentry>
4205 <varlistentry><term>Examples</term>
4206 <listitem><para>SYD(5000; 200; 5; 2) equals 1280</para></listitem>
4207 </varlistentry>
4208 <varlistentry><term>Related Functions</term>
4209 <listitem><simplelist>
4210 <member><link linkend="SLN">SLN</link> </member>
4211 <member><link linkend="DDB">DDB</link> </member>
4212 </simplelist></listitem>
4213 </varlistentry>
4214 </variablelist>
4215 </sect3>
4216
4217 <sect3 id="TBILLEQ">
4218 <title>TBILLEQ</title>
4219 <para>The TBILLEQ functions returns the bond equivalent for a treasury bill. The maturity date must be after the settlement date but within 365 days.</para>
4220 <para><segmentedlist><segtitle>Return type</segtitle>
4221 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4222 <variablelist>
4223 <varlistentry><term>Syntax</term>
4224 <listitem><para>TBILLEQ(settlement; maturity; discount)</para></listitem>
4225 </varlistentry>
4226 <varlistentry><term>Parameters</term>
4227 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4228 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
4229 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
4230 <seglistitem><seg>Discount rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
4231 </varlistentry>
4232 <varlistentry><term>Examples</term>
4233 <listitem><para>TBILLEQ("2/28/2001"; "8/31/2001"; 0.1) returns 0.1068</para></listitem>
4234 </varlistentry>
4235 <varlistentry><term>Related Functions</term>
4236 <listitem><simplelist>
4237 <member><link linkend="TBILLPRICE">TBILLPRICE</link> </member>
4238 <member><link linkend="TBILLYIELD">TBILLYIELD</link> </member>
4239 </simplelist></listitem>
4240 </varlistentry>
4241 </variablelist>
4242 </sect3>
4243
4244 <sect3 id="TBILLPRICE">
4245 <title>TBILLPRICE</title>
4246 <para>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.</para>
4247 <para><segmentedlist><segtitle>Return type</segtitle>
4248 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4249 <variablelist>
4250 <varlistentry><term>Syntax</term>
4251 <listitem><para>TBILLPRICE(settlement; maturity; discount)</para></listitem>
4252 </varlistentry>
4253 <varlistentry><term>Parameters</term>
4254 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4255 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
4256 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
4257 <seglistitem><seg>Discount rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
4258 </varlistentry>
4259 <varlistentry><term>Examples</term>
4260 <listitem><para>TBILLPRICE("2/28/2001"; "8/31/2001"; 0.05) returns 97.4444</para></listitem>
4261 </varlistentry>
4262 <varlistentry><term>Related Functions</term>
4263 <listitem><simplelist>
4264 <member><link linkend="TBILLEQ">TBILLEQ</link> </member>
4265 <member><link linkend="TBILLYIELD">TBILLYIELD</link> </member>
4266 </simplelist></listitem>
4267 </varlistentry>
4268 </variablelist>
4269 </sect3>
4270
4271 <sect3 id="TBILLYIELD">
4272 <title>TBILLYIELD</title>
4273 <para>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.</para>
4274 <para><segmentedlist><segtitle>Return type</segtitle>
4275 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4276 <variablelist>
4277 <varlistentry><term>Syntax</term>
4278 <listitem><para>TBILLYIELD(settlement; maturity; price)</para></listitem>
4279 </varlistentry>
4280 <varlistentry><term>Parameters</term>
4281 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4282 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
4283 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
4284 <seglistitem><seg>Price per $100 face value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
4285 </varlistentry>
4286 <varlistentry><term>Examples</term>
4287 <listitem><para>TBILLYIELD("2/28/2001"; "8/31/2001"; 600) returns -1.63</para></listitem>
4288 </varlistentry>
4289 <varlistentry><term>Related Functions</term>
4290 <listitem><simplelist>
4291 <member><link linkend="TBILLEQ">TBILLEQ</link> </member>
4292 <member><link linkend="TBILLPRICE">TBILLPRICE</link> </member>
4293 </simplelist></listitem>
4294 </varlistentry>
4295 </variablelist>
4296 </sect3>
4297
4298 <sect3 id="VDB">
4299 <title>VDB</title>
4300 <para>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.</para>
4301 <para><segmentedlist><segtitle>Return type</segtitle>
4302 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4303 <variablelist>
4304 <varlistentry><term>Syntax</term>
4305 <listitem><para>VDB(cost; salvage; life; start-period; end-period; [; depreciation-factor = 2 [; switch = false ]] )</para></listitem>
4306 </varlistentry>
4307 <varlistentry><term>Parameters</term>
4308 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4309 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
4310 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
4311 <seglistitem><seg>Price</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4312 <seglistitem><seg>Redemption</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4313 <seglistitem><seg>Basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
4314 </varlistentry>
4315 <varlistentry><term>Examples</term>
4316 <listitem><para>VDB(10000;600;10;0;0.875;1.5) returns 1312.5</para></listitem>
4317 </varlistentry>
4318 </variablelist>
4319 </sect3>
4320
4321 <sect3 id="XIRR">
4322 <title>XIRR</title>
4323 <para>The XIRR function calculates the internal rate of return for a non-periodic series of cash flows.</para>
4324 <para><segmentedlist><segtitle>Return type</segtitle>
4325 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4326 <variablelist>
4327 <varlistentry><term>Syntax</term>
4328 <listitem><para>XIRR( Values; Dates[; Guess = 0.1 ] )</para></listitem>
4329 </varlistentry>
4330 <varlistentry><term>Parameters</term>
4331 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4332 <seglistitem><seg>Values</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4333 <seglistitem><seg>Dates</seg><seg>Date</seg></seglistitem>
4334 <seglistitem><seg>Guess</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
4335 </varlistentry>
4336 <varlistentry><term>Examples</term>
4337 <listitem><para>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</para></listitem>
4338 </varlistentry>
4339 <varlistentry><term>Related Functions</term>
4340 <listitem><simplelist>
4341 <member><link linkend="IRR">IRR</link> </member>
4342 </simplelist></listitem>
4343 </varlistentry>
4344 </variablelist>
4345 </sect3>
4346
4347 <sect3 id="XNPV">
4348 <title>XNPV</title>
4349 <para>The XNPV function calculates the net present value of a series of cash flows.</para>
4350 <para><segmentedlist><segtitle>Return type</segtitle>
4351 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4352 <variablelist>
4353 <varlistentry><term>Syntax</term>
4354 <listitem><para>XNPV( Rate; Values; Dates )</para></listitem>
4355 </varlistentry>
4356 <varlistentry><term>Parameters</term>
4357 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4358 <seglistitem><seg>Rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4359 <seglistitem><seg>Values</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4360 <seglistitem><seg>Dates</seg><seg>Date</seg></seglistitem></segmentedlist></para></listitem>
4361 </varlistentry>
4362 <varlistentry><term>Examples</term>
4363 <listitem><para>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</para></listitem>
4364 </varlistentry>
4365 <varlistentry><term>Related Functions</term>
4366 <listitem><simplelist>
4367 <member><link linkend="NPV">NPV</link> </member>
4368 </simplelist></listitem>
4369 </varlistentry>
4370 </variablelist>
4371 </sect3>
4372
4373 <sect3 id="YIELDDISC">
4374 <title>YIELDDISC</title>
4375 <para>YIELDDISC calculates the yield of a discounted security per 100 currency units of face value.</para>
4376 <para><segmentedlist><segtitle>Return type</segtitle>
4377 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4378 <variablelist>
4379 <varlistentry><term>Syntax</term>
4380 <listitem><para>YIELDDISC(settlement; maturity; price, redemp, basis)</para></listitem>
4381 </varlistentry>
4382 <varlistentry><term>Parameters</term>
4383 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4384 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
4385 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
4386 <seglistitem><seg>Price</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4387 <seglistitem><seg>Redemption</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4388 <seglistitem><seg>Basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
4389 </varlistentry>
4390 <varlistentry><term>Examples</term>
4391 <listitem><para>YIELDDISC(DATE(1990;6;1);DATE(1990;12;31);941.66667;1000) returns 0.106194684</para></listitem>
4392 </varlistentry>
4393 </variablelist>
4394 </sect3>
4395
4396 <sect3 id="YIELDMAT">
4397 <title>YIELDMAT</title>
4398 <para>The YIELDMAT function calculates the yield of the security that pays interest on the maturity date.</para>
4399 <para><segmentedlist><segtitle>Return type</segtitle>
4400 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4401 <variablelist>
4402 <varlistentry><term>Syntax</term>
4403 <listitem><para>YIELDMAT( Settlement; Maturity; Issue; Rate; Price; Basis )</para></listitem>
4404 </varlistentry>
4405 <varlistentry><term>Parameters</term>
4406 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4407 <seglistitem><seg>Settlement</seg><seg>Date</seg></seglistitem>
4408 <seglistitem><seg>Maturity</seg><seg>Date</seg></seglistitem>
4409 <seglistitem><seg>Issue</seg><seg>Date</seg></seglistitem>
4410 <seglistitem><seg>Discount rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4411 <seglistitem><seg>Price</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4412 <seglistitem><seg>Basis</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
4413 </varlistentry>
4414 <varlistentry><term>Examples</term>
4415 <listitem><para>YIELDMAT(DATE(1990;6;1);DATE(1995;12;31);DATE(1990; 1; 1); 6%;103.819218241) returns 0.050000000</para></listitem>
4416 </varlistentry>
4417 <varlistentry><term>Related Functions</term>
4418 <listitem><simplelist>
4419 <member><link linkend="YIELDDISC">YIELDDISC</link> </member>
4420 </simplelist></listitem>
4421 </varlistentry>
4422 </variablelist>
4423 </sect3>
4424
4425 <sect3 id="ZERO_COUPON">
4426 <title>ZERO_COUPON</title>
4427 <para>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.</para>
4428 <para><segmentedlist><segtitle>Return type</segtitle>
4429 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
4430 <variablelist>
4431 <varlistentry><term>Syntax</term>
4432 <listitem><para>ZERO_COUPON(face value;rate;years)</para></listitem>
4433 </varlistentry>
4434 <varlistentry><term>Parameters</term>
4435 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4436 <seglistitem><seg>Face value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4437 <seglistitem><seg>Interest rate</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
4438 <seglistitem><seg>Years</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
4439 </varlistentry>
4440 <varlistentry><term>Examples</term>
4441 <listitem><para>ZERO_COUPON(1000;.1;20) equals 148.64</para></listitem>
4442 </varlistentry>
4443
4444 </variablelist>
4445 </sect3>
4446
4447 </sect2><sect2 id="Information">
4448 <title>Information</title>
4449
4450 <sect3 id="ERRORTYPE">
4451 <title>ERRORTYPE</title>
4452 <para>The ERRORTYPE() function converts a error to a number. If the value is not an error, an error is returned. Otherwise, a numerical code is returned. Error codes are modelled on Excel.</para>
4453 <para><segmentedlist><segtitle>Return type</segtitle>
4454 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
4455 <variablelist>
4456 <varlistentry><term>Syntax</term>
4457 <listitem><para>ERRORTYPE(value)</para></listitem>
4458 </varlistentry>
4459 <varlistentry><term>Parameters</term>
4460 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4461 <seglistitem><seg>Error</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4462 </varlistentry>
4463 <varlistentry><term>Examples</term>
4464 <listitem><para>ERRORTYPE(NA()) returns 7</para></listitem>
4465 </varlistentry>
4466 <varlistentry><term>Examples</term>
4467 <listitem><para>ERRORTYPE(0) returns an error</para></listitem>
4468 </varlistentry>
4469 </variablelist>
4470 </sect3>
4471
4472 <sect3 id="FILENAME">
4473 <title>FILENAME</title>
4474 <para>Returns the current filename. If the current document is not saved, an empty string is returned.</para>
4475 <para><segmentedlist><segtitle>Return type</segtitle>
4476 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
4477 <variablelist>
4478 <varlistentry><term>Syntax</term>
4479 <listitem><para>FILENAME()</para></listitem>
4480 </varlistentry>
4481 <varlistentry><term>Parameters</term>
4482 <listitem><para></para></listitem>
4483 </varlistentry>
4484 </variablelist>
4485 </sect3>
4486
4487 <sect3 id="FORMULA">
4488 <title>FORMULA</title>
4489 <para>The FORMULA() function returns the formula of a cell as string.</para>
4490 <para><segmentedlist><segtitle>Return type</segtitle>
4491 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
4492 <variablelist>
4493 <varlistentry><term>Syntax</term>
4494 <listitem><para>FORMULA(x)</para></listitem>
4495 </varlistentry>
4496 <varlistentry><term>Parameters</term>
4497 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4498 <seglistitem><seg>Reference</seg><seg>Reference</seg></seglistitem></segmentedlist></para></listitem>
4499 </varlistentry>
4500 <varlistentry><term>Examples</term>
4501 <listitem><para>FORMULA(A1) returns "=SUM(1+2)" if the cell A1 contains such a formula.</para></listitem>
4502 </varlistentry>
4503 </variablelist>
4504 </sect3>
4505
4506 <sect3 id="INFO">
4507 <title>INFO</title>
4508 <para>The INFO() function returns information about the current operating environment. Parameter type specifies what type of information you want to return. It is one of the following: "directory" returns the path of the current directory, "numfile" returns the number of active documents, "release" returns the version of &sheets; as text, "recalc" returns the current recalculation mode: "Automatic" or "Manual", "system" returns the name of the operating environment, "osversion" returns the current operating system.</para>
4509 <para><segmentedlist><segtitle>Return type</segtitle>
4510 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
4511 <variablelist>
4512 <varlistentry><term>Syntax</term>
4513 <listitem><para>INFO(type)</para></listitem>
4514 </varlistentry>
4515 <varlistentry><term>Parameters</term>
4516 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4517 <seglistitem><seg>Type of information</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
4518 </varlistentry>
4519 </variablelist>
4520 </sect3>
4521
4522 <sect3 id="ISBLANK">
4523 <title>ISBLANK</title>
4524 <para>The ISBLANK() function returns True if the parameter is empty. Otherwise it returns False.</para>
4525 <para><segmentedlist><segtitle>Return type</segtitle>
4526 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4527 <variablelist>
4528 <varlistentry><term>Syntax</term>
4529 <listitem><para>ISBLANK(x)</para></listitem>
4530 </varlistentry>
4531 <varlistentry><term>Parameters</term>
4532 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4533 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4534 </varlistentry>
4535 <varlistentry><term>Examples</term>
4536 <listitem><para>ISBLANK(A1) returns True if A1 is empty</para></listitem>
4537 </varlistentry>
4538 <varlistentry><term>Examples</term>
4539 <listitem><para>ISBLANK(A1) returns False if A1 holds a value</para></listitem>
4540 </varlistentry>
4541 </variablelist>
4542 </sect3>
4543
4544 <sect3 id="ISDATE">
4545 <title>ISDATE</title>
4546 <para>The ISDATE() function returns True if the parameter is a date value. Otherwise it returns False</para>
4547 <para><segmentedlist><segtitle>Return type</segtitle>
4548 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4549 <variablelist>
4550 <varlistentry><term>Syntax</term>
4551 <listitem><para>ISDATE(x)</para></listitem>
4552 </varlistentry>
4553 <varlistentry><term>Parameters</term>
4554 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4555 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4556 </varlistentry>
4557 <varlistentry><term>Examples</term>
4558 <listitem><para>ISDATE("2000-2-2") returns True</para></listitem>
4559 </varlistentry>
4560 <varlistentry><term>Examples</term>
4561 <listitem><para>ISDATE("hello") returns False</para></listitem>
4562 </varlistentry>
4563 </variablelist>
4564 </sect3>
4565
4566 <sect3 id="ISERR">
4567 <title>ISERR</title>
4568 <para>The ISERR() function returns True if its parameter is an error other than N/A. Otherwise, it returns False. Use ISERROR() if you want to include the N/A error as well.</para>
4569 <para><segmentedlist><segtitle>Return type</segtitle>
4570 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4571 <variablelist>
4572 <varlistentry><term>Syntax</term>
4573 <listitem><para>ISERR(x)</para></listitem>
4574 </varlistentry>
4575 <varlistentry><term>Parameters</term>
4576 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4577 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4578 </varlistentry>
4579 <varlistentry><term>Related Functions</term>
4580 <listitem><simplelist>
4581 <member><link linkend="ISERROR">ISERROR</link> </member>
4582 <member><link linkend="ISNA">ISNA</link> </member>
4583 </simplelist></listitem>
4584 </varlistentry>
4585 </variablelist>
4586 </sect3>
4587
4588 <sect3 id="ISERROR">
4589 <title>ISERROR</title>
4590 <para>The ISERROR() function returns True if its parameter is an error of any type. Otherwise, it returns False.</para>
4591 <para><segmentedlist><segtitle>Return type</segtitle>
4592 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4593 <variablelist>
4594 <varlistentry><term>Syntax</term>
4595 <listitem><para>ISERROR(x)</para></listitem>
4596 </varlistentry>
4597 <varlistentry><term>Parameters</term>
4598 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4599 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4600 </varlistentry>
4601 <varlistentry><term>Related Functions</term>
4602 <listitem><simplelist>
4603 <member><link linkend="ISERR">ISERR</link> </member>
4604 <member><link linkend="ISNA">ISNA</link> </member>
4605 </simplelist></listitem>
4606 </varlistentry>
4607 </variablelist>
4608 </sect3>
4609
4610 <sect3 id="ISEVEN">
4611 <title>ISEVEN</title>
4612 <para>The ISEVEN() function returns True if the number is even. Otherwise returns False.</para>
4613 <para><segmentedlist><segtitle>Return type</segtitle>
4614 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4615 <variablelist>
4616 <varlistentry><term>Syntax</term>
4617 <listitem><para>ISEVEN(x)</para></listitem>
4618 </varlistentry>
4619 <varlistentry><term>Parameters</term>
4620 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4621 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4622 </varlistentry>
4623 <varlistentry><term>Examples</term>
4624 <listitem><para>ISEVEN(12) returns True</para></listitem>
4625 </varlistentry>
4626 <varlistentry><term>Examples</term>
4627 <listitem><para>ISEVEN(-7) returns False</para></listitem>
4628 </varlistentry>
4629 </variablelist>
4630 </sect3>
4631
4632 <sect3 id="ISFORMULA">
4633 <title>ISFORMULA</title>
4634 <para>The ISFORMULA() function returns True if the referenced cell contains a formula. Otherwise it returns False</para>
4635 <para><segmentedlist><segtitle>Return type</segtitle>
4636 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4637 <variablelist>
4638 <varlistentry><term>Syntax</term>
4639 <listitem><para>ISFORMULA(x)</para></listitem>
4640 </varlistentry>
4641 <varlistentry><term>Parameters</term>
4642 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4643 <seglistitem><seg>Reference</seg><seg>Reference</seg></seglistitem></segmentedlist></para></listitem>
4644 </varlistentry>
4645 </variablelist>
4646 </sect3>
4647
4648 <sect3 id="ISLOGICAL">
4649 <title>ISLOGICAL</title>
4650 <para>The ISLOGICAL() function returns True if the parameter is a boolean value. Otherwise it returns False.</para>
4651 <para><segmentedlist><segtitle>Return type</segtitle>
4652 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4653 <variablelist>
4654 <varlistentry><term>Syntax</term>
4655 <listitem><para>ISLOGICAL(x)</para></listitem>
4656 </varlistentry>
4657 <varlistentry><term>Parameters</term>
4658 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4659 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4660 </varlistentry>
4661 <varlistentry><term>Examples</term>
4662 <listitem><para>ISLOGICAL(A1>A2) returns True</para></listitem>
4663 </varlistentry>
4664 <varlistentry><term>Examples</term>
4665 <listitem><para>ISLOGICAL(12) returns False</para></listitem>
4666 </varlistentry>
4667 </variablelist>
4668 </sect3>
4669
4670 <sect3 id="ISNA">
4671 <title>ISNA</title>
4672 <para>The ISNA() function returns True if its parameter is a N/A error. In all other cases, it returns False.</para>
4673 <para><segmentedlist><segtitle>Return type</segtitle>
4674 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4675 <variablelist>
4676 <varlistentry><term>Syntax</term>
4677 <listitem><para>ISNA(x)</para></listitem>
4678 </varlistentry>
4679 <varlistentry><term>Parameters</term>
4680 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4681 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4682 </varlistentry>
4683 <varlistentry><term>Related Functions</term>
4684 <listitem><simplelist>
4685 <member><link linkend="ISERR">ISERR</link> </member>
4686 <member><link linkend="ISERROR">ISERROR</link> </member>
4687 </simplelist></listitem>
4688 </varlistentry>
4689 </variablelist>
4690 </sect3>
4691
4692 <sect3 id="ISNONTEXT">
4693 <title>ISNONTEXT</title>
4694 <para>The ISNONTEXT() function returns True if the parameter is not a string. Otherwise it returns False. It's the same as ISNOTTEXT.</para>
4695 <para><segmentedlist><segtitle>Return type</segtitle>
4696 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4697 <variablelist>
4698 <varlistentry><term>Syntax</term>
4699 <listitem><para>ISNONTEXT(x)</para></listitem>
4700 </varlistentry>
4701 <varlistentry><term>Parameters</term>
4702 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4703 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4704 </varlistentry>
4705 <varlistentry><term>Examples</term>
4706 <listitem><para>ISNONTEXT(12) returns True</para></listitem>
4707 </varlistentry>
4708 <varlistentry><term>Examples</term>
4709 <listitem><para>ISNONTEXT("hello") returns False</para></listitem>
4710 </varlistentry>
4711 <varlistentry><term>Related Functions</term>
4712 <listitem><simplelist>
4713 <member><link linkend="ISNOTTEXT">ISNOTTEXT</link> </member>
4714 </simplelist></listitem>
4715 </varlistentry>
4716 </variablelist>
4717 </sect3>
4718
4719 <sect3 id="ISNOTTEXT">
4720 <title>ISNOTTEXT</title>
4721 <para>The ISNOTTEXT() function returns True if the parameter is not a string. Otherwise it returns False. It's the same as ISNONTEXT.</para>
4722 <para><segmentedlist><segtitle>Return type</segtitle>
4723 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4724 <variablelist>
4725 <varlistentry><term>Syntax</term>
4726 <listitem><para>ISNOTTEXT(x)</para></listitem>
4727 </varlistentry>
4728 <varlistentry><term>Parameters</term>
4729 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4730 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4731 </varlistentry>
4732 <varlistentry><term>Examples</term>
4733 <listitem><para>ISNOTTEXT(12) returns True</para></listitem>
4734 </varlistentry>
4735 <varlistentry><term>Examples</term>
4736 <listitem><para>ISNOTTEXT("hello") returns False</para></listitem>
4737 </varlistentry>
4738 <varlistentry><term>Related Functions</term>
4739 <listitem><simplelist>
4740 <member><link linkend="ISNONTEXT">ISNONTEXT</link> </member>
4741 </simplelist></listitem>
4742 </varlistentry>
4743 </variablelist>
4744 </sect3>
4745
4746 <sect3 id="ISNUM">
4747 <title>ISNUM</title>
4748 <para>The ISNUM() function returns True if the parameter is a numerical value. Otherwise it returns False. It's the same as ISNUMBER.</para>
4749 <para><segmentedlist><segtitle>Return type</segtitle>
4750 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4751 <variablelist>
4752 <varlistentry><term>Syntax</term>
4753 <listitem><para>ISNUM(x)</para></listitem>
4754 </varlistentry>
4755 <varlistentry><term>Parameters</term>
4756 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4757 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4758 </varlistentry>
4759 <varlistentry><term>Examples</term>
4760 <listitem><para>ISNUM(12) returns True</para></listitem>
4761 </varlistentry>
4762 <varlistentry><term>Examples</term>
4763 <listitem><para>ISNUM(hello) returns False</para></listitem>
4764 </varlistentry>
4765 <varlistentry><term>Related Functions</term>
4766 <listitem><simplelist>
4767 <member><link linkend="ISNUMBER">ISNUMBER</link> </member>
4768 </simplelist></listitem>
4769 </varlistentry>
4770 </variablelist>
4771 </sect3>
4772
4773 <sect3 id="ISNUMBER">
4774 <title>ISNUMBER</title>
4775 <para>The ISNUMBER() function returns True if the parameter is a numerical value. Otherwise it returns False. It's the same as ISNUM.</para>
4776 <para><segmentedlist><segtitle>Return type</segtitle>
4777 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4778 <variablelist>
4779 <varlistentry><term>Syntax</term>
4780 <listitem><para>ISNUMBER(x)</para></listitem>
4781 </varlistentry>
4782 <varlistentry><term>Parameters</term>
4783 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4784 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4785 </varlistentry>
4786 <varlistentry><term>Examples</term>
4787 <listitem><para>ISNUMBER(12) returns True</para></listitem>
4788 </varlistentry>
4789 <varlistentry><term>Examples</term>
4790 <listitem><para>ISNUMBER(hello) returns False</para></listitem>
4791 </varlistentry>
4792 <varlistentry><term>Related Functions</term>
4793 <listitem><simplelist>
4794 <member><link linkend="ISNUM">ISNUM</link> </member>
4795 </simplelist></listitem>
4796 </varlistentry>
4797 </variablelist>
4798 </sect3>
4799
4800 <sect3 id="ISODD">
4801 <title>ISODD</title>
4802 <para>The ISODD() function returns True if the number is odd. Otherwise returns False.</para>
4803 <para><segmentedlist><segtitle>Return type</segtitle>
4804 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4805 <variablelist>
4806 <varlistentry><term>Syntax</term>
4807 <listitem><para>ISODD(x)</para></listitem>
4808 </varlistentry>
4809 <varlistentry><term>Parameters</term>
4810 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4811 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4812 </varlistentry>
4813 <varlistentry><term>Examples</term>
4814 <listitem><para>ISODD(12) returns False</para></listitem>
4815 </varlistentry>
4816 <varlistentry><term>Examples</term>
4817 <listitem><para>ISODD(-7) returns True</para></listitem>
4818 </varlistentry>
4819 </variablelist>
4820 </sect3>
4821
4822 <sect3 id="ISREF">
4823 <title>ISREF</title>
4824 <para>The ISREF() function returns True if the parameter refers to a reference. Otherwise it returns False</para>
4825 <para><segmentedlist><segtitle>Return type</segtitle>
4826 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4827 <variablelist>
4828 <varlistentry><term>Syntax</term>
4829 <listitem><para>ISREF(x)</para></listitem>
4830 </varlistentry>
4831 <varlistentry><term>Parameters</term>
4832 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4833 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4834 </varlistentry>
4835 <varlistentry><term>Examples</term>
4836 <listitem><para>ISREF(A12) returns true</para></listitem>
4837 </varlistentry>
4838 <varlistentry><term>Examples</term>
4839 <listitem><para>ISREF("hello") returns false</para></listitem>
4840 </varlistentry>
4841 </variablelist>
4842 </sect3>
4843
4844 <sect3 id="ISTEXT">
4845 <title>ISTEXT</title>
4846 <para>The ISTEXT() function returns True if the parameter is a string. Otherwise it returns False</para>
4847 <para><segmentedlist><segtitle>Return type</segtitle>
4848 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4849 <variablelist>
4850 <varlistentry><term>Syntax</term>
4851 <listitem><para>ISTEXT(x)</para></listitem>
4852 </varlistentry>
4853 <varlistentry><term>Parameters</term>
4854 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4855 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4856 </varlistentry>
4857 <varlistentry><term>Examples</term>
4858 <listitem><para>ISTEXT(12) returns False</para></listitem>
4859 </varlistentry>
4860 <varlistentry><term>Examples</term>
4861 <listitem><para>ISTEXT("hello") returns True</para></listitem>
4862 </varlistentry>
4863 </variablelist>
4864 </sect3>
4865
4866 <sect3 id="ISTIME">
4867 <title>ISTIME</title>
4868 <para>The ISTIME() function returns True if the parameter is a time value. Otherwise it returns False.</para>
4869 <para><segmentedlist><segtitle>Return type</segtitle>
4870 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4871 <variablelist>
4872 <varlistentry><term>Syntax</term>
4873 <listitem><para>ISTIME(x)</para></listitem>
4874 </varlistentry>
4875 <varlistentry><term>Parameters</term>
4876 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4877 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4878 </varlistentry>
4879 <varlistentry><term>Examples</term>
4880 <listitem><para>ISTIME("12:05") returns True</para></listitem>
4881 </varlistentry>
4882 <varlistentry><term>Examples</term>
4883 <listitem><para>ISTIME("hello") returns False</para></listitem>
4884 </varlistentry>
4885 </variablelist>
4886 </sect3>
4887
4888 <sect3 id="N">
4889 <title>N</title>
4890 <para>The N() function converts a value to a number. If value is or refers to a number, this function returns the number. If value is True, this function returns 1. If a value is a date, this function returns the serial number of that date. Anything else will cause the function to return 0.</para>
4891 <para><segmentedlist><segtitle>Return type</segtitle>
4892 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
4893 <variablelist>
4894 <varlistentry><term>Syntax</term>
4895 <listitem><para>N(value)</para></listitem>
4896 </varlistentry>
4897 <varlistentry><term>Parameters</term>
4898 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4899 <seglistitem><seg>Value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4900 </varlistentry>
4901 <varlistentry><term>Examples</term>
4902 <listitem><para>N(3.14) returns 3.14</para></listitem>
4903 </varlistentry>
4904 <varlistentry><term>Examples</term>
4905 <listitem><para>N("7") returns 0 (because "7" is text)</para></listitem>
4906 </varlistentry>
4907 </variablelist>
4908 </sect3>
4909
4910 <sect3 id="NA">
4911 <title>NA</title>
4912 <para>The NA() function returns the constant error value, N/A.</para>
4913 <para><segmentedlist><segtitle>Return type</segtitle>
4914 <seglistitem><seg>Error</seg></seglistitem></segmentedlist></para>
4915 <variablelist>
4916 <varlistentry><term>Syntax</term>
4917 <listitem><para>NA()</para></listitem>
4918 </varlistentry>
4919 <varlistentry><term>Parameters</term>
4920 <listitem><para></para></listitem>
4921 </varlistentry>
4922 <varlistentry><term>Related Functions</term>
4923 <listitem><simplelist>
4924 <member><link linkend="ISNA">ISNA</link> </member>
4925 <member><link linkend="ISERR">ISERR</link> </member>
4926 <member><link linkend="ISERROR">ISERROR</link> </member>
4927 </simplelist></listitem>
4928 </varlistentry>
4929 </variablelist>
4930 </sect3>
4931
4932 <sect3 id="TYPE">
4933 <title>TYPE</title>
4934 <para>The TYPE() function returns 1 if the value is a number, 2 if it is text, 4 if the value is a logical value, 16 if it is an error value or 64 if the value is an array. If the cell the value represents contains a formula you get its return type.</para>
4935 <para><segmentedlist><segtitle>Return type</segtitle>
4936 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
4937 <variablelist>
4938 <varlistentry><term>Syntax</term>
4939
4940 <listitem><para>TYPE(x)</para></listitem>
4941 </varlistentry>
4942 <varlistentry><term>Parameters</term>
4943 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4944 <seglistitem><seg>Any value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
4945 </varlistentry>
4946 <varlistentry><term>Examples</term>
4947 <listitem><para>TYPE(A1) returns 2, if A1 contains "Text"</para></listitem>
4948 </varlistentry>
4949 <varlistentry><term>Examples</term>
4950 <listitem><para>TYPE(-7) returns 1</para></listitem>
4951 </varlistentry>
4952 <varlistentry><term>Examples</term>
4953 <listitem><para>TYPE(A2) returns 1, if A2 contains "=CURRENTDATE()"</para></listitem>
4954 </varlistentry>
4955 </variablelist>
4956 </sect3>
4957
4958 </sect2><sect2 id="Logical">
4959 <title>Logical</title>
4960
4961 <sect3 id="AND">
4962 <title>AND</title>
4963 <para>The AND() function returns True if all the values are true. Otherwise it returns False (unless any of the values in an error - then it returns an error).</para>
4964 <para><segmentedlist><segtitle>Return type</segtitle>
4965 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4966 <variablelist>
4967 <varlistentry><term>Syntax</term>
4968 <listitem><para>AND(value;value;...)</para></listitem>
4969 </varlistentry>
4970 <varlistentry><term>Parameters</term>
4971 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
4972 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
4973 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
4974 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
4975 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
4976 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
4977 </varlistentry>
4978 <varlistentry><term>Examples</term>
4979 <listitem><para>AND(true;true;true) returns True</para></listitem>
4980 </varlistentry>
4981 <varlistentry><term>Examples</term>
4982 <listitem><para>AND(true;false) returns False</para></listitem>
4983 </varlistentry>
4984 </variablelist>
4985 </sect3>
4986
4987 <sect3 id="FALSE">
4988 <title>FALSE</title>
4989 <para>The FALSE() function returns the boolean value FALSE.</para>
4990 <para><segmentedlist><segtitle>Return type</segtitle>
4991 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
4992 <variablelist>
4993 <varlistentry><term>Syntax</term>
4994 <listitem><para>FALSE()</para></listitem>
4995 </varlistentry>
4996 <varlistentry><term>Parameters</term>
4997 <listitem><para></para></listitem>
4998 </varlistentry>
4999 <varlistentry><term>Examples</term>
5000 <listitem><para>FALSE() returns FALSE</para></listitem>
5001 </varlistentry>
5002 </variablelist>
5003 </sect3>
5004
5005 <sect3 id="IF">
5006 <title>IF</title>
5007 <para>The IF() function is a conditional function. This function returns the second parameter if the condition is True. Otherwise it returns the third parameter (which defaults to being false).</para>
5008 <para><segmentedlist><segtitle>Return type</segtitle>
5009 <seglistitem><seg>Any kind of value</seg></seglistitem></segmentedlist></para>
5010 <variablelist>
5011 <varlistentry><term>Syntax</term>
5012 <listitem><para>IF(condition;if_true;if_false)</para></listitem>
5013 </varlistentry>
5014 <varlistentry><term>Parameters</term>
5015 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5016 <seglistitem><seg>Condition</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem>
5017 <seglistitem><seg>If true</seg><seg>Any kind of value</seg></seglistitem>
5018 <seglistitem><seg>If false</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
5019 </varlistentry>
5020 <varlistentry><term>Examples</term>
5021 <listitem><para>A1=4;A2=6;IF(A1>A2;5;3) returns 3</para></listitem>
5022 </varlistentry>
5023 </variablelist>
5024 </sect3>
5025
5026 <sect3 id="IFERROR">
5027 <title>IFERROR</title>
5028 <para>Return X unless it is an Error, in which case return an alternative value.</para>
5029 <para><segmentedlist><segtitle>Return type</segtitle>
5030 <seglistitem><seg>Any kind of value</seg></seglistitem></segmentedlist></para>
5031 <variablelist>
5032 <varlistentry><term>Syntax</term>
5033 <listitem><para>IFERROR(AnyX;AnyAlternative)</para></listitem>
5034 </varlistentry>
5035 <varlistentry><term>Parameters</term>
5036 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5037 <seglistitem><seg>Any X</seg><seg>Any kind of value</seg></seglistitem>
5038 <seglistitem><seg>Any Alternative</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
5039 </varlistentry>
5040 <varlistentry><term>Examples</term>
5041 <listitem><para>IFERROR(A1;A2) returns the content of A1 if that content is not an error-value else the content of A2 is returned.</para></listitem>
5042 </varlistentry>
5043 </variablelist>
5044 </sect3>
5045
5046 <sect3 id="IFNA">
5047 <title>IFNA</title>
5048 <para>Return X unless it is an NA, in which case return an alternative value.</para>
5049 <para><segmentedlist><segtitle>Return type</segtitle>
5050 <seglistitem><seg>Any kind of value</seg></seglistitem></segmentedlist></para>
5051 <variablelist>
5052 <varlistentry><term>Syntax</term>
5053 <listitem><para>IFNA(AnyX;AnyAlternative)</para></listitem>
5054 </varlistentry>
5055 <varlistentry><term>Parameters</term>
5056 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5057 <seglistitem><seg>Any X</seg><seg>Any kind of value</seg></seglistitem>
5058 <seglistitem><seg>Any Alternative</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
5059 </varlistentry>
5060 <varlistentry><term>Examples</term>
5061 <listitem><para>IFNA(A1;A2) returns the content of A1 if that content is not an #N/A error-value else the content of A2 is returned.</para></listitem>
5062 </varlistentry>
5063 </variablelist>
5064 </sect3>
5065
5066 <sect3 id="NAND">
5067 <title>NAND</title>
5068 <para>The NAND() function returns True if at least one value is not true. Otherwise it returns False.</para>
5069 <para><segmentedlist><segtitle>Return type</segtitle>
5070 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
5071 <variablelist>
5072 <varlistentry><term>Syntax</term>
5073 <listitem><para>NAND(value;value;...)</para></listitem>
5074 </varlistentry>
5075 <varlistentry><term>Parameters</term>
5076 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5077 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5078 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5079 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5080 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5081 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
5082 </varlistentry>
5083 <varlistentry><term>Examples</term>
5084 <listitem><para>NAND(true;false;false) returns True</para></listitem>
5085 </varlistentry>
5086 <varlistentry><term>Examples</term>
5087 <listitem><para>NAND(true;true) returns False</para></listitem>
5088 </varlistentry>
5089 </variablelist>
5090 </sect3>
5091
5092 <sect3 id="NOR">
5093 <title>NOR</title>
5094 <para>The NOR() function returns True if all the values given as parameters are of boolean type and have the value false. Otherwise it returns False.</para>
5095 <para><segmentedlist><segtitle>Return type</segtitle>
5096 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
5097 <variablelist>
5098 <varlistentry><term>Syntax</term>
5099 <listitem><para>NOR(value;value;...)</para></listitem>
5100 </varlistentry>
5101 <varlistentry><term>Parameters</term>
5102 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5103 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5104 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5105 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5106 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5107 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
5108 </varlistentry>
5109 <varlistentry><term>Examples</term>
5110 <listitem><para>NOR(true;false;false) returns False</para></listitem>
5111 </varlistentry>
5112 <varlistentry><term>Examples</term>
5113 <listitem><para>NOR(false;false) returns True</para></listitem>
5114 </varlistentry>
5115 </variablelist>
5116 </sect3>
5117
5118 <sect3 id="NOT">
5119 <title>NOT</title>
5120 <para>The NOT() function returns True if the value is False and returns False if the value is True. It returns an error if the input in an error.</para>
5121 <para><segmentedlist><segtitle>Return type</segtitle>
5122 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
5123 <variablelist>
5124 <varlistentry><term>Syntax</term>
5125 <listitem><para>NOT(bool)</para></listitem>
5126 </varlistentry>
5127 <varlistentry><term>Parameters</term>
5128 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5129 <seglistitem><seg>Boolean value</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
5130 </varlistentry>
5131 <varlistentry><term>Examples</term>
5132 <listitem><para>NOT(false) returns True</para></listitem>
5133 </varlistentry>
5134 <varlistentry><term>Examples</term>
5135 <listitem><para>NOT(true) returns False</para></listitem>
5136 </varlistentry>
5137 </variablelist>
5138 </sect3>
5139
5140 <sect3 id="OR">
5141 <title>OR</title>
5142 <para>The OR() function returns True if at least one of the values is true. Otherwise it returns False (unless any of the values is an error, then it returns an error).</para>
5143 <para><segmentedlist><segtitle>Return type</segtitle>
5144 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
5145 <variablelist>
5146 <varlistentry><term>Syntax</term>
5147 <listitem><para>OR(value;value;...)</para></listitem>
5148 </varlistentry>
5149 <varlistentry><term>Parameters</term>
5150 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5151 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5152 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5153 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5154 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5155 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
5156 </varlistentry>
5157 <varlistentry><term>Examples</term>
5158 <listitem><para>OR(false;false;false) returns False</para></listitem>
5159 </varlistentry>
5160 <varlistentry><term>Examples</term>
5161 <listitem><para>OR(true;false) returns True</para></listitem>
5162 </varlistentry>
5163 </variablelist>
5164 </sect3>
5165
5166 <sect3 id="TRUE">
5167 <title>TRUE</title>
5168 <para>The TRUE() function returns the boolean value TRUE.</para>
5169 <para><segmentedlist><segtitle>Return type</segtitle>
5170 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
5171 <variablelist>
5172 <varlistentry><term>Syntax</term>
5173 <listitem><para>TRUE()</para></listitem>
5174 </varlistentry>
5175 <varlistentry><term>Parameters</term>
5176 <listitem><para></para></listitem>
5177 </varlistentry>
5178 <varlistentry><term>Examples</term>
5179 <listitem><para>TRUE() returns TRUE</para></listitem>
5180 </varlistentry>
5181 </variablelist>
5182 </sect3>
5183
5184 <sect3 id="XOR">
5185 <title>XOR</title>
5186 <para>The XOR() function returns False if the number of True values is even. Otherwise it returns True. It returns an error if any argument is an error.</para>
5187 <para><segmentedlist><segtitle>Return type</segtitle>
5188 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
5189 <variablelist>
5190 <varlistentry><term>Syntax</term>
5191 <listitem><para>XOR(value;value;...)</para></listitem>
5192 </varlistentry>
5193 <varlistentry><term>Parameters</term>
5194 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5195 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5196 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5197 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5198 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem>
5199 <seglistitem><seg>Boolean values</seg><seg>A range of truth values (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
5200 </varlistentry>
5201 <varlistentry><term>Examples</term>
5202 <listitem><para>XOR(false;false;false) returns True</para></listitem>
5203 </varlistentry>
5204 <varlistentry><term>Examples</term>
5205 <listitem><para>XOR(true;false) returns True</para></listitem>
5206 </varlistentry>
5207 </variablelist>
5208 </sect3>
5209
5210 </sect2><sect2 id="Lookup---Reference">
5211 <title>Lookup & Reference</title>
5212
5213 <sect3 id="ADDRESS">
5214 <title>ADDRESS</title>
5215 <para>The ADDRESS creates a cell address. Parameter Row is the row number and Column is the column number.</para>
5216 <para>Absolute number specifies the type of reference: 1 or omitted = Absolute, 2 = Absolute row, relative column, 3 = Relative row; absolute column and 4 = Relative.</para>
5217 <para>A1 Style specifies the style of the address to return. If A1 is set to TRUE (default) the address is returned in A1 style if it is set to FALSE in R1C1 style.</para>
5218 <para>Sheet name is the text specifying the name of the sheet.</para>
5219 <para><segmentedlist><segtitle>Return type</segtitle>
5220 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
5221 <variablelist>
5222 <varlistentry><term>Syntax</term>
5223 <listitem><para>ADDRESS(row; col; absolute; style; sheet name)</para></listitem>
5224 </varlistentry>
5225 <varlistentry><term>Parameters</term>
5226 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5227 <seglistitem><seg>Row number</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
5228 <seglistitem><seg>Column number</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
5229 <seglistitem><seg>Absolute number (optional)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
5230 <seglistitem><seg>A1 style (optional)</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem>
5231 <seglistitem><seg>Sheet name</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
5232 </varlistentry>
5233 <varlistentry><term>Examples</term>
5234 <listitem><para>ADDRESS(6; 4) returns $D$6</para></listitem>
5235 </varlistentry>
5236 <varlistentry><term>Examples</term>
5237 <listitem><para>ADDRESS(6; 4; 2) returns D$6</para></listitem>
5238 </varlistentry>
5239 <varlistentry><term>Examples</term>
5240 <listitem><para>ADDRESS(6; 4; 2; FALSE; "Sheet1") returns Sheet1!R6C[4]</para></listitem>
5241 </varlistentry>
5242 <varlistentry><term>Examples</term>
5243 <listitem><para>ADDRESS(6; 4; 1; FALSE; "Sheet1") returns Sheet1!R6C4</para></listitem>
5244 </varlistentry>
5245 <varlistentry><term>Examples</term>
5246 <listitem><para>ADDRESS(6; 4; 4; TRUE; "Sheet1") returns Sheet1!D6</para></listitem>
5247 </varlistentry>
5248 </variablelist>
5249 </sect3>
5250
5251 <sect3 id="AREAS">
5252 <title>AREAS</title>
5253 <para>Returns the number of areas in the reference string. An area can be asingle cell or a set of cells.</para>
5254 <para><segmentedlist><segtitle>Return type</segtitle>
5255 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
5256 <variablelist>
5257 <varlistentry><term>Syntax</term>
5258 <listitem><para>AREAS(reference)</para></listitem>
5259 </varlistentry>
5260 <varlistentry><term>Parameters</term>
5261 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5262 <seglistitem><seg>Reference</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
5263 </varlistentry>
5264 <varlistentry><term>Examples</term>
5265 <listitem><para>AREAS(A1) returns 1</para></listitem>
5266 </varlistentry>
5267 <varlistentry><term>Examples</term>
5268 <listitem><para>AREAS((A1; A2:A4)) returns 2</para></listitem>
5269 </varlistentry>
5270 </variablelist>
5271 </sect3>
5272
5273 <sect3 id="CELL">
5274 <title>CELL</title>
5275 <para>Returns information about position, formatting or contents in a reference.</para>
5276 <para><segmentedlist><segtitle>Return type</segtitle>
5277 <seglistitem><seg>Any kind of value</seg></seglistitem></segmentedlist></para>
5278 <variablelist>
5279 <varlistentry><term>Syntax</term>
5280 <listitem><para>CELL(type; reference)</para></listitem>
5281 </varlistentry>
5282 <varlistentry><term>Parameters</term>
5283 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5284 <seglistitem><seg>Type</seg><seg>Text</seg></seglistitem>
5285 <seglistitem><seg>Reference</seg><seg>Reference</seg></seglistitem></segmentedlist></para></listitem>
5286 </varlistentry>
5287 <varlistentry><term>Examples</term>
5288 <listitem><para>CELL("COL", C7) returns 3</para></listitem>
5289 </varlistentry>
5290 <varlistentry><term>Examples</term>
5291 <listitem><para>CELL("ROW", C7) returns 7</para></listitem>
5292 </varlistentry>
5293 <varlistentry><term>Examples</term>
5294 <listitem><para>CELL("ADDRESS", C7) returns $C$7</para></listitem>
5295 </varlistentry>
5296 </variablelist>
5297 </sect3>
5298
5299 <sect3 id="CHOOSE">
5300 <title>CHOOSE</title>
5301 <para>Returns the parameter specified by the index.</para>
5302 <para><segmentedlist><segtitle>Return type</segtitle>
5303 <seglistitem><seg>Any kind of value</seg></seglistitem></segmentedlist></para>
5304 <variablelist>
5305 <varlistentry><term>Syntax</term>
5306 <listitem><para>CHOOSE(index; parameter1; parameter2;...)</para></listitem>
5307 </varlistentry>
5308 <varlistentry><term>Parameters</term>
5309 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5310 <seglistitem><seg>Index</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
5311 <seglistitem><seg>Arguments</seg><seg></seg></seglistitem></segmentedlist></para></listitem>
5312 </varlistentry>
5313 <varlistentry><term>Examples</term>
5314 <listitem><para>CHOOSE(1; "1st"; "2nd") returns "1st"</para></listitem>
5315 </varlistentry>
5316 <varlistentry><term>Examples</term>
5317 <listitem><para>CHOOSE(2; 3; 2; 4) returns 2</para></listitem>
5318 </varlistentry>
5319 </variablelist>
5320 </sect3>
5321
5322 <sect3 id="COLUMN">
5323 <title>COLUMN</title>
5324 <para>The COLUMN function returns the column of given cell reference. If no parameter is specified the column of the current cell gets returned.</para>
5325 <para><segmentedlist><segtitle>Return type</segtitle>
5326 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
5327 <variablelist>
5328 <varlistentry><term>Syntax</term>
5329 <listitem><para>COLUMN(reference)</para></listitem>
5330 </varlistentry>
5331 <varlistentry><term>Parameters</term>
5332 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5333 <seglistitem><seg>Reference</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
5334 </varlistentry>
5335 <varlistentry><term>Examples</term>
5336 <listitem><para>COLUMN(A1) returns 1</para></listitem>
5337 </varlistentry>
5338 <varlistentry><term>Examples</term>
5339 <listitem><para>COLUMN(D2) returns 4</para></listitem>
5340 </varlistentry>
5341 <varlistentry><term>Related Functions</term>
5342 <listitem><simplelist>
5343 <member><link linkend="COLUMNS">COLUMNS</link> </member>
5344 <member><link linkend="ROW">ROW</link> </member>
5345 </simplelist></listitem>
5346 </varlistentry>
5347 </variablelist>
5348 </sect3>
5349
5350 <sect3 id="COLUMNS">
5351 <title>COLUMNS</title>
5352 <para>The COLUMNS function returns the number of columns in a reference.</para>
5353 <para><segmentedlist><segtitle>Return type</segtitle>
5354 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
5355 <variablelist>
5356 <varlistentry><term>Syntax</term>
5357 <listitem><para>COLUMNS(reference)</para></listitem>
5358 </varlistentry>
5359 <varlistentry><term>Parameters</term>
5360 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5361 <seglistitem><seg>Reference</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
5362 </varlistentry>
5363 <varlistentry><term>Examples</term>
5364 <listitem><para>COLUMNS(A1:C3) returns 3</para></listitem>
5365 </varlistentry>
5366 <varlistentry><term>Examples</term>
5367 <listitem><para>COLUMNS(D2) returns 1</para></listitem>
5368 </varlistentry>
5369 <varlistentry><term>Related Functions</term>
5370 <listitem><simplelist>
5371 <member><link linkend="COLUMN">COLUMN</link> </member>
5372 <member><link linkend="ROWS">ROWS</link> </member>
5373 </simplelist></listitem>
5374 </varlistentry>
5375 </variablelist>
5376 </sect3>
5377
5378 <sect3 id="HLOOKUP">
5379 <title>HLOOKUP</title>
5380 <para>Look for a matching value in the first row of the given table, and return the value of the indicated row.</para>
5381 <para>Looks up the 'lookup value' in the first row of the 'data source'. If a value matches, the value in the 'row' and the column, the value was found in, is returned. If 'sorted' is true (default), the first row is assumed to be sorted. The search will end, if the 'lookup value' is lower than the value, currently compared to.</para>
5382 <para><segmentedlist><segtitle>Return type</segtitle>
5383 <seglistitem><seg>String/Numeric</seg></seglistitem></segmentedlist></para>
5384 <variablelist>
5385 <varlistentry><term>Syntax</term>
5386 <listitem><para>HLOOKUP(Lookup value; data source; Row; Sorted)</para></listitem>
5387 </varlistentry>
5388 <varlistentry><term>Parameters</term>
5389 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5390 <seglistitem><seg>Lookup value</seg><seg>String/Numeric</seg></seglistitem>
5391 <seglistitem><seg>Data source</seg><seg>Array</seg></seglistitem>
5392 <seglistitem><seg>Row</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
5393 <seglistitem><seg>Sorted (optional)</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
5394 </varlistentry>
5395 </variablelist>
5396 </sect3>
5397
5398 <sect3 id="INDEX">
5399 <title>INDEX</title>
5400 <para>If a range is given, returns value stored in a given row/column. If one cell is given, which contains an array, then one element of the array is returned.</para>
5401 <para><segmentedlist><segtitle>Return type</segtitle>
5402 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
5403 <variablelist>
5404 <varlistentry><term>Syntax</term>
5405 <listitem><para>INDEX(cell, row, column)</para></listitem>
5406 </varlistentry>
5407 <varlistentry><term>Parameters</term>
5408 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5409 <seglistitem><seg>Reference</seg><seg>Text</seg></seglistitem>
5410 <seglistitem><seg>Row</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
5411 <seglistitem><seg>Column</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
5412 </varlistentry>
5413 <varlistentry><term>Examples</term>
5414 <listitem><para>INDEX(A1:C3;2;2), returns contents of B2</para></listitem>
5415 </varlistentry>
5416 <varlistentry><term>Examples</term>
5417 <listitem><para>INDEX(A1;2;2), if A1 is a result of array calculation, returns its (2,2) element.</para></listitem>
5418 </varlistentry>
5419 </variablelist>
5420 </sect3>
5421
5422 <sect3 id="INDIRECT">
5423 <title>INDIRECT</title>
5424 <para>Returns the content of the cell specified by the reference text. The second parameter is optional.</para>
5425 <para><segmentedlist><segtitle>Return type</segtitle>
5426 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
5427 <variablelist>
5428 <varlistentry><term>Syntax</term>
5429 <listitem><para>INDIRECT(referenceText, a1 style)</para></listitem>
5430 </varlistentry>
5431 <varlistentry><term>Parameters</term>
5432 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5433 <seglistitem><seg>Reference</seg><seg>Text</seg></seglistitem>
5434 <seglistitem><seg>A1 style (optional)</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
5435 </varlistentry>
5436 <varlistentry><term>Examples</term>
5437 <listitem><para>INDIRECT(A1), A1 contains "B1", and B1 1 => returns 1</para></listitem>
5438
5439 </varlistentry>
5440 <varlistentry><term>Examples</term>
5441 <listitem><para>INDIRECT("A1"), returns content of A1</para></listitem>
5442 </varlistentry>
5443 </variablelist>
5444 </sect3>
5445
5446 <sect3 id="LOOKUP">
5447 <title>LOOKUP</title>
5448 <para>The LOOKUP function looks up the first parameter in the lookup vector. It returns a value in the result Vector with the same index as the matching value in the lookup vector. If value is not in the lookup vector it takes the next lower one. If no value in the lookup vector matches an error is returned. The lookup vector must be in ascending order and lookup and result vector must have the same size. Numeric values, string and boolean values are recognized. Comparison between strings is case-insensitive.</para>
5449 <para><segmentedlist><segtitle>Return type</segtitle>
5450 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
5451 <variablelist>
5452 <varlistentry><term>Syntax</term>
5453 <listitem><para>LOOKUP(value; lookup vector; result vector)</para></listitem>
5454 </varlistentry>
5455 <varlistentry><term>Parameters</term>
5456 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5457 <seglistitem><seg>Lookup value</seg><seg>String/Numeric</seg></seglistitem>
5458 <seglistitem><seg>Lookup vector</seg><seg>String/Numeric</seg></seglistitem>
5459 <seglistitem><seg>Result vector</seg><seg>String/Numeric</seg></seglistitem></segmentedlist></para></listitem>
5460 </varlistentry>
5461 <varlistentry><term>Examples</term>
5462 <listitem><para>LOOKUP(1.232; A1:A6; B1:B6) for A1 = 1, A2 = 2 returns the value of B1.</para></listitem>
5463 </varlistentry>
5464 </variablelist>
5465 </sect3>
5466
5467 <sect3 id="MATCH">
5468 <title>MATCH</title>
5469 <para>Finds a search value in a search region, and returns its position (starting from 1). Match type can be either -1, 0 or 1 and determines how is searched for the value. If match type is 0, the index of the first value that equals search value is returned. If match type is 1 (or omitted), the index of the first value that is less than or equal to the search value is returned and the values in the search region must be sorted in ascending order. If match type is -1, the smallest value that is greater than or equal to the search value is found, and the search region needs to be sorted in descending order.</para>
5470 <para><segmentedlist><segtitle>Return type</segtitle>
5471 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
5472 <variablelist>
5473 <varlistentry><term>Syntax</term>
5474 <listitem><para>MATCH(Search value; Search region; Match type)</para></listitem>
5475 </varlistentry>
5476 <varlistentry><term>Parameters</term>
5477 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5478 <seglistitem><seg>Search value</seg><seg>String/Numeric</seg></seglistitem>
5479 <seglistitem><seg>Search region</seg><seg>Reference/Array</seg></seglistitem>
5480 <seglistitem><seg>Match type (optional)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
5481 </varlistentry>
5482 </variablelist>
5483 </sect3>
5484
5485 <sect3 id="MULTIPLE.OPERATIONS">
5486 <title>MULTIPLE.OPERATIONS</title>
5487 <para>MULTIPLE.OPERATIONS executes the formula expression pointed to by FormulaCell and all formula expressions it depends on while replacing all references to RowCell with references to RowReplacement respectively all references to ColumnCell with references to ColumnReplacement. The function may be used to easily create tables of expressions that depend on two input parameters.</para>
5488 <para><segmentedlist><segtitle>Return type</segtitle>
5489 <seglistitem><seg>String/Numeric</seg></seglistitem></segmentedlist></para>
5490 <variablelist>
5491 <varlistentry><term>Syntax</term>
5492 <listitem><para>MULTIPLE.OPERATIONS(Formula cell; Row cell; Row replacement; Column cell; Column replacement)</para></listitem>
5493 </varlistentry>
5494 <varlistentry><term>Parameters</term>
5495 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5496 <seglistitem><seg>Formula cell</seg><seg>Reference</seg></seglistitem>
5497 <seglistitem><seg>Row cell</seg><seg>Reference</seg></seglistitem>
5498 <seglistitem><seg>Row replacement</seg><seg>Reference</seg></seglistitem>
5499 <seglistitem><seg>Column cell (optional)</seg><seg>Reference</seg></seglistitem>
5500 <seglistitem><seg>Column replacement (optional)</seg><seg>Reference</seg></seglistitem></segmentedlist></para></listitem>
5501 </varlistentry>
5502 </variablelist>
5503 </sect3>
5504
5505 <sect3 id="OFFSET">
5506 <title>OFFSET</title>
5507 <para>Modifies a reference's position and dimension.</para>
5508 <para><segmentedlist><segtitle>Return type</segtitle>
5509 <seglistitem><seg>Reference</seg></seglistitem></segmentedlist></para>
5510 <variablelist>
5511 <varlistentry><term>Syntax</term>
5512 <listitem><para>OFFSET(Reference reference; Integer rowOffset; Integer columnOffset; Integer newHeight; Integer newWidth)</para></listitem>
5513 </varlistentry>
5514 <varlistentry><term>Parameters</term>
5515 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5516 <seglistitem><seg>Reference or range</seg><seg>Reference</seg></seglistitem>
5517 <seglistitem><seg>Number of rows to offset</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
5518 <seglistitem><seg>Number of columns to offset</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
5519 <seglistitem><seg>Height of the offset range (optional)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
5520 <seglistitem><seg>Width of the offset range (optional)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
5521 </varlistentry>
5522 </variablelist>
5523 </sect3>
5524
5525 <sect3 id="ROW">
5526 <title>ROW</title>
5527 <para>The ROW function returns the row of given cell reference. If no parameter is specified the row of the current cell gets returned.</para>
5528 <para><segmentedlist><segtitle>Return type</segtitle>
5529 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
5530 <variablelist>
5531 <varlistentry><term>Syntax</term>
5532 <listitem><para>ROW(reference)</para></listitem>
5533 </varlistentry>
5534 <varlistentry><term>Parameters</term>
5535 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5536 <seglistitem><seg>Reference</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
5537 </varlistentry>
5538 <varlistentry><term>Examples</term>
5539 <listitem><para>ROW(A1) returns 1</para></listitem>
5540 </varlistentry>
5541 <varlistentry><term>Examples</term>
5542 <listitem><para>ROW(D2) returns 2</para></listitem>
5543 </varlistentry>
5544 <varlistentry><term>Related Functions</term>
5545 <listitem><simplelist>
5546 <member><link linkend="ROWS">ROWS</link> </member>
5547 <member><link linkend="COLUMN">COLUMN</link> </member>
5548 </simplelist></listitem>
5549 </varlistentry>
5550 </variablelist>
5551 </sect3>
5552
5553 <sect3 id="ROWS">
5554 <title>ROWS</title>
5555 <para>The ROWS function returns the number of rows in a reference.</para>
5556 <para><segmentedlist><segtitle>Return type</segtitle>
5557 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
5558 <variablelist>
5559 <varlistentry><term>Syntax</term>
5560 <listitem><para>ROWS(reference)</para></listitem>
5561 </varlistentry>
5562 <varlistentry><term>Parameters</term>
5563 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5564 <seglistitem><seg>Reference</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
5565 </varlistentry>
5566 <varlistentry><term>Examples</term>
5567 <listitem><para>ROWS(A1:C3) returns 3</para></listitem>
5568 </varlistentry>
5569 <varlistentry><term>Examples</term>
5570 <listitem><para>ROWS(D2) returns 1</para></listitem>
5571 </varlistentry>
5572 <varlistentry><term>Related Functions</term>
5573 <listitem><simplelist>
5574 <member><link linkend="ROW">ROW</link> </member>
5575 <member><link linkend="COLUMNS">COLUMNS</link> </member>
5576 </simplelist></listitem>
5577 </varlistentry>
5578 </variablelist>
5579 </sect3>
5580
5581 <sect3 id="SHEET">
5582 <title>SHEET</title>
5583 <para>Returns the sheet number of the reference or the string representing a sheet name.</para>
5584 <para><segmentedlist><segtitle>Return type</segtitle>
5585 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
5586 <variablelist>
5587 <varlistentry><term>Syntax</term>
5588 <listitem><para>SHEET(reference)</para></listitem>
5589 </varlistentry>
5590 <varlistentry><term>Parameters</term>
5591 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5592 <seglistitem><seg>Reference</seg><seg>Reference</seg></seglistitem></segmentedlist></para></listitem>
5593 </varlistentry>
5594 <varlistentry><term>Examples</term>
5595 <listitem><para>SHEET(Sheet1!C7) returns 1</para></listitem>
5596 </varlistentry>
5597 <varlistentry><term>Examples</term>
5598 <listitem><para>SHEET(Sheet2!C7) returns 2</para></listitem>
5599 </varlistentry>
5600 </variablelist>
5601 </sect3>
5602
5603 <sect3 id="SHEETS">
5604 <title>SHEETS</title>
5605 <para>Returns the number of sheets in a reference or current document.</para>
5606 <para><segmentedlist><segtitle>Return type</segtitle>
5607 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
5608 <variablelist>
5609 <varlistentry><term>Syntax</term>
5610 <listitem><para>SHEETS(reference)</para></listitem>
5611 </varlistentry>
5612 <varlistentry><term>Parameters</term>
5613 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5614 <seglistitem><seg>Reference</seg><seg>Reference</seg></seglistitem></segmentedlist></para></listitem>
5615 </varlistentry>
5616 </variablelist>
5617 </sect3>
5618
5619 <sect3 id="VLOOKUP">
5620 <title>VLOOKUP</title>
5621 <para>Look for a matching value in the first column of the given table, and return the value of the indicated column.</para>
5622 <para>Looks up the 'lookup value' in the first column of the 'data source'. If a value matches, the value in the 'column' and the row, the value was found in, is returned. If 'sorted' is true (default), the first column is assumed to be sorted. The search will end, if the 'lookup value' is lower than the value, currently compared to.</para>
5623 <para><segmentedlist><segtitle>Return type</segtitle>
5624 <seglistitem><seg>String/Numeric</seg></seglistitem></segmentedlist></para>
5625 <variablelist>
5626 <varlistentry><term>Syntax</term>
5627 <listitem><para>VLOOKUP(Lookup value; data source; Column; Sorted)</para></listitem>
5628 </varlistentry>
5629 <varlistentry><term>Parameters</term>
5630 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5631 <seglistitem><seg>Lookup value</seg><seg>String/Numeric</seg></seglistitem>
5632 <seglistitem><seg>Data source</seg><seg>Array</seg></seglistitem>
5633 <seglistitem><seg>Column</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
5634 <seglistitem><seg>Sorted (optional)</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
5635 </varlistentry>
5636 </variablelist>
5637 </sect3>
5638
5639 </sect2><sect2 id="Math">
5640 <title>Math</title>
5641
5642 <sect3 id="ABS">
5643 <title>ABS</title>
5644 <para>The ABS() function returns the absolute value of the floating-point number x.</para>
5645 <para><segmentedlist><segtitle>Return type</segtitle>
5646 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
5647 <variablelist>
5648 <varlistentry><term>Syntax</term>
5649 <listitem><para>ABS(x)</para></listitem>
5650 </varlistentry>
5651 <varlistentry><term>Parameters</term>
5652 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5653 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
5654 </varlistentry>
5655 <varlistentry><term>Examples</term>
5656 <listitem><para>ABS(12.5) equals 12.5</para></listitem>
5657 </varlistentry>
5658 <varlistentry><term>Examples</term>
5659 <listitem><para>ABS(-12.5) equals 12.5</para></listitem>
5660 </varlistentry>
5661 </variablelist>
5662 </sect3>
5663
5664 <sect3 id="CEIL">
5665 <title>CEIL</title>
5666 <para>The CEIL() function rounds x up to the nearest integer which is greater than the input, returning that value as a double.</para>
5667 <para><segmentedlist><segtitle>Return type</segtitle>
5668 <seglistitem><seg>An integer (like 0, -5, 14 )</seg></seglistitem></segmentedlist></para>
5669 <variablelist>
5670 <varlistentry><term>Syntax</term>
5671 <listitem><para>CEIL(x)</para></listitem>
5672 </varlistentry>
5673 <varlistentry><term>Parameters</term>
5674 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5675 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
5676 </varlistentry>
5677 <varlistentry><term>Examples</term>
5678 <listitem><para>CEIL(12.5) equals 13</para></listitem>
5679 </varlistentry>
5680 <varlistentry><term>Examples</term>
5681 <listitem><para>CEIL(-12.5) equals -12</para></listitem>
5682 </varlistentry>
5683 <varlistentry><term>Related Functions</term>
5684 <listitem><simplelist>
5685 <member><link linkend="CEILING">CEILING</link> </member>
5686 <member><link linkend="FLOOR">FLOOR</link> </member>
5687 <member><link linkend="ROUND">ROUND</link> </member>
5688 <member><link linkend="ROUNDUP">ROUNDUP</link> </member>
5689 </simplelist></listitem>
5690 </varlistentry>
5691 </variablelist>
5692 </sect3>
5693
5694 <sect3 id="CEILING">
5695 <title>CEILING</title>
5696 <para>The CEILING() function rounds x up (away from zero) to the nearest multiple of Significance which is greater than the input. The default value for Significance is 1 (or -1 if the value is negative), which means rounding up to the nearest integer. If the Mode parameter is non-zero, the function rounds away from zero, instead of up towards the positive infinity.</para>
5697 <para><segmentedlist><segtitle>Return type</segtitle>
5698 <seglistitem><seg>An integer (like 0, -5, 14 )</seg></seglistitem></segmentedlist></para>
5699 <variablelist>
5700 <varlistentry><term>Syntax</term>
5701 <listitem><para>CEILING(x)</para></listitem>
5702 </varlistentry>
5703 <varlistentry><term>Parameters</term>
5704 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5705 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
5706 <seglistitem><seg>Significance (optional)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
5707 <seglistitem><seg>Mode (optional)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
5708 </varlistentry>
5709 <varlistentry><term>Examples</term>
5710 <listitem><para>CEILING(12.5) equals 13</para></listitem>
5711 </varlistentry>
5712 <varlistentry><term>Examples</term>
5713 <listitem><para>CEILING(6.43; 4) equals 8</para></listitem>
5714 </varlistentry>
5715 <varlistentry><term>Examples</term>
5716 <listitem><para>CEILING(-6.43; -4; 1) equals -8</para></listitem>
5717 </varlistentry>
5718 <varlistentry><term>Examples</term>
5719 <listitem><para>CEILING(-6.43; -4; 0) equals -4</para></listitem>
5720 </varlistentry>
5721 <varlistentry><term>Related Functions</term>
5722 <listitem><simplelist>
5723 <member><link linkend="CEIL">CEIL</link> </member>
5724 <member><link linkend="FLOOR">FLOOR</link> </member>
5725 <member><link linkend="ROUND">ROUND</link> </member>
5726 <member><link linkend="ROUNDUP">ROUNDUP</link> </member>
5727 </simplelist></listitem>
5728 </varlistentry>
5729 </variablelist>
5730 </sect3>
5731
5732 <sect3 id="COUNT">
5733 <title>COUNT</title>
5734 <para>This function returns the count of integer or floating arguments passed. You can count using a range: COUNT(A1:B5) or using a list of values like COUNT(12;5;12.5).</para>
5735 <para><segmentedlist><segtitle>Return type</segtitle>
5736 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
5737 <variablelist>
5738 <varlistentry><term>Syntax</term>
5739 <listitem><para>COUNT(value;value;value...)</para></listitem>
5740 </varlistentry>
5741 <varlistentry><term>Parameters</term>
5742 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5743 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
5744 </varlistentry>
5745 <varlistentry><term>Examples</term>
5746 <listitem><para>COUNT(-5;"KSpread";2) returns 2</para></listitem>
5747 </varlistentry>
5748 <varlistentry><term>Examples</term>
5749 <listitem><para>COUNT(5) returns 1</para></listitem>
5750 </varlistentry>
5751 <varlistentry><term>Related Functions</term>
5752 <listitem><simplelist>
5753 <member><link linkend="COUNTA">COUNTA</link> </member>
5754 <member><link linkend="COUNTIF">COUNTIF</link> </member>
5755 <member><link linkend="SUM">SUM</link> </member>
5756 </simplelist></listitem>
5757 </varlistentry>
5758 </variablelist>
5759 </sect3>
5760
5761 <sect3 id="COUNTA">
5762 <title>COUNTA</title>
5763 <para>This function returns the count of all non empty arguments passed. You can count using a range: COUNTA(A1:B5) or using a list of values like COUNTA(12;5;12.5).</para>
5764 <para><segmentedlist><segtitle>Return type</segtitle>
5765 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
5766 <variablelist>
5767 <varlistentry><term>Syntax</term>
5768 <listitem><para>COUNTA(value;value;value...)</para></listitem>
5769 </varlistentry>
5770 <varlistentry><term>Parameters</term>
5771 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5772 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
5773 </varlistentry>
5774 <varlistentry><term>Examples</term>
5775 <listitem><para>COUNTA(-5;"KSpread";2) returns 3</para></listitem>
5776 </varlistentry>
5777 <varlistentry><term>Examples</term>
5778 <listitem><para>COUNTA(5) returns 1</para></listitem>
5779 </varlistentry>
5780 <varlistentry><term>Related Functions</term>
5781 <listitem><simplelist>
5782 <member><link linkend="COUNT">COUNT</link> </member>
5783 <member><link linkend="COUNTIF">COUNTIF</link> </member>
5784 </simplelist></listitem>
5785 </varlistentry>
5786 </variablelist>
5787 </sect3>
5788
5789 <sect3 id="COUNTBLANK">
5790 <title>COUNTBLANK</title>
5791 <para>This function returns the count of all empty cells within the range.</para>
5792 <para><segmentedlist><segtitle>Return type</segtitle>
5793 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
5794 <variablelist>
5795 <varlistentry><term>Syntax</term>
5796 <listitem><para>COUNTBLANK(range)</para></listitem>
5797 </varlistentry>
5798 <varlistentry><term>Parameters</term>
5799 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5800 <seglistitem><seg>Cell range</seg><seg>Range</seg></seglistitem></segmentedlist></para></listitem>
5801 </varlistentry>
5802 <varlistentry><term>Examples</term>
5803 <listitem><para>COUNTBLANK(A1:B5)</para></listitem>
5804 </varlistentry>
5805 <varlistentry><term>Related Functions</term>
5806 <listitem><simplelist>
5807 <member><link linkend="COUNT">COUNT</link> </member>
5808 <member><link linkend="COUNTA">COUNTA</link> </member>
5809 <member><link linkend="COUNTIF">COUNTIF</link> </member>
5810 </simplelist></listitem>
5811 </varlistentry>
5812 </variablelist>
5813 </sect3>
5814
5815 <sect3 id="COUNTIF">
5816 <title>COUNTIF</title>
5817 <para>The COUNTIF() function returns the number of cells in the given range that meet the given criteria.</para>
5818 <para><segmentedlist><segtitle>Return type</segtitle>
5819 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
5820 <variablelist>
5821 <varlistentry><term>Syntax</term>
5822 <listitem><para>COUNTIF(range;criteria)</para></listitem>
5823 </varlistentry>
5824 <varlistentry><term>Parameters</term>
5825 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5826 <seglistitem><seg>Range</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
5827 <seglistitem><seg>Criteria</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
5828 </varlistentry>
5829 <varlistentry><term>Examples</term>
5830 <listitem><para>COUNTIF(A2:A3;"14") returns 1 if A2 is -4 and A3 is 14</para></listitem>
5831 </varlistentry>
5832 <varlistentry><term>Related Functions</term>
5833 <listitem><simplelist>
5834 <member><link linkend="COUNT">COUNT</link> </member>
5835 <member><link linkend="SUMIF">SUMIF</link> </member>
5836 </simplelist></listitem>
5837 </varlistentry>
5838 </variablelist>
5839 </sect3>
5840
5841 <sect3 id="CUR">
5842 <title>CUR</title>
5843 <para>The CUR() function returns the non-negative cube root of x.</para>
5844 <para><segmentedlist><segtitle>Return type</segtitle>
5845 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
5846 <variablelist>
5847 <varlistentry><term>Syntax</term>
5848 <listitem><para>CUR(x)</para></listitem>
5849 </varlistentry>
5850 <varlistentry><term>Parameters</term>
5851 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5852 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
5853 </varlistentry>
5854 <varlistentry><term>Examples</term>
5855 <listitem><para>CUR(27) equals 3</para></listitem>
5856 </varlistentry>
5857 <varlistentry><term>Related Functions</term>
5858 <listitem><simplelist>
5859 <member><link linkend="SQRT">SQRT</link> </member>
5860 </simplelist></listitem>
5861 </varlistentry>
5862 </variablelist>
5863 </sect3>
5864
5865 <sect3 id="DIV">
5866 <title>DIV</title>
5867 <para>The DIV() function divides the first value by the other values in turn.</para>
5868 <para><segmentedlist><segtitle>Return type</segtitle>
5869 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
5870 <variablelist>
5871 <varlistentry><term>Syntax</term>
5872 <listitem><para>DIV(value;value;...)</para></listitem>
5873 </varlistentry>
5874 <varlistentry><term>Parameters</term>
5875 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5876 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
5877 </varlistentry>
5878 <varlistentry><term>Examples</term>
5879 <listitem><para>DIV(20;2;2) returns 5</para></listitem>
5880 </varlistentry>
5881 <varlistentry><term>Examples</term>
5882 <listitem><para>DIV(25;2.5) returns 10</para></listitem>
5883 </varlistentry>
5884 <varlistentry><term>Related Functions</term>
5885 <listitem><simplelist>
5886 <member><link linkend="MULTIPLY">MULTIPLY</link> </member>
5887 <member><link linkend="MOD">MOD</link> </member>
5888 </simplelist></listitem>
5889 </varlistentry>
5890 </variablelist>
5891 </sect3>
5892
5893 <sect3 id="EPS">
5894 <title>EPS</title>
5895 <para>EPS() returns the machine epsilon; this is the difference between 1 and the next largest floating-point number. Because computers use a finite number of digits, roundoff error is inherent (but usually insignificant) in all calculations.</para>
5896 <para><segmentedlist><segtitle>Return type</segtitle>
5897 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
5898 <variablelist>
5899 <varlistentry><term>Syntax</term>
5900 <listitem><para>EPS()</para></listitem>
5901 </varlistentry>
5902 <varlistentry><term>Parameters</term>
5903 <listitem><para></para></listitem>
5904 </varlistentry>
5905 <varlistentry><term>Examples</term>
5906 <listitem><para>On most systems, this returns 2^-52=2.2204460492503131e-16</para></listitem>
5907 </varlistentry>
5908 <varlistentry><term>Examples</term>
5909 <listitem><para>0.5*EPS() returns the "unit round"; this value is interesting because it is the largest number x where (1+x)-1=0 (due to roundoff errors).</para></listitem>
5910 </varlistentry>
5911 <varlistentry><term>Examples</term>
5912 <listitem><para>EPS() is so small that &sheets; displays 1+eps() as 1</para></listitem>
5913 </varlistentry>
5914 <varlistentry><term>Examples</term>
5915 <listitem><para>Pick a number x between 0 and EPS(). Observe that 1+x rounds x to either 0 or EPS() by using the equation (1+x)-1</para></listitem>
5916 </varlistentry>
5917 </variablelist>
5918 </sect3>
5919
5920 <sect3 id="EVEN">
5921 <title>EVEN</title>
5922 <para>The EVEN() function returns the number rounded up to the nearest even integer.</para>
5923 <para><segmentedlist><segtitle>Return type</segtitle>
5924 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
5925 <variablelist>
5926 <varlistentry><term>Syntax</term>
5927 <listitem><para>EVEN(value)</para></listitem>
5928 </varlistentry>
5929 <varlistentry><term>Parameters</term>
5930 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5931 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
5932 </varlistentry>
5933
5934 <varlistentry><term>Examples</term>
5935 <listitem><para>EVEN(1.2) returns 2</para></listitem>
5936 </varlistentry>
5937 <varlistentry><term>Examples</term>
5938 <listitem><para>EVEN(2) returns 2</para></listitem>
5939 </varlistentry>
5940 <varlistentry><term>Related Functions</term>
5941 <listitem><simplelist>
5942 <member><link linkend="ODD">ODD</link> </member>
5943 </simplelist></listitem>
5944 </varlistentry>
5945 </variablelist>
5946 </sect3>
5947
5948 <sect3 id="EXP">
5949 <title>EXP</title>
5950 <para>The EXP() function returns the value of e (the base of natural logarithms) raised to the power of x.</para>
5951 <para><segmentedlist><segtitle>Return type</segtitle>
5952 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
5953 <variablelist>
5954 <varlistentry><term>Syntax</term>
5955 <listitem><para>EXP(x)</para></listitem>
5956 </varlistentry>
5957 <varlistentry><term>Parameters</term>
5958 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5959 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
5960 </varlistentry>
5961 <varlistentry><term>Examples</term>
5962 <listitem><para>EXP(9) equals 8 103.08392758</para></listitem>
5963 </varlistentry>
5964 <varlistentry><term>Examples</term>
5965 <listitem><para>EXP(-9) equals 0.00012341</para></listitem>
5966 </varlistentry>
5967 <varlistentry><term>Related Functions</term>
5968 <listitem><simplelist>
5969 <member><link linkend="LN">LN</link> </member>
5970 </simplelist></listitem>
5971 </varlistentry>
5972 </variablelist>
5973 </sect3>
5974
5975 <sect3 id="FACT">
5976 <title>FACT</title>
5977 <para>The FACT() function calculates the factorial of the parameter. The mathematical expression is (value)!.</para>
5978 <para><segmentedlist><segtitle>Return type</segtitle>
5979 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
5980 <variablelist>
5981 <varlistentry><term>Syntax</term>
5982 <listitem><para>FACT(number)</para></listitem>
5983 </varlistentry>
5984 <varlistentry><term>Parameters</term>
5985 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
5986 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
5987 </varlistentry>
5988 <varlistentry><term>Examples</term>
5989 <listitem><para>FACT(10) returns 3628800</para></listitem>
5990 </varlistentry>
5991 <varlistentry><term>Examples</term>
5992 <listitem><para>FACT(0) returns 1</para></listitem>
5993 </varlistentry>
5994 </variablelist>
5995 </sect3>
5996
5997 <sect3 id="FACTDOUBLE">
5998 <title>FACTDOUBLE</title>
5999 <para>The FACTDOUBLE() function calculates the double factorial of a number, i.e. x!!.</para>
6000 <para><segmentedlist><segtitle>Return type</segtitle>
6001 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6002 <variablelist>
6003 <varlistentry><term>Syntax</term>
6004 <listitem><para>FACTDOUBLE(number)</para></listitem>
6005 </varlistentry>
6006 <varlistentry><term>Parameters</term>
6007 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6008 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6009 </varlistentry>
6010 <varlistentry><term>Examples</term>
6011 <listitem><para>FACTDOUBLE(6) returns 48</para></listitem>
6012 </varlistentry>
6013 <varlistentry><term>Examples</term>
6014 <listitem><para>FACTDOUBLE(7) returns 105</para></listitem>
6015 </varlistentry>
6016 </variablelist>
6017 </sect3>
6018
6019 <sect3 id="FIB">
6020 <title>FIB</title>
6021 <para>Function FIB calculates the Nth term of a Fibonacci sequence (1, 1, 2, 3, 5, 8, 13, 21...), in which each number, after the first two, is the sum of the two numbers immediately preceding it. FIB(0) is defined to be 0.</para>
6022 <para><segmentedlist><segtitle>Return type</segtitle>
6023 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6024 <variablelist>
6025 <varlistentry><term>Syntax</term>
6026 <listitem><para>FIB(n)</para></listitem>
6027 </varlistentry>
6028 <varlistentry><term>Parameters</term>
6029 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6030 <seglistitem><seg>Nth term</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6031 </varlistentry>
6032 <varlistentry><term>Examples</term>
6033 <listitem><para>FIB(9) returns 34</para></listitem>
6034 </varlistentry>
6035 <varlistentry><term>Examples</term>
6036 <listitem><para>FIB(26) returns 121393</para></listitem>
6037 </varlistentry>
6038 </variablelist>
6039 </sect3>
6040
6041 <sect3 id="FLOOR">
6042 <title>FLOOR</title>
6043 <para>Round a number x down to the nearest multiple of the second parameter, Significance.</para>
6044 <para>The FLOOR() function rounds x down (towards zero) to the nearest multiple of Significance which is smaller than the input.
6045 The default value for Significance is 1, if x is positive. It is -1, if the value is negative,
6046 which means rounding up to the nearest integer.
6047 If mode is given and not equal to zero, the amount of x is rounded toward zero to a multiple
6048 of significance and then the sign applied. Otherwise, it rounds toward negative infinity.
6049 If any of the two parameters x or Significance is zero, the result is zero.</para>
6050 <para><segmentedlist><segtitle>Return type</segtitle>
6051 <seglistitem><seg>An integer (like 0, -5, 14 )</seg></seglistitem></segmentedlist></para>
6052 <variablelist>
6053 <varlistentry><term>Syntax</term>
6054 <listitem><para>FLOOR(x)</para></listitem>
6055 </varlistentry>
6056 <varlistentry><term>Parameters</term>
6057 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6058 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
6059 <seglistitem><seg>Significance (optional)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
6060 <seglistitem><seg>Mode (optional)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6061 </varlistentry>
6062 <varlistentry><term>Examples</term>
6063 <listitem><para>FLOOR(12.5) equals 12</para></listitem>
6064 </varlistentry>
6065 <varlistentry><term>Examples</term>
6066 <listitem><para>FLOOR(-12.5) equals -13</para></listitem>
6067 </varlistentry>
6068 <varlistentry><term>Examples</term>
6069 <listitem><para>FLOOR(5; 2) equals 4</para></listitem>
6070 </varlistentry>
6071 <varlistentry><term>Examples</term>
6072 <listitem><para>FLOOR(5; 2.2) equals 4.4</para></listitem>
6073 </varlistentry>
6074 <varlistentry><term>Related Functions</term>
6075 <listitem><simplelist>
6076 <member><link linkend="CEIL">CEIL</link> </member>
6077 <member><link linkend="CEILING">CEILING</link> </member>
6078 <member><link linkend="ROUND">ROUND</link> </member>
6079 <member><link linkend="ROUNDDOWN">ROUNDDOWN</link> </member>
6080 </simplelist></listitem>
6081 </varlistentry>
6082 </variablelist>
6083 </sect3>
6084
6085 <sect3 id="GAMMA">
6086 <title>GAMMA</title>
6087 <para>The GAMMA() function returns the gamma function value.</para>
6088 <para><segmentedlist><segtitle>Return type</segtitle>
6089 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6090 <variablelist>
6091 <varlistentry><term>Syntax</term>
6092 <listitem><para>GAMMA(value)</para></listitem>
6093 </varlistentry>
6094 <varlistentry><term>Parameters</term>
6095 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6096 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6097 </varlistentry>
6098 <varlistentry><term>Examples</term>
6099 <listitem><para>GAMMA(1) returns 1</para></listitem>
6100 </varlistentry>
6101 <varlistentry><term>Related Functions</term>
6102 <listitem><simplelist>
6103 <member><link linkend="FACT">FACT</link> </member>
6104 </simplelist></listitem>
6105 </varlistentry>
6106 </variablelist>
6107 </sect3>
6108
6109 <sect3 id="GCD">
6110 <title>GCD</title>
6111 <para>The GCD() function returns the greatest common denominator for two or more integer values.</para>
6112 <para><segmentedlist><segtitle>Return type</segtitle>
6113 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
6114 <variablelist>
6115 <varlistentry><term>Syntax</term>
6116 <listitem><para>GCD(value; value)</para></listitem>
6117 </varlistentry>
6118 <varlistentry><term>Parameters</term>
6119 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6120 <seglistitem><seg>First number</seg><seg>A range of whole numbers (like 1, 132, 2344)</seg></seglistitem>
6121 <seglistitem><seg>Second number</seg><seg>A range of whole numbers (like 1, 132, 2344)</seg></seglistitem>
6122 <seglistitem><seg>Third number</seg><seg>A range of whole numbers (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
6123 </varlistentry>
6124 <varlistentry><term>Examples</term>
6125 <listitem><para>GCD(6;4) returns 2</para></listitem>
6126 </varlistentry>
6127 <varlistentry><term>Examples</term>
6128 <listitem><para>GCD(10;20) returns 10</para></listitem>
6129 </varlistentry>
6130 <varlistentry><term>Examples</term>
6131 <listitem><para>GCD(20;15;10) returns 5</para></listitem>
6132 </varlistentry>
6133 <varlistentry><term>Related Functions</term>
6134 <listitem><simplelist>
6135 <member><link linkend="LCM">LCM</link> </member>
6136 </simplelist></listitem>
6137 </varlistentry>
6138 </variablelist>
6139 </sect3>
6140
6141 <sect3 id="G_PRODUCT">
6142 <title>G_PRODUCT</title>
6143 <para>The G_PRODUCT() function is the same as KPRODUCT. It is provided for Gnumeric compatibility.</para>
6144 <para><segmentedlist><segtitle>Return type</segtitle>
6145 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6146 <variablelist>
6147 <varlistentry><term>Syntax</term>
6148 <listitem><para>G_PRODUCT(value;value;...)</para></listitem>
6149 </varlistentry>
6150 <varlistentry><term>Parameters</term>
6151 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6152 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
6153 </varlistentry>
6154 <varlistentry><term>Related Functions</term>
6155 <listitem><simplelist>
6156 <member><link linkend="KPRODUCT">KPRODUCT</link> </member>
6157 </simplelist></listitem>
6158 </varlistentry>
6159 </variablelist>
6160 </sect3>
6161
6162 <sect3 id="INT">
6163 <title>INT</title>
6164 <para>The INT() function returns the integer part of the value.</para>
6165 <para><segmentedlist><segtitle>Return type</segtitle>
6166 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
6167 <variablelist>
6168 <varlistentry><term>Syntax</term>
6169 <listitem><para>INT(x)</para></listitem>
6170 </varlistentry>
6171 <varlistentry><term>Parameters</term>
6172 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6173 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6174 </varlistentry>
6175 <varlistentry><term>Examples</term>
6176 <listitem><para>INT(12.55) equals 12</para></listitem>
6177 </varlistentry>
6178 <varlistentry><term>Examples</term>
6179 <listitem><para>INT(15) equals 15</para></listitem>
6180 </varlistentry>
6181 <varlistentry><term>Related Functions</term>
6182 <listitem><simplelist>
6183 <member><link linkend="FLOOR">FLOOR</link> </member>
6184 <member><link linkend="QUOTIENT">QUOTIENT</link> </member>
6185 </simplelist></listitem>
6186 </varlistentry>
6187 </variablelist>
6188 </sect3>
6189
6190 <sect3 id="INV">
6191 <title>INV</title>
6192 <para>This function multiplies each value by -1.</para>
6193 <para><segmentedlist><segtitle>Return type</segtitle>
6194 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6195 <variablelist>
6196 <varlistentry><term>Syntax</term>
6197 <listitem><para>INV(value)</para></listitem>
6198 </varlistentry>
6199 <varlistentry><term>Parameters</term>
6200 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6201 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6202 </varlistentry>
6203 <varlistentry><term>Examples</term>
6204 <listitem><para>INV(-5) equals 5</para></listitem>
6205 </varlistentry>
6206 <varlistentry><term>Examples</term>
6207 <listitem><para>INV(5) equals -5</para></listitem>
6208 </varlistentry>
6209 <varlistentry><term>Examples</term>
6210 <listitem><para>INV(0) equals 0</para></listitem>
6211 </varlistentry>
6212 </variablelist>
6213 </sect3>
6214
6215 <sect3 id="KPRODUCT">
6216 <title>KPRODUCT</title>
6217 <para>The KPRODUCT() function calculates the product of all the values given as parameters. You can calculate the product of a range: KPRODUCT(A1:B5) or a list of values like KPRODUCT(12;5;12.5). If no numeric values are found 1 is returned.</para>
6218 <para><segmentedlist><segtitle>Return type</segtitle>
6219 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6220 <variablelist>
6221 <varlistentry><term>Syntax</term>
6222 <listitem><para>KPRODUCT(value;value;...)</para></listitem>
6223 </varlistentry>
6224 <varlistentry><term>Parameters</term>
6225 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6226 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
6227 </varlistentry>
6228 <varlistentry><term>Examples</term>
6229 <listitem><para>KPRODUCT(3;5;7) equals 105</para></listitem>
6230 </varlistentry>
6231 <varlistentry><term>Examples</term>
6232 <listitem><para>KPRODUCT(12.5;2) equals 25</para></listitem>
6233 </varlistentry>
6234 <varlistentry><term>Related Functions</term>
6235 <listitem><simplelist>
6236 <member><link linkend="G_PRODUCT">G_PRODUCT</link> </member>
6237 <member><link linkend="MULTIPLY">MULTIPLY</link> </member>
6238 <member><link linkend="PRODUCT">PRODUCT</link> </member>
6239 </simplelist></listitem>
6240 </varlistentry>
6241 </variablelist>
6242 </sect3>
6243
6244 <sect3 id="LCM">
6245 <title>LCM</title>
6246 <para>The LCM() function returns the least common multiple for two or more float values</para>
6247 <para><segmentedlist><segtitle>Return type</segtitle>
6248 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6249 <variablelist>
6250 <varlistentry><term>Syntax</term>
6251 <listitem><para>LCM(value; value)</para></listitem>
6252 </varlistentry>
6253 <varlistentry><term>Parameters</term>
6254 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6255 <seglistitem><seg>First number</seg><seg>FLOAT</seg></seglistitem>
6256 <seglistitem><seg>Second number</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
6257 </varlistentry>
6258 <varlistentry><term>Examples</term>
6259 <listitem><para>LCM(6;4) returns 12</para></listitem>
6260 </varlistentry>
6261 <varlistentry><term>Examples</term>
6262 <listitem><para>LCM(1.5;2.25) returns 4.5</para></listitem>
6263 </varlistentry>
6264 <varlistentry><term>Examples</term>
6265 <listitem><para>LCM(2;3;4) returns 12</para></listitem>
6266 </varlistentry>
6267 <varlistentry><term>Related Functions</term>
6268 <listitem><simplelist>
6269 <member><link linkend="GCD">GCD</link> </member>
6270 </simplelist></listitem>
6271 </varlistentry>
6272 </variablelist>
6273 </sect3>
6274
6275 <sect3 id="LN">
6276 <title>LN</title>
6277 <para>The LN() function returns the natural logarithm of x.</para>
6278 <para><segmentedlist><segtitle>Return type</segtitle>
6279 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6280 <variablelist>
6281 <varlistentry><term>Syntax</term>
6282 <listitem><para>LN(x)</para></listitem>
6283 </varlistentry>
6284 <varlistentry><term>Parameters</term>
6285 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6286 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6287 </varlistentry>
6288 <varlistentry><term>Examples</term>
6289 <listitem><para>LN(0.8) equals -0.22314355</para></listitem>
6290 </varlistentry>
6291 <varlistentry><term>Examples</term>
6292 <listitem><para>LN(0) equals -inf</para></listitem>
6293 </varlistentry>
6294 <varlistentry><term>Related Functions</term>
6295 <listitem><simplelist>
6296 <member><link linkend="LOG">LOG</link> </member>
6297 <member><link linkend="LOG10">LOG10</link> </member>
6298 <member><link linkend="LOG2">LOG2</link> </member>
6299 </simplelist></listitem>
6300 </varlistentry>
6301 </variablelist>
6302 </sect3>
6303
6304 <sect3 id="LOG">
6305 <title>LOG</title>
6306 <para>The LOG() function returns the base-10 logarithm of x.</para>
6307 <para><segmentedlist><segtitle>Return type</segtitle>
6308 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6309 <variablelist>
6310 <varlistentry><term>Syntax</term>
6311 <listitem><para>LOG(x)</para></listitem>
6312 </varlistentry>
6313 <varlistentry><term>Parameters</term>
6314 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6315 <seglistitem><seg>A floating point value, greater than zero</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6316 </varlistentry>
6317 <varlistentry><term>Examples</term>
6318 <listitem><para>LOG(0.8) equals -0.09691001</para></listitem>
6319 </varlistentry>
6320 <varlistentry><term>Examples</term>
6321 <listitem><para>LOG(0) is an error.</para></listitem>
6322 </varlistentry>
6323 <varlistentry><term>Related Functions</term>
6324 <listitem><simplelist>
6325 <member><link linkend="LN">LN</link> </member>
6326 <member><link linkend="LOGN">LOGN</link> </member>
6327 <member><link linkend="LOG10">LOG10</link> </member>
6328 <member><link linkend="LOG2">LOG2</link> </member>
6329 </simplelist></listitem>
6330 </varlistentry>
6331 </variablelist>
6332 </sect3>
6333
6334 <sect3 id="LOG10">
6335 <title>LOG10</title>
6336 <para>The LOG10() function returns the base-10 logarithm of the argument.</para>
6337 <para><segmentedlist><segtitle>Return type</segtitle>
6338 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6339 <variablelist>
6340 <varlistentry><term>Syntax</term>
6341 <listitem><para>LOG10(x)</para></listitem>
6342 </varlistentry>
6343 <varlistentry><term>Parameters</term>
6344 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6345 <seglistitem><seg>A positive floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6346 </varlistentry>
6347 <varlistentry><term>Examples</term>
6348 <listitem><para>LOG10(10) equals 1.</para></listitem>
6349 </varlistentry>
6350 <varlistentry><term>Examples</term>
6351 <listitem><para>LOG10(0) is an error.</para></listitem>
6352 </varlistentry>
6353 <varlistentry><term>Related Functions</term>
6354 <listitem><simplelist>
6355 <member><link linkend="LN">LN</link> </member>
6356 <member><link linkend="LOGN">LOGN</link> </member>
6357 <member><link linkend="LOG">LOG</link> </member>
6358 <member><link linkend="LOG2">LOG2</link> </member>
6359 </simplelist></listitem>
6360 </varlistentry>
6361 </variablelist>
6362 </sect3>
6363
6364 <sect3 id="LOG2">
6365 <title>LOG2</title>
6366 <para>The LOG2() function returns the base-2 logarithm of x.</para>
6367 <para><segmentedlist><segtitle>Return type</segtitle>
6368 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6369 <variablelist>
6370 <varlistentry><term>Syntax</term>
6371 <listitem><para>LOG2(x)</para></listitem>
6372 </varlistentry>
6373 <varlistentry><term>Parameters</term>
6374 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6375 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6376 </varlistentry>
6377 <varlistentry><term>Examples</term>
6378 <listitem><para>LOG2(0.8) equals -0.32192809</para></listitem>
6379 </varlistentry>
6380 <varlistentry><term>Examples</term>
6381 <listitem><para>LOG2(0) equals -inf.</para></listitem>
6382 </varlistentry>
6383 <varlistentry><term>Related Functions</term>
6384 <listitem><simplelist>
6385 <member><link linkend="LN">LN</link> </member>
6386 <member><link linkend="LOGN">LOGN</link> </member>
6387 <member><link linkend="LOG">LOG</link> </member>
6388 <member><link linkend="LOG10">LOG10</link> </member>
6389 </simplelist></listitem>
6390 </varlistentry>
6391 </variablelist>
6392 </sect3>
6393
6394 <sect3 id="LOGN">
6395 <title>LOGN</title>
6396 <para>The LOGn() function returns the base n logarithm of x.</para>
6397 <para><segmentedlist><segtitle>Return type</segtitle>
6398 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6399 <variablelist>
6400 <varlistentry><term>Syntax</term>
6401 <listitem><para>LOGn(value;base)</para></listitem>
6402 </varlistentry>
6403 <varlistentry><term>Parameters</term>
6404 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6405 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
6406 <seglistitem><seg>Base</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6407 </varlistentry>
6408 <varlistentry><term>Examples</term>
6409 <listitem><para>LOGn(12;10) equals 1.07918125</para></listitem>
6410 </varlistentry>
6411 <varlistentry><term>Examples</term>
6412 <listitem><para>LOGn(12;2) equals 3.5849625</para></listitem>
6413 </varlistentry>
6414 <varlistentry><term>Related Functions</term>
6415 <listitem><simplelist>
6416 <member><link linkend="LOG">LOG</link> </member>
6417 <member><link linkend="LN">LN</link> </member>
6418 <member><link linkend="LOG10">LOG10</link> </member>
6419 <member><link linkend="LOG2">LOG2</link> </member>
6420 </simplelist></listitem>
6421 </varlistentry>
6422 </variablelist>
6423 </sect3>
6424
6425 <sect3 id="MAX">
6426 <title>MAX</title>
6427 <para>The MAX() function returns the largest value given in the parameters. String and logical values are ignored.</para>
6428 <para><segmentedlist><segtitle>Return type</segtitle>
6429 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6430 <variablelist>
6431 <varlistentry><term>Syntax</term>
6432 <listitem><para>MAX(value;value;...)</para></listitem>
6433 </varlistentry>
6434
6435 <varlistentry><term>Parameters</term>
6436 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6437 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
6438 </varlistentry>
6439 <varlistentry><term>Examples</term>
6440 <listitem><para>MAX(12;5; 7) returns 12</para></listitem>
6441 </varlistentry>
6442 <varlistentry><term>Examples</term>
6443 <listitem><para>MAX(12.5; 2) returns 12.5</para></listitem>
6444 </varlistentry>
6445 <varlistentry><term>Examples</term>
6446 <listitem><para>MAX(0.5; 0.4; TRUE; 0.2) returns 0.5</para></listitem>
6447 </varlistentry>
6448 <varlistentry><term>Related Functions</term>
6449 <listitem><simplelist>
6450 <member><link linkend="COUNT">COUNT</link> </member>
6451 <member><link linkend="COUNTA">COUNTA</link> </member>
6452 <member><link linkend="MAXA">MAXA</link> </member>
6453 <member><link linkend="MIN">MIN</link> </member>
6454 <member><link linkend="MINA">MINA</link> </member>
6455 </simplelist></listitem>
6456 </varlistentry>
6457 </variablelist>
6458 </sect3>
6459
6460 <sect3 id="MAXA">
6461 <title>MAXA</title>
6462 <para>The MAXA() function returns the largest value given in the parameters. TRUE evaluates to 1, FALSE evaluates to 0. String values are ignored.</para>
6463 <para><segmentedlist><segtitle>Return type</segtitle>
6464 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6465 <variablelist>
6466 <varlistentry><term>Syntax</term>
6467 <listitem><para>MAXA(value;value;...)</para></listitem>
6468 </varlistentry>
6469 <varlistentry><term>Parameters</term>
6470 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6471 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
6472 </varlistentry>
6473 <varlistentry><term>Examples</term>
6474 <listitem><para>MAXA(12;5; 7) returns 12</para></listitem>
6475 </varlistentry>
6476 <varlistentry><term>Examples</term>
6477 <listitem><para>MAXA(12.5; 2) returns 12.5</para></listitem>
6478 </varlistentry>
6479 <varlistentry><term>Examples</term>
6480 <listitem><para>MAXA(0.5; 0.4; TRUE; 0.2) returns 1</para></listitem>
6481 </varlistentry>
6482 <varlistentry><term>Related Functions</term>
6483 <listitem><simplelist>
6484 <member><link linkend="COUNT">COUNT</link> </member>
6485 <member><link linkend="COUNTA">COUNTA</link> </member>
6486 <member><link linkend="MAX">MAX</link> </member>
6487 <member><link linkend="MIN">MIN</link> </member>
6488 <member><link linkend="MINA">MINA</link> </member>
6489 </simplelist></listitem>
6490 </varlistentry>
6491 </variablelist>
6492 </sect3>
6493
6494 <sect3 id="MDETERM">
6495 <title>MDETERM</title>
6496 <para>Function MDETERM returns the determinant of a given matrix. The matrix must be of type n x n.</para>
6497 <para><segmentedlist><segtitle>Return type</segtitle>
6498 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6499 <variablelist>
6500 <varlistentry><term>Syntax</term>
6501 <listitem><para>MDETERM(matrix)</para></listitem>
6502 </varlistentry>
6503 <varlistentry><term>Parameters</term>
6504 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6505 <seglistitem><seg>Range</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6506 </varlistentry>
6507 <varlistentry><term>Examples</term>
6508 <listitem><para>MDETERM(A1:C3)</para></listitem>
6509 </varlistentry>
6510 <varlistentry><term>Related Functions</term>
6511 <listitem><simplelist>
6512 <member><link linkend="MMULT">MMULT</link> </member>
6513 </simplelist></listitem>
6514 </varlistentry>
6515 </variablelist>
6516 </sect3>
6517
6518 <sect3 id="MIN">
6519 <title>MIN</title>
6520 <para>The MIN() function returns the smallest value given in the parameters. String and logical values are ignored.</para>
6521 <para><segmentedlist><segtitle>Return type</segtitle>
6522 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6523 <variablelist>
6524 <varlistentry><term>Syntax</term>
6525 <listitem><para>MIN(value;value;...)</para></listitem>
6526 </varlistentry>
6527 <varlistentry><term>Parameters</term>
6528 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6529 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
6530 </varlistentry>
6531 <varlistentry><term>Examples</term>
6532 <listitem><para>MIN(12;5; 7) returns 5</para></listitem>
6533 </varlistentry>
6534 <varlistentry><term>Examples</term>
6535 <listitem><para>MIN(12.5; 2) returns 2</para></listitem>
6536 </varlistentry>
6537 <varlistentry><term>Examples</term>
6538 <listitem><para>MIN(0.4; 2; FALSE; 0.7) returns 0.4</para></listitem>
6539 </varlistentry>
6540 <varlistentry><term>Related Functions</term>
6541 <listitem><simplelist>
6542 <member><link linkend="COUNT">COUNT</link> </member>
6543 <member><link linkend="COUNTA">COUNTA</link> </member>
6544 <member><link linkend="MAX">MAX</link> </member>
6545 <member><link linkend="MAXA">MAXA</link> </member>
6546 <member><link linkend="MINA">MINA</link> </member>
6547 </simplelist></listitem>
6548 </varlistentry>
6549 </variablelist>
6550 </sect3>
6551
6552 <sect3 id="MINA">
6553 <title>MINA</title>
6554 <para>The MINA() function returns the smallest value given in the parameters. TRUE evaluates to 1, FALSE to 0. String values are ignored.</para>
6555 <para><segmentedlist><segtitle>Return type</segtitle>
6556 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6557 <variablelist>
6558 <varlistentry><term>Syntax</term>
6559 <listitem><para>MINA(value;value;...)</para></listitem>
6560 </varlistentry>
6561 <varlistentry><term>Parameters</term>
6562 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6563 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
6564 </varlistentry>
6565 <varlistentry><term>Examples</term>
6566 <listitem><para>MINA(12;5; 7) returns 5</para></listitem>
6567 </varlistentry>
6568 <varlistentry><term>Examples</term>
6569 <listitem><para>MINA(12.5; 2) returns 2</para></listitem>
6570 </varlistentry>
6571 <varlistentry><term>Examples</term>
6572 <listitem><para>MINA(0.4; 2; FALSE; 0.7) returns 0.</para></listitem>
6573 </varlistentry>
6574 <varlistentry><term>Related Functions</term>
6575 <listitem><simplelist>
6576 <member><link linkend="COUNT">COUNT</link> </member>
6577 <member><link linkend="COUNTA">COUNTA</link> </member>
6578 <member><link linkend="MAX">MAX</link> </member>
6579 <member><link linkend="MAXA">MAXA</link> </member>
6580 <member><link linkend="MIN">MIN</link> </member>
6581 </simplelist></listitem>
6582 </varlistentry>
6583 </variablelist>
6584 </sect3>
6585
6586 <sect3 id="MINVERSE">
6587 <title>MINVERSE</title>
6588 <para>Calculates the inverse of the matrix.</para>
6589 <para>The matrix multiplied with its inverse results in the unity matrix of the same dimension.</para>
6590 <para>Invertible matrices have a non-zero determinant.</para>
6591 <para><segmentedlist><segtitle>Return type</segtitle>
6592 <seglistitem><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6593 <variablelist>
6594 <varlistentry><term>Syntax</term>
6595 <listitem><para>MINVERSE(matrix)</para></listitem>
6596 </varlistentry>
6597 <varlistentry><term>Parameters</term>
6598 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6599 <seglistitem><seg>Matrix</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6600 </varlistentry>
6601 <varlistentry><term>Examples</term>
6602 <listitem><para>MINVERSE(A1:C3)</para></listitem>
6603 </varlistentry>
6604 <varlistentry><term>Related Functions</term>
6605 <listitem><simplelist>
6606 <member><link linkend="MDETERM">MDETERM</link> </member>
6607 <member><link linkend="MUNIT">MUNIT</link> </member>
6608 </simplelist></listitem>
6609 </varlistentry>
6610 </variablelist>
6611 </sect3>
6612
6613 <sect3 id="MMULT">
6614 <title>MMULT</title>
6615 <para>Function MMULT multiplies two matrices. Number of columns of the first matrix must be the same as row count of the second one. The result is a matrix.</para>
6616 <para><segmentedlist><segtitle>Return type</segtitle>
6617 <seglistitem><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6618 <variablelist>
6619 <varlistentry><term>Syntax</term>
6620 <listitem><para>MMULT(matrix1;matrix2)</para></listitem>
6621 </varlistentry>
6622 <varlistentry><term>Parameters</term>
6623 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6624 <seglistitem><seg>First matrix</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
6625 <seglistitem><seg>Second matrix</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6626 </varlistentry>
6627 <varlistentry><term>Examples</term>
6628 <listitem><para>MMULT(A1:C3)</para></listitem>
6629 </varlistentry>
6630 <varlistentry><term>Related Functions</term>
6631 <listitem><simplelist>
6632 <member><link linkend="MDETERM">MDETERM</link> </member>
6633 </simplelist></listitem>
6634 </varlistentry>
6635 </variablelist>
6636 </sect3>
6637
6638 <sect3 id="MOD">
6639 <title>MOD</title>
6640 <para>The MOD() function returns the remainder after division. If the second parameter is null the function returns #DIV/0.</para>
6641 <para><segmentedlist><segtitle>Return type</segtitle>
6642 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
6643 <variablelist>
6644 <varlistentry><term>Syntax</term>
6645 <listitem><para>MOD(value;value)</para></listitem>
6646 </varlistentry>
6647 <varlistentry><term>Parameters</term>
6648 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6649 <seglistitem><seg>Floating point value</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
6650 <seglistitem><seg>Floating point value</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
6651 </varlistentry>
6652 <varlistentry><term>Examples</term>
6653 <listitem><para>MOD(12;5) returns 2</para></listitem>
6654 </varlistentry>
6655 <varlistentry><term>Examples</term>
6656 <listitem><para>MOD(5;5) returns 0</para></listitem>
6657 </varlistentry>
6658 <varlistentry><term>Related Functions</term>
6659 <listitem><simplelist>
6660 <member><link linkend="DIV">DIV</link> </member>
6661 </simplelist></listitem>
6662 </varlistentry>
6663 </variablelist>
6664 </sect3>
6665
6666 <sect3 id="MROUND">
6667 <title>MROUND</title>
6668 <para>The MROUND() function returns the value rounded to the specified multiple. The value and the multiple must have the same sign</para>
6669 <para><segmentedlist><segtitle>Return type</segtitle>
6670 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6671 <variablelist>
6672 <varlistentry><term>Syntax</term>
6673 <listitem><para>MROUND(value; multiple)</para></listitem>
6674 </varlistentry>
6675 <varlistentry><term>Parameters</term>
6676 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6677 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
6678 <seglistitem><seg>Multiple</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6679 </varlistentry>
6680 <varlistentry><term>Examples</term>
6681 <listitem><para>MROUND(1.252; 0.5) equals 1.5</para></listitem>
6682 </varlistentry>
6683 <varlistentry><term>Examples</term>
6684 <listitem><para>MROUND(-1.252; -0.5) equals -1.5</para></listitem>
6685 </varlistentry>
6686 <varlistentry><term>Related Functions</term>
6687 <listitem><simplelist>
6688 <member><link linkend="ROUND">ROUND</link> </member>
6689 </simplelist></listitem>
6690 </varlistentry>
6691 </variablelist>
6692 </sect3>
6693
6694 <sect3 id="MULTINOMIAL">
6695 <title>MULTINOMIAL</title>
6696 <para>The MULTINOMIAL() function returns the multinomial of each number in the parameters. It uses this formula for MULTINOMIAL(a,b,c):</para>
6697 <para>(a+b+c)! / a!b!c!</para>
6698 <para><segmentedlist><segtitle>Return type</segtitle>
6699 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6700 <variablelist>
6701 <varlistentry><term>Syntax</term>
6702 <listitem><para>MULTINOMIAL(value;value;...)</para></listitem>
6703 </varlistentry>
6704 <varlistentry><term>Parameters</term>
6705 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6706 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
6707 </varlistentry>
6708 <varlistentry><term>Examples</term>
6709 <listitem><para>MULTINOMIAL(3;4;5) equals 27720</para></listitem>
6710 </varlistentry>
6711 </variablelist>
6712 </sect3>
6713
6714 <sect3 id="MULTIPLY">
6715 <title>MULTIPLY</title>
6716 <para>The MULTIPLY() function multiplies all the values given in the parameters. You can multiply values given by a range MULTIPLY(A1:B5) or a list of values like MULTIPLY(12;5;12.5). It's equivalent to PRODUCT.</para>
6717 <para><segmentedlist><segtitle>Return type</segtitle>
6718 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6719 <variablelist>
6720 <varlistentry><term>Syntax</term>
6721 <listitem><para>MULTIPLY(value;value;...)</para></listitem>
6722 </varlistentry>
6723 <varlistentry><term>Parameters</term>
6724 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6725 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
6726 </varlistentry>
6727 <varlistentry><term>Examples</term>
6728 <listitem><para>MULTIPLY(12;5;7) equals 420</para></listitem>
6729 </varlistentry>
6730 <varlistentry><term>Examples</term>
6731 <listitem><para>MULTIPLY(12.5;2) equals 25</para></listitem>
6732 </varlistentry>
6733 <varlistentry><term>Related Functions</term>
6734 <listitem><simplelist>
6735 <member><link linkend="DIV">DIV</link> </member>
6736 <member><link linkend="PRODUCT">PRODUCT</link> </member>
6737 <member><link linkend="KPRODUCT">KPRODUCT</link> </member>
6738 </simplelist></listitem>
6739 </varlistentry>
6740 </variablelist>
6741 </sect3>
6742
6743 <sect3 id="MUNIT">
6744 <title>MUNIT</title>
6745 <para>Creates the unity matrix of the given dimension.</para>
6746 <para><segmentedlist><segtitle>Return type</segtitle>
6747 <seglistitem><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6748 <variablelist>
6749 <varlistentry><term>Syntax</term>
6750 <listitem><para>MUNIT(dimension)</para></listitem>
6751 </varlistentry>
6752 <varlistentry><term>Parameters</term>
6753 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6754 <seglistitem><seg>Dimension</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
6755 </varlistentry>
6756 <varlistentry><term>Examples</term>
6757 <listitem><para>MUNIT(3) creates a 3x3 unity matrix</para></listitem>
6758 </varlistentry>
6759 <varlistentry><term>Related Functions</term>
6760 <listitem><simplelist>
6761 <member><link linkend="MINVERSE">MINVERSE</link> </member>
6762 </simplelist></listitem>
6763 </varlistentry>
6764 </variablelist>
6765 </sect3>
6766
6767 <sect3 id="ODD">
6768 <title>ODD</title>
6769 <para>The ODD() function returns the number rounded up (or down, for negative values) to the nearest odd integer. By definition, ODD(0) is 1.</para>
6770 <para><segmentedlist><segtitle>Return type</segtitle>
6771 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6772 <variablelist>
6773 <varlistentry><term>Syntax</term>
6774 <listitem><para>ODD(value)</para></listitem>
6775 </varlistentry>
6776 <varlistentry><term>Parameters</term>
6777 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6778 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6779 </varlistentry>
6780 <varlistentry><term>Examples</term>
6781 <listitem><para>ODD(1.2) returns 3</para></listitem>
6782 </varlistentry>
6783 <varlistentry><term>Examples</term>
6784 <listitem><para>ODD(2) returns 3</para></listitem>
6785 </varlistentry>
6786 <varlistentry><term>Examples</term>
6787 <listitem><para>ODD(-2) returns -3</para></listitem>
6788 </varlistentry>
6789 <varlistentry><term>Related Functions</term>
6790 <listitem><simplelist>
6791 <member><link linkend="EVEN">EVEN</link> </member>
6792 </simplelist></listitem>
6793 </varlistentry>
6794 </variablelist>
6795 </sect3>
6796
6797 <sect3 id="POW">
6798 <title>POW</title>
6799 <para>The POW(x;y) function returns the value of x raised to the power of y. It's the same as POWER.</para>
6800 <para><segmentedlist><segtitle>Return type</segtitle>
6801 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6802 <variablelist>
6803 <varlistentry><term>Syntax</term>
6804 <listitem><para>POW(value;value)</para></listitem>
6805 </varlistentry>
6806 <varlistentry><term>Parameters</term>
6807 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6808 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
6809 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6810 </varlistentry>
6811 <varlistentry><term>Examples</term>
6812 <listitem><para>POW(1.2;3.4) equals 1.8572</para></listitem>
6813 </varlistentry>
6814 <varlistentry><term>Examples</term>
6815 <listitem><para>POW(2;3) equals 8</para></listitem>
6816 </varlistentry>
6817 <varlistentry><term>Related Functions</term>
6818 <listitem><simplelist>
6819 <member><link linkend="POWER">POWER</link> </member>
6820 </simplelist></listitem>
6821 </varlistentry>
6822 </variablelist>
6823 </sect3>
6824
6825 <sect3 id="POWER">
6826 <title>POWER</title>
6827 <para>The POWER(x;y) function returns the value of x raised to the power of y.</para>
6828 <para><segmentedlist><segtitle>Return type</segtitle>
6829 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6830 <variablelist>
6831 <varlistentry><term>Syntax</term>
6832 <listitem><para>POWER(value;value)</para></listitem>
6833 </varlistentry>
6834 <varlistentry><term>Parameters</term>
6835 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6836 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
6837 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6838 </varlistentry>
6839 <varlistentry><term>Examples</term>
6840 <listitem><para>POWER(1.2;3.4) equals 1.8572</para></listitem>
6841 </varlistentry>
6842 <varlistentry><term>Examples</term>
6843 <listitem><para>POWER(2;3) equals 8</para></listitem>
6844 </varlistentry>
6845 <varlistentry><term>Related Functions</term>
6846 <listitem><simplelist>
6847 <member><link linkend="POW">POW</link> </member>
6848 </simplelist></listitem>
6849 </varlistentry>
6850 </variablelist>
6851 </sect3>
6852
6853 <sect3 id="PRODUCT">
6854 <title>PRODUCT</title>
6855 <para>The PRODUCT() function calculates the product of all the values given as parameters. You can calculate the product of a range: PRODUCT(A1:B5) or a list of values like product(12;5;12.5). If no numeric values are found 0 is returned.</para>
6856 <para><segmentedlist><segtitle>Return type</segtitle>
6857 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6858 <variablelist>
6859 <varlistentry><term>Syntax</term>
6860 <listitem><para>PRODUCT(value;value;...)</para></listitem>
6861 </varlistentry>
6862 <varlistentry><term>Parameters</term>
6863 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6864 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
6865 </varlistentry>
6866 <varlistentry><term>Examples</term>
6867 <listitem><para>PRODUCT(3;5;7) equals 105</para></listitem>
6868 </varlistentry>
6869 <varlistentry><term>Examples</term>
6870 <listitem><para>PRODUCT(12.5;2) equals 25</para></listitem>
6871 </varlistentry>
6872 <varlistentry><term>Related Functions</term>
6873 <listitem><simplelist>
6874 <member><link linkend="MULTIPLY">MULTIPLY</link> </member>
6875 <member><link linkend="KPRODUCT">KPRODUCT</link> </member>
6876 </simplelist></listitem>
6877 </varlistentry>
6878 </variablelist>
6879 </sect3>
6880
6881 <sect3 id="QUOTIENT">
6882 <title>QUOTIENT</title>
6883 <para>Function QUOTIENT returns the integer portion of numerator/denumerator.</para>
6884 <para><segmentedlist><segtitle>Return type</segtitle>
6885 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
6886 <variablelist>
6887 <varlistentry><term>Syntax</term>
6888 <listitem><para>QUOTIENT(numerator;denumerator)</para></listitem>
6889 </varlistentry>
6890 <varlistentry><term>Parameters</term>
6891 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6892 <seglistitem><seg>Numerator</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
6893 <seglistitem><seg>Denumerator</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6894 </varlistentry>
6895 <varlistentry><term>Examples</term>
6896 <listitem><para>QUOTIENT(21;4) returns 5</para></listitem>
6897 </varlistentry>
6898 <varlistentry><term>Related Functions</term>
6899 <listitem><simplelist>
6900 <member><link linkend="INT">INT</link> </member>
6901 </simplelist></listitem>
6902 </varlistentry>
6903 </variablelist>
6904 </sect3>
6905
6906 <sect3 id="RAND">
6907 <title>RAND</title>
6908 <para>The RAND() function returns a pseudo-random number between 0 and 1.</para>
6909 <para><segmentedlist><segtitle>Return type</segtitle>
6910 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6911 <variablelist>
6912 <varlistentry><term>Syntax</term>
6913 <listitem><para>RAND()</para></listitem>
6914 </varlistentry>
6915 <varlistentry><term>Parameters</term>
6916 <listitem><para></para></listitem>
6917 </varlistentry>
6918 <varlistentry><term>Examples</term>
6919 <listitem><para>RAND() equals for example 0.78309922...</para></listitem>
6920 </varlistentry>
6921 <varlistentry><term>Related Functions</term>
6922 <listitem><simplelist>
6923 <member><link linkend="RANDBETWEEN">RANDBETWEEN</link> </member>
6924 <member><link linkend="RANDEXP">RANDEXP</link> </member>
6925 </simplelist></listitem>
6926 </varlistentry>
6927 </variablelist>
6928 </sect3>
6929
6930 <sect3 id="RANDBERNOULLI">
6931 <title>RANDBERNOULLI</title>
6932 <para>The RANDBERNOULLI() function returns a Bernoulli-distributed pseudo-random number.</para>
6933
6934 <para><segmentedlist><segtitle>Return type</segtitle>
6935 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6936 <variablelist>
6937 <varlistentry><term>Syntax</term>
6938 <listitem><para>RANDBERNOULLI(x)</para></listitem>
6939 </varlistentry>
6940 <varlistentry><term>Parameters</term>
6941 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6942 <seglistitem><seg>A floating point value (between 0 and 1)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
6943 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
6944 </varlistentry>
6945 <varlistentry><term>Examples</term>
6946 <listitem><para>RANDBERNOULLI(0.45)</para></listitem>
6947 </varlistentry>
6948 <varlistentry><term>Related Functions</term>
6949 <listitem><simplelist>
6950 <member><link linkend="RAND">RAND</link> </member>
6951 </simplelist></listitem>
6952 </varlistentry>
6953 </variablelist>
6954 </sect3>
6955
6956 <sect3 id="RANDBETWEEN">
6957 <title>RANDBETWEEN</title>
6958 <para>The RANDBETWEEN() function returns a pseudo-random number between bottom and top value. If bottom > top this function returns Err.</para>
6959 <para><segmentedlist><segtitle>Return type</segtitle>
6960 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6961 <variablelist>
6962 <varlistentry><term>Syntax</term>
6963 <listitem><para>RANDBETWEEN(bottom;top)</para></listitem>
6964 </varlistentry>
6965 <varlistentry><term>Parameters</term>
6966 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6967 <seglistitem><seg>Bottom value</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
6968 <seglistitem><seg>Top value</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
6969 </varlistentry>
6970 <varlistentry><term>Examples</term>
6971 <listitem><para>RANDBETWEEN(12;78) equals for example 61.0811...</para></listitem>
6972 </varlistentry>
6973 <varlistentry><term>Related Functions</term>
6974 <listitem><simplelist>
6975 <member><link linkend="RAND">RAND</link> </member>
6976 </simplelist></listitem>
6977 </varlistentry>
6978 </variablelist>
6979 </sect3>
6980
6981 <sect3 id="RANDBINOM">
6982 <title>RANDBINOM</title>
6983 <para>The RANDBINOM() function returns a binomially-distributed pseudo-random number.</para>
6984 <para><segmentedlist><segtitle>Return type</segtitle>
6985 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
6986 <variablelist>
6987 <varlistentry><term>Syntax</term>
6988 <listitem><para>RANDBINOM(x)</para></listitem>
6989 </varlistentry>
6990 <varlistentry><term>Parameters</term>
6991 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
6992 <seglistitem><seg>A floating point value (between 0 and 1)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
6993 <seglistitem><seg>Trials (greater 0)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
6994 </varlistentry>
6995 <varlistentry><term>Examples</term>
6996 <listitem><para>RANDBINOM(4)</para></listitem>
6997 </varlistentry>
6998 <varlistentry><term>Related Functions</term>
6999 <listitem><simplelist>
7000 <member><link linkend="RAND">RAND</link> </member>
7001 <member><link linkend="RANDNEGBINOM">RANDNEGBINOM</link> </member>
7002 </simplelist></listitem>
7003 </varlistentry>
7004 </variablelist>
7005 </sect3>
7006
7007 <sect3 id="RANDEXP">
7008 <title>RANDEXP</title>
7009 <para>The RANDEXP() function returns an exponentially-distributed pseudo-random number.</para>
7010 <para><segmentedlist><segtitle>Return type</segtitle>
7011 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7012 <variablelist>
7013 <varlistentry><term>Syntax</term>
7014 <listitem><para>RANDEXP(x)</para></listitem>
7015 </varlistentry>
7016 <varlistentry><term>Parameters</term>
7017 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7018 <seglistitem><seg>A floating point value (greater 0)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7019 </varlistentry>
7020 <varlistentry><term>Examples</term>
7021 <listitem><para>RANDEXP(0.88)</para></listitem>
7022 </varlistentry>
7023 <varlistentry><term>Related Functions</term>
7024 <listitem><simplelist>
7025 <member><link linkend="RAND">RAND</link> </member>
7026 </simplelist></listitem>
7027 </varlistentry>
7028 </variablelist>
7029 </sect3>
7030
7031 <sect3 id="RANDNEGBINOM">
7032 <title>RANDNEGBINOM</title>
7033 <para>The RANDNEGBINOM() function returns a negative binomially-distributed pseudo-random number.</para>
7034 <para><segmentedlist><segtitle>Return type</segtitle>
7035 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7036 <variablelist>
7037 <varlistentry><term>Syntax</term>
7038 <listitem><para>RANDNEGBINOM(x)</para></listitem>
7039 </varlistentry>
7040 <varlistentry><term>Parameters</term>
7041 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7042 <seglistitem><seg>A floating point value (between 0 and 1)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7043 <seglistitem><seg>Failures (greater 0)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7044 </varlistentry>
7045 <varlistentry><term>Examples</term>
7046 <listitem><para>RANDNEGBINOM(4)</para></listitem>
7047 </varlistentry>
7048 <varlistentry><term>Related Functions</term>
7049 <listitem><simplelist>
7050 <member><link linkend="RAND">RAND</link> </member>
7051 <member><link linkend="RANDBINOM">RANDBINOM</link> </member>
7052 </simplelist></listitem>
7053 </varlistentry>
7054 </variablelist>
7055 </sect3>
7056
7057 <sect3 id="RANDNORM">
7058 <title>RANDNORM</title>
7059 <para>The RANDNORM() function returns a Normal(Gaussian)-distributed pseudo-random number.</para>
7060 <para><segmentedlist><segtitle>Return type</segtitle>
7061 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7062 <variablelist>
7063 <varlistentry><term>Syntax</term>
7064 <listitem><para>RANDNORM(mu; sigma)</para></listitem>
7065 </varlistentry>
7066 <varlistentry><term>Parameters</term>
7067 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7068 <seglistitem><seg>Mean value of the normal distribution</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7069 <seglistitem><seg>Dispersion of the normal distribution</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7070 </varlistentry>
7071 <varlistentry><term>Examples</term>
7072 <listitem><para>RANDNORM(0; 1)</para></listitem>
7073 </varlistentry>
7074 <varlistentry><term>Related Functions</term>
7075 <listitem><simplelist>
7076 <member><link linkend="RAND">RAND</link> </member>
7077 </simplelist></listitem>
7078 </varlistentry>
7079 </variablelist>
7080 </sect3>
7081
7082 <sect3 id="RANDPOISSON">
7083 <title>RANDPOISSON</title>
7084 <para>The RANDPOISSON() function returns a poisson-distributed pseudo-random number.</para>
7085 <para><segmentedlist><segtitle>Return type</segtitle>
7086 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7087 <variablelist>
7088 <varlistentry><term>Syntax</term>
7089 <listitem><para>RANDPOISSON(x)</para></listitem>
7090 </varlistentry>
7091 <varlistentry><term>Parameters</term>
7092 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7093 <seglistitem><seg>A floating point value (greater 0)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7094 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7095 </varlistentry>
7096 <varlistentry><term>Examples</term>
7097 <listitem><para>RANDPOISSON(4)</para></listitem>
7098 </varlistentry>
7099 <varlistentry><term>Related Functions</term>
7100 <listitem><simplelist>
7101 <member><link linkend="RAND">RAND</link> </member>
7102 </simplelist></listitem>
7103 </varlistentry>
7104 </variablelist>
7105 </sect3>
7106
7107 <sect3 id="ROOTN">
7108 <title>ROOTN</title>
7109 <para>The ROOTN() function returns the non-negative nth root of x.</para>
7110 <para><segmentedlist><segtitle>Return type</segtitle>
7111 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7112 <variablelist>
7113 <varlistentry><term>Syntax</term>
7114 <listitem><para>ROOTN(x;n)</para></listitem>
7115 </varlistentry>
7116 <varlistentry><term>Parameters</term>
7117 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7118 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7119 <seglistitem><seg>Value</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7120 </varlistentry>
7121 <varlistentry><term>Examples</term>
7122 <listitem><para>ROOTN(9;2) equals 3</para></listitem>
7123 </varlistentry>
7124 <varlistentry><term>Related Functions</term>
7125 <listitem><simplelist>
7126 <member><link linkend="SQRT">SQRT</link> </member>
7127 </simplelist></listitem>
7128 </varlistentry>
7129 </variablelist>
7130 </sect3>
7131
7132 <sect3 id="ROUND">
7133 <title>ROUND</title>
7134 <para>The ROUND(value;[digits]) function returns value rounded. Digits is the number of digits to which you want to round that number. If digits is zero or omitted, value is rounded up to the nearest integer. If digits is smaller than zero, the corresponding integer part of the number is rounded.</para>
7135 <para><segmentedlist><segtitle>Return type</segtitle>
7136 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7137 <variablelist>
7138 <varlistentry><term>Syntax</term>
7139 <listitem><para>ROUND(value;[digits])</para></listitem>
7140 </varlistentry>
7141 <varlistentry><term>Parameters</term>
7142 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7143 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7144 <seglistitem><seg>Digits</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7145 </varlistentry>
7146 <varlistentry><term>Examples</term>
7147 <listitem><para>ROUND(1.252;2) equals 1.25</para></listitem>
7148 </varlistentry>
7149 <varlistentry><term>Examples</term>
7150 <listitem><para>ROUND(-1.252;2) equals -1.25</para></listitem>
7151 </varlistentry>
7152 <varlistentry><term>Examples</term>
7153 <listitem><para>ROUND(1.258;2) equals 1.26</para></listitem>
7154 </varlistentry>
7155 <varlistentry><term>Examples</term>
7156 <listitem><para>ROUND(-12.25;-1) equals -10</para></listitem>
7157 </varlistentry>
7158 <varlistentry><term>Examples</term>
7159 <listitem><para>ROUND(-1.252;0) equals -1</para></listitem>
7160 </varlistentry>
7161 <varlistentry><term>Related Functions</term>
7162 <listitem><simplelist>
7163 <member><link linkend="MROUND">MROUND</link> </member>
7164 <member><link linkend="ROUNDDOWN">ROUNDDOWN</link> </member>
7165 <member><link linkend="ROUNDUP">ROUNDUP</link> </member>
7166 </simplelist></listitem>
7167 </varlistentry>
7168 </variablelist>
7169 </sect3>
7170
7171 <sect3 id="ROUNDDOWN">
7172 <title>ROUNDDOWN</title>
7173 <para>The ROUNDDOWN(value;[digits]) function returns value rounded so that its absolute value is lesser. Digits is the number of digits to which you want to round that number. If digits is zero or omitted, value is rounded down to the nearest integer.</para>
7174 <para><segmentedlist><segtitle>Return type</segtitle>
7175 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7176 <variablelist>
7177 <varlistentry><term>Syntax</term>
7178 <listitem><para>ROUNDDOWN(value;[digits])</para></listitem>
7179 </varlistentry>
7180 <varlistentry><term>Parameters</term>
7181 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7182 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7183 <seglistitem><seg>Digits</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7184 </varlistentry>
7185 <varlistentry><term>Examples</term>
7186 <listitem><para>ROUNDDOWN(1.252) equals 1</para></listitem>
7187 </varlistentry>
7188 <varlistentry><term>Examples</term>
7189 <listitem><para>ROUNDDOWN(1.252;2) equals 1.25</para></listitem>
7190 </varlistentry>
7191 <varlistentry><term>Examples</term>
7192 <listitem><para>ROUNDDOWN(-1.252;2) equals -1.25</para></listitem>
7193 </varlistentry>
7194 <varlistentry><term>Examples</term>
7195 <listitem><para>ROUNDDOWN(-1.252) equals -1</para></listitem>
7196 </varlistentry>
7197 <varlistentry><term>Related Functions</term>
7198 <listitem><simplelist>
7199 <member><link linkend="ROUND">ROUND</link> </member>
7200 <member><link linkend="ROUNDUP">ROUNDUP</link> </member>
7201 </simplelist></listitem>
7202 </varlistentry>
7203 </variablelist>
7204 </sect3>
7205
7206 <sect3 id="ROUNDUP">
7207 <title>ROUNDUP</title>
7208 <para>The ROUNDUP(value;[digits]) function returns value rounded so that its absolute value is greater. Digits is the number of digits to which you want to round that number. If digits is zero or omitted, value is rounded up to the nearest integer.</para>
7209 <para><segmentedlist><segtitle>Return type</segtitle>
7210 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7211 <variablelist>
7212 <varlistentry><term>Syntax</term>
7213 <listitem><para>ROUNDUP(value;[digits])</para></listitem>
7214 </varlistentry>
7215 <varlistentry><term>Parameters</term>
7216 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7217 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7218 <seglistitem><seg>Digits</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7219 </varlistentry>
7220 <varlistentry><term>Examples</term>
7221 <listitem><para>ROUNDUP(1.252) equals 2</para></listitem>
7222 </varlistentry>
7223 <varlistentry><term>Examples</term>
7224 <listitem><para>ROUNDUP(1.252;2) equals 1.26</para></listitem>
7225 </varlistentry>
7226 <varlistentry><term>Examples</term>
7227 <listitem><para>ROUNDUP(-1.252;2) equals -1.26</para></listitem>
7228 </varlistentry>
7229 <varlistentry><term>Examples</term>
7230 <listitem><para>ROUNDUP(-1.252) equals -2</para></listitem>
7231 </varlistentry>
7232 <varlistentry><term>Related Functions</term>
7233 <listitem><simplelist>
7234 <member><link linkend="ROUND">ROUND</link> </member>
7235 <member><link linkend="ROUNDDOWN">ROUNDDOWN</link> </member>
7236 </simplelist></listitem>
7237 </varlistentry>
7238 </variablelist>
7239 </sect3>
7240
7241 <sect3 id="SERIESSUM">
7242 <title>SERIESSUM</title>
7243 <para>The SERIESSUM() function returns the sum of a power series.</para>
7244 <para><segmentedlist><segtitle>Return type</segtitle>
7245 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7246 <variablelist>
7247 <varlistentry><term>Syntax</term>
7248 <listitem><para>SERIESSUM( X; N; M; Coefficients)</para></listitem>
7249 </varlistentry>
7250 <varlistentry><term>Parameters</term>
7251 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7252 <seglistitem><seg>X the independent variable of the power series</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7253 <seglistitem><seg>N the initial power to which X is to be raised</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7254 <seglistitem><seg>M the increment by which to increase N for each term in the series</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7255 <seglistitem><seg>Coefficients a set of coefficients by which each successive power of the variable X is multiplied</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
7256 </varlistentry>
7257 <varlistentry><term>Examples</term>
7258 <listitem><para>SERIESSUM(2;0;2;{1;2}) return 9</para></listitem>
7259 </varlistentry>
7260 </variablelist>
7261 </sect3>
7262
7263 <sect3 id="SIGN">
7264 <title>SIGN</title>
7265 <para>This function returns -1 if the number is negative, 0 if the number is null and 1 if the number is positive.</para>
7266 <para><segmentedlist><segtitle>Return type</segtitle>
7267 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
7268 <variablelist>
7269 <varlistentry><term>Syntax</term>
7270 <listitem><para>SIGN(value)</para></listitem>
7271 </varlistentry>
7272 <varlistentry><term>Parameters</term>
7273 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7274 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7275 </varlistentry>
7276 <varlistentry><term>Examples</term>
7277 <listitem><para>SIGN(5) equals 1</para></listitem>
7278 </varlistentry>
7279 <varlistentry><term>Examples</term>
7280 <listitem><para>SIGN(0) equals 0</para></listitem>
7281 </varlistentry>
7282 <varlistentry><term>Examples</term>
7283 <listitem><para>SIGN(-5) equals -1</para></listitem>
7284 </varlistentry>
7285 </variablelist>
7286 </sect3>
7287
7288 <sect3 id="SQRT">
7289 <title>SQRT</title>
7290 <para>The SQRT() function returns the non-negative square root of the argument. It is an error if the argument is negative.</para>
7291 <para><segmentedlist><segtitle>Return type</segtitle>
7292 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7293 <variablelist>
7294 <varlistentry><term>Syntax</term>
7295 <listitem><para>SQRT(x)</para></listitem>
7296 </varlistentry>
7297 <varlistentry><term>Parameters</term>
7298 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7299 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7300 </varlistentry>
7301 <varlistentry><term>Examples</term>
7302 <listitem><para>SQRT(9) equals 3</para></listitem>
7303 </varlistentry>
7304 <varlistentry><term>Examples</term>
7305 <listitem><para>SQRT(-9) is an error</para></listitem>
7306 </varlistentry>
7307 <varlistentry><term>Related Functions</term>
7308 <listitem><simplelist>
7309 <member><link linkend="IMSQRT">IMSQRT</link> </member>
7310 </simplelist></listitem>
7311 </varlistentry>
7312 </variablelist>
7313 </sect3>
7314
7315 <sect3 id="SQRTPI">
7316 <title>SQRTPI</title>
7317 <para>The SQRTPI() function returns the non-negative square root of x * PI. It is an error if the argument is negative.</para>
7318 <para><segmentedlist><segtitle>Return type</segtitle>
7319 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7320 <variablelist>
7321 <varlistentry><term>Syntax</term>
7322 <listitem><para>SQRTPI(x)</para></listitem>
7323 </varlistentry>
7324 <varlistentry><term>Parameters</term>
7325 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7326 <seglistitem><seg>A floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7327 </varlistentry>
7328 <varlistentry><term>Examples</term>
7329 <listitem><para>SQRTPI(2) equals 2.506628</para></listitem>
7330 </varlistentry>
7331 </variablelist>
7332 </sect3>
7333
7334 <sect3 id="SUBTOTAL">
7335 <title>SUBTOTAL</title>
7336 <para>The SUBTOTAL() function returns a subtotal of a given list of arguments ignoring other subtotal results in there. Function can be one of the following numbers: 1 - Average, 2 - Count, 3 - CountA, 4 - Max, 5 - Min, 6 - Product, 7 - StDev, 8 - StDevP, 9 - Sum, 10 - Var, 11 - VarP.</para>
7337 <para><segmentedlist><segtitle>Return type</segtitle>
7338 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7339 <variablelist>
7340 <varlistentry><term>Syntax</term>
7341 <listitem><para>SUBTOTAL(function; value)</para></listitem>
7342 </varlistentry>
7343 <varlistentry><term>Parameters</term>
7344 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7345 <seglistitem><seg>Function</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
7346 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
7347 </varlistentry>
7348 <varlistentry><term>Examples</term>
7349 <listitem><para>If A1:A5 contains 7, 24, 23, 56 and 9:</para></listitem>
7350 </varlistentry>
7351 <varlistentry><term>Examples</term>
7352 <listitem><para>SUBTOTAL(1; A1:A5) returns 23.8</para></listitem>
7353 </varlistentry>
7354 <varlistentry><term>Examples</term>
7355 <listitem><para>SUBTOTAL(4; A1:A5) returns 56</para></listitem>
7356 </varlistentry>
7357 <varlistentry><term>Examples</term>
7358 <listitem><para>SUBTOTAL(9; A1:A5) returns 119</para></listitem>
7359 </varlistentry>
7360 <varlistentry><term>Examples</term>
7361 <listitem><para>SUBTOTAL(11; A1:A5) returns 307.76</para></listitem>
7362 </varlistentry>
7363 <varlistentry><term>Related Functions</term>
7364 <listitem><simplelist>
7365 <member><link linkend="AVERAGE">AVERAGE</link> </member>
7366 <member><link linkend="COUNT">COUNT</link> </member>
7367 <member><link linkend="COUNTA">COUNTA</link> </member>
7368 <member><link linkend="MAX">MAX</link> </member>
7369 <member><link linkend="MIN">MIN</link> </member>
7370 <member><link linkend="PRODUCT">PRODUCT</link> </member>
7371 <member><link linkend="STDEV">STDEV</link> </member>
7372 <member><link linkend="STDEVP">STDEVP</link> </member>
7373 <member><link linkend="SUM">SUM</link> </member>
7374 <member><link linkend="VAR">VAR</link> </member>
7375 <member><link linkend="VARP">VARP</link> </member>
7376 </simplelist></listitem>
7377 </varlistentry>
7378 </variablelist>
7379 </sect3>
7380
7381 <sect3 id="SUM">
7382 <title>SUM</title>
7383 <para>The SUM() function calculates the sum of all the values given as parameters. You can calculate the sum of a range SUM(A1:B5) or a list of values like SUM(12;5;12.5).</para>
7384 <para><segmentedlist><segtitle>Return type</segtitle>
7385 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7386 <variablelist>
7387 <varlistentry><term>Syntax</term>
7388 <listitem><para>SUM(value;value;...)</para></listitem>
7389 </varlistentry>
7390 <varlistentry><term>Parameters</term>
7391 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7392 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
7393 </varlistentry>
7394 <varlistentry><term>Examples</term>
7395 <listitem><para>SUM(12;5;7) equals 24</para></listitem>
7396 </varlistentry>
7397 <varlistentry><term>Examples</term>
7398 <listitem><para>SUM(12.5;2) equals 14.5</para></listitem>
7399 </varlistentry>
7400 <varlistentry><term>Related Functions</term>
7401 <listitem><simplelist>
7402 <member><link linkend="SUMA">SUMA</link> </member>
7403 <member><link linkend="SUMSQ">SUMSQ</link> </member>
7404 <member><link linkend="SUMIF">SUMIF</link> </member>
7405 </simplelist></listitem>
7406 </varlistentry>
7407 </variablelist>
7408 </sect3>
7409
7410 <sect3 id="SUMA">
7411 <title>SUMA</title>
7412 <para>The SUMA() function calculates the sum of all the values given as parameters. You can calculate the sum of a range SUMA(A1:B5) or a list of values like SUMA(12;5;12.5). If a parameter contains text or the boolean value FALSE it is counted as 0, if a parameter evaluates to TRUE it is counted as 1.</para>
7413 <para><segmentedlist><segtitle>Return type</segtitle>
7414 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7415 <variablelist>
7416 <varlistentry><term>Syntax</term>
7417 <listitem><para>SUM(value;value;...)</para></listitem>
7418 </varlistentry>
7419 <varlistentry><term>Parameters</term>
7420 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7421 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
7422 </varlistentry>
7423 <varlistentry><term>Examples</term>
7424 <listitem><para>SUMA(12;5; 7) equals 24</para></listitem>
7425 </varlistentry>
7426 <varlistentry><term>Examples</term>
7427 <listitem><para>SUMA(12.5; 2; TRUE) equals 15.5</para></listitem>
7428 </varlistentry>
7429
7430 <varlistentry><term>Related Functions</term>
7431 <listitem><simplelist>
7432 <member><link linkend="SUM">SUM</link> </member>
7433 <member><link linkend="SUMSQ">SUMSQ</link> </member>
7434 </simplelist></listitem>
7435 </varlistentry>
7436 </variablelist>
7437 </sect3>
7438
7439 <sect3 id="SUMIF">
7440 <title>SUMIF</title>
7441 <para>The SUMIF() function calculates the sum of all values given as parameters which match the criteria. The sum range is optional. If not supplied, the values in the check range are summed. The length of the check range should be equal or less than the length of the sum range.</para>
7442 <para><segmentedlist><segtitle>Return type</segtitle>
7443 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7444 <variablelist>
7445 <varlistentry><term>Syntax</term>
7446 <listitem><para>SUMIF(checkrange;criteria;sumrange)</para></listitem>
7447 </varlistentry>
7448 <varlistentry><term>Parameters</term>
7449 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7450 <seglistitem><seg>Check range</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
7451 <seglistitem><seg>Criteria</seg><seg>Text</seg></seglistitem>
7452 <seglistitem><seg>Sum range</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7453 </varlistentry>
7454 <varlistentry><term>Examples</term>
7455 <listitem><para>SUMIF(A1:A4;">1") sums all values in range A1:A4 which match >1</para></listitem>
7456 </varlistentry>
7457 <varlistentry><term>Examples</term>
7458 <listitem><para>SUMIF(A1:A4;"=0";B1:B4) sums all values in range B1:B4 if the corresponding value in A1:A4 matches =0</para></listitem>
7459 </varlistentry>
7460 <varlistentry><term>Related Functions</term>
7461 <listitem><simplelist>
7462 <member><link linkend="SUM">SUM</link> </member>
7463 <member><link linkend="COUNTIF">COUNTIF</link> </member>
7464 </simplelist></listitem>
7465 </varlistentry>
7466 </variablelist>
7467 </sect3>
7468
7469 <sect3 id="SUMSQ">
7470 <title>SUMSQ</title>
7471 <para>The SUMSQ() function calculates the sum of all the squares of values given as parameters. You can calculate the sum of a range SUMSQ(A1:B5) or a list of values like SUMSQ(12;5;12.5).</para>
7472 <para><segmentedlist><segtitle>Return type</segtitle>
7473 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7474 <variablelist>
7475 <varlistentry><term>Syntax</term>
7476 <listitem><para>SUMSQ(value;value;...)</para></listitem>
7477 </varlistentry>
7478 <varlistentry><term>Parameters</term>
7479 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7480 <seglistitem><seg>Values</seg><seg>FLOAT</seg></seglistitem></segmentedlist></para></listitem>
7481 </varlistentry>
7482 <varlistentry><term>Examples</term>
7483 <listitem><para>SUMSQ(12;5;7) equals 218</para></listitem>
7484 </varlistentry>
7485 <varlistentry><term>Examples</term>
7486 <listitem><para>SUMSQ(12.5;2) equals 173</para></listitem>
7487 </varlistentry>
7488 <varlistentry><term>Related Functions</term>
7489 <listitem><simplelist>
7490 <member><link linkend="SUM">SUM</link> </member>
7491 </simplelist></listitem>
7492 </varlistentry>
7493 </variablelist>
7494 </sect3>
7495
7496 <sect3 id="TRANSPOSE">
7497 <title>TRANSPOSE</title>
7498 <para>Returns the transpose of a matrix, i.e. rows and columns of the matrix are exchanged.</para>
7499 <para><segmentedlist><segtitle>Return type</segtitle>
7500 <seglistitem><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7501 <variablelist>
7502 <varlistentry><term>Syntax</term>
7503 <listitem><para>TRANSPOSE(matrix)</para></listitem>
7504 </varlistentry>
7505 <varlistentry><term>Parameters</term>
7506 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7507 <seglistitem><seg>Matrix</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7508 </varlistentry>
7509 <varlistentry><term>Examples</term>
7510 <listitem><para>TRANSPOSE(A1:C3)</para></listitem>
7511 </varlistentry>
7512 </variablelist>
7513 </sect3>
7514
7515 <sect3 id="TRUNC">
7516 <title>TRUNC</title>
7517 <para>The TRUNC() function truncates a numeric value to a certain precision. If the precision is omitted 0 is assumed.</para>
7518 <para><segmentedlist><segtitle>Return type</segtitle>
7519 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7520 <variablelist>
7521 <varlistentry><term>Syntax</term>
7522 <listitem><para>TRUNC(value; precision)</para></listitem>
7523 </varlistentry>
7524 <varlistentry><term>Parameters</term>
7525 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7526 <seglistitem><seg>Floating point value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7527 <seglistitem><seg>Precision</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7528 </varlistentry>
7529 <varlistentry><term>Examples</term>
7530 <listitem><para>TRUNC(1.2) returns 1</para></listitem>
7531 </varlistentry>
7532 <varlistentry><term>Examples</term>
7533 <listitem><para>TRUNC(213.232; 2) returns 213.23</para></listitem>
7534 </varlistentry>
7535 <varlistentry><term>Related Functions</term>
7536 <listitem><simplelist>
7537 <member><link linkend="ROUND">ROUND</link> </member>
7538 <member><link linkend="ROUNDDOWN">ROUNDDOWN</link> </member>
7539 <member><link linkend="ROUNDUP">ROUNDUP</link> </member>
7540 </simplelist></listitem>
7541 </varlistentry>
7542 </variablelist>
7543 </sect3>
7544
7545 </sect2><sect2 id="Statistical">
7546 <title>Statistical</title>
7547
7548 <sect3 id="AVEDEV">
7549 <title>AVEDEV</title>
7550 <para>The AVEDEV() function calculates the average of the absolute deviations of a data set from their mean.</para>
7551 <para><segmentedlist><segtitle>Return type</segtitle>
7552 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7553 <variablelist>
7554 <varlistentry><term>Syntax</term>
7555 <listitem><para>AVEDEV(value;value;...)</para></listitem>
7556 </varlistentry>
7557 <varlistentry><term>Parameters</term>
7558 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7559 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
7560 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
7561 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
7562 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
7563 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7564 </varlistentry>
7565 <varlistentry><term>Examples</term>
7566 <listitem><para>AVEDEV(11.4;17.3;21.3;25.9;40.1) returns 7.84</para></listitem>
7567 </varlistentry>
7568 <varlistentry><term>Examples</term>
7569 <listitem><para>AVEDEV(A1:A5) ...</para></listitem>
7570 </varlistentry>
7571 </variablelist>
7572 </sect3>
7573
7574 <sect3 id="AVERAGE">
7575 <title>AVERAGE</title>
7576 <para>The AVERAGE() function calculates the average of all the values given as parameters. You can calculate the average of a range AVERAGE(A1:B5) or a list of values like AVERAGE(12;5;12.5).</para>
7577 <para><segmentedlist><segtitle>Return type</segtitle>
7578 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7579 <variablelist>
7580 <varlistentry><term>Syntax</term>
7581 <listitem><para>AVERAGE(value;value;...)</para></listitem>
7582 </varlistentry>
7583 <varlistentry><term>Parameters</term>
7584 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7585 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
7586 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
7587 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
7588 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
7589 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7590 </varlistentry>
7591 <varlistentry><term>Examples</term>
7592 <listitem><para>AVERAGE(12;5;7) equals 8</para></listitem>
7593 </varlistentry>
7594 <varlistentry><term>Examples</term>
7595 <listitem><para>AVERAGE(12.5;2) equals 7.25</para></listitem>
7596 </varlistentry>
7597 </variablelist>
7598 </sect3>
7599
7600 <sect3 id="AVERAGEA">
7601 <title>AVERAGEA</title>
7602 <para>The AVERAGEA() calculates the average of the given arguments. Numbers, text and logical values are included in the calculation too. If the cell contains text or the argument evaluates to FALSE, it is counted as value zero (0). If the argument evaluates to TRUE, it is counted as one (1). Note that empty cells are not counted.</para>
7603 <para><segmentedlist><segtitle>Return type</segtitle>
7604 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7605 <variablelist>
7606 <varlistentry><term>Syntax</term>
7607 <listitem><para>AVERAGEA(value;value;...)</para></listitem>
7608 </varlistentry>
7609 <varlistentry><term>Parameters</term>
7610 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7611 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
7612 <seglistitem><seg>String values</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
7613 </varlistentry>
7614 <varlistentry><term>Examples</term>
7615 <listitem><para>AVERAGEA(11.4;17.3;"sometext";25.9;40.1) equals 18.94</para></listitem>
7616 </varlistentry>
7617 </variablelist>
7618 </sect3>
7619
7620 <sect3 id="BETADIST">
7621 <title>BETADIST</title>
7622 <para>The BETADIST() function returns the cumulative beta probability density function.</para>
7623 <para>The third and fourth parameters are optional. They set the lower and upper bounds, otherwise defaulting to 0.0 and 1.0 respectively.</para>
7624 <para><segmentedlist><segtitle>Return type</segtitle>
7625 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7626 <variablelist>
7627 <varlistentry><term>Syntax</term>
7628 <listitem><para>BETADIST(number;alpha;beta;start;end;[cumulative=TRUE])</para></listitem>
7629 </varlistentry>
7630 <varlistentry><term>Parameters</term>
7631 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7632 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7633 <seglistitem><seg>Alpha parameter</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7634 <seglistitem><seg>Beta parameter</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7635 <seglistitem><seg>Start</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7636 <seglistitem><seg>End</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7637 <seglistitem><seg>Cumulative</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
7638 </varlistentry>
7639 <varlistentry><term>Examples</term>
7640 <listitem><para>BETADIST(0.2859;0.2606;0.8105) equals 0.675444</para></listitem>
7641 </varlistentry>
7642 <varlistentry><term>Examples</term>
7643 <listitem><para>BETADIST(0.2859;0.2606;0.8105;0.2;0.9) equals 0.537856</para></listitem>
7644 </varlistentry>
7645 </variablelist>
7646 </sect3>
7647
7648 <sect3 id="BETAINV">
7649 <title>BETAINV</title>
7650 <para>The BETAINV() function returns the inverse of BETADIST(x;alpha;beta;a;b;TRUE()).</para>
7651 <para>The start and end parameters are optional. They set the lower and upper bounds, otherwise defaulting to 0.0 and 1.0 respectively.</para>
7652 <para><segmentedlist><segtitle>Return type</segtitle>
7653 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7654 <variablelist>
7655 <varlistentry><term>Syntax</term>
7656 <listitem><para>BETAINV(number;alpha;beta [; start=0 [; end=1]])</para></listitem>
7657 </varlistentry>
7658 <varlistentry><term>Parameters</term>
7659 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7660 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7661 <seglistitem><seg>Alpha parameter</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7662 <seglistitem><seg>Beta parameter</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7663 <seglistitem><seg>Start</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7664 <seglistitem><seg>End</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7665 </varlistentry>
7666 <varlistentry><term>Examples</term>
7667 <listitem><para>BETADIST(BETAINV(0.1;3;4);3;4) equals 0.1</para></listitem>
7668 </varlistentry>
7669 <varlistentry><term>Examples</term>
7670 <listitem><para>BETADIST(BETAINV(0.3;3;4);3;4) equals 0.3</para></listitem>
7671 </varlistentry>
7672 </variablelist>
7673 </sect3>
7674
7675 <sect3 id="BINO">
7676 <title>BINO</title>
7677 <para>The BINO() function returns the binomial distribution.</para>
7678 <para>The first parameter is the number of trials, the second parameter is the number of successes, and the third is the probability of success. The number of trials should be greater than the number of successes and the probability should be smaller or equal to 1.</para>
7679 <para><segmentedlist><segtitle>Return type</segtitle>
7680 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7681 <variablelist>
7682 <varlistentry><term>Syntax</term>
7683 <listitem><para>BINO(trials;success;prob_of_success)</para></listitem>
7684 </varlistentry>
7685 <varlistentry><term>Parameters</term>
7686 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7687 <seglistitem><seg>Number of trials</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
7688 <seglistitem><seg>Number of successful trials</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
7689 <seglistitem><seg>Probability of success</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
7690 </varlistentry>
7691 <varlistentry><term>Examples</term>
7692 <listitem><para>BINO(12;9;0.8) returns 0.236223201</para></listitem>
7693 </varlistentry>
7694 </variablelist>
7695 </sect3>
7696
7697 <sect3 id="CHIDIST">
7698 <title>CHIDIST</title>
7699 <para>The CHIDIST() function returns the probability value from the indicated Chi square that a hypothesis is confirmed.</para>
7700 <para>CHIDIST compares the Chi square value to be given for a random sample that is calculated from the sum of (observed value-expected value)^2/expected value for all values with the theoretical Chi square distribution and determines from this the probability of error for the hypothesis to be tested.</para>
7701 <para><segmentedlist><segtitle>Return type</segtitle>
7702 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7703 <variablelist>
7704 <varlistentry><term>Syntax</term>
7705 <listitem><para>CHIDIST(number;degrees_freedom)</para></listitem>
7706 </varlistentry>
7707 <varlistentry><term>Parameters</term>
7708 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7709 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7710 <seglistitem><seg>Degrees of freedom</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7711 </varlistentry>
7712 <varlistentry><term>Examples</term>
7713 <listitem><para>CHIDIST(13.27;5) returns 0.021</para></listitem>
7714 </varlistentry>
7715 </variablelist>
7716 </sect3>
7717
7718 <sect3 id="COMBIN">
7719 <title>COMBIN</title>
7720 <para>The COMBIN() function calculates the count of possible combinations. The first parameter is the total count of elements. The second parameter is the count of elements to choose. Both parameters should be positive and the first parameter should not be less than the second. Otherwise the function returns an error.</para>
7721 <para><segmentedlist><segtitle>Return type</segtitle>
7722 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
7723 <variablelist>
7724 <varlistentry><term>Syntax</term>
7725 <listitem><para>COMBIN(total;chosen)</para></listitem>
7726 </varlistentry>
7727 <varlistentry><term>Parameters</term>
7728 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7729 <seglistitem><seg>Total number of elements</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
7730 <seglistitem><seg>Number of elements to choose</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7731 </varlistentry>
7732 <varlistentry><term>Examples</term>
7733 <listitem><para>COMBIN(12;5) returns 792</para></listitem>
7734 </varlistentry>
7735 <varlistentry><term>Examples</term>
7736 <listitem><para>COMBIN(5;5) returns 1</para></listitem>
7737 </varlistentry>
7738 </variablelist>
7739 </sect3>
7740
7741 <sect3 id="COMBINA">
7742 <title>COMBINA</title>
7743 <para>The COMBINA() function calculates the count of possible combinations. The first parameter is the total count of elements. The second parameter is the count of elements to choose. Both parameters should be positive and the first parameter should not be less than the second. Otherwise the function returns an error.</para>
7744 <para><segmentedlist><segtitle>Return type</segtitle>
7745 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
7746 <variablelist>
7747 <varlistentry><term>Syntax</term>
7748 <listitem><para>COMBIN(total;chosen)</para></listitem>
7749 </varlistentry>
7750 <varlistentry><term>Parameters</term>
7751 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7752 <seglistitem><seg>Total number of elements</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
7753 <seglistitem><seg>Number of elements to choose</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7754 </varlistentry>
7755 <varlistentry><term>Examples</term>
7756 <listitem><para>COMBIN(12;5) returns 792</para></listitem>
7757 </varlistentry>
7758 <varlistentry><term>Examples</term>
7759 <listitem><para>COMBIN(5;5) returns 1</para></listitem>
7760 </varlistentry>
7761 </variablelist>
7762 </sect3>
7763
7764 <sect3 id="CONFIDENCE">
7765 <title>CONFIDENCE</title>
7766 <para>The CONFIDENCE() function returns the confidence interval for a population mean.</para>
7767 <para>The alpha parameter must be between 0 and 1 (non-inclusive), stddev must be positive and size must be greater or equal to 1.</para>
7768 <para><segmentedlist><segtitle>Return type</segtitle>
7769 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7770 <variablelist>
7771 <varlistentry><term>Syntax</term>
7772 <listitem><para>CONFIDENCE(alpha;stddev;size)</para></listitem>
7773 </varlistentry>
7774 <varlistentry><term>Parameters</term>
7775 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7776 <seglistitem><seg>Level of the confidence interval</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7777 <seglistitem><seg>Standard deviation for the total population</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7778 <seglistitem><seg>Size of the total population</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7779 </varlistentry>
7780 <varlistentry><term>Examples</term>
7781 <listitem><para>CONFIDENCE(0.05;1.5;100) equals 0.294059</para></listitem>
7782 </varlistentry>
7783 </variablelist>
7784 </sect3>
7785
7786 <sect3 id="CORREL">
7787 <title>CORREL</title>
7788 <para>The CORREL() function calculates the correlation coefficient of two cell ranges.</para>
7789 <para><segmentedlist><segtitle>Return type</segtitle>
7790 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7791 <variablelist>
7792 <varlistentry><term>Syntax</term>
7793 <listitem><para>CORREL(range1; range2)</para></listitem>
7794 </varlistentry>
7795 <varlistentry><term>Parameters</term>
7796 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7797 <seglistitem><seg>Cell range of values</seg><seg>Double</seg></seglistitem>
7798 <seglistitem><seg>Second cell range of values</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
7799 </varlistentry>
7800 <varlistentry><term>Examples</term>
7801 <listitem><para>CORREL(A1:A3; B1:B3)</para></listitem>
7802 </varlistentry>
7803 <varlistentry><term>Related Functions</term>
7804 <listitem><simplelist>
7805 <member><link linkend="PEARSON">PEARSON</link> </member>
7806 </simplelist></listitem>
7807 </varlistentry>
7808 </variablelist>
7809 </sect3>
7810
7811 <sect3 id="COVAR">
7812 <title>COVAR</title>
7813 <para>The COVAR() function calculates the covariance of two cell ranges.</para>
7814 <para><segmentedlist><segtitle>Return type</segtitle>
7815 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7816 <variablelist>
7817 <varlistentry><term>Syntax</term>
7818 <listitem><para>COVAR(range1; range2)</para></listitem>
7819 </varlistentry>
7820 <varlistentry><term>Parameters</term>
7821 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7822 <seglistitem><seg>Cell range of values</seg><seg>Double</seg></seglistitem>
7823 <seglistitem><seg>Second cell range of values</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
7824 </varlistentry>
7825 <varlistentry><term>Examples</term>
7826 <listitem><para>COVAR(A1:A3; B1:B3)</para></listitem>
7827 </varlistentry>
7828 </variablelist>
7829 </sect3>
7830
7831 <sect3 id="DEVSQ">
7832 <title>DEVSQ</title>
7833 <para>The DEVSQ() function calculates the sum of squares of deviations.</para>
7834 <para><segmentedlist><segtitle>Return type</segtitle>
7835 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7836 <variablelist>
7837 <varlistentry><term>Syntax</term>
7838 <listitem><para>DEVSQ(value; value;...)</para></listitem>
7839 </varlistentry>
7840 <varlistentry><term>Parameters</term>
7841 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7842 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
7843 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
7844 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
7845 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
7846 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
7847 </varlistentry>
7848 <varlistentry><term>Examples</term>
7849 <listitem><para>DEVSQ(A1:A5)</para></listitem>
7850 </varlistentry>
7851 <varlistentry><term>Examples</term>
7852 <listitem><para>DEVSQ(21; 33; 54; 23) returns 684.75</para></listitem>
7853 </varlistentry>
7854 </variablelist>
7855 </sect3>
7856
7857 <sect3 id="EXPONDIST">
7858 <title>EXPONDIST</title>
7859 <para>The EXPONDIST() function returns the exponential distribution.</para>
7860 <para>The lambda parameter must be positive.</para>
7861 <para>Cumulative = 0 calculates the density function; cumulative = 1 calculates the distribution.</para>
7862 <para><segmentedlist><segtitle>Return type</segtitle>
7863 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7864 <variablelist>
7865 <varlistentry><term>Syntax</term>
7866 <listitem><para>EXPONDIST(number;lambda;cumulative)</para></listitem>
7867 </varlistentry>
7868 <varlistentry><term>Parameters</term>
7869 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7870 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7871 <seglistitem><seg>Lambda parameter</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7872 <seglistitem><seg>0 = density, 1 = distribution</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7873 </varlistentry>
7874 <varlistentry><term>Examples</term>
7875 <listitem><para>EXPONDIST(3;0.5;0) equals 0.111565</para></listitem>
7876 </varlistentry>
7877 <varlistentry><term>Examples</term>
7878 <listitem><para>EXPONDIST(3;0.5;1) equals 0.776870</para></listitem>
7879 </varlistentry>
7880 </variablelist>
7881 </sect3>
7882
7883 <sect3 id="FDIST">
7884 <title>FDIST</title>
7885 <para>The FDIST() function returns the f-distribution.</para>
7886 <para><segmentedlist><segtitle>Return type</segtitle>
7887 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7888 <variablelist>
7889 <varlistentry><term>Syntax</term>
7890 <listitem><para>FDIST(number;degrees_freedom_1;degrees_freedom_2)</para></listitem>
7891 </varlistentry>
7892 <varlistentry><term>Parameters</term>
7893 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7894 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7895 <seglistitem><seg>Degrees of freedom 1</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
7896 <seglistitem><seg>Degrees of freedom 2</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7897 </varlistentry>
7898 <varlistentry><term>Examples</term>
7899 <listitem><para>FDIST(0.8;8;12) yields 0.61</para></listitem>
7900 </varlistentry>
7901 </variablelist>
7902 </sect3>
7903
7904 <sect3 id="FINV">
7905 <title>FINV</title>
7906 <para>The FINV() function returns the unique non-negative number x such that FDIST(x;r1;r2) = p.</para>
7907 <para><segmentedlist><segtitle>Return type</segtitle>
7908 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7909 <variablelist>
7910 <varlistentry><term>Syntax</term>
7911 <listitem><para>FINV(number; r1; r2)</para></listitem>
7912 </varlistentry>
7913 <varlistentry><term>Parameters</term>
7914 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7915 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
7916 <seglistitem><seg>Number r1</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
7917 <seglistitem><seg>Number r2</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
7918 </varlistentry>
7919 <varlistentry><term>Examples</term>
7920 <listitem><para>FDIST(FINV(0.1;3;4);3;4) equals 0.1</para></listitem>
7921 </varlistentry>
7922
7923 </variablelist>
7924 </sect3>
7925
7926 <sect3 id="FISHER">
7927 <title>FISHER</title>
7928 <para>The FISHER() function returns the Fisher transformation for x and creates a function close to a normal distribution.</para>
7929 <para><segmentedlist><segtitle>Return type</segtitle>
7930 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7931 <variablelist>
7932 <varlistentry><term>Syntax</term>
7933 <listitem><para>FISHER(number)</para></listitem>
7934 </varlistentry>
7935 <varlistentry><term>Parameters</term>
7936 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7937 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7938 </varlistentry>
7939 <varlistentry><term>Examples</term>
7940 <listitem><para>FISHER(0.2859) equals 0.294096</para></listitem>
7941 </varlistentry>
7942 <varlistentry><term>Examples</term>
7943 <listitem><para>FISHER(0.8105) equals 1.128485</para></listitem>
7944 </varlistentry>
7945 </variablelist>
7946 </sect3>
7947
7948 <sect3 id="FISHERINV">
7949 <title>FISHERINV</title>
7950 <para>The FISHERINV() function returns the inverse of the Fisher transformation for x and creates a function close to a normal distribution.</para>
7951 <para><segmentedlist><segtitle>Return type</segtitle>
7952 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7953 <variablelist>
7954 <varlistentry><term>Syntax</term>
7955 <listitem><para>FISHERINV(number)</para></listitem>
7956 </varlistentry>
7957 <varlistentry><term>Parameters</term>
7958 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7959 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7960 </varlistentry>
7961 <varlistentry><term>Examples</term>
7962 <listitem><para>FISHERINV(0.2859) equals 0.278357</para></listitem>
7963 </varlistentry>
7964 <varlistentry><term>Examples</term>
7965 <listitem><para>FISHERINV(0.8105) equals 0.669866</para></listitem>
7966 </varlistentry>
7967 </variablelist>
7968 </sect3>
7969
7970 <sect3 id="FREQUENCY">
7971 <title>FREQUENCY</title>
7972 <para>Counts the number of values for each interval given by the border values in the second parameter.</para>
7973 <para>The values in the second parameter determine the upper boundaries of the intervals.
7974 The intervals include the upper boundaries.
7975 The returned array is a column vector and has one more element than the second parameter;
7976 the last element represents the number of all elements greater than the last value in second parameter.
7977 If the second parameter is empty, all values in the first parameter are counted.</para>
7978 <para><segmentedlist><segtitle>Return type</segtitle>
7979 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7980 <variablelist>
7981 <varlistentry><term>Syntax</term>
7982 <listitem><para>FREQUENCY(Range data; Range bins)</para></listitem>
7983 </varlistentry>
7984 <varlistentry><term>Parameters</term>
7985 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
7986 <seglistitem><seg>Floating point values, that should be counted.</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
7987 <seglistitem><seg>Floating point values, representing the upper boundaries of the intervals.</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
7988 </varlistentry>
7989 </variablelist>
7990 </sect3>
7991
7992 <sect3 id="GAMMADIST">
7993 <title>GAMMADIST</title>
7994 <para>The GAMMADIST() function returns the gamma distribution.</para>
7995 <para>If the last parameter (cumulated) is 0, it calculates the density function; if it's 1, the distribution is returned.</para>
7996 <para>The first three parameters must be positive.</para>
7997 <para><segmentedlist><segtitle>Return type</segtitle>
7998 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
7999 <variablelist>
8000 <varlistentry><term>Syntax</term>
8001 <listitem><para>GAMMADIST(number;alpha;beta;cumulated)</para></listitem>
8002 </varlistentry>
8003 <varlistentry><term>Parameters</term>
8004 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8005 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8006 <seglistitem><seg>Alpha parameter</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8007 <seglistitem><seg>Beta parameter</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8008 <seglistitem><seg>Cumulated flag</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
8009 </varlistentry>
8010 <varlistentry><term>Examples</term>
8011 <listitem><para>GAMMADIST(0.758;0.1;0.35;1) equals 0.995450</para></listitem>
8012 </varlistentry>
8013 <varlistentry><term>Examples</term>
8014 <listitem><para>GAMMADIST(0.758;0.1;0.35;0) equals 0.017179</para></listitem>
8015 </varlistentry>
8016 </variablelist>
8017 </sect3>
8018
8019 <sect3 id="GAMMAINV">
8020 <title>GAMMAINV</title>
8021 <para>The GAMMAINV() function returns the unique number x >= 0 such that GAMMAINV(x;alpha;beta;TRUE()) = p.</para>
8022 <para><segmentedlist><segtitle>Return type</segtitle>
8023 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8024 <variablelist>
8025 <varlistentry><term>Syntax</term>
8026 <listitem><para>GAMMAINV(number;alpha;beta)</para></listitem>
8027 </varlistentry>
8028 <varlistentry><term>Parameters</term>
8029 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8030 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8031 <seglistitem><seg>Alpha parameter</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8032 <seglistitem><seg>Beta parameter</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8033 </varlistentry>
8034 <varlistentry><term>Examples</term>
8035 <listitem><para>GAMMADIST(GAMMAINV(0.1;3;4);3;4) equals 0.1</para></listitem>
8036 </varlistentry>
8037 <varlistentry><term>Examples</term>
8038 <listitem><para>GAMMADIST(GAMMAINV(0.3;3;4);3;4) equals 0.3</para></listitem>
8039 </varlistentry>
8040 </variablelist>
8041 </sect3>
8042
8043 <sect3 id="GAMMALN">
8044 <title>GAMMALN</title>
8045 <para>The GAMMALN() function returns the natural logarithm of the gamma function: G(x). The number parameter must be positive.</para>
8046 <para><segmentedlist><segtitle>Return type</segtitle>
8047 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8048 <variablelist>
8049 <varlistentry><term>Syntax</term>
8050 <listitem><para>GAMMALN(Number)</para></listitem>
8051 </varlistentry>
8052 <varlistentry><term>Parameters</term>
8053 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8054 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8055 </varlistentry>
8056 <varlistentry><term>Examples</term>
8057 <listitem><para>GAMMALN(2) returns 0</para></listitem>
8058 </varlistentry>
8059 </variablelist>
8060 </sect3>
8061
8062 <sect3 id="GAUSS">
8063 <title>GAUSS</title>
8064 <para>The GAUSS() function returns the integral values for the standard normal cumulative distribution.</para>
8065 <para><segmentedlist><segtitle>Return type</segtitle>
8066 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8067 <variablelist>
8068 <varlistentry><term>Syntax</term>
8069 <listitem><para>GAUSS(value)</para></listitem>
8070 </varlistentry>
8071 <varlistentry><term>Parameters</term>
8072 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8073 <seglistitem><seg>The number for which the integral value of standard normal distribution is to be calculated</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8074 </varlistentry>
8075 <varlistentry><term>Examples</term>
8076 <listitem><para>GAUSS(0.25) equals 0.098706</para></listitem>
8077 </varlistentry>
8078 </variablelist>
8079 </sect3>
8080
8081 <sect3 id="GEOMEAN">
8082 <title>GEOMEAN</title>
8083 <para>The GEOMEAN() function returns the geometric mean of the given arguments. This is equal to the Nth root of the product of the terms.</para>
8084 <para><segmentedlist><segtitle>Return type</segtitle>
8085 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8086 <variablelist>
8087 <varlistentry><term>Syntax</term>
8088 <listitem><para>GEOMEAN(value; value;...)</para></listitem>
8089 </varlistentry>
8090 <varlistentry><term>Parameters</term>
8091 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8092 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8093 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8094 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8095 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8096 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8097 </varlistentry>
8098 <varlistentry><term>Examples</term>
8099 <listitem><para>GEOMEAN(A1:A5)</para></listitem>
8100 </varlistentry>
8101 <varlistentry><term>Examples</term>
8102 <listitem><para>GEOMEAN(21; 33; 54; 23) returns 30.45886</para></listitem>
8103 </varlistentry>
8104 <varlistentry><term>Related Functions</term>
8105 <listitem><simplelist>
8106 <member><link linkend="HARMEAN">HARMEAN</link> </member>
8107 </simplelist></listitem>
8108 </varlistentry>
8109 </variablelist>
8110 </sect3>
8111
8112 <sect3 id="HARMEAN">
8113 <title>HARMEAN</title>
8114 <para>The HARMEAN() function returns the harmonic mean of the N data points (N divided by the sum of the inverses of the data points).</para>
8115 <para><segmentedlist><segtitle>Return type</segtitle>
8116 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8117 <variablelist>
8118 <varlistentry><term>Syntax</term>
8119 <listitem><para>HARMEAN(value; value;...)</para></listitem>
8120 </varlistentry>
8121 <varlistentry><term>Parameters</term>
8122 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8123 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8124 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8125 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8126 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8127 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8128 </varlistentry>
8129 <varlistentry><term>Examples</term>
8130 <listitem><para>HARMEAN(A1:A5)</para></listitem>
8131 </varlistentry>
8132 <varlistentry><term>Examples</term>
8133 <listitem><para>HARMEAN(21; 33; 54; 23) returns 28.588</para></listitem>
8134 </varlistentry>
8135 <varlistentry><term>Related Functions</term>
8136 <listitem><simplelist>
8137 <member><link linkend="GEOMEAN">GEOMEAN</link> </member>
8138 </simplelist></listitem>
8139 </varlistentry>
8140 </variablelist>
8141 </sect3>
8142
8143 <sect3 id="HYPGEOMDIST">
8144 <title>HYPGEOMDIST</title>
8145 <para>The HYPGEOMDIST() function returns the hypergeometric distribution.</para>
8146 <para><segmentedlist><segtitle>Return type</segtitle>
8147 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8148 <variablelist>
8149 <varlistentry><term>Syntax</term>
8150 <listitem><para>HYPGEOMDIST(x; n; M; N)</para></listitem>
8151 </varlistentry>
8152 <varlistentry><term>Parameters</term>
8153 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8154 <seglistitem><seg>Number of success in the sample</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
8155 <seglistitem><seg>Number of trials</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
8156 <seglistitem><seg>Number of success overall</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
8157 <seglistitem><seg>Population size</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
8158 </varlistentry>
8159 <varlistentry><term>Examples</term>
8160 <listitem><para>HYPGEOMDIST(2; 5; 6; 20) returns 0.3522</para></listitem>
8161 </varlistentry>
8162 </variablelist>
8163 </sect3>
8164
8165 <sect3 id="INTERCEPT">
8166 <title>INTERCEPT</title>
8167 <para>The INTERCEPT() function calculates the interception of the linear regression line with the y axis.</para>
8168 <para><segmentedlist><segtitle>Return type</segtitle>
8169 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8170 <variablelist>
8171 <varlistentry><term>Syntax</term>
8172 <listitem><para>INTERCEPT(y;x)</para></listitem>
8173 </varlistentry>
8174 <varlistentry><term>Parameters</term>
8175 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8176 <seglistitem><seg>y values (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8177 <seglistitem><seg>x values (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8178 </varlistentry>
8179 </variablelist>
8180 </sect3>
8181
8182 <sect3 id="INVBINO">
8183 <title>INVBINO</title>
8184 <para>The INVBINO() function returns the negative binomial distribution. The first parameter is the number of trials, the second parameter is the number of failures, and the third is the probability of failure. The number of trials should be larger than the number of failures and the probability should be smaller or equal to 1.</para>
8185 <para><segmentedlist><segtitle>Return type</segtitle>
8186 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8187 <variablelist>
8188 <varlistentry><term>Syntax</term>
8189 <listitem><para>INVBINO(trials;failure;prob_of_failure)</para></listitem>
8190 </varlistentry>
8191 <varlistentry><term>Parameters</term>
8192 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8193 <seglistitem><seg>Number of trials</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
8194 <seglistitem><seg>Number of failures</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
8195 <seglistitem><seg>Probability of failure</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8196 </varlistentry>
8197 <varlistentry><term>Examples</term>
8198 <listitem><para>INVBINO(12;3;0.2) returns 0.236223201</para></listitem>
8199 </varlistentry>
8200 </variablelist>
8201 </sect3>
8202
8203 <sect3 id="KURT">
8204 <title>KURT</title>
8205 <para>The KURT() function calculates an unbiased estimate of the kurtosis of a data set. You have to provide at least 4 values, otherwise an error is returned.</para>
8206 <para><segmentedlist><segtitle>Return type</segtitle>
8207 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8208 <variablelist>
8209 <varlistentry><term>Syntax</term>
8210 <listitem><para>KURT(value; value;...)</para></listitem>
8211 </varlistentry>
8212 <varlistentry><term>Parameters</term>
8213 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8214 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8215 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8216 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8217 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8218 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8219 </varlistentry>
8220 <varlistentry><term>Examples</term>
8221 <listitem><para>KURT(A1:A5)</para></listitem>
8222 </varlistentry>
8223 <varlistentry><term>Examples</term>
8224 <listitem><para>KURT(21; 33; 54; 23) returns 1.344239</para></listitem>
8225 </varlistentry>
8226 <varlistentry><term>Related Functions</term>
8227 <listitem><simplelist>
8228 <member><link linkend="KURTP">KURTP</link> </member>
8229 </simplelist></listitem>
8230 </varlistentry>
8231 </variablelist>
8232 </sect3>
8233
8234 <sect3 id="KURTP">
8235 <title>KURTP</title>
8236 <para>The KURTP() function calculates an population kurtosis of a data set. You have to provide at least 4 values, otherwise an error is returned.</para>
8237 <para><segmentedlist><segtitle>Return type</segtitle>
8238 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8239 <variablelist>
8240 <varlistentry><term>Syntax</term>
8241 <listitem><para>KURTP(value; value;...)</para></listitem>
8242 </varlistentry>
8243 <varlistentry><term>Parameters</term>
8244 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8245 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8246 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8247 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8248 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem>
8249 <seglistitem><seg>Floating point values</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8250 </varlistentry>
8251 <varlistentry><term>Examples</term>
8252 <listitem><para>KURTP(A1:A5)</para></listitem>
8253 </varlistentry>
8254 <varlistentry><term>Examples</term>
8255 <listitem><para>KURTP(21; 33; 54; 23) returns -1.021</para></listitem>
8256 </varlistentry>
8257 <varlistentry><term>Related Functions</term>
8258 <listitem><simplelist>
8259 <member><link linkend="KURT">KURT</link> </member>
8260 </simplelist></listitem>
8261 </varlistentry>
8262 </variablelist>
8263 </sect3>
8264
8265 <sect3 id="LARGE">
8266 <title>LARGE</title>
8267 <para>The LARGE() function returns the k-th largest value from the data set.</para>
8268 <para><segmentedlist><segtitle>Return type</segtitle>
8269 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8270 <variablelist>
8271 <varlistentry><term>Syntax</term>
8272 <listitem><para>LARGE(range; k)</para></listitem>
8273 </varlistentry>
8274 <varlistentry><term>Parameters</term>
8275 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8276 <seglistitem><seg>Cell range of values</seg><seg>Double</seg></seglistitem>
8277 <seglistitem><seg>Position (from the largest)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
8278 </varlistentry>
8279 <varlistentry><term>Examples</term>
8280 <listitem><para>A1: 3, A2: 1, A3: 5 => LARGE(A1:A3; 2) returns 3</para></listitem>
8281 </varlistentry>
8282 </variablelist>
8283 </sect3>
8284
8285 <sect3 id="LEGACYFDIST">
8286 <title>LEGACYFDIST</title>
8287 <para>The LEGACYFDIST() function returns the f-distribution.</para>
8288 <para><segmentedlist><segtitle>Return type</segtitle>
8289 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8290 <variablelist>
8291 <varlistentry><term>Syntax</term>
8292 <listitem><para>LEGACYFDIST(number;degrees_freedom_1;degrees_freedom_2)</para></listitem>
8293 </varlistentry>
8294 <varlistentry><term>Parameters</term>
8295 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8296 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8297 <seglistitem><seg>Degrees of freedom 1</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
8298 <seglistitem><seg>Degrees of freedom 2</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
8299 </varlistentry>
8300 <varlistentry><term>Examples</term>
8301 <listitem><para>LEGACYFDIST(0.8;8;12) yields 0.61</para></listitem>
8302 </varlistentry>
8303 </variablelist>
8304 </sect3>
8305
8306 <sect3 id="LOGINV">
8307 <title>LOGINV</title>
8308 <para>The LOGINV() function returns the inverse of the lognormal cumulative distribution.</para>
8309 <para><segmentedlist><segtitle>Return type</segtitle>
8310 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8311 <variablelist>
8312 <varlistentry><term>Syntax</term>
8313 <listitem><para>LOGINV(p; mean; stdev)</para></listitem>
8314 </varlistentry>
8315 <varlistentry><term>Parameters</term>
8316 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8317 <seglistitem><seg>Probability</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8318 <seglistitem><seg>Mean value of the standard logarithmic distribution</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8319 <seglistitem><seg>Standard deviation of the standard logarithmic distribution</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8320 </varlistentry>
8321 <varlistentry><term>Examples</term>
8322 <listitem><para>LOGINV(0.1;0;1) equals 0.2776</para></listitem>
8323 </varlistentry>
8324 </variablelist>
8325 </sect3>
8326
8327 <sect3 id="LOGNORMDIST">
8328 <title>LOGNORMDIST</title>
8329 <para>The LOGNORMDIST() function returns the cumulative lognormal distribution.</para>
8330 <para><segmentedlist><segtitle>Return type</segtitle>
8331 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8332 <variablelist>
8333 <varlistentry><term>Syntax</term>
8334 <listitem><para>LOGNORMDIST(Number;MV;STD)</para></listitem>
8335 </varlistentry>
8336 <varlistentry><term>Parameters</term>
8337 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8338 <seglistitem><seg>Probability value for which the standard logarithmic distribution is to be calculated</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8339 <seglistitem><seg>Mean value of the standard logarithmic distribution</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8340 <seglistitem><seg>Standard deviation of the standard logarithmic distribution</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8341 </varlistentry>
8342 <varlistentry><term>Examples</term>
8343 <listitem><para>LOGNORMDIST(0.1;0;1) equals 0.01</para></listitem>
8344 </varlistentry>
8345 </variablelist>
8346 </sect3>
8347
8348 <sect3 id="MEDIAN">
8349 <title>MEDIAN</title>
8350 <para>The MEDIAN() function calculates the median of all the values given as parameters. You can calculate the median of a range like MEDIAN(A1:B5) or a list of values like MEDIAN(12; 5; 12.5). Blank cells will be considered as a zero, and cells with text will be ignored.</para>
8351 <para><segmentedlist><segtitle>Return type</segtitle>
8352 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8353 <variablelist>
8354 <varlistentry><term>Syntax</term>
8355 <listitem><para>MEDIAN(value;value;...)</para></listitem>
8356 </varlistentry>
8357 <varlistentry><term>Parameters</term>
8358 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8359 <seglistitem><seg>Floating point value or range of values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8360 <seglistitem><seg>Floating point values or range of values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8361 <seglistitem><seg>Floating point values or range of values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8362 <seglistitem><seg>Floating point values or range of values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8363 <seglistitem><seg>Floating point values or range of values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8364 </varlistentry>
8365 <varlistentry><term>Examples</term>
8366 <listitem><para>MEDIAN(12; 5; 5.5) equals 5.5</para></listitem>
8367 </varlistentry>
8368 <varlistentry><term>Examples</term>
8369 <listitem><para>MEDIAN(12; 7; 8;2) equals 7.5</para></listitem>
8370 </varlistentry>
8371 </variablelist>
8372 </sect3>
8373
8374 <sect3 id="MODE">
8375 <title>MODE</title>
8376 <para>The MODE() function returns the most frequently occurring value in the data set.</para>
8377 <para><segmentedlist><segtitle>Return type</segtitle>
8378 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8379 <variablelist>
8380 <varlistentry><term>Syntax</term>
8381 <listitem><para>MODE(number; number2; ...)</para></listitem>
8382 </varlistentry>
8383 <varlistentry><term>Parameters</term>
8384 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8385 <seglistitem><seg>Float</seg><seg>Double</seg></seglistitem>
8386 <seglistitem><seg>Float</seg><seg>Double</seg></seglistitem>
8387 <seglistitem><seg>Float</seg><seg>Double</seg></seglistitem>
8388 <seglistitem><seg>Float</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8389 </varlistentry>
8390 <varlistentry><term>Examples</term>
8391 <listitem><para>MODE(12; 14; 12; 15) returns 12</para></listitem>
8392 </varlistentry>
8393 </variablelist>
8394 </sect3>
8395
8396 <sect3 id="NEGBINOMDIST">
8397 <title>NEGBINOMDIST</title>
8398 <para>The NEGBINOMDIST() function returns the negative binomial distribution.</para>
8399 <para><segmentedlist><segtitle>Return type</segtitle>
8400 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8401 <variablelist>
8402 <varlistentry><term>Syntax</term>
8403 <listitem><para>NEGBINOMDIST(failures; success; prob_of_success)</para></listitem>
8404 </varlistentry>
8405 <varlistentry><term>Parameters</term>
8406 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8407 <seglistitem><seg>Number of failures</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
8408 <seglistitem><seg>Number of successful trials</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
8409 <seglistitem><seg>Probability of success</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8410 </varlistentry>
8411 <varlistentry><term>Examples</term>
8412 <listitem><para>NEGBINOMDIST(2;5;0.55) returns 0.152872629</para></listitem>
8413 </varlistentry>
8414 </variablelist>
8415 </sect3>
8416
8417 <sect3 id="NORMDIST">
8418 <title>NORMDIST</title>
8419
8420 <para>The NORMDIST() function returns the normal cumulative distribution.</para>
8421 <para>Number is the value of the distribution based on which the normal distribution is to be calculated.</para>
8422 <para>MV is the linear middle of the distribution.</para>
8423 <para>STD is the standard deviation of the distribution.</para>
8424 <para>K = 0 calculates the density function; K = 1 calculates the distribution.</para>
8425 <para><segmentedlist><segtitle>Return type</segtitle>
8426 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8427 <variablelist>
8428 <varlistentry><term>Syntax</term>
8429 <listitem><para>NORMDIST(Number;MV;STD;K)</para></listitem>
8430 </varlistentry>
8431 <varlistentry><term>Parameters</term>
8432 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8433 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8434 <seglistitem><seg>Linear middle of the distribution</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8435 <seglistitem><seg>Standard deviation of the distribution</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8436 <seglistitem><seg>0 = density, 1 = distribution</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
8437 </varlistentry>
8438 <varlistentry><term>Examples</term>
8439 <listitem><para>NORMDIST(0.859;0.6;0.258;0) equals 0.934236</para></listitem>
8440 </varlistentry>
8441 <varlistentry><term>Examples</term>
8442 <listitem><para>NORMDIST(0.859;0.6;0.258;1) equals 0.842281</para></listitem>
8443 </varlistentry>
8444 </variablelist>
8445 </sect3>
8446
8447 <sect3 id="NORMINV">
8448 <title>NORMINV</title>
8449 <para>The NORMINV() function returns the inverse of the normal cumulative distribution. The number must be between 0 and 1 (non-inclusive) and STD must be positive.</para>
8450 <para><segmentedlist><segtitle>Return type</segtitle>
8451 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8452 <variablelist>
8453 <varlistentry><term>Syntax</term>
8454 <listitem><para>NORMINV(number;MV;STD)</para></listitem>
8455 </varlistentry>
8456 <varlistentry><term>Parameters</term>
8457 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8458 <seglistitem><seg>Probability value for which the standard logarithmic distribution is to be calculated</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8459 <seglistitem><seg>Middle value in the normal distribution</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8460 <seglistitem><seg>Standard deviation of the normal distribution</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8461 </varlistentry>
8462 <varlistentry><term>Examples</term>
8463 <listitem><para>NORMINV(0.9;63;5) equals 69.41</para></listitem>
8464 </varlistentry>
8465 </variablelist>
8466 </sect3>
8467
8468 <sect3 id="NORMSDIST">
8469 <title>NORMSDIST</title>
8470 <para>The NORMSDIST() function returns the standard normal distribution.</para>
8471 <para><segmentedlist><segtitle>Return type</segtitle>
8472 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8473 <variablelist>
8474 <varlistentry><term>Syntax</term>
8475 <listitem><para>NORMSDIST(Number)</para></listitem>
8476 </varlistentry>
8477 <varlistentry><term>Parameters</term>
8478 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8479 <seglistitem><seg>Value to which the standard normal distribution is calculated</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8480 </varlistentry>
8481 <varlistentry><term>Examples</term>
8482 <listitem><para>NORMSDIST(1) equals 0.84</para></listitem>
8483 </varlistentry>
8484 </variablelist>
8485 </sect3>
8486
8487 <sect3 id="NORMSINV">
8488 <title>NORMSINV</title>
8489 <para>The NORMSINV() function returns the inverse of the standard normal cumulative distribution. The number must be between 0 and 1 (non-inclusive).</para>
8490 <para><segmentedlist><segtitle>Return type</segtitle>
8491 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8492 <variablelist>
8493 <varlistentry><term>Syntax</term>
8494 <listitem><para>NORMSINV(Number)</para></listitem>
8495 </varlistentry>
8496 <varlistentry><term>Parameters</term>
8497 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8498 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8499 </varlistentry>
8500 <varlistentry><term>Examples</term>
8501 <listitem><para>NORMSINV(0.908789) returns 1.3333</para></listitem>
8502 </varlistentry>
8503 </variablelist>
8504 </sect3>
8505
8506 <sect3 id="PEARSON">
8507 <title>PEARSON</title>
8508 <para>The PEARSON() function calculates the correlation coefficient of two cell ranges. It is the same as the CORREL function.</para>
8509 <para><segmentedlist><segtitle>Return type</segtitle>
8510 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8511 <variablelist>
8512 <varlistentry><term>Syntax</term>
8513 <listitem><para>PEARSON(range1; range2)</para></listitem>
8514 </varlistentry>
8515 <varlistentry><term>Parameters</term>
8516 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8517 <seglistitem><seg>Cell range of values</seg><seg>Double</seg></seglistitem>
8518 <seglistitem><seg>Second cell range of values</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8519 </varlistentry>
8520 <varlistentry><term>Examples</term>
8521 <listitem><para>PEARSON(A1:A3; B1:B3)</para></listitem>
8522 </varlistentry>
8523 <varlistentry><term>Related Functions</term>
8524 <listitem><simplelist>
8525 <member><link linkend="CORREL">CORREL</link> </member>
8526 </simplelist></listitem>
8527 </varlistentry>
8528 </variablelist>
8529 </sect3>
8530
8531 <sect3 id="PERCENTILE">
8532 <title>PERCENTILE</title>
8533 <para>The PERCENTILE() function returns the x-th sample percentile of data values in Data. A percentile returns the scale value for a data series which goes from the smallest (alpha=0) to the largest value (alpha=1) of a data series. For alpha = 25%, the percentile means the first quartile; alpha = 50% is the MEDIAN. Blank cells will be considered as a zero, and cells with text will be ignored.</para>
8534 <para><segmentedlist><segtitle>Return type</segtitle>
8535 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8536 <variablelist>
8537 <varlistentry><term>Syntax</term>
8538 <listitem><para>PERCENTILE(data;alpha)</para></listitem>
8539 </varlistentry>
8540 <varlistentry><term>Parameters</term>
8541 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8542 <seglistitem><seg>Range of values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8543 <seglistitem><seg>The percentile value between 0 and 1, inclusive.</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8544 </varlistentry>
8545 <varlistentry><term>Related Functions</term>
8546 <listitem><simplelist>
8547 <member><link linkend="MEDIAN">MEDIAN</link> </member>
8548 </simplelist></listitem>
8549 </varlistentry>
8550 </variablelist>
8551 </sect3>
8552
8553 <sect3 id="PERMUT">
8554 <title>PERMUT</title>
8555 <para>The PERMUT() function returns the number of permutations. The first parameter is the number of elements, and the second parameter is the number of elements used in the permutation.</para>
8556 <para><segmentedlist><segtitle>Return type</segtitle>
8557 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
8558 <variablelist>
8559 <varlistentry><term>Syntax</term>
8560 <listitem><para>PERMUT(total;permutated)</para></listitem>
8561 </varlistentry>
8562 <varlistentry><term>Parameters</term>
8563 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8564 <seglistitem><seg>Total number of elements</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
8565 <seglistitem><seg>Number of elements to permutate</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
8566 </varlistentry>
8567 <varlistentry><term>Examples</term>
8568 <listitem><para>PERMUT(8;5) equals 6720</para></listitem>
8569 </varlistentry>
8570 <varlistentry><term>Examples</term>
8571 <listitem><para>PERMUT(1;1) equals 1</para></listitem>
8572 </varlistentry>
8573 </variablelist>
8574 </sect3>
8575
8576 <sect3 id="PERMUTATIONA">
8577 <title>PERMUTATIONA</title>
8578 <para>The PERMUTATIONA() function returns the number of ordered permutations when allowing repetition. The first parameter is the number of elements, and the second parameter is the number of elements to choose. Both parameters must be positive.</para>
8579 <para><segmentedlist><segtitle>Return type</segtitle>
8580 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
8581 <variablelist>
8582 <varlistentry><term>Syntax</term>
8583 <listitem><para>PERMUTATIONA(total;chosen)</para></listitem>
8584 </varlistentry>
8585 <varlistentry><term>Parameters</term>
8586 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8587 <seglistitem><seg>Total number of elements</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
8588 <seglistitem><seg>Number of elements to choose</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
8589 </varlistentry>
8590 <varlistentry><term>Examples</term>
8591 <listitem><para>PERMUTATIONA(2,3) returns 8</para></listitem>
8592 </varlistentry>
8593 <varlistentry><term>Examples</term>
8594 <listitem><para>PERMUTATIONA(0,0) returns 1</para></listitem>
8595 </varlistentry>
8596 </variablelist>
8597 </sect3>
8598
8599 <sect3 id="PHI">
8600 <title>PHI</title>
8601 <para>The PHI() function returns value of the distribution function for a standard normal distribution.</para>
8602 <para><segmentedlist><segtitle>Return type</segtitle>
8603 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8604 <variablelist>
8605 <varlistentry><term>Syntax</term>
8606 <listitem><para>PHI(value)</para></listitem>
8607 </varlistentry>
8608 <varlistentry><term>Parameters</term>
8609 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8610 <seglistitem><seg>The number for which the standard normal distribution is to be calculated</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8611 </varlistentry>
8612 <varlistentry><term>Examples</term>
8613 <listitem><para>PHI(0.25) equals 0.386668</para></listitem>
8614 </varlistentry>
8615 </variablelist>
8616 </sect3>
8617
8618 <sect3 id="POISSON">
8619 <title>POISSON</title>
8620 <para>The POISSON() function returns the Poisson distribution.</para>
8621 <para>The lambda and number parameters must be positive.</para>
8622 <para>Cumulative = 0 calculates the density function; cumulative = 1 calculates the distribution.</para>
8623 <para><segmentedlist><segtitle>Return type</segtitle>
8624 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8625 <variablelist>
8626 <varlistentry><term>Syntax</term>
8627 <listitem><para>POISSON(number;lambda;cumulative)</para></listitem>
8628 </varlistentry>
8629 <varlistentry><term>Parameters</term>
8630 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8631 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8632 <seglistitem><seg>Lambda parameter (the middle value)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8633 <seglistitem><seg>0 = density, 1 = distribution</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
8634 </varlistentry>
8635 <varlistentry><term>Examples</term>
8636 <listitem><para>POISSON(60;50;0) equals 0.020105</para></listitem>
8637 </varlistentry>
8638 <varlistentry><term>Examples</term>
8639 <listitem><para>POISSON(60;50;1) equals 0.927840</para></listitem>
8640 </varlistentry>
8641 </variablelist>
8642 </sect3>
8643
8644 <sect3 id="RANK">
8645 <title>RANK</title>
8646 <para>The RANK() function returns the rank of a number in a list of numbers.</para>
8647 <para>Order specifies how to rank the numbers:</para>
8648 <para>If 0 or omitted, Data is ranked in descending order.</para>
8649 <para>If not 0, Data is ranked in ascending order.</para>
8650 <para><segmentedlist><segtitle>Return type</segtitle>
8651 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8652 <variablelist>
8653 <varlistentry><term>Syntax</term>
8654 <listitem><para>RSQ(Value; Data; Order)</para></listitem>
8655 </varlistentry>
8656 <varlistentry><term>Parameters</term>
8657 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8658 <seglistitem><seg>Value</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8659 <seglistitem><seg>Data (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8660 <seglistitem><seg>Order</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8661 </varlistentry>
8662 <varlistentry><term>Examples</term>
8663 <listitem><para>RANK (2;{1;2;3}) equals 2</para></listitem>
8664 </varlistentry>
8665 </variablelist>
8666 </sect3>
8667
8668 <sect3 id="RSQ">
8669 <title>RSQ</title>
8670 <para>The RSQ() function returns the square of the Pearson product moment correlation coefficient through data points in known_y's and known_x's.</para>
8671 <para>If "arrayY" and "arrayX" are empty or have a different number of data points, then #N/A is returned.</para>
8672 <para><segmentedlist><segtitle>Return type</segtitle>
8673 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8674 <variablelist>
8675 <varlistentry><term>Syntax</term>
8676 <listitem><para>RSQ(known Y; known X)</para></listitem>
8677 </varlistentry>
8678 <varlistentry><term>Parameters</term>
8679 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8680 <seglistitem><seg>known Y (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8681 <seglistitem><seg>known X (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8682 </varlistentry>
8683 </variablelist>
8684 </sect3>
8685
8686 <sect3 id="SKEW">
8687 <title>SKEW</title>
8688 <para>The SKEW() function returns an estimate for skewness of a distribution</para>
8689 <para><segmentedlist><segtitle>Return type</segtitle>
8690 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8691 <variablelist>
8692 <varlistentry><term>Syntax</term>
8693 <listitem><para>SKEW(number; number2; ...)</para></listitem>
8694 </varlistentry>
8695 <varlistentry><term>Parameters</term>
8696 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8697 <seglistitem><seg>Float</seg><seg>Double</seg></seglistitem>
8698 <seglistitem><seg>Float</seg><seg>Double</seg></seglistitem>
8699 <seglistitem><seg>Float</seg><seg>Double</seg></seglistitem>
8700 <seglistitem><seg>Float</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8701 </varlistentry>
8702 <varlistentry><term>Examples</term>
8703 <listitem><para>SKEW(11.4; 17.3; 21.3; 25.9; 40.1) returns 0.9768</para></listitem>
8704 </varlistentry>
8705 <varlistentry><term>Related Functions</term>
8706 <listitem><simplelist>
8707 <member><link linkend="SKEWP">SKEWP</link> </member>
8708 </simplelist></listitem>
8709 </varlistentry>
8710 </variablelist>
8711 </sect3>
8712
8713 <sect3 id="SKEWP">
8714 <title>SKEWP</title>
8715 <para>The SKEWP() function returns the population skewness of a distribution</para>
8716 <para><segmentedlist><segtitle>Return type</segtitle>
8717 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8718 <variablelist>
8719 <varlistentry><term>Syntax</term>
8720 <listitem><para>SKEWP(number; number2; ...)</para></listitem>
8721 </varlistentry>
8722 <varlistentry><term>Parameters</term>
8723 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8724 <seglistitem><seg>Float</seg><seg>Double</seg></seglistitem>
8725 <seglistitem><seg>Float</seg><seg>Double</seg></seglistitem>
8726 <seglistitem><seg>Float</seg><seg>Double</seg></seglistitem>
8727 <seglistitem><seg>Float</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8728 </varlistentry>
8729 <varlistentry><term>Examples</term>
8730 <listitem><para>SKEWP(11.4; 17.3; 21.3; 25.9; 40.1) returns 0.6552</para></listitem>
8731 </varlistentry>
8732 <varlistentry><term>Related Functions</term>
8733 <listitem><simplelist>
8734 <member><link linkend="SKEW">SKEW</link> </member>
8735 </simplelist></listitem>
8736 </varlistentry>
8737 </variablelist>
8738 </sect3>
8739
8740 <sect3 id="SLOPE">
8741 <title>SLOPE</title>
8742 <para>The SLOPE() function calculates the slope of the linear regression line.</para>
8743 <para><segmentedlist><segtitle>Return type</segtitle>
8744 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8745 <variablelist>
8746 <varlistentry><term>Syntax</term>
8747 <listitem><para>SLOPE(y;x)</para></listitem>
8748 </varlistentry>
8749 <varlistentry><term>Parameters</term>
8750 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8751 <seglistitem><seg>y values (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8752 <seglistitem><seg>x values (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8753 </varlistentry>
8754 </variablelist>
8755 </sect3>
8756
8757 <sect3 id="SMALL">
8758 <title>SMALL</title>
8759 <para>The SMALL() function returns the k-th smallest value from the data set.</para>
8760 <para><segmentedlist><segtitle>Return type</segtitle>
8761 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8762 <variablelist>
8763 <varlistentry><term>Syntax</term>
8764 <listitem><para>SMALL(range; k)</para></listitem>
8765 </varlistentry>
8766 <varlistentry><term>Parameters</term>
8767 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8768 <seglistitem><seg>Cell range of values</seg><seg>Double</seg></seglistitem>
8769 <seglistitem><seg>Position (from the smallest)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
8770 </varlistentry>
8771 <varlistentry><term>Examples</term>
8772 <listitem><para>A1: 3, A2: 1, A3: 5 => SMALL(A1:A3; 1) returns 1</para></listitem>
8773 </varlistentry>
8774 </variablelist>
8775 </sect3>
8776
8777 <sect3 id="STANDARDIZE">
8778 <title>STANDARDIZE</title>
8779 <para>The STANDARDIZE() function calculates a normalized value.</para>
8780 <para><segmentedlist><segtitle>Return type</segtitle>
8781 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8782 <variablelist>
8783 <varlistentry><term>Syntax</term>
8784 <listitem><para>STANDARDIZE(x; mean, stdev)</para></listitem>
8785 </varlistentry>
8786 <varlistentry><term>Parameters</term>
8787 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8788 <seglistitem><seg>Number to be normalized</seg><seg>Double</seg></seglistitem>
8789 <seglistitem><seg>Mean of the distribution</seg><seg>Double</seg></seglistitem>
8790 <seglistitem><seg>Standard deviation</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8791 </varlistentry>
8792 <varlistentry><term>Examples</term>
8793 <listitem><para>STANDARDIZE(4; 3; 7) returns 0.1429</para></listitem>
8794 </varlistentry>
8795 </variablelist>
8796 </sect3>
8797
8798 <sect3 id="STDEV">
8799 <title>STDEV</title>
8800 <para>The STDEV() function returns the estimate standard deviation based on a sample. The standard deviation is a measure of how widely values are dispersed from the average value.</para>
8801 <para><segmentedlist><segtitle>Return type</segtitle>
8802 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8803 <variablelist>
8804 <varlistentry><term>Syntax</term>
8805 <listitem><para>STDEV(value;value;...)</para></listitem>
8806 </varlistentry>
8807 <varlistentry><term>Parameters</term>
8808 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8809 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8810 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8811 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8812 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8813 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8814 </varlistentry>
8815 <varlistentry><term>Examples</term>
8816 <listitem><para>STDEV(6;7;8) equals 1</para></listitem>
8817 </varlistentry>
8818 <varlistentry><term>Related Functions</term>
8819 <listitem><simplelist>
8820 <member><link linkend="STDEVP">STDEVP</link> </member>
8821 </simplelist></listitem>
8822 </varlistentry>
8823 </variablelist>
8824 </sect3>
8825
8826 <sect3 id="STDEVA">
8827 <title>STDEVA</title>
8828 <para>The STDEVA() function returns the estimate standard deviation based on a sample. The standard deviation is a measure of how widely values are dispersed from the average value. If a referenced cell contains text or contains the boolean value FALSE, it is counted as 0. If the boolean value is TRUE it is counted as 1.</para>
8829 <para><segmentedlist><segtitle>Return type</segtitle>
8830 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8831 <variablelist>
8832 <varlistentry><term>Syntax</term>
8833 <listitem><para>STDEVA(value;value;...)</para></listitem>
8834 </varlistentry>
8835 <varlistentry><term>Parameters</term>
8836 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8837 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8838 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8839 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8840 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8841 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8842 </varlistentry>
8843 <varlistentry><term>Examples</term>
8844 <listitem><para>STDEVA(6; 7; A1; 8) equals 1, if A1 is empty</para></listitem>
8845 </varlistentry>
8846 <varlistentry><term>Examples</term>
8847 <listitem><para>STDEVA(6; 7; A1; 8) equals 3.109, if A1 is TRUE</para></listitem>
8848 </varlistentry>
8849 <varlistentry><term>Related Functions</term>
8850 <listitem><simplelist>
8851 <member><link linkend="STDEV">STDEV</link> </member>
8852 <member><link linkend="STDEVP">STDEVP</link> </member>
8853 </simplelist></listitem>
8854 </varlistentry>
8855 </variablelist>
8856 </sect3>
8857
8858 <sect3 id="STDEVP">
8859 <title>STDEVP</title>
8860 <para>The STDEVP() function returns the standard deviation based on an entire population</para>
8861 <para><segmentedlist><segtitle>Return type</segtitle>
8862 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8863 <variablelist>
8864 <varlistentry><term>Syntax</term>
8865 <listitem><para>STDEVP(value;value;...)</para></listitem>
8866 </varlistentry>
8867 <varlistentry><term>Parameters</term>
8868 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8869 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8870 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8871 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8872 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8873 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8874 </varlistentry>
8875 <varlistentry><term>Examples</term>
8876 <listitem><para>STDEVP(6;7;8) equals 0.816497...</para></listitem>
8877 </varlistentry>
8878 <varlistentry><term>Related Functions</term>
8879 <listitem><simplelist>
8880 <member><link linkend="STDEV">STDEV</link> </member>
8881 </simplelist></listitem>
8882 </varlistentry>
8883 </variablelist>
8884 </sect3>
8885
8886 <sect3 id="STDEVPA">
8887 <title>STDEVPA</title>
8888 <para>The STDEVPA() function returns standard deviation based on an entire population. If a referenced cell contains text or contains the boolean value FALSE, it is counted as 0. If the boolean value is TRUE it is counted as 1.</para>
8889 <para><segmentedlist><segtitle>Return type</segtitle>
8890 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8891 <variablelist>
8892 <varlistentry><term>Syntax</term>
8893 <listitem><para>STDEVPA(value;value;...)</para></listitem>
8894 </varlistentry>
8895 <varlistentry><term>Parameters</term>
8896 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8897 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8898 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8899 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8900 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
8901 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8902 </varlistentry>
8903 <varlistentry><term>Examples</term>
8904 <listitem><para>STDEVPA(6; 7; A1; 8) equals 0.816497..., if A1 is empty</para></listitem>
8905 </varlistentry>
8906 <varlistentry><term>Examples</term>
8907 <listitem><para>STDEVPA(6; 7; A1; 8) equals 2.69..., if A1 is TRUE</para></listitem>
8908 </varlistentry>
8909 <varlistentry><term>Examples</term>
8910 <listitem><para>STDEVPA(6; 7; A1; 8) equals 3.11..., if A1 is FALSE</para></listitem>
8911 </varlistentry>
8912
8913 <varlistentry><term>Related Functions</term>
8914 <listitem><simplelist>
8915 <member><link linkend="STDEV">STDEV</link> </member>
8916 <member><link linkend="STDEVP">STDEVP</link> </member>
8917 </simplelist></listitem>
8918 </varlistentry>
8919 </variablelist>
8920 </sect3>
8921
8922 <sect3 id="STEYX">
8923 <title>STEYX</title>
8924 <para>The STEYX() function calculates the standard error of the predicted y value for each x in the regression.</para>
8925 <para><segmentedlist><segtitle>Return type</segtitle>
8926 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8927 <variablelist>
8928 <varlistentry><term>Syntax</term>
8929 <listitem><para>SLOPE(y;x)</para></listitem>
8930 </varlistentry>
8931 <varlistentry><term>Parameters</term>
8932 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8933 <seglistitem><seg>y values (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
8934 <seglistitem><seg>x values (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
8935 </varlistentry>
8936 </variablelist>
8937 </sect3>
8938
8939 <sect3 id="SUM2XMY">
8940 <title>SUM2XMY</title>
8941 <para><segmentedlist><segtitle>Return type</segtitle>
8942 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8943 <variablelist>
8944 <varlistentry><term>Syntax</term>
8945 <listitem><para>SLOPE(y;x)</para></listitem>
8946 </varlistentry>
8947 <varlistentry><term>Parameters</term>
8948 <listitem><para></para></listitem>
8949 </varlistentry>
8950 </variablelist>
8951 </sect3>
8952
8953 <sect3 id="SUMPRODUCT">
8954 <title>SUMPRODUCT</title>
8955 <para>The SUMPRODUCT() function (SUM(X*Y)) returns the sum of the product of these values. The number of values in the two arrays should be equal. Otherwise this function returns Err.</para>
8956 <para><segmentedlist><segtitle>Return type</segtitle>
8957 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8958 <variablelist>
8959 <varlistentry><term>Syntax</term>
8960 <listitem><para>SUMPRODUCT(array1;array2)</para></listitem>
8961 </varlistentry>
8962 <varlistentry><term>Parameters</term>
8963 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8964 <seglistitem><seg>Value (array)</seg><seg>Double</seg></seglistitem>
8965 <seglistitem><seg>Value (array)</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8966 </varlistentry>
8967 <varlistentry><term>Examples</term>
8968 <listitem><para>SUMPRODUCT(A1:A2;B1:B2) with A1=2, A2=5, B1=3 and B2=5, returns 31</para></listitem>
8969 </varlistentry>
8970 </variablelist>
8971 </sect3>
8972
8973 <sect3 id="SUMX2MY2">
8974 <title>SUMX2MY2</title>
8975 <para>The SUMX2MY2() function (SUM(X^2-Y^2)) returns the difference of the squares of these values. The number of values in the two arrays should be equal. Otherwise this function returns Err.</para>
8976 <para><segmentedlist><segtitle>Return type</segtitle>
8977 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8978 <variablelist>
8979 <varlistentry><term>Syntax</term>
8980 <listitem><para>SUMX2MY2(array1;array2)</para></listitem>
8981 </varlistentry>
8982 <varlistentry><term>Parameters</term>
8983 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
8984 <seglistitem><seg>Value (array)</seg><seg>Double</seg></seglistitem>
8985 <seglistitem><seg>Value (array)</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
8986 </varlistentry>
8987 <varlistentry><term>Examples</term>
8988 <listitem><para>SUMX2MY2(A1:A2;B1:B2) with A1=2, A2=5, B1=3 and B2=5, returns -5</para></listitem>
8989 </varlistentry>
8990 </variablelist>
8991 </sect3>
8992
8993 <sect3 id="SUMX2PY2">
8994 <title>SUMX2PY2</title>
8995 <para>The SUMX2PY2() function (SUM(X^2+Y^2)) returns the sum of the squares of these values. The number of values in the two arrays should be equal. Otherwise this function returns Err.</para>
8996 <para><segmentedlist><segtitle>Return type</segtitle>
8997 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
8998 <variablelist>
8999 <varlistentry><term>Syntax</term>
9000 <listitem><para>SUMX2PY2(array1;array2)</para></listitem>
9001 </varlistentry>
9002 <varlistentry><term>Parameters</term>
9003 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9004 <seglistitem><seg>Value (array)</seg><seg>Double</seg></seglistitem>
9005 <seglistitem><seg>Value (array)</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
9006 </varlistentry>
9007 <varlistentry><term>Examples</term>
9008 <listitem><para>SUMX2PY2(A1:A2;B1:B2) with A1=2, A2=5, B1=3 and B2=5, returns 63</para></listitem>
9009 </varlistentry>
9010 </variablelist>
9011 </sect3>
9012
9013 <sect3 id="SUMXMY2">
9014 <title>SUMXMY2</title>
9015 <para>The SUMXMY2() function (SUM((X-Y)^2)) returns the square of the differences of these values. The number of values in the two arrays should be equal. Otherwise this function returns Err.</para>
9016 <para><segmentedlist><segtitle>Return type</segtitle>
9017 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
9018 <variablelist>
9019 <varlistentry><term>Syntax</term>
9020 <listitem><para>SUMXMY2(array1;array2)</para></listitem>
9021 </varlistentry>
9022 <varlistentry><term>Parameters</term>
9023 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9024 <seglistitem><seg>Value (array)</seg><seg>Double</seg></seglistitem>
9025 <seglistitem><seg>Value (array)</seg><seg>Double</seg></seglistitem></segmentedlist></para></listitem>
9026 </varlistentry>
9027 <varlistentry><term>Examples</term>
9028 <listitem><para>SUMXMY2(A1:A2;B1:B2) with A1=2, A2=5, B1=3 and B2=5, returns 1</para></listitem>
9029 </varlistentry>
9030 </variablelist>
9031 </sect3>
9032
9033 <sect3 id="TDIST">
9034 <title>TDIST</title>
9035 <para>The TDIST() function returns the t-distribution.</para>
9036 <para>Mode = 1 returns the one-tailed test, Mode = 2 returns the two-tailed test.</para>
9037 <para><segmentedlist><segtitle>Return type</segtitle>
9038 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
9039 <variablelist>
9040 <varlistentry><term>Syntax</term>
9041 <listitem><para>TDIST(number;degrees_freedom;mode)</para></listitem>
9042 </varlistentry>
9043 <varlistentry><term>Parameters</term>
9044 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9045 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
9046 <seglistitem><seg>Degrees of freedom for the t-distribution</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
9047 <seglistitem><seg>Mode (1 or 2)</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
9048 </varlistentry>
9049 <varlistentry><term>Examples</term>
9050 <listitem><para>TDIST(12;5;1) returns 0.000035</para></listitem>
9051 </varlistentry>
9052 </variablelist>
9053 </sect3>
9054
9055 <sect3 id="TREND">
9056 <title>TREND</title>
9057 <para>The TREND() function calculates a sequence of values based on a linear regression of known value pairs.</para>
9058 <para>Constraints: COUNT(knownY) = COUNT(knownX).</para>
9059 <para><segmentedlist><segtitle>Return type</segtitle>
9060 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
9061 <variablelist>
9062 <varlistentry><term>Syntax</term>
9063 <listitem><para>TREND(knownY[;knownX[;newX[;allowOffset = TRUE]]])</para></listitem>
9064 </varlistentry>
9065 <varlistentry><term>Parameters</term>
9066 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9067 <seglistitem><seg>KnownY</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
9068 <seglistitem><seg>KnownX</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
9069 <seglistitem><seg>NumberSequence newX</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
9070 <seglistitem><seg>allowOffset</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
9071 </varlistentry>
9072 </variablelist>
9073 </sect3>
9074
9075 <sect3 id="TRIMMEAN">
9076 <title>TRIMMEAN</title>
9077 <para>The TRIMMEAN() function calculates the mean of a data set's fraction.</para>
9078 <para><segmentedlist><segtitle>Return type</segtitle>
9079 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
9080 <variablelist>
9081 <varlistentry><term>Syntax</term>
9082 <listitem><para>TRIMMEAN(dataSet; cutOffFraction)</para></listitem>
9083 </varlistentry>
9084 <varlistentry><term>Parameters</term>
9085 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9086 <seglistitem><seg>dataSet</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
9087 <seglistitem><seg>cutOffFraction</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
9088 </varlistentry>
9089 </variablelist>
9090 </sect3>
9091
9092 <sect3 id="TTEST">
9093 <title>TTEST</title>
9094 <para>The TTEST() function calculates the probability of a t-test.</para>
9095 <para><segmentedlist><segtitle>Return type</segtitle>
9096 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
9097 <variablelist>
9098 <varlistentry><term>Syntax</term>
9099 <listitem><para>TTEST(x; y; type; mode)</para></listitem>
9100 </varlistentry>
9101 <varlistentry><term>Parameters</term>
9102 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9103 <seglistitem><seg>x (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
9104 <seglistitem><seg>y (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
9105 <seglistitem><seg>type</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
9106 <seglistitem><seg>mode</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
9107 </varlistentry>
9108 </variablelist>
9109 </sect3>
9110
9111 <sect3 id="VAR">
9112 <title>VAR</title>
9113 <para>The VAR() function calculates the estimates variance based on a sample.</para>
9114 <para><segmentedlist><segtitle>Return type</segtitle>
9115 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
9116 <variablelist>
9117 <varlistentry><term>Syntax</term>
9118 <listitem><para>VAR(value;value;...)</para></listitem>
9119 </varlistentry>
9120 <varlistentry><term>Parameters</term>
9121 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9122 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9123 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9124 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9125 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9126 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
9127 </varlistentry>
9128 <varlistentry><term>Examples</term>
9129 <listitem><para>VAR(12;5;7) equals 13</para></listitem>
9130 </varlistentry>
9131 <varlistentry><term>Examples</term>
9132 <listitem><para>VAR(15;80;3) equals 1716.333...</para></listitem>
9133 </varlistentry>
9134 <varlistentry><term>Examples</term>
9135 <listitem><para>VAR(6;7;8) equals 1</para></listitem>
9136 </varlistentry>
9137 <varlistentry><term>Related Functions</term>
9138 <listitem><simplelist>
9139 <member><link linkend="VARIANCE">VARIANCE</link> </member>
9140 <member><link linkend="VARA">VARA</link> </member>
9141 <member><link linkend="VARP">VARP</link> </member>
9142 <member><link linkend="VARPA">VARPA</link> </member>
9143 </simplelist></listitem>
9144 </varlistentry>
9145 </variablelist>
9146 </sect3>
9147
9148 <sect3 id="VARA">
9149 <title>VARA</title>
9150 <para>The VARA() function calculates the variance based on a sample.</para>
9151 <para><segmentedlist><segtitle>Return type</segtitle>
9152 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
9153 <variablelist>
9154 <varlistentry><term>Syntax</term>
9155 <listitem><para>VARA(value;value;...)</para></listitem>
9156 </varlistentry>
9157 <varlistentry><term>Parameters</term>
9158 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9159 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9160 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9161 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9162 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9163 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
9164 </varlistentry>
9165 <varlistentry><term>Examples</term>
9166 <listitem><para>VARA(12;5;7) equals 13</para></listitem>
9167 </varlistentry>
9168 <varlistentry><term>Examples</term>
9169 <listitem><para>VARA(15;80;3) equals 1716.333...</para></listitem>
9170 </varlistentry>
9171 <varlistentry><term>Examples</term>
9172 <listitem><para>VARA(6;7;8) equals 1</para></listitem>
9173 </varlistentry>
9174 <varlistentry><term>Related Functions</term>
9175 <listitem><simplelist>
9176 <member><link linkend="VAR">VAR</link> </member>
9177 <member><link linkend="VARP">VARP</link> </member>
9178 <member><link linkend="VARPA">VARPA</link> </member>
9179 </simplelist></listitem>
9180 </varlistentry>
9181 </variablelist>
9182 </sect3>
9183
9184 <sect3 id="VARIANCE">
9185 <title>VARIANCE</title>
9186 <para>The VARIANCE() function calculates the estimates variance based on a sample. It's the same as the VAR function.</para>
9187 <para><segmentedlist><segtitle>Return type</segtitle>
9188 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
9189 <variablelist>
9190 <varlistentry><term>Syntax</term>
9191 <listitem><para>VARIANCE(value;value;...)</para></listitem>
9192 </varlistentry>
9193 <varlistentry><term>Parameters</term>
9194 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9195 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9196 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9197 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9198 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9199 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
9200 </varlistentry>
9201 <varlistentry><term>Examples</term>
9202 <listitem><para>VARIANCE(12;5;7) equals 13</para></listitem>
9203 </varlistentry>
9204 <varlistentry><term>Examples</term>
9205 <listitem><para>VARIANCE(15;80;3) equals 1716.333...</para></listitem>
9206 </varlistentry>
9207 <varlistentry><term>Examples</term>
9208 <listitem><para>VARIANCE(6;7;8) equals 1</para></listitem>
9209 </varlistentry>
9210 <varlistentry><term>Related Functions</term>
9211 <listitem><simplelist>
9212 <member><link linkend="VAR">VAR</link> </member>
9213 <member><link linkend="VARA">VARA</link> </member>
9214 <member><link linkend="VARP">VARP</link> </member>
9215 <member><link linkend="VARPA">VARPA</link> </member>
9216 </simplelist></listitem>
9217 </varlistentry>
9218 </variablelist>
9219 </sect3>
9220
9221 <sect3 id="VARP">
9222 <title>VARP</title>
9223 <para>The VARP() function calculates the variance based on an entire population.</para>
9224 <para><segmentedlist><segtitle>Return type</segtitle>
9225 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
9226 <variablelist>
9227 <varlistentry><term>Syntax</term>
9228 <listitem><para>VARP(value;value;...)</para></listitem>
9229 </varlistentry>
9230 <varlistentry><term>Parameters</term>
9231 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9232 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9233 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9234 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9235 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9236 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
9237 </varlistentry>
9238 <varlistentry><term>Examples</term>
9239 <listitem><para>VARP(12;5;7) equals 8.666...</para></listitem>
9240 </varlistentry>
9241 <varlistentry><term>Examples</term>
9242 <listitem><para>VARP(15;80;3) equals 1144.22...</para></listitem>
9243 </varlistentry>
9244 <varlistentry><term>Examples</term>
9245 <listitem><para>VARP(6;7;8) equals 0.6666667...</para></listitem>
9246 </varlistentry>
9247 <varlistentry><term>Related Functions</term>
9248 <listitem><simplelist>
9249 <member><link linkend="VAR">VAR</link> </member>
9250 <member><link linkend="VARA">VARA</link> </member>
9251 <member><link linkend="VARPA">VARPA</link> </member>
9252 </simplelist></listitem>
9253 </varlistentry>
9254 </variablelist>
9255 </sect3>
9256
9257 <sect3 id="VARPA">
9258 <title>VARPA</title>
9259 <para>The VARPA() function calculates the variance based on an entire population. Text and boolean values that evaluate to FALSE are counted as 0, boolean value that evaluate to TRUE are counted as 1.</para>
9260 <para><segmentedlist><segtitle>Return type</segtitle>
9261 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
9262 <variablelist>
9263 <varlistentry><term>Syntax</term>
9264 <listitem><para>VARPA(value;value;...)</para></listitem>
9265 </varlistentry>
9266 <varlistentry><term>Parameters</term>
9267 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9268 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9269 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9270 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9271 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem>
9272 <seglistitem><seg>Floating point values</seg><seg>A range of floating point values (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
9273 </varlistentry>
9274 <varlistentry><term>Examples</term>
9275 <listitem><para>VARPA(12;5;7) equals 8.666...</para></listitem>
9276 </varlistentry>
9277 <varlistentry><term>Examples</term>
9278 <listitem><para>VARPA(15;80;3) equals 1144.22...</para></listitem>
9279 </varlistentry>
9280 <varlistentry><term>Examples</term>
9281 <listitem><para>VARPA(6;7;8) equals 0.6666667...</para></listitem>
9282 </varlistentry>
9283 <varlistentry><term>Related Functions</term>
9284 <listitem><simplelist>
9285 <member><link linkend="VAR">VAR</link> </member>
9286 <member><link linkend="VARA">VARA</link> </member>
9287 <member><link linkend="VARP">VARP</link> </member>
9288 </simplelist></listitem>
9289 </varlistentry>
9290 </variablelist>
9291 </sect3>
9292
9293 <sect3 id="WEIBULL">
9294 <title>WEIBULL</title>
9295 <para>The WEIBULL() function returns the Weibull distribution.</para>
9296 <para>The alpha and beta parameters must be positive, the number (first parameter) must be non-negative.</para>
9297 <para>Cumulative = 0 calculates the density function; cumulative = 1 calculates the distribution.</para>
9298 <para><segmentedlist><segtitle>Return type</segtitle>
9299 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
9300 <variablelist>
9301 <varlistentry><term>Syntax</term>
9302 <listitem><para>WEIBULL(number;alpha;beta;cumulative)</para></listitem>
9303 </varlistentry>
9304 <varlistentry><term>Parameters</term>
9305 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9306 <seglistitem><seg>Number</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
9307 <seglistitem><seg>Alpha parameter</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
9308 <seglistitem><seg>Beta parameter</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
9309 <seglistitem><seg>0 = density, 1 = distribution</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
9310 </varlistentry>
9311 <varlistentry><term>Examples</term>
9312 <listitem><para>WEIBULL(2;1;1;0) equals 0.135335</para></listitem>
9313 </varlistentry>
9314 <varlistentry><term>Examples</term>
9315 <listitem><para>WEIBULL(2;1;1;1) equals 0.864665</para></listitem>
9316 </varlistentry>
9317 </variablelist>
9318 </sect3>
9319
9320 <sect3 id="ZTEST">
9321 <title>ZTEST</title>
9322 <para>The ZTEST() function calculates the two tailed probability of a z-test with normal distribution.</para>
9323 <para>Performs a test of the null hypothesis, that sample is a sample
9324 of a normal distributed random variable with mean mean and standard
9325 deviation sigma. A return value of 1 indicates, that the null
9326 hypothesis is rejected, i.e. the sample is not a random sample of
9327 the normal distribution.
9328 If sigma is omitted, it is estimated from sample, using STDEV.
9329 </para>
9330 <para><segmentedlist><segtitle>Return type</segtitle>
9331 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
9332 <variablelist>
9333 <varlistentry><term>Syntax</term>
9334 <listitem><para>ZTEST(x; mean; standardDeviation)</para></listitem>
9335 </varlistentry>
9336 <varlistentry><term>Parameters</term>
9337 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9338 <seglistitem><seg>x (array)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
9339 <seglistitem><seg>mean</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
9340 <seglistitem><seg>standardDeviation</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
9341 </varlistentry>
9342 </variablelist>
9343 </sect3>
9344
9345 </sect2><sect2 id="Text">
9346 <title>Text</title>
9347
9348 <sect3 id="ASC">
9349 <title>ASC</title>
9350 <para>The ASC() function returns the half-width characters corresponding to the full-width argument.</para>
9351 <para><segmentedlist><segtitle>Return type</segtitle>
9352 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9353 <variablelist>
9354 <varlistentry><term>Syntax</term>
9355 <listitem><para>ASC(text)</para></listitem>
9356 </varlistentry>
9357 <varlistentry><term>Parameters</term>
9358 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9359 <seglistitem><seg>Full width characters</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
9360 </varlistentry>
9361 <varlistentry><term>Related Functions</term>
9362 <listitem><simplelist>
9363 <member><link linkend="JIS">JIS</link> </member>
9364 </simplelist></listitem>
9365 </varlistentry>
9366 </variablelist>
9367 </sect3>
9368
9369 <sect3 id="BAHTTEXT">
9370 <title>BAHTTEXT</title>
9371 <para>The BAHTTEXT() function converts a number to a text in Thai characters (baht).</para>
9372 <para><segmentedlist><segtitle>Return type</segtitle>
9373 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9374 <variablelist>
9375 <varlistentry><term>Syntax</term>
9376 <listitem><para>BAHTTEXT(number)</para></listitem>
9377 </varlistentry>
9378 <varlistentry><term>Parameters</term>
9379 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9380 <seglistitem><seg>Number</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
9381 </varlistentry>
9382 <varlistentry><term>Examples</term>
9383 <listitem><para>BAHTTEXT(23) returns "ยสบสามบาทถวน"</para></listitem>
9384 </varlistentry>
9385 </variablelist>
9386 </sect3>
9387
9388 <sect3 id="CHAR">
9389 <title>CHAR</title>
9390 <para>The CHAR() function returns the character specified by a number.</para>
9391 <para><segmentedlist><segtitle>Return type</segtitle>
9392 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9393 <variablelist>
9394 <varlistentry><term>Syntax</term>
9395 <listitem><para>CHAR(code)</para></listitem>
9396 </varlistentry>
9397 <varlistentry><term>Parameters</term>
9398 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9399 <seglistitem><seg>Character code</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
9400 </varlistentry>
9401 <varlistentry><term>Examples</term>
9402 <listitem><para>CHAR(65) returns "A"</para></listitem>
9403 </varlistentry>
9404 <varlistentry><term>Related Functions</term>
9405 <listitem><simplelist>
9406 <member><link linkend="CODE">CODE</link> </member>
9407 </simplelist></listitem>
9408 </varlistentry>
9409 </variablelist>
9410
9411 </sect3>
9412
9413 <sect3 id="CLEAN">
9414 <title>CLEAN</title>
9415 <para>The CLEAN() function removes every non-printable character from the string</para>
9416 <para><segmentedlist><segtitle>Return type</segtitle>
9417 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9418 <variablelist>
9419 <varlistentry><term>Syntax</term>
9420 <listitem><para>CLEAN(text)</para></listitem>
9421 </varlistentry>
9422 <varlistentry><term>Parameters</term>
9423 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9424 <seglistitem><seg>Source string</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
9425 </varlistentry>
9426 <varlistentry><term>Examples</term>
9427 <listitem><para>CLEAN(AsciiToChar(7) + "HELLO") returns "HELLO"</para></listitem>
9428 </varlistentry>
9429 </variablelist>
9430 </sect3>
9431
9432 <sect3 id="CODE">
9433 <title>CODE</title>
9434 <para>The CODE() function returns a numeric code for the first character in a text string.</para>
9435 <para><segmentedlist><segtitle>Return type</segtitle>
9436 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
9437 <variablelist>
9438 <varlistentry><term>Syntax</term>
9439 <listitem><para>CODE(text)</para></listitem>
9440 </varlistentry>
9441 <varlistentry><term>Parameters</term>
9442 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9443 <seglistitem><seg>Text</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
9444 </varlistentry>
9445 <varlistentry><term>Examples</term>
9446 <listitem><para>CODE("KDE") returns 75</para></listitem>
9447 </varlistentry>
9448 <varlistentry><term>Related Functions</term>
9449 <listitem><simplelist>
9450 <member><link linkend="CHAR">CHAR</link> </member>
9451 </simplelist></listitem>
9452 </varlistentry>
9453 </variablelist>
9454 </sect3>
9455
9456 <sect3 id="COMPARE">
9457 <title>COMPARE</title>
9458 <para>The COMPARE() function returns 0 if the two strings are equal; -1 if the first one is lower in value than the second one; otherwise it returns 1.</para>
9459 <para><segmentedlist><segtitle>Return type</segtitle>
9460 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
9461 <variablelist>
9462 <varlistentry><term>Syntax</term>
9463 <listitem><para>COMPARE(string1; string2; true|false)</para></listitem>
9464 </varlistentry>
9465 <varlistentry><term>Parameters</term>
9466 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9467 <seglistitem><seg>First string</seg><seg>Text</seg></seglistitem>
9468 <seglistitem><seg>String to compare with</seg><seg>Text</seg></seglistitem>
9469 <seglistitem><seg>Compare case-sensitive (true/false)</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
9470 </varlistentry>
9471 <varlistentry><term>Examples</term>
9472 <listitem><para>COMPARE("Calligra"; "Calligra"; true) returns 0</para></listitem>
9473 </varlistentry>
9474 <varlistentry><term>Examples</term>
9475 <listitem><para>COMPARE("calligra"; "Calligra"; true) returns 1</para></listitem>
9476 </varlistentry>
9477 <varlistentry><term>Examples</term>
9478 <listitem><para>COMPARE("kspread"; "Calligra"; false) returns 1</para></listitem>
9479 </varlistentry>
9480 <varlistentry><term>Related Functions</term>
9481 <listitem><simplelist>
9482 <member><link linkend="EXACT">EXACT</link> </member>
9483 </simplelist></listitem>
9484 </varlistentry>
9485 </variablelist>
9486 </sect3>
9487
9488 <sect3 id="CONCATENATE">
9489 <title>CONCATENATE</title>
9490 <para>The CONCATENATE() function returns a string which is the concatenation of the strings passed as parameters.</para>
9491 <para><segmentedlist><segtitle>Return type</segtitle>
9492 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9493 <variablelist>
9494 <varlistentry><term>Syntax</term>
9495 <listitem><para>CONCATENATE(value;value;...)</para></listitem>
9496 </varlistentry>
9497 <varlistentry><term>Parameters</term>
9498 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9499 <seglistitem><seg>String values</seg><seg>A range of strings</seg></seglistitem>
9500 <seglistitem><seg>String values</seg><seg>A range of strings</seg></seglistitem>
9501 <seglistitem><seg>String values</seg><seg>A range of strings</seg></seglistitem>
9502 <seglistitem><seg>String values</seg><seg>A range of strings</seg></seglistitem>
9503 <seglistitem><seg>String values</seg><seg>A range of strings</seg></seglistitem></segmentedlist></para></listitem>
9504 </varlistentry>
9505 <varlistentry><term>Examples</term>
9506 <listitem><para>CONCATENATE("Sheets";"Calligra";"KDE") returns "SheetsCalligraKDE"</para></listitem>
9507 </varlistentry>
9508 </variablelist>
9509 </sect3>
9510
9511 <sect3 id="DOLLAR">
9512 <title>DOLLAR</title>
9513 <para>The DOLLAR() function converts a number to text using currency format, with the decimals rounded to the specified place. Although the name is DOLLAR, this function will do the conversion according to the current locale.</para>
9514 <para><segmentedlist><segtitle>Return type</segtitle>
9515 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9516 <variablelist>
9517 <varlistentry><term>Syntax</term>
9518 <listitem><para>DOLLAR(number;decimals)</para></listitem>
9519 </varlistentry>
9520 <varlistentry><term>Parameters</term>
9521 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9522 <seglistitem><seg>Number</seg><seg>Double</seg></seglistitem>
9523 <seglistitem><seg>Decimals</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
9524 </varlistentry>
9525 <varlistentry><term>Examples</term>
9526 <listitem><para>DOLLAR(1403.77) returns "$ 1,403.77"</para></listitem>
9527 </varlistentry>
9528 <varlistentry><term>Examples</term>
9529 <listitem><para>DOLLAR(-0.123;4) returns "$-0.1230"</para></listitem>
9530 </varlistentry>
9531 </variablelist>
9532 </sect3>
9533
9534 <sect3 id="EXACT">
9535 <title>EXACT</title>
9536 <para>The EXACT() function returns True if these two strings are equal. Otherwise, it returns False.</para>
9537 <para><segmentedlist><segtitle>Return type</segtitle>
9538 <seglistitem><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para>
9539 <variablelist>
9540 <varlistentry><term>Syntax</term>
9541 <listitem><para>EXACT(string1;string2)</para></listitem>
9542 </varlistentry>
9543 <varlistentry><term>Parameters</term>
9544 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9545 <seglistitem><seg>String</seg><seg>Text</seg></seglistitem>
9546 <seglistitem><seg>String</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
9547 </varlistentry>
9548 <varlistentry><term>Examples</term>
9549 <listitem><para>EXACT("Calligra";"Calligra") returns True</para></listitem>
9550 </varlistentry>
9551 <varlistentry><term>Examples</term>
9552 <listitem><para>EXACT("KSpread";"Calligra") returns False</para></listitem>
9553 </varlistentry>
9554 <varlistentry><term>Related Functions</term>
9555 <listitem><simplelist>
9556 <member><link linkend="COMPARE">COMPARE</link> </member>
9557 </simplelist></listitem>
9558 </varlistentry>
9559 </variablelist>
9560 </sect3>
9561
9562 <sect3 id="FIND">
9563 <title>FIND</title>
9564 <para>The FIND() function finds one text string (find_text) within another text string (within_text) and returns the number of the starting point of find_text, from the leftmost character of within_text.</para>
9565 <para>Parameter start_num specifies the character at which to start the search. The first character is character number 1. If start_num is omitted, it is assumed to be 1.</para>
9566 <para>You can also use function SEARCH, but unlike SEARCH, FIND is case-sensitive and does not allow wildcard characters.</para>
9567 <para><segmentedlist><segtitle>Return type</segtitle>
9568 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
9569 <variablelist>
9570 <varlistentry><term>Syntax</term>
9571 <listitem><para>FIND(find_text;within_text;start_num)</para></listitem>
9572 </varlistentry>
9573 <varlistentry><term>Parameters</term>
9574 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9575 <seglistitem><seg>The text you want to find</seg><seg>Text</seg></seglistitem>
9576 <seglistitem><seg>The text which may contain find_text</seg><seg>Text</seg></seglistitem>
9577 <seglistitem><seg>Specifies index to start the search</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
9578 </varlistentry>
9579 <varlistentry><term>Examples</term>
9580 <listitem><para>FIND("Cal";"Calligra") returns 1</para></listitem>
9581 </varlistentry>
9582 <varlistentry><term>Examples</term>
9583 <listitem><para>FIND("i";"Calligra") returns 5</para></listitem>
9584 </varlistentry>
9585 <varlistentry><term>Examples</term>
9586 <listitem><para>FIND("a";"Sheets in Calligra";4) returns 12</para></listitem>
9587 </varlistentry>
9588 <varlistentry><term>Related Functions</term>
9589 <listitem><simplelist>
9590 <member><link linkend="FINDB">FINDB</link> </member>
9591 <member><link linkend="SEARCH">SEARCH</link> </member>
9592 <member><link linkend="REPLACE">REPLACE</link> </member>
9593 <member><link linkend="SEARCHB">SEARCHB</link> </member>
9594 <member><link linkend="REPLACEB">REPLACEB</link> </member>
9595 </simplelist></listitem>
9596 </varlistentry>
9597 </variablelist>
9598 </sect3>
9599
9600 <sect3 id="FINDB">
9601 <title>FINDB</title>
9602 <para>The FINDB() function finds one text string (find_text) within another text string (within_text) and returns the number of the starting point of find_text, from the leftmost character of within_text using byte positions.</para>
9603 <para>Parameter BytePosition specifies the character at which to start the search. The first character is character number 2. If start_num is omitted, it is assumed to be 2.</para>
9604 <para><segmentedlist><segtitle>Return type</segtitle>
9605 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
9606 <variablelist>
9607 <varlistentry><term>Syntax</term>
9608 <listitem><para>FINDB(find_text;within_text;BytePosition Start)</para></listitem>
9609 </varlistentry>
9610 <varlistentry><term>Parameters</term>
9611 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9612 <seglistitem><seg>The text you want to find</seg><seg>Text</seg></seglistitem>
9613 <seglistitem><seg>The text which may contain find_text</seg><seg>Text</seg></seglistitem>
9614 <seglistitem><seg>Specifies byte position to start the search</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
9615 </varlistentry>
9616 <varlistentry><term>Related Functions</term>
9617 <listitem><simplelist>
9618 <member><link linkend="FIND">FIND</link> </member>
9619 <member><link linkend="SEARCH">SEARCH</link> </member>
9620 <member><link linkend="REPLACE">REPLACE</link> </member>
9621 <member><link linkend="SEARCHB">SEARCHB</link> </member>
9622 <member><link linkend="REPLACEB">REPLACEB</link> </member>
9623 </simplelist></listitem>
9624 </varlistentry>
9625 </variablelist>
9626 </sect3>
9627
9628 <sect3 id="FIXED">
9629 <title>FIXED</title>
9630 <para>The FIXED() function rounds a number to the specified number of decimals, formats the number in decimal format string, and returns the result as text. If decimals is negative, number is rounded to the left of the decimal point. If you omit decimals, it is assumed to be 2. If optional parameter no_commas is True, thousand separators will not show up.</para>
9631 <para><segmentedlist><segtitle>Return type</segtitle>
9632 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9633 <variablelist>
9634 <varlistentry><term>Syntax</term>
9635 <listitem><para>FIXED(number;decimals;no_commas)</para></listitem>
9636 </varlistentry>
9637 <varlistentry><term>Parameters</term>
9638 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9639 <seglistitem><seg>Number</seg><seg>Double</seg></seglistitem>
9640 <seglistitem><seg>Decimals</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
9641 <seglistitem><seg>No_commas</seg><seg>A truth value (TRUE or FALSE)</seg></seglistitem></segmentedlist></para></listitem>
9642 </varlistentry>
9643 <varlistentry><term>Examples</term>
9644 <listitem><para>FIXED(1234.567;1) returns "1,234.6"</para></listitem>
9645 </varlistentry>
9646 <varlistentry><term>Examples</term>
9647 <listitem><para>FIXED(1234.567;1;FALSE) returns "1234.6"</para></listitem>
9648 </varlistentry>
9649 <varlistentry><term>Examples</term>
9650 <listitem><para>FIXED(44.332) returns "44.33"</para></listitem>
9651 </varlistentry>
9652 </variablelist>
9653 </sect3>
9654
9655 <sect3 id="JIS">
9656 <title>JIS</title>
9657 <para>The JIS() function returns the full-width characters corresponding to the half-width argument.</para>
9658 <para><segmentedlist><segtitle>Return type</segtitle>
9659 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9660 <variablelist>
9661 <varlistentry><term>Syntax</term>
9662 <listitem><para>JIS(text)</para></listitem>
9663 </varlistentry>
9664 <varlistentry><term>Parameters</term>
9665 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9666 <seglistitem><seg>Half-width characters</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
9667 </varlistentry>
9668 <varlistentry><term>Related Functions</term>
9669 <listitem><simplelist>
9670 <member><link linkend="ASC">ASC</link> </member>
9671 </simplelist></listitem>
9672 </varlistentry>
9673 </variablelist>
9674 </sect3>
9675
9676 <sect3 id="LEFT">
9677 <title>LEFT</title>
9678 <para>The LEFT() function returns a substring that contains the 'length' leftmost characters of the string. The whole string is returned if 'length' exceeds the length of the string. It is an error for the number of characters to be less than 0.</para>
9679 <para><segmentedlist><segtitle>Return type</segtitle>
9680 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9681 <variablelist>
9682 <varlistentry><term>Syntax</term>
9683 <listitem><para>LEFT(text;length)</para></listitem>
9684 </varlistentry>
9685 <varlistentry><term>Parameters</term>
9686 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9687 <seglistitem><seg>Source string</seg><seg>Text</seg></seglistitem>
9688 <seglistitem><seg>Number of characters</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
9689 </varlistentry>
9690 <varlistentry><term>Examples</term>
9691 <listitem><para>LEFT("hello";2) returns "he"</para></listitem>
9692 </varlistentry>
9693 <varlistentry><term>Examples</term>
9694 <listitem><para>LEFT("KSpread";10) returns "KSpread"</para></listitem>
9695 </varlistentry>
9696 <varlistentry><term>Examples</term>
9697 <listitem><para>LEFT("KSpread") returns "K"</para></listitem>
9698 </varlistentry>
9699 <varlistentry><term>Related Functions</term>
9700 <listitem><simplelist>
9701 <member><link linkend="RIGHT">RIGHT</link> </member>
9702 <member><link linkend="MID">MID</link> </member>
9703 <member><link linkend="RIGHTB">RIGHTB</link> </member>
9704 <member><link linkend="MIDB">MIDB</link> </member>
9705 </simplelist></listitem>
9706 </varlistentry>
9707 </variablelist>
9708 </sect3>
9709
9710 <sect3 id="LEFTB">
9711 <title>LEFTB</title>
9712 <para>The LEFTB() function returns a substring that contains the 'length' leftmost characters of the string using byte positions. The whole string is returned if 'length' exceeds the length of the string. It is an error for the number of characters to be less than 0.</para>
9713 <para><segmentedlist><segtitle>Return type</segtitle>
9714 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9715 <variablelist>
9716 <varlistentry><term>Syntax</term>
9717 <listitem><para>LEFTB(text;ByteLength)</para></listitem>
9718 </varlistentry>
9719 <varlistentry><term>Parameters</term>
9720 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9721 <seglistitem><seg>Source string</seg><seg>Text</seg></seglistitem>
9722 <seglistitem><seg>Byte Length</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
9723 </varlistentry>
9724 <varlistentry><term>Related Functions</term>
9725 <listitem><simplelist>
9726 <member><link linkend="RIGHT">RIGHT</link> </member>
9727 <member><link linkend="MID">MID</link> </member>
9728 <member><link linkend="RIGHTB">RIGHTB</link> </member>
9729 <member><link linkend="MIDB">MIDB</link> </member>
9730 </simplelist></listitem>
9731 </varlistentry>
9732 </variablelist>
9733 </sect3>
9734
9735 <sect3 id="LEN">
9736 <title>LEN</title>
9737 <para>The LEN() function returns the length of the string.</para>
9738 <para><segmentedlist><segtitle>Return type</segtitle>
9739 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
9740 <variablelist>
9741 <varlistentry><term>Syntax</term>
9742 <listitem><para>LEN(text)</para></listitem>
9743 </varlistentry>
9744 <varlistentry><term>Parameters</term>
9745 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9746 <seglistitem><seg>String</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
9747 </varlistentry>
9748 <varlistentry><term>Examples</term>
9749 <listitem><para>LEN("hello") returns 5</para></listitem>
9750 </varlistentry>
9751 <varlistentry><term>Examples</term>
9752 <listitem><para>LEN("KSpread") returns 7</para></listitem>
9753 </varlistentry>
9754 <varlistentry><term>Related Functions</term>
9755 <listitem><simplelist>
9756 <member><link linkend="LENB">LENB</link> </member>
9757 </simplelist></listitem>
9758 </varlistentry>
9759 </variablelist>
9760 </sect3>
9761
9762 <sect3 id="LENB">
9763 <title>LENB</title>
9764 <para>The LENB() function returns the length of the string using byte positions.</para>
9765 <para><segmentedlist><segtitle>Return type</segtitle>
9766 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
9767 <variablelist>
9768 <varlistentry><term>Syntax</term>
9769 <listitem><para>LENB(text)</para></listitem>
9770 </varlistentry>
9771 <varlistentry><term>Parameters</term>
9772 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9773 <seglistitem><seg>String</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
9774 </varlistentry>
9775 </variablelist>
9776 </sect3>
9777
9778 <sect3 id="LOWER">
9779 <title>LOWER</title>
9780 <para>The LOWER() function converts a string to lower case.</para>
9781 <para><segmentedlist><segtitle>Return type</segtitle>
9782 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9783 <variablelist>
9784 <varlistentry><term>Syntax</term>
9785 <listitem><para>LOWER(text)</para></listitem>
9786 </varlistentry>
9787 <varlistentry><term>Parameters</term>
9788 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9789 <seglistitem><seg>Source string</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
9790 </varlistentry>
9791 <varlistentry><term>Examples</term>
9792 <listitem><para>LOWER("hello") returns "hello"</para></listitem>
9793 </varlistentry>
9794 <varlistentry><term>Examples</term>
9795 <listitem><para>LOWER("HELLO") returns "hello"</para></listitem>
9796 </varlistentry>
9797 <varlistentry><term>Related Functions</term>
9798 <listitem><simplelist>
9799 <member><link linkend="UPPER">UPPER</link> </member>
9800 <member><link linkend="TOGGLE">TOGGLE</link> </member>
9801 </simplelist></listitem>
9802 </varlistentry>
9803 </variablelist>
9804 </sect3>
9805
9806 <sect3 id="MID">
9807 <title>MID</title>
9808 <para>The MID() function returns a substring that contains 'length' characters of the string, starting at 'position' index.</para>
9809 <para><segmentedlist><segtitle>Return type</segtitle>
9810 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9811 <variablelist>
9812 <varlistentry><term>Syntax</term>
9813 <listitem><para>MID(text;position;length)</para></listitem>
9814 </varlistentry>
9815 <varlistentry><term>Parameters</term>
9816 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9817 <seglistitem><seg>Source string</seg><seg>Text</seg></seglistitem>
9818 <seglistitem><seg>Position</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
9819 <seglistitem><seg>Length</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
9820 </varlistentry>
9821 <varlistentry><term>Examples</term>
9822 <listitem><para>MID("Calligra";2;3) returns "all"</para></listitem>
9823 </varlistentry>
9824 <varlistentry><term>Examples</term>
9825 <listitem><para>MID("Calligra";2) returns "alligra"</para></listitem>
9826 </varlistentry>
9827 <varlistentry><term>Related Functions</term>
9828 <listitem><simplelist>
9829 <member><link linkend="LEFT">LEFT</link> </member>
9830 <member><link linkend="RIGHT">RIGHT</link> </member>
9831 <member><link linkend="LEFTB">LEFTB</link> </member>
9832 <member><link linkend="RIGHTB">RIGHTB</link> </member>
9833 <member><link linkend="MIDB">MIDB</link> </member>
9834 </simplelist></listitem>
9835 </varlistentry>
9836 </variablelist>
9837 </sect3>
9838
9839 <sect3 id="MIDB">
9840 <title>MIDB</title>
9841 <para>The MIDB() function returns a substring that contains 'length' characters of the string, starting at 'position' index using byte positions.</para>
9842 <para><segmentedlist><segtitle>Return type</segtitle>
9843 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9844 <variablelist>
9845 <varlistentry><term>Syntax</term>
9846 <listitem><para>MIDB(text;BytePosition Start;ByteLength)</para></listitem>
9847 </varlistentry>
9848 <varlistentry><term>Parameters</term>
9849 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9850 <seglistitem><seg>Source string</seg><seg>Text</seg></seglistitem>
9851 <seglistitem><seg>Byte Position</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
9852 <seglistitem><seg>Byte Length</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
9853 </varlistentry>
9854 <varlistentry><term>Related Functions</term>
9855 <listitem><simplelist>
9856 <member><link linkend="LEFT">LEFT</link> </member>
9857 <member><link linkend="RIGHT">RIGHT</link> </member>
9858 <member><link linkend="LEFTB">LEFTB</link> </member>
9859 <member><link linkend="RIGHTB">RIGHTB</link> </member>
9860 <member><link linkend="MID">MID</link> </member>
9861 </simplelist></listitem>
9862 </varlistentry>
9863 </variablelist>
9864 </sect3>
9865
9866 <sect3 id="PROPER">
9867 <title>PROPER</title>
9868 <para>The PROPER() function converts the first letter of each word to uppercase and the rest of the letters to lowercase.</para>
9869 <para><segmentedlist><segtitle>Return type</segtitle>
9870 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9871 <variablelist>
9872 <varlistentry><term>Syntax</term>
9873 <listitem><para>PROPER(string)</para></listitem>
9874 </varlistentry>
9875 <varlistentry><term>Parameters</term>
9876 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9877 <seglistitem><seg>String</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
9878 </varlistentry>
9879 <varlistentry><term>Examples</term>
9880 <listitem><para>PROPER("this is a title") returns "This Is A Title"</para></listitem>
9881 </varlistentry>
9882 </variablelist>
9883 </sect3>
9884
9885 <sect3 id="REGEXP">
9886 <title>REGEXP</title>
9887 <para>Returns a part of the string that matches a regular expression. If the string does not match the given regular expression, value specified as default is returned.</para>
9888 <para>If a back-reference is provided, then the value of that back-reference is returned.</para>
9889 <para>If no default value is given, an empty string is assumed. If no back-reference is given, 0 is assumed (so that entire matching part is returned).</para>
9890 <para><segmentedlist><segtitle>Return type</segtitle>
9891 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9892 <variablelist>
9893 <varlistentry><term>Syntax</term>
9894 <listitem><para>REGEXP(text; regexp; default; backref)</para></listitem>
9895 </varlistentry>
9896 <varlistentry><term>Parameters</term>
9897 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9898 <seglistitem><seg>Searched text</seg><seg>Text</seg></seglistitem>
9899 <seglistitem><seg>Regular expression</seg><seg>Text</seg></seglistitem>
9900 <seglistitem><seg>Default value (optional)</seg><seg>Text</seg></seglistitem>
9901 <seglistitem><seg>Back-reference (optional)</seg><seg>Number</seg></seglistitem></segmentedlist></para></listitem>
9902 </varlistentry>
9903 <varlistentry><term>Examples</term>
9904 <listitem><para>REGEXP("Number is 15.";"[0-9]+") = "15" </para></listitem>
9905
9906 </varlistentry>
9907 <varlistentry><term>Examples</term>
9908 <listitem><para>REGEXP("15, 20, 26, 41";"([0-9]+), *[0-9]+$";"";1) = "26" </para></listitem>
9909 </varlistentry>
9910 </variablelist>
9911 </sect3>
9912
9913 <sect3 id="REGEXPRE">
9914 <title>REGEXPRE</title>
9915 <para>Replaces all matches of a regular expression with the replacement text</para>
9916 <para><segmentedlist><segtitle>Return type</segtitle>
9917 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9918 <variablelist>
9919 <varlistentry><term>Syntax</term>
9920 <listitem><para>REGEXPRE(text; regexp; replacement)</para></listitem>
9921 </varlistentry>
9922 <varlistentry><term>Parameters</term>
9923 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9924 <seglistitem><seg>Searched text</seg><seg>Text</seg></seglistitem>
9925 <seglistitem><seg>Regular expression</seg><seg>Text</seg></seglistitem>
9926 <seglistitem><seg>Replacement</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
9927 </varlistentry>
9928 <varlistentry><term>Examples</term>
9929 <listitem><para>REGEXPRE("14 and 15 and 16";"[0-9]+";"num") returns "num and num and num"</para></listitem>
9930 </varlistentry>
9931 </variablelist>
9932 </sect3>
9933
9934 <sect3 id="REPLACE">
9935 <title>REPLACE</title>
9936 <para>The REPLACE() function replaces part of a text string with a different text string.</para>
9937 <para><segmentedlist><segtitle>Return type</segtitle>
9938 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9939 <variablelist>
9940 <varlistentry><term>Syntax</term>
9941 <listitem><para>REPLACE(text;position;length;new_text)</para></listitem>
9942 </varlistentry>
9943 <varlistentry><term>Parameters</term>
9944 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9945 <seglistitem><seg>Text which you want to replace some characters</seg><seg>Text</seg></seglistitem>
9946 <seglistitem><seg>Position of the characters to replace</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
9947 <seglistitem><seg>Number of characters to replace</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
9948 <seglistitem><seg>The text that will replace characters in old text</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
9949 </varlistentry>
9950 <varlistentry><term>Examples</term>
9951 <listitem><para>REPLACE("abcdefghijk";6;5;"-") returns "abcde-k"</para></listitem>
9952 </varlistentry>
9953 <varlistentry><term>Examples</term>
9954 <listitem><para>REPLACE("2002";3;2;"03") returns "2003"</para></listitem>
9955 </varlistentry>
9956 <varlistentry><term>Related Functions</term>
9957 <listitem><simplelist>
9958 <member><link linkend="FIND">FIND</link> </member>
9959 <member><link linkend="MID">MID</link> </member>
9960 <member><link linkend="FINDB">FINDB</link> </member>
9961 <member><link linkend="MIDB">MIDB</link> </member>
9962 </simplelist></listitem>
9963 </varlistentry>
9964 </variablelist>
9965 </sect3>
9966
9967 <sect3 id="REPLACEB">
9968 <title>REPLACEB</title>
9969 <para>The REPLACEB() function replaces part of a text string with a different text string using byte positions.</para>
9970 <para><segmentedlist><segtitle>Return type</segtitle>
9971 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9972 <variablelist>
9973 <varlistentry><term>Syntax</term>
9974 <listitem><para>REPLACEB(text;BytePosition;ByteLength Len;new_text)</para></listitem>
9975 </varlistentry>
9976 <varlistentry><term>Parameters</term>
9977 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
9978 <seglistitem><seg>Text which you want to replace some characters using byte position</seg><seg>Text</seg></seglistitem>
9979 <seglistitem><seg>Byte position of the characters to replace</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
9980 <seglistitem><seg>The byte length of characters to replace</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem>
9981 <seglistitem><seg>The text that will replace characters in old text</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
9982 </varlistentry>
9983 <varlistentry><term>Related Functions</term>
9984 <listitem><simplelist>
9985 <member><link linkend="FINDB">FINDB</link> </member>
9986 <member><link linkend="MIDB">MIDB</link> </member>
9987 <member><link linkend="FIND">FIND</link> </member>
9988 <member><link linkend="MID">MID</link> </member>
9989 </simplelist></listitem>
9990 </varlistentry>
9991 </variablelist>
9992 </sect3>
9993
9994 <sect3 id="REPT">
9995 <title>REPT</title>
9996 <para>The REPT() function repeats the first parameter as many times as by the second parameter. The second parameter must not be negative, and this function will return an empty string if the second parameter is zero (or rounds down to zero).</para>
9997 <para><segmentedlist><segtitle>Return type</segtitle>
9998 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
9999 <variablelist>
10000 <varlistentry><term>Syntax</term>
10001 <listitem><para>REPT(text;count)</para></listitem>
10002 </varlistentry>
10003 <varlistentry><term>Parameters</term>
10004 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10005 <seglistitem><seg>Source string</seg><seg>Text</seg></seglistitem>
10006 <seglistitem><seg>Count of repetitions</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
10007 </varlistentry>
10008 <varlistentry><term>Examples</term>
10009 <listitem><para>REPT("KSpread";3) returns "KSpreadKSpreadKSpread"</para></listitem>
10010 </varlistentry>
10011 <varlistentry><term>Examples</term>
10012 <listitem><para>REPT("KSpread";0) returns ""</para></listitem>
10013 </varlistentry>
10014 </variablelist>
10015 </sect3>
10016
10017 <sect3 id="RIGHT">
10018 <title>RIGHT</title>
10019 <para>The RIGHT() function returns a substring that contains the 'length' rightmost characters of the string. The whole string is returned if 'length' exceeds the length of the string.</para>
10020 <para><segmentedlist><segtitle>Return type</segtitle>
10021 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
10022 <variablelist>
10023 <varlistentry><term>Syntax</term>
10024 <listitem><para>RIGHT(text;length)</para></listitem>
10025 </varlistentry>
10026 <varlistentry><term>Parameters</term>
10027 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10028 <seglistitem><seg>Source string</seg><seg>Text</seg></seglistitem>
10029 <seglistitem><seg>Number of characters</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
10030 </varlistentry>
10031 <varlistentry><term>Examples</term>
10032 <listitem><para>RIGHT("hello";2) returns "lo"</para></listitem>
10033 </varlistentry>
10034 <varlistentry><term>Examples</term>
10035 <listitem><para>RIGHT("KSpread";10) returns "KSpread"</para></listitem>
10036 </varlistentry>
10037 <varlistentry><term>Examples</term>
10038 <listitem><para>RIGHT("KSpread") returns "d"</para></listitem>
10039 </varlistentry>
10040 <varlistentry><term>Related Functions</term>
10041 <listitem><simplelist>
10042 <member><link linkend="LEFT">LEFT</link> </member>
10043 <member><link linkend="MID">MID</link> </member>
10044 <member><link linkend="LEFTB">LEFTB</link> </member>
10045 <member><link linkend="MIDB">MIDB</link> </member>
10046 </simplelist></listitem>
10047 </varlistentry>
10048 </variablelist>
10049 </sect3>
10050
10051 <sect3 id="RIGHTB">
10052 <title>RIGHTB</title>
10053 <para>The RIGHTB() function returns a substring that contains the 'length' rightmost characters of the string using byte positions. The whole string is returned if 'length' exceeds the length of the string.</para>
10054 <para><segmentedlist><segtitle>Return type</segtitle>
10055 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
10056 <variablelist>
10057 <varlistentry><term>Syntax</term>
10058 <listitem><para>RIGHTB(text;ByteLength)</para></listitem>
10059 </varlistentry>
10060 <varlistentry><term>Parameters</term>
10061 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10062 <seglistitem><seg>Source string</seg><seg>Text</seg></seglistitem>
10063 <seglistitem><seg>Byte Length</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
10064 </varlistentry>
10065 <varlistentry><term>Related Functions</term>
10066 <listitem><simplelist>
10067 <member><link linkend="LEFT">LEFT</link> </member>
10068 <member><link linkend="MID">MID</link> </member>
10069 <member><link linkend="LEFTB">LEFTB</link> </member>
10070 <member><link linkend="MIDB">MIDB</link> </member>
10071 </simplelist></listitem>
10072 </varlistentry>
10073 </variablelist>
10074 </sect3>
10075
10076 <sect3 id="ROT13">
10077 <title>ROT13</title>
10078 <para>The ROT13() function encrypts text by replacing each letter with the one 13 places along in the alphabet. If the 13th position is beyond the letter Z, it begins again at A (rotation).</para>
10079 <para>By applying the encryption function again to the resulting text, you can decrypt the text.</para>
10080 <para><segmentedlist><segtitle>Return type</segtitle>
10081 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
10082 <variablelist>
10083 <varlistentry><term>Syntax</term>
10084 <listitem><para>ROT13(Text)</para></listitem>
10085 </varlistentry>
10086 <varlistentry><term>Parameters</term>
10087 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10088 <seglistitem><seg>Text</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
10089 </varlistentry>
10090 <varlistentry><term>Examples</term>
10091 <listitem><para>ROT13("KSpread") returns "XFcernq"</para></listitem>
10092 </varlistentry>
10093 <varlistentry><term>Examples</term>
10094 <listitem><para>ROT13("XFcernq") returns "KSpread"</para></listitem>
10095 </varlistentry>
10096 </variablelist>
10097 </sect3>
10098
10099 <sect3 id="SEARCH">
10100 <title>SEARCH</title>
10101 <para>The SEARCH() function finds one text string (find_text) within another text string (within_text) and returns the number of the starting point of find_text, from the leftmost character of within_text.</para>
10102 <para>You can use wildcard characters, question mark (?) and asterisk (*). A question mark matches any single character, an asterisk matches any sequences of characters.</para>
10103 <para>Parameter start_num specifies the character at which to start the search. The first character is character number 1. If start_num is omitted, it is assumed to be 1. SEARCH does not distinguish between uppercase and lowercase letters.</para>
10104 <para><segmentedlist><segtitle>Return type</segtitle>
10105 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
10106 <variablelist>
10107 <varlistentry><term>Syntax</term>
10108 <listitem><para>SEARCH(find_text;within_text;start_num)</para></listitem>
10109 </varlistentry>
10110 <varlistentry><term>Parameters</term>
10111 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10112 <seglistitem><seg>The text you want to find</seg><seg>Text</seg></seglistitem>
10113 <seglistitem><seg>The text which may contain find_text</seg><seg>Text</seg></seglistitem>
10114 <seglistitem><seg>Specified index to start the search</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
10115 </varlistentry>
10116 <varlistentry><term>Examples</term>
10117 <listitem><para>SEARCH("e";"Statements";6) returns 7</para></listitem>
10118 </varlistentry>
10119 <varlistentry><term>Examples</term>
10120 <listitem><para>SEARCH("margin";"Profit Margin") returns 8</para></listitem>
10121 </varlistentry>
10122 <varlistentry><term>Related Functions</term>
10123 <listitem><simplelist>
10124 <member><link linkend="FIND">FIND</link> </member>
10125 <member><link linkend="FINDB">FINDB</link> </member>
10126 <member><link linkend="SEARCHB">SEARCHB</link> </member>
10127 </simplelist></listitem>
10128 </varlistentry>
10129 </variablelist>
10130 </sect3>
10131
10132 <sect3 id="SEARCHB">
10133 <title>SEARCHB</title>
10134 <para>The SEARCHB() function finds one text string (find_text) within another text string (within_text) and returns the number of the starting point of find_text, from the leftmost character of within_text using byte positions.</para>
10135 <para>You can use wildcard characters, question mark (?) and asterisk (*). A question mark matches any single character, an asterisk matches any sequences of characters.</para>
10136 <para>Parameter BytePosition specifies the character at which to start the search. The first character is character number 2. If BytePosition is omitted, it is assumed to be 2. SEARCHB does not distinguish between uppercase and lowercase letters.</para>
10137 <para><segmentedlist><segtitle>Return type</segtitle>
10138 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
10139 <variablelist>
10140 <varlistentry><term>Syntax</term>
10141 <listitem><para>SEARCHB(find_text;within_text;BytePosition Start)</para></listitem>
10142 </varlistentry>
10143 <varlistentry><term>Parameters</term>
10144 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10145 <seglistitem><seg>The text you want to find</seg><seg>Text</seg></seglistitem>
10146 <seglistitem><seg>The text which may contain find_text</seg><seg>Text</seg></seglistitem>
10147 <seglistitem><seg>Specified byte position to start the search</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
10148 </varlistentry>
10149 <varlistentry><term>Related Functions</term>
10150 <listitem><simplelist>
10151 <member><link linkend="FINDB">FINDB</link> </member>
10152 <member><link linkend="FIND">FIND</link> </member>
10153 <member><link linkend="SEARCH">SEARCH</link> </member>
10154 </simplelist></listitem>
10155 </varlistentry>
10156 </variablelist>
10157 </sect3>
10158
10159 <sect3 id="SLEEK">
10160 <title>SLEEK</title>
10161 <para>The SLEEK() function removes all spaces from the string.</para>
10162 <para><segmentedlist><segtitle>Return type</segtitle>
10163 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
10164 <variablelist>
10165 <varlistentry><term>Syntax</term>
10166 <listitem><para>SLEEK(text)</para></listitem>
10167 </varlistentry>
10168 <varlistentry><term>Parameters</term>
10169 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10170 <seglistitem><seg>Source string</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
10171 </varlistentry>
10172 <varlistentry><term>Examples</term>
10173 <listitem><para>SLEEK("This is some text ") returns "Thisissometext"</para></listitem>
10174 </varlistentry>
10175 <varlistentry><term>Related Functions</term>
10176 <listitem><simplelist>
10177 <member><link linkend="TRIM">TRIM</link> </member>
10178 </simplelist></listitem>
10179 </varlistentry>
10180 </variablelist>
10181 </sect3>
10182
10183 <sect3 id="SUBSTITUTE">
10184 <title>SUBSTITUTE</title>
10185 <para>The SUBSTITUTE() substitutes new_text for old_text in a text string. If instance_num is specified, only that instance of old_text is replaced. Otherwise, every occurrence of old_text is changed to new_text. Use SUBSTITUTE when you want to replace specific text, use REPLACE when you want to replace any text that occurs in a specific location.</para>
10186 <para><segmentedlist><segtitle>Return type</segtitle>
10187 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
10188 <variablelist>
10189 <varlistentry><term>Syntax</term>
10190 <listitem><para>SUBSTITUTE(text; old_text; new_text; instance_num)</para></listitem>
10191 </varlistentry>
10192 <varlistentry><term>Parameters</term>
10193 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10194 <seglistitem><seg>Text for which you want to substitute</seg><seg>Text</seg></seglistitem>
10195 <seglistitem><seg>Part of text you want to replace</seg><seg>Text</seg></seglistitem>
10196 <seglistitem><seg>New text which will be replacement</seg><seg>Text</seg></seglistitem>
10197 <seglistitem><seg>Which occurrence to replace</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
10198 </varlistentry>
10199 <varlistentry><term>Examples</term>
10200 <listitem><para>SUBSTITUTE("Cost Data";"Cost";"Sales") returns "Sales Data"</para></listitem>
10201 </varlistentry>
10202 <varlistentry><term>Examples</term>
10203 <listitem><para>SUBSTITUTE("Qtr 1, 2001";"1";"3";1) returns "Qtr 3, 2001"</para></listitem>
10204 </varlistentry>
10205 <varlistentry><term>Examples</term>
10206 <listitem><para>SUBSTITUTE("Qtr 1, 2001";"1";"3";4) returns "Qtr 3, 2003"</para></listitem>
10207 </varlistentry>
10208 <varlistentry><term>Related Functions</term>
10209 <listitem><simplelist>
10210 <member><link linkend="REPLACE">REPLACE</link> </member>
10211 <member><link linkend="REPLACEB">REPLACEB</link> </member>
10212 <member><link linkend="FIND">FIND</link> </member>
10213 <member><link linkend="FINDB">FINDB</link> </member>
10214 </simplelist></listitem>
10215 </varlistentry>
10216 </variablelist>
10217 </sect3>
10218
10219 <sect3 id="T">
10220 <title>T</title>
10221 <para>The T() function returns the text referred to by value. If value is, or refers to, text then T returns value. If value does not refer to text then T returns empty text.</para>
10222 <para><segmentedlist><segtitle>Return type</segtitle>
10223 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
10224 <variablelist>
10225 <varlistentry><term>Syntax</term>
10226 <listitem><para>T(value)</para></listitem>
10227 </varlistentry>
10228 <varlistentry><term>Parameters</term>
10229 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10230 <seglistitem><seg>Value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
10231 </varlistentry>
10232 <varlistentry><term>Examples</term>
10233 <listitem><para>T("Calligra") returns "Calligra"</para></listitem>
10234 </varlistentry>
10235 <varlistentry><term>Examples</term>
10236 <listitem><para>T(1.2) returns "" (empty text)</para></listitem>
10237 </varlistentry>
10238 </variablelist>
10239 </sect3>
10240
10241 <sect3 id="TEXT">
10242 <title>TEXT</title>
10243 <para>The TEXT() function converts a value to text.</para>
10244 <para><segmentedlist><segtitle>Return type</segtitle>
10245 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
10246 <variablelist>
10247 <varlistentry><term>Syntax</term>
10248 <listitem><para>TEXT(value)</para></listitem>
10249 </varlistentry>
10250 <varlistentry><term>Parameters</term>
10251 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10252 <seglistitem><seg>Value</seg><seg>Any kind of value</seg></seglistitem></segmentedlist></para></listitem>
10253 </varlistentry>
10254 <varlistentry><term>Examples</term>
10255 <listitem><para>TEXT(1234.56) returns "1234.56"</para></listitem>
10256 </varlistentry>
10257 <varlistentry><term>Examples</term>
10258 <listitem><para>TEXT("KSpread") returns "KSpread"</para></listitem>
10259 </varlistentry>
10260 </variablelist>
10261 </sect3>
10262
10263 <sect3 id="TOGGLE">
10264 <title>TOGGLE</title>
10265 <para>The TOGGLE() function changes lowercase characters to uppercase and uppercase characters to lowercase.</para>
10266 <para><segmentedlist><segtitle>Return type</segtitle>
10267 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
10268 <variablelist>
10269 <varlistentry><term>Syntax</term>
10270 <listitem><para>TOGGLE(text)</para></listitem>
10271 </varlistentry>
10272 <varlistentry><term>Parameters</term>
10273 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10274 <seglistitem><seg>Source string</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
10275 </varlistentry>
10276 <varlistentry><term>Examples</term>
10277 <listitem><para>TOGGLE("hello") returns "HELLO"</para></listitem>
10278 </varlistentry>
10279 <varlistentry><term>Examples</term>
10280 <listitem><para>TOGGLE("HELLO") returns "hello"</para></listitem>
10281 </varlistentry>
10282 <varlistentry><term>Examples</term>
10283 <listitem><para>TOGGLE("HeLlO") returns "hElLo"</para></listitem>
10284 </varlistentry>
10285 <varlistentry><term>Related Functions</term>
10286 <listitem><simplelist>
10287 <member><link linkend="UPPER">UPPER</link> </member>
10288 <member><link linkend="LOWER">LOWER</link> </member>
10289 </simplelist></listitem>
10290 </varlistentry>
10291 </variablelist>
10292 </sect3>
10293
10294 <sect3 id="TRIM">
10295 <title>TRIM</title>
10296 <para>The TRIM() function returns text with only single spaces between words.</para>
10297 <para><segmentedlist><segtitle>Return type</segtitle>
10298 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
10299 <variablelist>
10300 <varlistentry><term>Syntax</term>
10301 <listitem><para>TRIM(text)</para></listitem>
10302 </varlistentry>
10303 <varlistentry><term>Parameters</term>
10304 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10305 <seglistitem><seg>String</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
10306 </varlistentry>
10307 <varlistentry><term>Examples</term>
10308 <listitem><para>TRIM(" hello KSpread ") returns "hello KSpread"</para></listitem>
10309 </varlistentry>
10310 </variablelist>
10311 </sect3>
10312
10313 <sect3 id="UNICHAR">
10314 <title>UNICHAR</title>
10315 <para>The UNICHAR() function returns the character specified by a unicode code point.</para>
10316 <para><segmentedlist><segtitle>Return type</segtitle>
10317 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
10318 <variablelist>
10319 <varlistentry><term>Syntax</term>
10320 <listitem><para>UNICHAR(code)</para></listitem>
10321 </varlistentry>
10322 <varlistentry><term>Parameters</term>
10323 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10324 <seglistitem><seg>Character code</seg><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para></listitem>
10325 </varlistentry>
10326 <varlistentry><term>Examples</term>
10327 <listitem><para>UNICHAR(65) returns "A"</para></listitem>
10328 </varlistentry>
10329 <varlistentry><term>Related Functions</term>
10330 <listitem><simplelist>
10331 <member><link linkend="UNICODE">UNICODE</link> </member>
10332 <member><link linkend="CHAR">CHAR</link> </member>
10333 </simplelist></listitem>
10334 </varlistentry>
10335 </variablelist>
10336 </sect3>
10337
10338 <sect3 id="UNICODE">
10339 <title>UNICODE</title>
10340 <para>The UNICODE() function returns a unicode code point for the first character in a text string.</para>
10341 <para><segmentedlist><segtitle>Return type</segtitle>
10342 <seglistitem><seg>Whole number (like 1, 132, 2344)</seg></seglistitem></segmentedlist></para>
10343 <variablelist>
10344 <varlistentry><term>Syntax</term>
10345 <listitem><para>UNICODE(text)</para></listitem>
10346 </varlistentry>
10347 <varlistentry><term>Parameters</term>
10348 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10349 <seglistitem><seg>Text</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
10350 </varlistentry>
10351 <varlistentry><term>Examples</term>
10352 <listitem><para>UNICODE("KDE") returns 75</para></listitem>
10353 </varlistentry>
10354 <varlistentry><term>Related Functions</term>
10355 <listitem><simplelist>
10356 <member><link linkend="UNICHAR">UNICHAR</link> </member>
10357 <member><link linkend="CODE">CODE</link> </member>
10358 </simplelist></listitem>
10359 </varlistentry>
10360 </variablelist>
10361 </sect3>
10362
10363 <sect3 id="UPPER">
10364 <title>UPPER</title>
10365 <para>The UPPER() function converts a string to upper case.</para>
10366 <para><segmentedlist><segtitle>Return type</segtitle>
10367 <seglistitem><seg>Text</seg></seglistitem></segmentedlist></para>
10368 <variablelist>
10369 <varlistentry><term>Syntax</term>
10370 <listitem><para>UPPER(text)</para></listitem>
10371 </varlistentry>
10372 <varlistentry><term>Parameters</term>
10373 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10374 <seglistitem><seg>Source string</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
10375 </varlistentry>
10376 <varlistentry><term>Examples</term>
10377 <listitem><para>UPPER("hello") returns "HELLO"</para></listitem>
10378 </varlistentry>
10379 <varlistentry><term>Examples</term>
10380 <listitem><para>UPPER("HELLO") returns "HELLO"</para></listitem>
10381 </varlistentry>
10382 <varlistentry><term>Related Functions</term>
10383 <listitem><simplelist>
10384 <member><link linkend="LOWER">LOWER</link> </member>
10385 <member><link linkend="TOGGLE">TOGGLE</link> </member>
10386 </simplelist></listitem>
10387 </varlistentry>
10388 </variablelist>
10389 </sect3>
10390
10391 <sect3 id="VALUE">
10392 <title>VALUE</title>
10393 <para>Converts text string that represents a value to the real value. </para>
10394 <para><segmentedlist><segtitle>Return type</segtitle>
10395 <seglistitem><seg>Double</seg></seglistitem></segmentedlist></para>
10396 <variablelist>
10397 <varlistentry><term>Syntax</term>
10398
10399 <listitem><para>VALUE(text)</para></listitem>
10400 </varlistentry>
10401 <varlistentry><term>Parameters</term>
10402 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10403 <seglistitem><seg>Text</seg><seg>Text</seg></seglistitem></segmentedlist></para></listitem>
10404 </varlistentry>
10405 <varlistentry><term>Examples</term>
10406 <listitem><para>VALUE("14.03") returns 14.03</para></listitem>
10407 </varlistentry>
10408 </variablelist>
10409 </sect3>
10410
10411 </sect2><sect2 id="Trigonometric">
10412 <title>Trigonometric</title>
10413
10414 <sect3 id="ACOS">
10415 <title>ACOS</title>
10416 <para>The ACOS() function returns the arc cosine in radians and the value is mathematically defined to be 0 to PI (inclusive).</para>
10417 <para><segmentedlist><segtitle>Return type</segtitle>
10418 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10419 <variablelist>
10420 <varlistentry><term>Syntax</term>
10421 <listitem><para>ACOS(Float)</para></listitem>
10422 </varlistentry>
10423 <varlistentry><term>Parameters</term>
10424 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10425 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10426 </varlistentry>
10427 <varlistentry><term>Examples</term>
10428 <listitem><para>ACOS(0.8) equals 0.6435011</para></listitem>
10429 </varlistentry>
10430 <varlistentry><term>Examples</term>
10431 <listitem><para>ACOS(0) equals 1.57079633</para></listitem>
10432 </varlistentry>
10433 <varlistentry><term>Related Functions</term>
10434 <listitem><simplelist>
10435 <member><link linkend="COS">COS</link> </member>
10436 </simplelist></listitem>
10437 </varlistentry>
10438 </variablelist>
10439 </sect3>
10440
10441 <sect3 id="ACOSH">
10442 <title>ACOSH</title>
10443 <para>The ACOSH() function calculates the inverse hyperbolic cosine of x. That is the value whose hyperbolic cosine is x. If x is less than 1.0, acosh() returns not-a-number (NaN) and errno is set.</para>
10444 <para><segmentedlist><segtitle>Return type</segtitle>
10445 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10446 <variablelist>
10447 <varlistentry><term>Syntax</term>
10448 <listitem><para>ACOSH(Float)</para></listitem>
10449 </varlistentry>
10450 <varlistentry><term>Parameters</term>
10451 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10452 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10453 </varlistentry>
10454 <varlistentry><term>Examples</term>
10455 <listitem><para>ACOSH(5) equals 2.29243167</para></listitem>
10456 </varlistentry>
10457 <varlistentry><term>Examples</term>
10458 <listitem><para>ACOSH(0) equals NaN</para></listitem>
10459 </varlistentry>
10460 <varlistentry><term>Related Functions</term>
10461 <listitem><simplelist>
10462 <member><link linkend="COSH">COSH</link> </member>
10463 </simplelist></listitem>
10464 </varlistentry>
10465 </variablelist>
10466 </sect3>
10467
10468 <sect3 id="ACOT">
10469 <title>ACOT</title>
10470 <para>The ACOT() function returns the inverse cotangent of a number.</para>
10471 <para><segmentedlist><segtitle>Return type</segtitle>
10472 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10473 <variablelist>
10474 <varlistentry><term>Syntax</term>
10475 <listitem><para>ACOT(Float)</para></listitem>
10476 </varlistentry>
10477 <varlistentry><term>Parameters</term>
10478 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10479 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10480 </varlistentry>
10481 <varlistentry><term>Examples</term>
10482 <listitem><para>ACOT(0) equals 1.57079633</para></listitem>
10483 </varlistentry>
10484 </variablelist>
10485 </sect3>
10486
10487 <sect3 id="ASIN">
10488 <title>ASIN</title>
10489 <para>The ASIN() function returns the arc sine in radians and the value is mathematically defined to be -PI/2 to PI/2 (inclusive).</para>
10490 <para><segmentedlist><segtitle>Return type</segtitle>
10491 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10492 <variablelist>
10493 <varlistentry><term>Syntax</term>
10494 <listitem><para>ASIN(Float)</para></listitem>
10495 </varlistentry>
10496 <varlistentry><term>Parameters</term>
10497 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10498 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10499 </varlistentry>
10500 <varlistentry><term>Examples</term>
10501 <listitem><para>ASIN(0.8) equals 0.92729522</para></listitem>
10502 </varlistentry>
10503 <varlistentry><term>Examples</term>
10504 <listitem><para>ASIN(0) equals 0</para></listitem>
10505 </varlistentry>
10506 <varlistentry><term>Related Functions</term>
10507 <listitem><simplelist>
10508 <member><link linkend="SIN">SIN</link> </member>
10509 </simplelist></listitem>
10510 </varlistentry>
10511 </variablelist>
10512 </sect3>
10513
10514 <sect3 id="ASINH">
10515 <title>ASINH</title>
10516 <para>The ASINH() function calculates the inverse hyperbolic sine of x; that is the value whose hyperbolic sine is x.</para>
10517 <para><segmentedlist><segtitle>Return type</segtitle>
10518 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10519 <variablelist>
10520 <varlistentry><term>Syntax</term>
10521 <listitem><para>ASINH(Float)</para></listitem>
10522 </varlistentry>
10523 <varlistentry><term>Parameters</term>
10524 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10525 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10526 </varlistentry>
10527 <varlistentry><term>Examples</term>
10528 <listitem><para>ASINH(0.8) equals 0.73266826</para></listitem>
10529 </varlistentry>
10530 <varlistentry><term>Examples</term>
10531 <listitem><para>ASINH(0) equals 0</para></listitem>
10532 </varlistentry>
10533 <varlistentry><term>Related Functions</term>
10534 <listitem><simplelist>
10535 <member><link linkend="SINH">SINH</link> </member>
10536 </simplelist></listitem>
10537 </varlistentry>
10538 </variablelist>
10539 </sect3>
10540
10541 <sect3 id="ATAN">
10542 <title>ATAN</title>
10543 <para>The ATAN() function returns the arc tangent in radians and the value is mathematically defined to be -PI/2 to PI/2 (inclusive).</para>
10544 <para><segmentedlist><segtitle>Return type</segtitle>
10545 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10546 <variablelist>
10547 <varlistentry><term>Syntax</term>
10548 <listitem><para>ATAN(Float)</para></listitem>
10549 </varlistentry>
10550 <varlistentry><term>Parameters</term>
10551 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10552 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10553 </varlistentry>
10554 <varlistentry><term>Examples</term>
10555 <listitem><para>ATAN(0.8) equals 0.67474094</para></listitem>
10556 </varlistentry>
10557 <varlistentry><term>Examples</term>
10558 <listitem><para>ATAN(0) equals 0</para></listitem>
10559 </varlistentry>
10560 <varlistentry><term>Related Functions</term>
10561 <listitem><simplelist>
10562 <member><link linkend="TAN">TAN</link> </member>
10563 <member><link linkend="ATAN2">ATAN2</link> </member>
10564 </simplelist></listitem>
10565 </varlistentry>
10566 </variablelist>
10567 </sect3>
10568
10569 <sect3 id="ATAN2">
10570 <title>ATAN2</title>
10571 <para>This function calculates the arc tangent of the two variables x and y. It is similar to calculating the arc tangent of y/x, except that the signs of both arguments are used to determine the quadrant of the result.</para>
10572 <para><segmentedlist><segtitle>Return type</segtitle>
10573 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10574 <variablelist>
10575 <varlistentry><term>Syntax</term>
10576 <listitem><para>ATAN2(value;value)</para></listitem>
10577 </varlistentry>
10578 <varlistentry><term>Parameters</term>
10579 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10580 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem>
10581 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10582 </varlistentry>
10583 <varlistentry><term>Examples</term>
10584 <listitem><para>ATAN2(0.5;1.0) equals 1.107149</para></listitem>
10585 </varlistentry>
10586 <varlistentry><term>Examples</term>
10587 <listitem><para>ATAN2(-0.5;2.0) equals 1.815775</para></listitem>
10588 </varlistentry>
10589 <varlistentry><term>Related Functions</term>
10590 <listitem><simplelist>
10591 <member><link linkend="ATAN">ATAN</link> </member>
10592 </simplelist></listitem>
10593 </varlistentry>
10594 </variablelist>
10595 </sect3>
10596
10597 <sect3 id="ATANH">
10598 <title>ATANH</title>
10599 <para>The ATANH() function calculates the inverse hyperbolic tangent of x; that is the value whose hyperbolic tangent is x. If the absolute value of x is greater than 1.0, ATANH() returns not-a-number (NaN).</para>
10600 <para><segmentedlist><segtitle>Return type</segtitle>
10601 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10602 <variablelist>
10603 <varlistentry><term>Syntax</term>
10604 <listitem><para>ATANH(Float)</para></listitem>
10605 </varlistentry>
10606 <varlistentry><term>Parameters</term>
10607 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10608 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10609 </varlistentry>
10610 <varlistentry><term>Examples</term>
10611 <listitem><para>ATANH(0.8) equals 1.09861229</para></listitem>
10612 </varlistentry>
10613 <varlistentry><term>Examples</term>
10614 <listitem><para>ATANH(0) equals 0</para></listitem>
10615 </varlistentry>
10616 <varlistentry><term>Related Functions</term>
10617 <listitem><simplelist>
10618 <member><link linkend="TANH">TANH</link> </member>
10619 </simplelist></listitem>
10620 </varlistentry>
10621 </variablelist>
10622 </sect3>
10623
10624 <sect3 id="COS">
10625 <title>COS</title>
10626 <para>The COS() function returns the cosine of x, where x is given in radians.</para>
10627 <para><segmentedlist><segtitle>Return type</segtitle>
10628 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10629 <variablelist>
10630 <varlistentry><term>Syntax</term>
10631 <listitem><para>COS(Float)</para></listitem>
10632 </varlistentry>
10633 <varlistentry><term>Parameters</term>
10634 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10635 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10636 </varlistentry>
10637 <varlistentry><term>Examples</term>
10638 <listitem><para>COS(0) equals 1.0</para></listitem>
10639 </varlistentry>
10640 <varlistentry><term>Examples</term>
10641 <listitem><para>COS(PI()/2) equals 0</para></listitem>
10642 </varlistentry>
10643 <varlistentry><term>Related Functions</term>
10644 <listitem><simplelist>
10645 <member><link linkend="SIN">SIN</link> </member>
10646 <member><link linkend="ACOS">ACOS</link> </member>
10647 </simplelist></listitem>
10648 </varlistentry>
10649 </variablelist>
10650 </sect3>
10651
10652 <sect3 id="COSH">
10653 <title>COSH</title>
10654 <para>The COSH() function returns the hyperbolic cosine of x, which is defined mathematically as (exp(x) + exp(-x)) / 2.</para>
10655 <para><segmentedlist><segtitle>Return type</segtitle>
10656 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10657 <variablelist>
10658 <varlistentry><term>Syntax</term>
10659 <listitem><para>COSH(Float)</para></listitem>
10660 </varlistentry>
10661 <varlistentry><term>Parameters</term>
10662 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10663 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10664 </varlistentry>
10665 <varlistentry><term>Examples</term>
10666 <listitem><para>COSH(0.8) equals 1.33743495</para></listitem>
10667 </varlistentry>
10668 <varlistentry><term>Examples</term>
10669 <listitem><para>COSH(0) equals 1</para></listitem>
10670 </varlistentry>
10671 <varlistentry><term>Related Functions</term>
10672 <listitem><simplelist>
10673 <member><link linkend="ACOSH">ACOSH</link> </member>
10674 </simplelist></listitem>
10675 </varlistentry>
10676 </variablelist>
10677 </sect3>
10678
10679 <sect3 id="CSC">
10680 <title>CSC</title>
10681 <para>The CSC() function returns the cosecant of x, where x is given in radians.</para>
10682 <para><segmentedlist><segtitle>Return type</segtitle>
10683 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10684 <variablelist>
10685 <varlistentry><term>Syntax</term>
10686 <listitem><para>CSC(Float)</para></listitem>
10687 </varlistentry>
10688 <varlistentry><term>Parameters</term>
10689 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10690 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10691 </varlistentry>
10692 <varlistentry><term>Examples</term>
10693 <listitem><para>CSC(PI()/2) equals 1</para></listitem>
10694 </varlistentry>
10695 </variablelist>
10696 </sect3>
10697
10698 <sect3 id="CSCH">
10699 <title>CSCH</title>
10700 <para>The CSCH() function returns the hyperbolic cosecant of x, where x is given in radians.</para>
10701 <para><segmentedlist><segtitle>Return type</segtitle>
10702 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10703 <variablelist>
10704 <varlistentry><term>Syntax</term>
10705 <listitem><para>CSCH(Float)</para></listitem>
10706 </varlistentry>
10707 <varlistentry><term>Parameters</term>
10708 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10709 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10710 </varlistentry>
10711 <varlistentry><term>Examples</term>
10712 <listitem><para>CSCH(PI()/2) equals 0.434537208...</para></listitem>
10713 </varlistentry>
10714 </variablelist>
10715 </sect3>
10716
10717 <sect3 id="DEGREES">
10718 <title>DEGREES</title>
10719 <para>This function transforms a radian angle to a degree angle.</para>
10720 <para><segmentedlist><segtitle>Return type</segtitle>
10721 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10722 <variablelist>
10723 <varlistentry><term>Syntax</term>
10724 <listitem><para>DEGREES(Float)</para></listitem>
10725 </varlistentry>
10726 <varlistentry><term>Parameters</term>
10727 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10728 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10729 </varlistentry>
10730 <varlistentry><term>Examples</term>
10731 <listitem><para>DEGREES(0.78) equals 44.69</para></listitem>
10732 </varlistentry>
10733 <varlistentry><term>Examples</term>
10734 <listitem><para>DEGREES(1) equals 57.29</para></listitem>
10735 </varlistentry>
10736 <varlistentry><term>Related Functions</term>
10737 <listitem><simplelist>
10738 <member><link linkend="RADIANS">RADIANS</link> </member>
10739 </simplelist></listitem>
10740 </varlistentry>
10741 </variablelist>
10742 </sect3>
10743
10744 <sect3 id="PI">
10745 <title>PI</title>
10746 <para>The PI() function returns the value of PI.</para>
10747 <para><segmentedlist><segtitle>Return type</segtitle>
10748 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10749 <variablelist>
10750 <varlistentry><term>Syntax</term>
10751 <listitem><para>PI()</para></listitem>
10752 </varlistentry>
10753 <varlistentry><term>Parameters</term>
10754 <listitem><para></para></listitem>
10755 </varlistentry>
10756 <varlistentry><term>Examples</term>
10757 <listitem><para>PI() equals 3.141592654...</para></listitem>
10758 </varlistentry>
10759 </variablelist>
10760 </sect3>
10761
10762 <sect3 id="RADIANS">
10763 <title>RADIANS</title>
10764 <para>This function transforms a degree angle to a radian angle.</para>
10765 <para><segmentedlist><segtitle>Return type</segtitle>
10766 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10767 <variablelist>
10768 <varlistentry><term>Syntax</term>
10769 <listitem><para>RADIANS(Float)</para></listitem>
10770 </varlistentry>
10771 <varlistentry><term>Parameters</term>
10772 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10773 <seglistitem><seg>Angle (degrees)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10774 </varlistentry>
10775 <varlistentry><term>Examples</term>
10776 <listitem><para>RADIANS(75) equals 1.308</para></listitem>
10777 </varlistentry>
10778 <varlistentry><term>Examples</term>
10779 <listitem><para>RADIANS(90) equals 1.5707</para></listitem>
10780 </varlistentry>
10781 <varlistentry><term>Related Functions</term>
10782 <listitem><simplelist>
10783 <member><link linkend="DEGREES">DEGREES</link> </member>
10784 </simplelist></listitem>
10785 </varlistentry>
10786 </variablelist>
10787 </sect3>
10788
10789 <sect3 id="SEC">
10790 <title>SEC</title>
10791 <para>The SEC() function returns the secant of x, where x is given in radians.</para>
10792 <para><segmentedlist><segtitle>Return type</segtitle>
10793 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10794 <variablelist>
10795 <varlistentry><term>Syntax</term>
10796 <listitem><para>SEC(Float)</para></listitem>
10797 </varlistentry>
10798 <varlistentry><term>Parameters</term>
10799 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10800 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10801 </varlistentry>
10802 <varlistentry><term>Examples</term>
10803 <listitem><para>SEC(0) equals 1</para></listitem>
10804 </varlistentry>
10805 </variablelist>
10806 </sect3>
10807
10808 <sect3 id="SECH">
10809 <title>SECH</title>
10810 <para>The SECH() function returns the hyperbolic secant of x, where x is given in radians.</para>
10811 <para><segmentedlist><segtitle>Return type</segtitle>
10812 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10813 <variablelist>
10814 <varlistentry><term>Syntax</term>
10815 <listitem><para>SECH(Float)</para></listitem>
10816 </varlistentry>
10817 <varlistentry><term>Parameters</term>
10818 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10819 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10820 </varlistentry>
10821 <varlistentry><term>Examples</term>
10822 <listitem><para>SECH(0) equals 1</para></listitem>
10823 </varlistentry>
10824 </variablelist>
10825 </sect3>
10826
10827 <sect3 id="SIN">
10828 <title>SIN</title>
10829 <para>The SIN() function returns the sine of x, where x is given in radians.</para>
10830 <para><segmentedlist><segtitle>Return type</segtitle>
10831 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10832 <variablelist>
10833 <varlistentry><term>Syntax</term>
10834 <listitem><para>SIN(Float)</para></listitem>
10835 </varlistentry>
10836 <varlistentry><term>Parameters</term>
10837 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10838 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10839 </varlistentry>
10840 <varlistentry><term>Examples</term>
10841 <listitem><para>SIN(0) equals 0</para></listitem>
10842 </varlistentry>
10843 <varlistentry><term>Examples</term>
10844 <listitem><para>SIN(PI()/2) equals 1</para></listitem>
10845 </varlistentry>
10846 <varlistentry><term>Related Functions</term>
10847 <listitem><simplelist>
10848 <member><link linkend="COS">COS</link> </member>
10849 <member><link linkend="ASIN">ASIN</link> </member>
10850 </simplelist></listitem>
10851 </varlistentry>
10852 </variablelist>
10853 </sect3>
10854
10855 <sect3 id="SINH">
10856 <title>SINH</title>
10857 <para>The SINH() function returns the hyperbolic sine of x, which is defined mathematically as (exp(x) - exp(-x)) / 2.</para>
10858 <para><segmentedlist><segtitle>Return type</segtitle>
10859 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10860 <variablelist>
10861 <varlistentry><term>Syntax</term>
10862 <listitem><para>SINH(Float)</para></listitem>
10863 </varlistentry>
10864 <varlistentry><term>Parameters</term>
10865 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10866 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10867 </varlistentry>
10868 <varlistentry><term>Examples</term>
10869 <listitem><para>SINH(0.8) equals 0.88810598</para></listitem>
10870 </varlistentry>
10871 <varlistentry><term>Examples</term>
10872 <listitem><para>SINH(0) equals 0</para></listitem>
10873 </varlistentry>
10874 <varlistentry><term>Related Functions</term>
10875 <listitem><simplelist>
10876 <member><link linkend="ASINH">ASINH</link> </member>
10877 </simplelist></listitem>
10878 </varlistentry>
10879 </variablelist>
10880 </sect3>
10881
10882 <sect3 id="TAN">
10883 <title>TAN</title>
10884 <para>The TAN() function returns the tangent of x, where x is given in radians.</para>
10885 <para><segmentedlist><segtitle>Return type</segtitle>
10886 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10887 <variablelist>
10888 <varlistentry><term>Syntax</term>
10889 <listitem><para>TAN(Float)</para></listitem>
10890 </varlistentry>
10891 <varlistentry><term>Parameters</term>
10892 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10893 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10894 </varlistentry>
10895 <varlistentry><term>Examples</term>
10896
10897 <listitem><para>TAN(0.7) equals 0.84228838</para></listitem>
10898 </varlistentry>
10899 <varlistentry><term>Examples</term>
10900 <listitem><para>TAN(0) equals 0</para></listitem>
10901 </varlistentry>
10902 <varlistentry><term>Related Functions</term>
10903 <listitem><simplelist>
10904 <member><link linkend="ATAN">ATAN</link> </member>
10905 </simplelist></listitem>
10906 </varlistentry>
10907 </variablelist>
10908 </sect3>
10909
10910 <sect3 id="TANH">
10911 <title>TANH</title>
10912 <para>The TANH() function returns the hyperbolic tangent of x, which is defined mathematically as sinh(x)/cosh(x).</para>
10913 <para><segmentedlist><segtitle>Return type</segtitle>
10914 <seglistitem><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para>
10915 <variablelist>
10916 <varlistentry><term>Syntax</term>
10917 <listitem><para>TANH(Float)</para></listitem>
10918 </varlistentry>
10919 <varlistentry><term>Parameters</term>
10920 <listitem><para><segmentedlist><segtitle>Comment</segtitle><segtitle>Type</segtitle>
10921 <seglistitem><seg>Angle (radians)</seg><seg>A floating point value (like 1.3, 0.343, 253 )</seg></seglistitem></segmentedlist></para></listitem>
10922 </varlistentry>
10923 <varlistentry><term>Examples</term>
10924 <listitem><para>TANH(0.8) equals 0.66403677</para></listitem>
10925 </varlistentry>
10926 <varlistentry><term>Examples</term>
10927 <listitem><para>TANH(0) equals 0</para></listitem>
10928 </varlistentry>
10929 <varlistentry><term>Related Functions</term>
10930 <listitem><simplelist>
10931 <member><link linkend="ATANH">ATANH</link> </member>
10932 </simplelist></listitem>
10933 </varlistentry>
10934 </variablelist>
10935 </sect3>
10936
10937 </sect2>
10938 </sect1>
10939 </chapter>
10940
10941