diff options
Diffstat (limited to 'helpcontent2/source/text/scalc/01/04060106.xhp')
| -rw-r--r-- | helpcontent2/source/text/scalc/01/04060106.xhp | 1554 |
1 files changed, 1554 insertions, 0 deletions
diff --git a/helpcontent2/source/text/scalc/01/04060106.xhp b/helpcontent2/source/text/scalc/01/04060106.xhp new file mode 100644 index 000000000..753b9f131 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060106.xhp @@ -0,0 +1,1554 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0104060106xml" indexer="include"> + <title id="tit" xml-lang="en-US">Mathematical Functions</title> + <filename>/text/scalc/01/04060106.xhp</filename> + </topic> +</meta> + +<body> + +<bookmark xml-lang="en-US" branch="index" id="bm_id3147124"> + <bookmark_value>mathematical functions</bookmark_value> + <bookmark_value>Function Wizard; mathematical</bookmark_value> + <bookmark_value>functions; mathematical functions</bookmark_value> + <bookmark_value>trigonometric functions</bookmark_value> +</bookmark> + + +<h1 id="hd_id3147124"><variable id="math_functions_h1"><link href="text/scalc/01/04060106.xhp" name="math_link">Mathematical Functions</link></variable></h1> +<paragraph id="par_id3154943" role="paragraph" xml-lang="en-US"><variable id="mathematiktext">This category contains the <emph>Mathematical</emph> functions for Calc.</variable> To open the <emph>Function Wizard</emph>, choose <link href="text/scalc/01/04060000.xhp" name="Insert - Function"><emph>Insert - Function</emph></link>.</paragraph> +<sort order="asc" descendant="h2"> +<section id="Section1"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3146944"> + <bookmark_value>ABS function</bookmark_value> + <bookmark_value>absolute values</bookmark_value> + <bookmark_value>values;absolute</bookmark_value> +</bookmark> +<comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ABS" id="bm_id3150695" localize="false"/> + +<h2 id="hd_id3146944">ABS</h2> +<paragraph id="par_id3154546" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ABS">Returns the absolute value of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147475" role="code" xml-lang="en-US">ABS(Number)</paragraph> +<paragraph id="par_id3148438" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number whose absolute value is to be calculated. The absolute value of a number is its value without the +/- sign.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152787" role="paragraph" xml-lang="en-US"><item type="input">=ABS(-56)</item> returns 56.</paragraph> +<paragraph id="par_id3148752" role="paragraph" xml-lang="en-US"><item type="input">=ABS(12)</item> returns 12.</paragraph> +<paragraph id="par_id320139" role="paragraph" xml-lang="en-US"><item type="input">=ABS(0)</item> returns 0.<comment>see also SIGN</comment></paragraph> +</section> + +<section id="Section61"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153114"> + <bookmark_value>ACOS function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCCOS" id="bm_id3155952" localize="false"/> + +<h2 id="hd_id3153114">ACOS</h2> +<paragraph id="par_id3145163" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCCOS">Returns the inverse trigonometric cosine of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150020" role="code" xml-lang="en-US">ACOS(Number)</paragraph> +<paragraph id="par_id3159134" role="paragraph" xml-lang="en-US">This function returns the inverse trigonometric cosine of <emph>Number</emph>, that is the angle (in radians) whose cosine is Number. The angle returned is between 0 and PI.</paragraph> +<paragraph id="par_id679647" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150128" role="paragraph" xml-lang="en-US"><item type="input">=ACOS(-1)</item> returns 3.14159265358979 (PI radians)</paragraph> +<paragraph id="par_id8792382" role="paragraph" xml-lang="en-US"><item type="input">=DEGREES(ACOS(0.5))</item> returns 60. The cosine of 60 degrees is 0.5.</paragraph><comment>see also COS, SIN, TAN, COT, ASIN, ATAN, ATAN2, ACOT</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section60"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145355"> + <bookmark_value>ACOSH function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCOSHYP" id="bm_id3148386" localize="false"/> + +<h2 id="hd_id3145355">ACOSH</h2> +<paragraph id="par_id3157993" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCOSHYP">Returns the inverse hyperbolic cosine of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3151017" role="code" xml-lang="en-US">ACOSH(Number)</paragraph> +<paragraph id="par_id3149000" role="paragraph" xml-lang="en-US">This function returns the inverse hyperbolic cosine of <emph>Number</emph>, that is the number whose hyperbolic cosine is Number.</paragraph> +<paragraph id="par_id6393932" role="paragraph" xml-lang="en-US">Number must be greater than or equal to 1.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145629" role="paragraph" xml-lang="en-US"><item type="input">=ACOSH(1)</item> returns 0.</paragraph> +<paragraph id="par_id951567" role="paragraph" xml-lang="en-US"><item type="input">=ACOSH(COSH(4))</item> returns 4.</paragraph><comment>see also ASINH, ATANH, ACOTH, COSH, SINH, TANH, COTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section59"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149027"> + <bookmark_value>ACOT function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCCOT" id="bm_id3154634" localize="false"/> + +<h2 id="hd_id3149027">ACOT</h2> +<paragraph id="par_id3155818" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCCOT">Returns the inverse cotangent (the arccotangent) of the given number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3158419" role="code" xml-lang="en-US">ACOT(Number)</paragraph> +<paragraph id="par_id3154948" role="paragraph" xml-lang="en-US">This function returns the inverse trigonometric cotangent of <emph>Number</emph>, that is the angle (in radians) whose cotangent is Number. The angle returned is between 0 and PI.</paragraph> +<paragraph id="par_id5834528" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3155375" role="paragraph" xml-lang="en-US"><item type="input">=ACOT(1)</item> returns 0.785398163397448 (PI/4 radians).</paragraph> +<paragraph id="par_id8589434" role="paragraph" xml-lang="en-US"><item type="input">=DEGREES(ACOT(1))</item> returns 45. The tangent of 45 degrees is 1.</paragraph><comment>see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN, ATAN2</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section58"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148426"> + <bookmark_value>ACOTH function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCOTHYP" id="bm_id3149777" localize="false"/> + +<h2 id="hd_id3148426">ACOTH</h2> +<paragraph id="par_id3147478" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCOTHYP">Returns the inverse hyperbolic cotangent of the given number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147172" role="code" xml-lang="en-US">ACOTH(Number)</paragraph> +<paragraph id="par_id3146155" role="paragraph" xml-lang="en-US">This function returns the inverse hyperbolic cotangent of <emph>Number</emph>, that is the number whose hyperbolic cotangent is Number.</paragraph> +<paragraph id="par_id5818659" role="paragraph" xml-lang="en-US">An error results if Number is between -1 and 1 inclusive.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150608" role="paragraph" xml-lang="en-US"><item type="input">=ACOTH(1.1)</item> returns inverse hyperbolic cotangent of 1.1, approximately 1.52226.</paragraph><comment>see also ACOSH, ASINH, ATANH, COSH, SINH, TANH, COTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="aggregate"> + +<h2 id="hd_id7145084" localize="false"><embedvar href="text/scalc/01/func_aggregate.xhp#aggregate_head"/></h2> +<paragraph id="par_id323373151810412" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/func_aggregate.xhp#aggregate_des"/></paragraph> +</section> + +<section id="Section57"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145084"> + <bookmark_value>ASIN function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCSIN" id="bm_id3149280" localize="false"/> + +<h2 id="hd_id3145084">ASIN</h2> +<paragraph id="par_id3156296" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCSIN">Returns the inverse trigonometric sine of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3156305" role="code" xml-lang="en-US">ASIN(Number)</paragraph> +<paragraph id="par_id3150964" role="paragraph" xml-lang="en-US">This function returns the inverse trigonometric sine of <emph>Number</emph>, that is the angle (in radians) whose sine is Number. The angle returned is between -PI/2 and +PI/2.</paragraph> +<paragraph id="par_id203863" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156100" role="paragraph" xml-lang="en-US"><item type="input">=ASIN(0)</item> returns 0.</paragraph> +<paragraph id="par_id6853846" role="paragraph" xml-lang="en-US"><item type="input">=ASIN(1)</item> returns 1.5707963267949 (PI/2 radians).</paragraph> +<paragraph id="par_id8772240" role="paragraph" xml-lang="en-US"><item type="input">=DEGREES(ASIN(0.5))</item> returns 30. The sine of 30 degrees is 0.5.</paragraph><comment>see also COS, SIN, TAN, COT, ACOS, ATAN, ATAN2, ACOT</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section56"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151266"> + <bookmark_value>ASINH function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARSINHYP" id="bm_id3145206" localize="false"/> + +<h2 id="hd_id3151266">ASINH</h2> +<paragraph id="par_id3147077" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARSINHYP">Returns the inverse hyperbolic sine of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150882" role="code" xml-lang="en-US">ASINH(Number)</paragraph> +<paragraph id="par_id3147621" role="paragraph" xml-lang="en-US">This function returns the inverse hyperbolic sine of <emph>Number</emph>, that is the number whose hyperbolic sine is Number.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156120" role="paragraph" xml-lang="en-US"><item type="input">=ASINH(-90)</item> returns approximately -5.1929877.</paragraph> +<paragraph id="par_id4808496" role="paragraph" xml-lang="en-US"><item type="input">=ASINH(SINH(4))</item> returns 4.</paragraph><comment>see also ACOSH, ATANH, ACOTH, COSH, SINH, TANH, COTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section55"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155996"> + <bookmark_value>ATAN function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCTAN" id="bm_id3154743" localize="false"/> + +<h2 id="hd_id3155996">ATAN</h2> +<paragraph id="par_id3149985" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCTAN">Returns the inverse trigonometric tangent of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150261" role="code" xml-lang="en-US">ATAN(Number)</paragraph> +<paragraph id="par_id3147267" role="paragraph" xml-lang="en-US">This function returns the inverse trigonometric tangent of <emph>Number</emph>, that is the angle (in radians) whose tangent is Number. The angle returned is between -PI/2 and PI/2.</paragraph> +<paragraph id="par_id6293527" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3143229" role="paragraph" xml-lang="en-US"><item type="input">=ATAN(1)</item> returns 0.785398163397448 (PI/4 radians).</paragraph> +<paragraph id="par_id8746299" role="paragraph" xml-lang="en-US"><item type="input">=DEGREES(ATAN(1))</item> returns 45. The tangent of 45 degrees is 1.</paragraph><comment>see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN2, ACOT</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section54"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153983"> + <bookmark_value>ATAN2 function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCTAN2" id="bm_id3159180" localize="false"/> + +<h2 id="hd_id3153983">ATAN2</h2> +<paragraph id="par_id3154297" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCTAN2">Returns the angle (in radians) between the x-axis and a line from the origin to the point (NumberX|NumberY).</ahelp></paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3156013" role="code" xml-lang="en-US">ATAN2(NumberX; NumberY)</paragraph> +<paragraph id="par_id3001800" role="paragraph" xml-lang="en-US"><emph>NumberX</emph> is the value of the x coordinate.</paragraph> +<paragraph id="par_id3152798" role="paragraph" xml-lang="en-US"><emph>NumberY</emph> is the value of the y coordinate.</paragraph> +<tip id="par_id5036168">Programming languages have usually the opposite order of arguments for their atan2() function.</tip> +<paragraph id="par_id5036165" role="paragraph" xml-lang="en-US">ATAN2 returns the angle (in radians) between the x-axis and a line from the origin to the point (NumberX|NumberY)</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154692" role="paragraph" xml-lang="en-US"><item type="input">=ATAN2(-5;9)</item> returns 2.07789 radians.</paragraph> + +<paragraph id="par_id5036166" role="paragraph" xml-lang="en-US">To get the angle in degrees apply the DEGREES function to the result.</paragraph> +<paragraph id="par_id1477095" role="paragraph" xml-lang="en-US"><input>=DEGREES(ATAN2(12.3;12.3))</input> returns 45. The tangent of 45 degrees is 1.</paragraph><comment>see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN, ACOT</comment> +<note id="par_id5036167">%PRODUCTNAME results 0 for ATAN2(0;0).</note> + +<paragraph id="par_id5036169" role="paragraph" xml-lang="en-US">The function can be used in converting cartesian coordinates to polar coordinates.</paragraph> +<paragraph id="par_id5036170" role="paragraph" xml-lang="en-US">=DEGREES(ATAN2(-8;5)) returns φ = 147.9 degrees</paragraph> +<paragraph role="paragraph" id="par_id5036171" xml-lang="en-US"> +<image id="img_id3150758" src="media/helpimg/scalc/coordinates-to-polar-01.svg" width="2.5inch" height="1.5inch"><alt id="alt_id3150758" xml-lang="en-US">Cartesian coordinates to polar coordinates example</alt></image> +</paragraph> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section53"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155398"> + <bookmark_value>ATANH function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARTANHYP" id="bm_id3154939" localize="false"/> + +<h2 id="hd_id3155398">ATANH</h2> +<paragraph id="par_id3148829" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARTANHYP">Returns the inverse hyperbolic tangent of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149912" role="code" xml-lang="en-US">ATANH(Number)</paragraph> +<paragraph id="par_id3150521" role="paragraph" xml-lang="en-US">This function returns the inverse hyperbolic tangent of <emph>Number</emph>, that is the number whose hyperbolic tangent is Number.</paragraph> +<paragraph id="par_id9357280" role="paragraph" xml-lang="en-US">Number must obey the condition -1 < number < 1.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145419" role="paragraph" xml-lang="en-US"><item type="input">=ATANH(0)</item> returns 0.</paragraph><comment>see also ACOSH, ASINH, ACOTH, COSH, SINH, TANH, COTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section52"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153062"> + <bookmark_value>COS function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COS" id="bm_id3158408" localize="false"/> + +<h2 id="hd_id3153062">COS</h2> +<paragraph id="par_id3148803" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COS">Returns the cosine of the given angle (in radians).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154213" role="code" xml-lang="en-US">COS(Number)</paragraph> +<paragraph id="par_id3154285" role="paragraph" xml-lang="en-US">Returns the (trigonometric) cosine of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph id="par_id831019" role="paragraph" xml-lang="en-US">To return the cosine of an angle in degrees, use the RADIANS function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3147241" role="paragraph" xml-lang="en-US"><item type="input">=COS(PI()*2)</item> returns 1, the cosine of 2*PI radians.</paragraph> +<paragraph id="par_id3147516" role="paragraph" xml-lang="en-US"><item type="input">=COS(RADIANS(60))</item> returns 0.5, the cosine of 60 degrees.</paragraph><comment>see also SIN, TAN, COT, ACOS, ASIN, ATAN, ATAN2, ACOT</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section51"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154277"> + <bookmark_value>COSH function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COSHYP" id="bm_id3149158" localize="false"/> + +<h2 id="hd_id3154277">COSH</h2> +<paragraph id="par_id3146946" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COSHYP">Returns the hyperbolic cosine of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3166440" role="code" xml-lang="en-US">COSH(Number)</paragraph> +<paragraph id="par_id3150710" role="paragraph" xml-lang="en-US">Returns the hyperbolic cosine of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154099" role="paragraph" xml-lang="en-US"><item type="input">=COSH(0)</item> returns 1, the hyperbolic cosine of 0.</paragraph><comment>see also SINH, TANH, COTH, ACOSH, ASINH, ATANH, ACOTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section50"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152888"> + <bookmark_value>COT function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COT" id="bm_id3153392" localize="false"/> + +<h2 id="hd_id3152888">COT</h2> +<paragraph id="par_id3153679" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COT">Returns the cotangent of the given angle (in radians).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154856" role="code" xml-lang="en-US">COT(Number)</paragraph> +<paragraph id="par_id3149969" role="paragraph" xml-lang="en-US">Returns the (trigonometric) cotangent of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph id="par_id3444624" role="paragraph" xml-lang="en-US">To return the cotangent of an angle in degrees, use the RADIANS function.</paragraph> +<paragraph id="par_id6814477" role="paragraph" xml-lang="en-US">The cotangent of an angle is equivalent to 1 divided by the tangent of that angle.</paragraph> + +<h3 id="hd_id3149800">Examples:</h3> +<paragraph id="par_id3148616" role="paragraph" xml-lang="en-US"><item type="input">=COT(PI()/4)</item> returns 1, the cotangent of PI/4 radians.</paragraph> +<paragraph id="par_id3148986" role="paragraph" xml-lang="en-US"><item type="input">=COT(RADIANS(45))</item> returns 1, the cotangent of 45 degrees.</paragraph><comment>see also COS, SIN, TAN, ACOS, ASIN, ATAN, ATAN2, ACOT</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section49"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154337"> + <bookmark_value>COTH function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COTHYP" id="bm_id3148650" localize="false"/> + +<h2 id="hd_id3154337">COTH</h2> +<paragraph id="par_id3149419" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COTHYP">Returns the hyperbolic cotangent of a given number (angle).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3143280" role="code" xml-lang="en-US">COTH(Number)</paragraph> +<paragraph id="par_id3154799" role="paragraph" xml-lang="en-US">Returns the hyperbolic cotangent of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3144754" role="paragraph" xml-lang="en-US"><item type="input">=COTH(1)</item> returns the hyperbolic cotangent of 1, approximately 1.3130.</paragraph><comment>see also COSH, SINH, TANH, ACOSH, ASINH, ATANH, ACOTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section64"> +<bookmark xml-lang="en-US" branch="index" id="bm_id6110552"> + <bookmark_value>CSC function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COSECANT" id="bm_id5645316" localize="false"/> + +<h2 id="hd_id9523234">CSC</h2> +<paragraph id="par_id4896433" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COSECANT">Returns the cosecant of the given angle (in radians). The cosecant of an angle is equivalent to 1 divided by the sine of that angle</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id4571344" role="code" xml-lang="en-US">CSC(Number)</paragraph> +<paragraph id="par_id9859164" role="paragraph" xml-lang="en-US">Returns the (trigonometric) cosecant of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph id="par_id3428494" role="paragraph" xml-lang="en-US">To return the cosecant of an angle in degrees, use the RADIANS function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3736803" role="paragraph" xml-lang="en-US"><item type="input">=CSC(PI()/4)</item> returns approximately 1.4142135624, the inverse of the sine of PI/4 radians.</paragraph> +<paragraph id="par_id6016818" role="paragraph" xml-lang="en-US"><item type="input">=CSC(RADIANS(30))</item> returns 2, the cosecant of 30 degrees.</paragraph><comment>see also SIN, TAN, COT, SEC, ACOS, ASIN, ATAN, ATAN2, ACOT</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section66"> +<bookmark xml-lang="en-US" branch="index" id="bm_id9288877"> + <bookmark_value>CSCH function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COSECANTHYP" id="bm_id9532490" localize="false"/> + +<h2 id="hd_id4325650">CSCH</h2> +<paragraph id="par_id579916" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COSECANTHYP">Returns the hyperbolic cosecant of a number.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3108851" role="code" xml-lang="en-US">CSCH(Number)</paragraph> +<paragraph id="par_id1394188" role="paragraph" xml-lang="en-US">Returns the hyperbolic cosecant of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id5426085" role="paragraph" xml-lang="en-US"><item type="input">=CSCH(1)</item> returns approximately 0.8509181282, the hyperbolic cosecant of 1.</paragraph><comment>see also SINH, TANH, COTH, SECH,ACOSH, ASINH, ATANH, ACOTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section48"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145314"> + <bookmark_value>DEGREES function</bookmark_value> + <bookmark_value>converting;radians, into degrees</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DEG" id="bm_id3153946" localize="false"/> + +<h2 id="hd_id3145314">DEGREES</h2> +<paragraph id="par_id3149939" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_DEG">Converts radians into degrees.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3145600" role="code" xml-lang="en-US">DEGREES(Number)</paragraph> +<paragraph id="par_id3149484" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the angle in radians to be converted to degrees.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3459578" role="paragraph" xml-lang="en-US"><item type="input">=DEGREES(PI())</item> returns 180 degrees.</paragraph><comment>see also RADIANS</comment> +</section> + +<section id="Section47"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148698"> + <bookmark_value>EXP function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_EXP" id="bm_id3154625" localize="false"/> + +<h2 id="hd_id3148698">EXP</h2> +<paragraph id="par_id3150592" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_EXP">Returns <literal>e</literal> raised to the power of a number.</ahelp> The constant <literal>e</literal> has a value of approximately 2.71828182845904.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3146786" role="code" xml-lang="en-US">EXP(Number)</paragraph> +<paragraph id="par_id3155608" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the power to which e is to be raised.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156340" role="paragraph" xml-lang="en-US"><item type="input">=EXP(1)</item> returns 2.71828182845904, the mathematical constant <literal>e</literal> to Calc's accuracy.</paragraph><comment>see also POWER, LN</comment> +</section> + +<section id="Section46"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145781"> + <bookmark_value>FACT function</bookmark_value> + <bookmark_value>factorials;numbers</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FAKULTAET" id="bm_id3153886" localize="false"/> + +<h2 id="hd_id3145781">FACT</h2> +<paragraph id="par_id3151109" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FAKULTAET">Returns the factorial of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154661" role="code" xml-lang="en-US">FACT(Number)</paragraph> +<paragraph id="par_id3152952" role="paragraph" xml-lang="en-US">Returns Number!, the factorial of <emph>Number</emph>, calculated as 1*2*3*4* ... * Number.</paragraph> +<paragraph id="par_id3834650" role="paragraph" xml-lang="en-US">=FACT(0) returns 1 by definition.</paragraph> +<paragraph id="par_id8429517" role="paragraph" xml-lang="en-US">The factorial of a negative number returns the "invalid argument" error.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154476" role="paragraph" xml-lang="en-US"><item type="input">=FACT(3)</item> returns 6.</paragraph> +<paragraph id="par_id3147525" role="paragraph" xml-lang="en-US"><item type="input">=FACT(0)</item> returns 1.</paragraph><comment>see also FACTDOUBLE, MULTINOMIAL, PRODUCT</comment> +</section> + +<section id="Section45"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159084"> + <bookmark_value>INT function</bookmark_value> + <bookmark_value>numbers;rounding down to next integer</bookmark_value> + <bookmark_value>rounding;down to next integer</bookmark_value> +</bookmark> +<comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GANZZAHL" id="bm_id3151311" localize="false"/> + +<h2 id="hd_id3159084">INT</h2> +<paragraph id="par_id3158441" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GANZZAHL">Rounds a number down to the nearest integer.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3156146" role="code" xml-lang="en-US">INT(Number)</paragraph> +<paragraph id="par_id3154117" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded down to the nearest integer.</paragraph> +<paragraph id="par_id153508" role="paragraph" xml-lang="en-US">Negative numbers round down to the integer below.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156267" role="paragraph" xml-lang="en-US"><item type="input">=INT(5.7)</item> returns 5.</paragraph> +<paragraph id="par_id3147323" role="paragraph" xml-lang="en-US"><item type="input">=INT(-1.3)</item> returns -2.</paragraph><comment>see also TRUNC, ROUND, ROUNDDOWN, ROUNDUP, CEILING, FLOOR, EVEN, ODD, MROUND</comment> +</section> + +<section id="Section44"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150938"> + <bookmark_value>EVEN function</bookmark_value> + <bookmark_value>numbers;rounding up/down to even integers</bookmark_value> + <bookmark_value>rounding;up/down to even integers</bookmark_value> +</bookmark> +<comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GERADE" id="bm_id3150949" localize="false"/> + +<h2 id="hd_id3150938">EVEN</h2> +<paragraph id="par_id3149988" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GERADE">Rounds a positive number up to the next even integer and a negative number down to the next even integer.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150830" role="code" xml-lang="en-US">EVEN(Number)</paragraph> +<paragraph id="par_id3153350" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded to the next even integer up, away from zero.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154361" role="paragraph" xml-lang="en-US"><item type="input">=EVEN(2.3)</item> returns 4.</paragraph> +<paragraph id="par_id8477736" role="paragraph" xml-lang="en-US"><item type="input">=EVEN(2)</item> returns 2.</paragraph> +<paragraph id="par_id159611" role="paragraph" xml-lang="en-US"><item type="input">=EVEN(0)</item> returns 0.</paragraph> +<paragraph id="par_id6097598" role="paragraph" xml-lang="en-US"><item type="input">=EVEN(-0.5)</item> returns -2.</paragraph><comment>see also CEILING, FLOOR, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> +</section> + +<section id="Section43"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147356"> + <bookmark_value>GCD function</bookmark_value> + <bookmark_value>greatest common divisor</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GGT" id="bm_id3149737" localize="false"/> + +<h2 id="hd_id3147356">GCD</h2> +<paragraph id="par_id3152465" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GGT">Returns the greatest common divisor of two or more integers.</ahelp></paragraph> +<paragraph id="par_id2769249" role="paragraph" xml-lang="en-US">The greatest common divisor is the positive largest integer which will divide, without remainder, each of the given integers.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154524" role="code" xml-lang="en-US">GCD(<embedvar href="text/scalc/01/ful_func.xhp#integer255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#integer255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3151285" role="paragraph" xml-lang="en-US"><item type="input">=GCD(16;32;24) </item>gives the result 8, because 8 is the largest number that can divide 16, 24 and 32 without a remainder.</paragraph> +<paragraph id="par_id1604663" role="paragraph" xml-lang="en-US"><item type="input">=GCD(B1:B3)</item> where cells B1, B2, B3 contain <item type="input">9</item>, <item type="input">12</item>, <item type="input">9</item> gives 3.</paragraph> +</section> + +<section id="Section42"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151221"> + <bookmark_value>GCD_EXCEL2003 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_GCD" id="bm_id3147578" localize="false"/> +<h2 id="hd_id3151221">GCD_EXCEL2003</h2> +<paragraph id="par_id3153257" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_GCD">The result is the greatest common divisor of a list of numbers.</ahelp></paragraph> +<embed href="text/scalc/01/04060102.xhp#ADD_note"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3156205" role="code" xml-lang="en-US">GCD_EXCEL2003(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3159192" role="paragraph" xml-lang="en-US"><item type="input">=GCD_EXCEL2003(5;15;25)</item> returns 5.</paragraph> +</section> + +<section id="Section39"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145213"> + <bookmark_value>LCM function</bookmark_value> + <bookmark_value>least common multiples</bookmark_value> + <bookmark_value>lowest common multiples</bookmark_value> +</bookmark> +<comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KGV" id="bm_id3145225" localize="false"/> + +<h2 id="hd_id3145213">LCM</h2> +<paragraph id="par_id3146814" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KGV">Returns the least common multiple of one or more integers.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147279" role="code" xml-lang="en-US">LCM(<embedvar href="text/scalc/01/ful_func.xhp#integer255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#integer255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154914" role="paragraph" xml-lang="en-US">If you enter the numbers 512; 1024 and 2000 as Integer 1;2 and 3, then 128000 will be returned.</paragraph> +</section> + +<section id="Section38"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154230"> + <bookmark_value>LCM_EXCEL2003 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_LCM" id="bm_id3147222" localize="false"/> +<h2 id="hd_id3154230">LCM_EXCEL2003</h2> +<paragraph id="par_id3149036" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_LCM">The result is the lowest common multiple of a list of numbers.</ahelp></paragraph> +<embed href="text/scalc/01/04060102.xhp#ADD_note"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154395" role="code" xml-lang="en-US">LCM_EXCEL2003(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145135" role="paragraph" xml-lang="en-US"><item type="input">=LCM_EXCEL2003(5;15;25)</item> returns 75.</paragraph> +</section> + +<section id="Section37"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155802"> + <bookmark_value>COMBIN function</bookmark_value> + <bookmark_value>number of combinations</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KOMBINATIONEN" id="bm_id3155077" localize="false"/><comment>should be statistical-->add a link there</comment> + +<h2 id="hd_id3155802">COMBIN</h2> +<paragraph id="par_id3156172" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KOMBINATIONEN">Returns the number of combinations for elements without repetition.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150223" role="code" xml-lang="en-US">COMBIN(Count1; Count2)</paragraph> +<paragraph id="par_id3150313" role="paragraph" xml-lang="en-US"><emph>Count1</emph> is the number of items in the set.</paragraph> +<paragraph id="par_id3153830" role="paragraph" xml-lang="en-US"><emph>Count2</emph> is the number of items to choose from the set.</paragraph> +<paragraph id="par_id6807458" role="paragraph" xml-lang="en-US">COMBIN returns the number of ordered ways to choose these items. For example if there are 3 items A, B and C in a set, you can choose 2 items in 3 different ways, namely AB, AC and BC.</paragraph> +<paragraph id="par_id7414471" role="paragraph" xml-lang="en-US">COMBIN implements the formula: Count1!/(Count2!*(Count1-Count2)!)</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3153517" role="paragraph" xml-lang="en-US"><item type="input">=COMBIN(3;2)</item> returns 3.</paragraph><comment>see also COMBINA</comment> +</section> + +<section id="Section36"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150284"> + <bookmark_value>COMBINA function</bookmark_value> + <bookmark_value>number of combinations with repetitions</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KOMBINATIONEN2" id="bm_id3150295" localize="false"/><comment>should be statistical-->add a link there</comment> + +<h2 id="hd_id3150284">COMBINA</h2> +<paragraph id="par_id3157894" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KOMBINATIONEN2">Returns the number of combinations of a subset of items including repetitions.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3145765" role="code" xml-lang="en-US">COMBINA(Count1; Count2)</paragraph> +<paragraph id="par_id3153372" role="paragraph" xml-lang="en-US"><emph>Count1</emph> is the number of items in the set.</paragraph> +<paragraph id="par_id3155544" role="paragraph" xml-lang="en-US"><emph>Count2</emph> is the number of items to choose from the set.</paragraph> +<paragraph id="par_id1997131" role="paragraph" xml-lang="en-US">COMBINA returns the number of unique ways to choose these items, where the order of choosing is irrelevant, and repetition of items is allowed. For example if there are 3 items A, B and C in a set, you can choose 2 items in 6 different ways, namely AA, AB, AC, BB, BC and CC.</paragraph> +<paragraph id="par_id2052064" role="paragraph" xml-lang="en-US">COMBINA implements the formula: (Count1+Count2-1)! / (Count2!(Count1-1)!)<comment>i88052</comment></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152904" role="paragraph" xml-lang="en-US"><item type="input">=COMBINA(3;2)</item> returns 6.</paragraph><comment>see also COMBIN</comment> +</section> + +<section id="trunc"> + <h2 id="hd_id561641930400206"><link href="text/scalc/01/func_trunc.xhp" name="trunc_link">TRUNC</link></h2> + <embed href="text/scalc/01/func_trunc.xhp#trunc_desc"/> +</section> + +<section id="Section34"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153601"> + <bookmark_value>LN function</bookmark_value> + <bookmark_value>natural logarithm</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LN" id="bm_id3153613" localize="false"/> + +<h2 id="hd_id3153601">LN</h2> +<paragraph id="par_id3154974" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LN">Returns the natural logarithm based on the constant e of a number.</ahelp> The constant e has a value of approximately 2.71828182845904.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3155284" role="code" xml-lang="en-US">LN(Number)</paragraph> +<paragraph id="par_id3155297" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value whose natural logarithm is to be calculated.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3153866" role="paragraph" xml-lang="en-US"><item type="input">=LN(3)</item> returns the natural logarithm of 3 (approximately 1.0986).</paragraph> +<paragraph id="par_id5747245" role="paragraph" xml-lang="en-US"><item type="input">=LN(EXP(321))</item> returns 321.</paragraph><comment>see also LOG, LOG10, EXP</comment> +</section> + +<section id="Section33"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3109813"> + <bookmark_value>LOG function</bookmark_value> + <bookmark_value>logarithms</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOG" id="bm_id3109824" localize="false"/> + +<h2 id="hd_id3109813">LOG</h2> +<paragraph id="par_id3109841" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LOG">Returns the logarithm of a number to the specified base.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3144732" role="code" xml-lang="en-US">LOG(Number [; Base])</paragraph> +<paragraph id="par_id3144746" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value whose logarithm is to be calculated.</paragraph> +<paragraph id="par_id3152840" role="paragraph" xml-lang="en-US"><emph>Base</emph> (optional) is the base for the logarithm calculation. If omitted, Base 10 is assumed.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154429" role="paragraph" xml-lang="en-US"><item type="input">=LOG(10;3)</item> returns the logarithm to base 3 of 10 (approximately 2.0959).</paragraph> +<paragraph id="par_id5577562" role="paragraph" xml-lang="en-US"><item type="input">=LOG(7^4;7)</item> returns 4.</paragraph><comment>see also LOG10, LN, POWER</comment> +</section> + +<section id="Section32"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154187"> + <bookmark_value>LOG10 function</bookmark_value> + <bookmark_value>base-10 logarithm</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOG10" id="bm_id3155460" localize="false"/> + +<h2 id="hd_id3154187">LOG10</h2> +<paragraph id="par_id3155476" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LOG10">Returns the base-10 logarithm of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3159294" role="code" xml-lang="en-US">LOG10(Number)</paragraph> +<paragraph id="par_id3159308" role="paragraph" xml-lang="en-US">Returns the logarithm to base 10 of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3157916" role="paragraph" xml-lang="en-US"><item type="input">=LOG10(5)</item> returns the base-10 logarithm of 5 (approximately 0.69897).</paragraph><comment>see also LOG, LN, POWER</comment> +</section> + + +<section id="Section30"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157762"> + <bookmark_value>PI function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_PI" id="bm_id3157774" localize="false"/> + +<h2 id="hd_id3157762">PI</h2> +<paragraph id="par_id3157790" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_PI">Returns 3.14159265358979, the value of the mathematical constant PI to 14 decimal places.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3157822" role="code" xml-lang="en-US">PI()</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152370" role="paragraph" xml-lang="en-US"><item type="input">=PI()</item> returns 3.14159265358979.</paragraph> +</section> + +<section id="Section29"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152418"> + <bookmark_value>MULTINOMIAL function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_MULTINOMIAL" id="bm_id3152429" localize="false"/> +<h2 id="hd_id3152418">MULTINOMIAL</h2> +<paragraph id="par_id3152454" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_MULTINOMIAL">Returns the factorial of the sum of the arguments divided by the product of the factorials of the arguments.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3155660" role="code" xml-lang="en-US">MULTINOMIAL(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3155701" role="paragraph" xml-lang="en-US"><item type="input">=MULTINOMIAL(F11:H11)</item> returns 1260, if F11 to H11 contain the values <item type="input">2</item>, <item type="input">3</item> and <item type="input">4</item>. This corresponds to the formula =(2+3+4)! / (2!*3!*4!)</paragraph> +</section> + +<section id="Section28"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155717"> + <bookmark_value>POWER function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_POTENZ" id="bm_id3155728" localize="false"/> + +<h2 id="hd_id3155717">POWER</h2> +<paragraph id="par_id3159495" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_POTENZ">Returns a number raised to another number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3159526" role="code" xml-lang="en-US">POWER(Base; Exponent)</paragraph> +<paragraph id="par_id3159540" role="paragraph" xml-lang="en-US">Returns <emph>Base</emph> raised to the power of <emph>Exponent</emph>.</paragraph> +<paragraph id="par_id5081637" role="paragraph" xml-lang="en-US">The same result may be achieved by using the exponentiation operator ^:</paragraph> +<paragraph id="par_id9759514" role="code" xml-lang="en-US"><item type="literal">Base^Exponent</item></paragraph> +<note id="par_id241599040594931"><literal>=POWER(0,0)</literal> returns 1.</note> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3159594" role="paragraph" xml-lang="en-US"><item type="input">=POWER(4;3)</item> returns 64, which is 4 to the power of 3.</paragraph> +<paragraph id="par_id1614429" role="paragraph" xml-lang="en-US">=4^3 also returns 4 to the power of 3.</paragraph><comment>see also EXP, LOG, SQRT</comment> +</section> + +<section id="Section27"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152651"> + <bookmark_value>SERIESSUM function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_SERIESSUM" id="bm_id3152662" localize="false"/> + +<h2 id="hd_id3152651">SERIESSUM</h2> +<paragraph id="par_id3152688" role="paragraph" xml-lang="en-US"><ahelp hid=".">Sums the first terms of a power series.</ahelp></paragraph> +<paragraph id="par_id3152708" role="paragraph" xml-lang="en-US">SERIESSUM(x;n;m;c) = c<sub>1</sub>x<sup>n</sup> + c<sub>2</sub>x<sup>n+m</sup> + c<sub>3</sub>x<sup>n+2m</sup> + ... + c<sub>i</sub>x<sup>n + (i-1)m</sup>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_idN11BD9" role="code" xml-lang="en-US">SERIESSUM(X; N; M; Coefficients)</paragraph> +<paragraph id="par_id3152737" role="paragraph" xml-lang="en-US"><emph>X</emph> is the input value for the power series.</paragraph> +<paragraph id="par_id3144344" role="paragraph" xml-lang="en-US"><emph>N</emph> is the initial power</paragraph> +<paragraph id="par_id3144357" role="paragraph" xml-lang="en-US"><emph>M</emph> is the increment to increase N</paragraph> +<paragraph id="par_id3144370" role="paragraph" xml-lang="en-US"><emph>Coefficients</emph> is a series of coefficients. For each coefficient the series sum is extended by one section.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id431635251540138"><input>=SERIESSUM(A1; 0; 1; {1; 2; 3})</input> calculates the value of 1+2x+3x<sup>2</sup>, where x is the value in cell A1. If A1 contains 1, the formula returns 6; if A1 contains 2, the formula returns 17; if A1 contains 3, the formula returns 34; and so on.</paragraph> +<tip id="par_id881635251427220">Refer to the <link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/SERIESSUM" name="SERIESSUM_Wiki">SERIESSUM</link> wiki page for more details about this function.</tip> +</section> + +<section id="Section26"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3144386"> + <bookmark_value>PRODUCT function</bookmark_value> + <bookmark_value>numbers;multiplying</bookmark_value> + <bookmark_value>multiplying;numbers</bookmark_value> +</bookmark> +<comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_PRODUKT" id="bm_id3144397" localize="false"/> + +<h2 id="hd_id3144386">PRODUCT</h2> +<paragraph id="par_id3144414" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_PRODUKT">Multiplies all the numbers given as arguments and returns the product.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3144446" role="code" xml-lang="en-US">PRODUCT(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3144494" role="paragraph" xml-lang="en-US"><item type="input">=PRODUCT(2;3;4)</item> returns 24.</paragraph><comment>see also FACT, SUM</comment> +</section> + +<section id="Section25"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3160340"> + <bookmark_value>SUMSQ function</bookmark_value> + <bookmark_value>square number additions</bookmark_value> + <bookmark_value>sums;of square numbers</bookmark_value> +</bookmark> +<comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QUADRATESUMME" id="bm_id3160351" localize="false"/> + +<h2 id="hd_id3160340">SUMSQ</h2> +<paragraph id="par_id3160368" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_QUADRATESUMME">Calculates the sum of the squares of a set of numbers.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3160402" role="code" xml-lang="en-US">SUMSQ(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3160449" role="paragraph" xml-lang="en-US">If you enter the numbers 2; 3 and 4 in the Number 1; 2 and 3 arguments, 29 is returned as the result.</paragraph> +</section> + +<section id="Section24"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158247"> + <bookmark_value>MOD function</bookmark_value> + <bookmark_value>remainders of divisions</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_REST" id="bm_id3158259" localize="false"/> + +<h2 id="hd_id3158247">MOD</h2> +<paragraph id="par_id3158276" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_REST">Returns the remainder when one integer is divided by another.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3158308" role="code" xml-lang="en-US">MOD(Dividend; Divisor)</paragraph> +<paragraph id="par_id3158321" role="paragraph" xml-lang="en-US">For integer arguments this function returns Dividend modulo Divisor, that is the remainder when <emph>Dividend</emph> is divided by <emph>Divisor</emph>.</paragraph> +<paragraph id="par_id3158341" role="paragraph" xml-lang="en-US">This function is implemented as <item type="literal">Dividend - Divisor * INT(Dividend/Divisor)</item> , and this formula gives the result if the arguments are not integer.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3158374" role="paragraph" xml-lang="en-US"><item type="input">=MOD(22;3)</item> returns 1, the remainder when 22 is divided by 3.</paragraph> +<paragraph id="par_id1278420" role="paragraph" xml-lang="en-US"><item type="input">=MOD(11.25;2.5)</item> returns 1.25.</paragraph><comment>see also QUOTIENT, INT</comment> +</section> + +<section id="Section23"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3144592"> + <bookmark_value>QUOTIENT function</bookmark_value> + <bookmark_value>divisions</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_QUOTIENT" id="bm_id3144603" localize="false"/> + +<h2 id="hd_id3144592">QUOTIENT</h2> +<paragraph id="par_id3144627" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_QUOTIENT">Returns the integer part of a division operation.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3144659" role="code" xml-lang="en-US">QUOTIENT(Numerator; Denominator)</paragraph> +<paragraph id="par_id9038972" role="paragraph" xml-lang="en-US">Returns the integer part of <emph>Numerator</emph> divided by <emph>Denominator</emph>.</paragraph> +<paragraph id="par_id7985168" role="paragraph" xml-lang="en-US">QUOTIENT is equivalent to <item type="literal">INT(numerator/denominator)</item> for same-sign numerator and denominator, except that it may report errors with different error codes. More generally, it is equivalent to <item type="literal">INT(numerator/denominator/SIGN(numerator/denominator))*SIGN(numerator/denominator)</item>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3144687" role="paragraph" xml-lang="en-US"><item type="input">=QUOTIENT(11;3)</item> returns 3. The remainder of 2 is lost.</paragraph><comment>see also MOD, INT</comment> +</section> + +<section id="Section22"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3144702"> + <bookmark_value>RADIANS function</bookmark_value> + <bookmark_value>converting;degrees, into radians</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RAD" id="bm_id3158008" localize="false"/> + +<h2 id="hd_id3144702">RADIANS</h2> +<paragraph id="par_id3158025" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RAD">Converts degrees to radians.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3158055" role="code" xml-lang="en-US">RADIANS(Number)</paragraph> +<paragraph id="par_id3158069" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the angle in degrees to be converted to radians.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3939634" role="paragraph" xml-lang="en-US"><item type="input">=RADIANS(90)</item> returns 1.5707963267949, which is PI/2 to Calc's accuracy.</paragraph><comment>see also DEGREES</comment> +</section> + +<section id="Section67"> +<embed href="text/scalc/01/func_rawsubtract.xhp#func_rawsubtract"/> +</section> + +<section id="Section21"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158121"> + <bookmark_value>ROUND function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RUNDEN" id="bm_id3158133" localize="false"/> + +<h2 id="hd_id3158121">ROUND</h2> +<paragraph id="par_id3158150" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RUNDEN">Rounds a number to a certain number of decimal places.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3158182" role="code" xml-lang="en-US">ROUND(Number [; Count])</paragraph> +<paragraph id="par_id3158196" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded to <emph>Count</emph> decimal places. If Count is omitted or zero, the function rounds to the nearest integer. If Count is negative, the function rounds to the nearest 10, 100, 1000, etc.</paragraph> +<paragraph id="par_id599688" role="paragraph" xml-lang="en-US">This function rounds to the nearest number. See ROUNDDOWN and ROUNDUP for alternatives.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145876" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(2.348;2)</item> returns 2.35</paragraph> +<paragraph id="par_id3145899" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(-32.4834;3)</item> returns -32.483. Change the cell format to see all decimals.</paragraph> +<paragraph id="par_id1371501" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(2.348;0)</item> returns 2.</paragraph> +<paragraph id="par_id4661702" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(2.5)</item> returns 3.</paragraph> +<paragraph id="par_id7868892" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(987.65;-2)</item> returns 1000.</paragraph><comment>see also INT, TRUNC, ROUNDDOWN, ROUNDUP, CEILING, FLOOR, EVEN, ODD, MROUND</comment> +</section> + +<section id="rounddown"> + <h2 id="hd_id561641930400105"><link href="text/scalc/01/func_rounddown.xhp" name="rounddown_link">ROUNDDOWN</link></h2> + <embed href="text/scalc/01/func_trunc.xhp#trunc_desc"/> +</section> + +<section id="Section19"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3163268"> + <bookmark_value>ROUNDUP function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_AUFRUNDEN" id="bm_id3163280" localize="false"/> + +<h2 id="hd_id3163268">ROUNDUP</h2> +<paragraph id="par_id3163297" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_AUFRUNDEN">Rounds a number up, away from zero, to a certain precision.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3163328" role="code" xml-lang="en-US">ROUNDUP(Number [; Count])</paragraph> +<paragraph id="par_id3163342" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded up (away from zero) to <emph>Count</emph> decimal places. If Count is omitted or zero, the function rounds up to an integer. If Count is negative, the function rounds up to the next 10, 100, 1000, etc.</paragraph> +<paragraph id="par_id9573961" role="paragraph" xml-lang="en-US">This function rounds away from zero. See ROUNDDOWN and ROUND for alternatives.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3144786" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(1.1111;2)</item> returns 1.12.</paragraph> +<paragraph id="par_id7700430" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(1.2345;1)</item> returns 1.3.</paragraph> +<paragraph id="par_id1180455" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(45.67;0)</item> returns 46.</paragraph> +<paragraph id="par_id3405560" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(-45.67)</item> returns -46.</paragraph> +<paragraph id="par_id3409527" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(987.65;-2)</item> returns 1000.</paragraph><comment>see also INT, TRUNC, ROUND, ROUNDDOWN, CEILING, FLOOR, EVEN, ODD, MROUND</comment> +</section> + +<section id="Section63"> +<bookmark xml-lang="en-US" branch="index" id="bm_id5256537"> + <bookmark_value>SEC function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SECANT" id="bm_id6577644" localize="false"/> + +<h2 id="hd_id5187204">SEC</h2> +<paragraph id="par_id9954962" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SECANT">Returns the secant of the given angle (in radians). The secant of an angle is equivalent to 1 divided by the cosine of that angle</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2055913" role="code" xml-lang="en-US">SEC(Number)</paragraph> +<paragraph id="par_id9568170" role="paragraph" xml-lang="en-US">Returns the (trigonometric) secant of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph id="par_id9047465" role="paragraph" xml-lang="en-US">To return the secant of an angle in degrees, use the RADIANS function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id6935513" role="paragraph" xml-lang="en-US"><item type="input">=SEC(PI()/4)</item> returns approximately 1.4142135624, the inverse of the cosine of PI/4 radians.</paragraph> +<paragraph id="par_id3954287" role="paragraph" xml-lang="en-US"><item type="input">=SEC(RADIANS(60))</item> returns 2, the secant of 60 degrees.</paragraph><comment>see also SIN, TAN, COT, CSC, ACOS, ASIN, ATAN, ATAN2, ACOT</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section65"> +<bookmark xml-lang="en-US" branch="index" id="bm_id840005"> + <bookmark_value>SECH function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SECANTHYP" id="bm_id6301347" localize="false"/> + +<h2 id="hd_id8661934">SECH</h2> +<paragraph id="par_id408174" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SECANTHYP">Returns the hyperbolic secant of a number.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id4985391" role="code" xml-lang="en-US">SECH(Number)</paragraph> +<paragraph id="par_id1952124" role="paragraph" xml-lang="en-US">Returns the hyperbolic secant of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id1187764" role="paragraph" xml-lang="en-US"><item type="input">=SECH(0)</item> returns 1, the hyperbolic secant of 0.</paragraph><comment>see also SINH, TANH, COTH, CSCH, ACOSH, ASINH, ATANH, ACOTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section18"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3144877"> + <bookmark_value>SIN function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SIN" id="bm_id3144889" localize="false"/> + +<h2 id="hd_id3144877">SIN</h2> +<paragraph id="par_id3144906" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SIN">Returns the sine of the given angle (in radians).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3144937" role="code" xml-lang="en-US">SIN(Number)</paragraph> +<paragraph id="par_id3144950" role="paragraph" xml-lang="en-US">Returns the (trigonometric) sine of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph id="par_id8079470" role="paragraph" xml-lang="en-US">To return the sine of an angle in degrees, use the RADIANS function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3144983" role="paragraph" xml-lang="en-US"><item type="input">=SIN(PI()/2)</item> returns 1, the sine of PI/2 radians.</paragraph> +<paragraph id="par_id3916440" role="paragraph" xml-lang="en-US"><item type="input">=SIN(RADIANS(30))</item> returns 0.5, the sine of 30 degrees.</paragraph><comment>see also COS, TAN, COT, ACOS, ASIN, ATAN, ATAN2, ACOT</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section17"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3163397"> + <bookmark_value>SINH function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SINHYP" id="bm_id3163409" localize="false"/> + +<h2 id="hd_id3163397">SINH</h2> +<paragraph id="par_id3163426" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SINHYP">Returns the hyperbolic sine of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3163457" role="code" xml-lang="en-US">SINH(Number)</paragraph> +<paragraph id="par_id3163471" role="paragraph" xml-lang="en-US">Returns the hyperbolic sine of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3163504" role="paragraph" xml-lang="en-US"><item type="input">=SINH(0)</item> returns 0, the hyperbolic sine of 0.</paragraph><comment>see also COSH, TANH, COTH, ACOSH, ASINH, ATANH, ACOTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="sum"> + <h2 localize="false" id="hd_id841636542200276"><embedvar href="text/scalc/01/func_sum.xhp#sum_head"/></h2> + <paragraph id="par_id301636542246396" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/func_sum.xhp#func_sum_desc"/></paragraph> +</section> + +<section id="Section15"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151957"> + <bookmark_value>SUMIF function</bookmark_value> + <bookmark_value>adding;specified numbers</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMMEWENN" id="bm_id3151969" localize="false"/> + +<h2 id="hd_id3151957"><variable id="sumif_head"><link href="text/scalc/01/04060106.xhp#Section15">SUMIF</link></variable></h2> +<paragraph id="par_id3151986" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEWENN">Adds the cells specified by a given criterion.</ahelp> This function is used to sum a range when you search for a certain value.</paragraph> +<embed href="text/shared/00/00000001.xhp#regex"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3152028" role="code" xml-lang="en-US">SUMIF(Range; Criterion [; SumRange])</paragraph> +<paragraph id="par_id3152043" role="paragraph" xml-lang="en-US"><emph>Range</emph> is the range to which the criterion is to be applied.</paragraph> +<embed href="text/scalc/01/ex_data_stat_func.xhp#criterion"/> +<paragraph id="par_id3152083" role="paragraph" xml-lang="en-US"><emph>SumRange</emph> is the range from which values are summed. If this parameter has not been indicated, the values found in the Range are summed.</paragraph> +<note id="par_id8347422">SUMIF supports the reference concatenation operator (~) only in the Criterion parameter, and only if the optional SumRange parameter is not given.</note> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152148" role="paragraph" xml-lang="en-US">To sum up only negative numbers: <item type="input">=SUMIF(A1:A10;"<0")</item></paragraph> +<paragraph id="par_id6670125" role="paragraph" xml-lang="en-US"><item type="input">=SUMIF(A1:A10;">0";B1:B10)</item> - sums values from the range B1:B10 only if the corresponding values in the range A1:A10 are >0.</paragraph> +<paragraph id="par_id6062196" role="paragraph" xml-lang="en-US">See COUNTIF() for some more syntax examples that can be used with SUMIF().</paragraph> +</section> + +<section id="color"> +<embed href="text/scalc/01/func_color.xhp#func_color"/> +</section> + +<section id="sumifs"> + +<h2 localize="false" id="hd_id72921259523046"><embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_head"/></h2> +<paragraph id="par_id131512822630259" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_des"/></paragraph> +</section> + +<section id="Section14"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152195"> + <bookmark_value>TAN function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TAN" id="bm_id3152207" localize="false"/> + +<h2 id="hd_id3152195">TAN</h2> +<paragraph id="par_id3152224" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TAN">Returns the tangent of the given angle (in radians).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3152255" role="code" xml-lang="en-US">TAN(Number)</paragraph> +<paragraph id="par_id3152269" role="paragraph" xml-lang="en-US">Returns the (trigonometric) tangent of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph id="par_id5752128" role="paragraph" xml-lang="en-US">To return the tangent of an angle in degrees, use the RADIANS function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152301" role="paragraph" xml-lang="en-US"><item type="input">=TAN(PI()/4) </item>returns 1, the tangent of PI/4 radians.</paragraph> +<paragraph id="par_id1804864" role="paragraph" xml-lang="en-US"><item type="input">=TAN(RADIANS(45))</item> returns 1, the tangent of 45 degrees.</paragraph><comment>see also COS, SIN, COT, ACOS, ASIN, ATAN, ATAN2, ACOT</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section13"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3165434"> + <bookmark_value>TANH function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TANHYP" id="bm_id3165446" localize="false"/> + +<h2 id="hd_id3165434">TANH</h2> +<paragraph id="par_id3165462" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TANHYP">Returns the hyperbolic tangent of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3165494" role="code" xml-lang="en-US">TANH(Number)</paragraph> +<paragraph id="par_id3165508" role="paragraph" xml-lang="en-US">Returns the hyperbolic tangent of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3165541" role="paragraph" xml-lang="en-US"><item type="input">=TANH(0)</item> returns 0, the hyperbolic tangent of 0.</paragraph><comment>see also COSH, SINH, COTH, ACOSH, ASINH, ATANH, ACOTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="Section12"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3165633"> + <bookmark_value>AutoFilter function; subtotals</bookmark_value> + <bookmark_value>sums;of filtered data</bookmark_value> + <bookmark_value>filtered data; sums</bookmark_value> + <bookmark_value>SUBTOTAL function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TEILERGEBNIS" id="bm_id3165644" localize="false"/> + +<h2 id="hd_id3165633">SUBTOTAL</h2> +<paragraph id="par_id3165682" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TEILERGEBNIS">Calculates subtotals.</ahelp> If a range already contains subtotals, these are not used for further calculations. Use this function with the AutoFilters to take only the filtered records into account.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3165717" role="code" xml-lang="en-US">SUBTOTAL(Function; Range)</paragraph> +<paragraph id="par_id3165731" role="paragraph" xml-lang="en-US"><emph>Function</emph> is a number that stands for one of the following functions:</paragraph> + +<table id="tbl_id3165752"> + <tablerow> + <tablecell> + <paragraph id="par_id3165782" role="tablehead" xml-lang="en-US">Function index</paragraph> + <paragraph id="par_id20082017081856189" role="tablehead" xml-lang="en-US">(includes hidden values)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716337755" role="tablehead" xml-lang="en-US">Function index</paragraph> + <paragraph id="par_id200820170818568679" role="tablehead" xml-lang="en-US">(ignores hidden values)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3165806" role="tablehead" xml-lang="en-US">Function</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3165833" role="paragraph" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id20082017071634481" role="paragraph" localize="false" xml-lang="en-US">101</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3165856" role="paragraph" xml-lang="en-US">AVERAGE</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3165883" role="paragraph" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716349348" role="paragraph" localize="false" xml-lang="en-US">102</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3165906" role="paragraph" xml-lang="en-US">COUNT</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3165933" role="paragraph" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716342109" role="paragraph" localize="false" xml-lang="en-US">103</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3165956" role="paragraph" xml-lang="en-US">COUNTA</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3165983" role="paragraph" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716348854" role="paragraph" localize="false" xml-lang="en-US">104</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3166006" role="paragraph" xml-lang="en-US">MAX</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3166033" role="paragraph" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id20082017071634799" role="paragraph" localize="false" xml-lang="en-US">105</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3166056" role="paragraph" xml-lang="en-US">MIN</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3143316" role="paragraph" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716342762" role="paragraph" localize="false" xml-lang="en-US">106</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143339" role="paragraph" xml-lang="en-US">PRODUCT</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3143366" role="paragraph" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716348779" role="paragraph" localize="false" xml-lang="en-US">107</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143389" role="paragraph" xml-lang="en-US">STDEV</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3143416" role="paragraph" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716355943" role="paragraph" localize="false" xml-lang="en-US">108</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143439" role="paragraph" xml-lang="en-US">STDEVP</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3143466" role="paragraph" localize="false" xml-lang="en-US">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716355993" role="paragraph" localize="false" xml-lang="en-US">109</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143489" role="paragraph" xml-lang="en-US">SUM</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3143516" role="paragraph" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716351843" role="paragraph" localize="false" xml-lang="en-US">110</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143539" role="paragraph" xml-lang="en-US">VAR</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3143566" role="paragraph" localize="false" xml-lang="en-US">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716353789" role="paragraph" localize="false" xml-lang="en-US">111</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143589" role="paragraph" xml-lang="en-US">VARP</paragraph> + </tablecell> + </tablerow> +</table> + +<paragraph id="par_id20082017075115609" role="paragraph" xml-lang="en-US">Use numbers 1-11 to include manually hidden rows or 101-111 to exclude them; filtered-out cells are always excluded.</paragraph> +<paragraph id="par_id3143606" role="paragraph" xml-lang="en-US"><emph>Range</emph> is the range whose cells are included.</paragraph> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3143638" role="paragraph" xml-lang="en-US">You have a table in the cell range A1:B6 containing a bill of material for 10 students. Row 2 (Pen) is manually hidden. You want to see the sum of the figures that are displayed; that is, just the subtotal for the filtered rows. In this case the correct formula would be:</paragraph> + +<table id="tbl_200820170737188127"> + <tablerow> + <tablecell> + <paragraph id="par_id200820170806057438" role="tablehead" localize="false" xml-lang="en-US"/> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751186827" role="tablehead" localize="false" xml-lang="en-US">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751186410" role="tablehead" localize="false" xml-lang="en-US">B</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id200820170751189874" role="tablehead" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751186696" role="tablecontent" xml-lang="en-US"><emph>ITEM</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id20082017075118422" role="tablecontent" xml-lang="en-US"><emph>QUANTITY</emph></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id200820170751187332" role="tablehead" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751195726" role="tablecontent" xml-lang="en-US">Pen</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751199921" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id200820170751197796" role="tablehead" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751195912" role="tablecontent" xml-lang="en-US">Pencil</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751195191" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id200820170751193908" role="tablehead" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751199399" role="tablecontent" xml-lang="en-US">Notebook</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751204129" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id200820170751201815" role="tablehead" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751201323" role="tablecontent" xml-lang="en-US">Rubber</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id20082017075120380" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id20082017075120914" role="tablehead" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751204884" role="tablecontent" xml-lang="en-US">Sharpener</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751204938" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + </tablerow> +</table> + +<paragraph id="par_id3143658" role="paragraph" xml-lang="en-US"><item type="input">=SUBTOTAL(9;B2:B6) returns 50.</item></paragraph> +<paragraph id="par_id200820170751218092" role="paragraph" xml-lang="en-US"><item type="input">=SUBTOTAL(109;B2:B6) returns 40.</item></paragraph> +</section> + +<section id="Section11"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143672"> + <bookmark_value>Euro; converting</bookmark_value> + <bookmark_value>EUROCONVERT function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UMRECHNEN" id="bm_id3143684" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_EUROCONVERT" id="bm_id0119200904282677" localize="false"/> + +<h2 id="hd_id3143672">EUROCONVERT<comment>insert link in financial</comment></h2> +<paragraph id="par_id3143708" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_UMRECHNEN">Converts between old European national currency and to and from Euros.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3143748" role="code" xml-lang="en-US">EUROCONVERT(Value; "From_currency"; "To_currency" [; full_precision [; triangulation_precision]])</paragraph> +<paragraph id="par_id3143763" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the amount of the currency to be converted.</paragraph> +<paragraph id="par_id3143782" role="paragraph" xml-lang="en-US"><emph>From_currency</emph> and <emph>To_currency</emph> are the currency units to convert from and to respectively. These must be text, the official abbreviation for the currency (for example, "EUR"). The rates (shown per Euro) were set by the European Commission.</paragraph> +<paragraph id="par_id0119200904301810" role="paragraph" xml-lang="en-US"><emph>Full_precision</emph> is optional. If omitted or False, the result is rounded according to the decimals of the To currency. If Full_precision is True, the result is not rounded.</paragraph> +<paragraph id="par_id0119200904301815" role="paragraph" xml-lang="en-US"><emph>Triangulation_precision</emph> is optional. If Triangulation_precision is given and >=3, the intermediate result of a triangular conversion (currency1,EUR,currency2) is rounded to that precision. If Triangulation_precision is omitted, the intermediate result is not rounded. Also if To currency is "EUR", Triangulation_precision is used as if triangulation was needed and conversion from EUR to EUR was applied.</paragraph> + +<h3 id="par_id3143819"><emph>Examples</emph></h3> +<paragraph id="par_id3143837" role="paragraph" xml-lang="en-US"><item type="input">=EUROCONVERT(100;"ATS";"EUR")</item> converts 100 Austrian Schillings into Euros.</paragraph> +<paragraph id="par_id3143853" role="paragraph" xml-lang="en-US"><item type="input">=EUROCONVERT(100;"EUR";"DEM")</item> converts 100 Euros into German Marks.</paragraph> +</section> + +<section id="convert"> +<bookmark xml-lang="en-US" branch="index" id="bm_id0908200902090676"> + <bookmark_value>CONVERT_OOO function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UMRECHNEN" id="bm_id0908200902093111" localize="false"/> + +<h2 id="hd_id0908200902074836">CONVERT_OOO</h2> +<paragraph id="par_id0908200902131122" role="paragraph" xml-lang="en-US"><ahelp hid=".">Converts to euros a currency value expressed in one of the legacy currencies of 19 member states of the Eurozone, and vice versa.</ahelp> The conversion uses the fixed exchange rates at which the legacy currencies entered the euro.</paragraph> + +<tip id="par_id581631900947319">We recommend using the more flexible EUROCONVERT function for converting between these currencies. CONVERT_OOO is not a standardized function and is not portable.</tip> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id0908200902131191" role="code" xml-lang="en-US">CONVERT_OOO(Value; "Text1"; "Text2")</paragraph> +<paragraph role="paragraph" id="par_id901631901062056"><emph>Value</emph> is the amount of the currency to be converted.</paragraph> +<paragraph role="paragraph" id="par_id461631901137229"><emph>Text1</emph> is a three-character string that specifies the currency to be converted from.</paragraph> +<paragraph role="paragraph" id="par_id351631901218862"><emph>Text2</emph> is a three-character string that specifies the currency to be converted to.</paragraph> +<paragraph role="paragraph" id="par_id1001631901312606"><emph>Text1</emph> and <emph>Text2</emph> must each take one of the following values: "ATS", "BEF", "CYP", "DEM", "EEK", "ESP", "EUR", "FIM", "FRF", "GRD", "IEP", "ITL", "LTL", "LUF", "LVL", "MTL", "NLG", "PTE", "SIT", and "SKK".</paragraph> +<paragraph role="paragraph" id="par_id111631901383901">One, and only one, of <emph>Text1</emph> or <emph>Text2</emph> must be equal to "EUR".</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id090820090213112" role="paragraph" xml-lang="en-US"><item type="input">=CONVERT_OOO(100;"ATS";"EUR")</item> returns the euro value of 100 Austrian schillings.</paragraph> +<paragraph id="par_id0908200902475431" role="paragraph" xml-lang="en-US"><input>=CONVERT_OOO(100;"EUR";"DEM")</input> converts 100 euros into German marks.</paragraph> +<tip id="par_id251631901851101">Refer to the <link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/CONVERT_OOO" name="CONVERT_OOO Wiki">CONVERT_OOO</link> wiki page for more details about this function.</tip> +</section> + +<section id="Section10"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157177"> + <bookmark_value>ODD function</bookmark_value> + <bookmark_value>rounding;up/down to nearest odd integer</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UNGERADE" id="bm_id3157188" localize="false"/> + +<h2 id="hd_id3157177">ODD</h2> +<paragraph id="par_id3157205" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_UNGERADE">Rounds a positive number up to the nearest odd integer and a negative number down to the nearest odd integer.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3157237" role="code" xml-lang="en-US">ODD(Number)</paragraph> +<paragraph id="par_id3157250" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded to the next odd integer up, away from zero.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3157283" role="paragraph" xml-lang="en-US"><item type="input">=ODD(1.2)</item> returns 3.</paragraph> +<paragraph id="par_id8746910" role="paragraph" xml-lang="en-US"><item type="input">=ODD(1)</item> returns 1.</paragraph> +<paragraph id="par_id9636524" role="paragraph" xml-lang="en-US"><item type="input">=ODD(0)</item> returns 1.</paragraph> +<paragraph id="par_id5675527" role="paragraph" xml-lang="en-US"><item type="input">=ODD(-3.1)</item> returns -5.</paragraph><comment>see also CEILING, FLOOR, EVEN, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> +</section> + +<section id="Section8"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164086"> + <bookmark_value>SIGN function</bookmark_value> + <bookmark_value>algebraic signs</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VORZEICHEN" id="bm_id3164098" localize="false"/> + +<h2 id="hd_id3164086">SIGN</h2> +<paragraph id="par_id3164115" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_VORZEICHEN">Returns the sign of a number. Returns 1 if the number is positive, -1 if negative and 0 if zero.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164150" role="code" xml-lang="en-US">SIGN(Number)</paragraph> +<paragraph id="par_id3164164" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number whose sign is to be determined.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3164197" role="paragraph" xml-lang="en-US"><item type="input">=SIGN(3.4)</item> returns 1.</paragraph> +<paragraph id="par_id3164212" role="paragraph" xml-lang="en-US"><item type="input">=SIGN(-4.5)</item> returns -1.</paragraph><comment>see also ABS</comment> +</section> + +<section id="Section7"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164252"> + <bookmark_value>MROUND function</bookmark_value> + <bookmark_value>nearest multiple</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_MROUND" id="bm_id3164264" localize="false"/> + +<h2 id="hd_id3164252">MROUND</h2> +<paragraph id="par_id3164288" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_MROUND">Returns a number rounded to the nearest multiple of another number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164320" role="code" xml-lang="en-US">MROUND(Number; Multiple)</paragraph> +<paragraph id="par_id3486434" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded to the nearest multiple of <emph>Multiple</emph>.</paragraph> +<paragraph id="par_id3068636" role="paragraph" xml-lang="en-US">An alternative implementation would be <item type="literal">Multiple * ROUND(Number/Multiple)</item>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3164347" role="paragraph" xml-lang="en-US"><item type="input">=MROUND(15.5;3)</item> returns 15, as 15.5 is closer to 15 (= 3*5) than to 18 (= 3*6).</paragraph> +<paragraph id="par_idN14DD6" role="paragraph" xml-lang="en-US"><item type="input">=MROUND(1.4;0.5)</item> returns 1.5 (= 0.5*3).</paragraph><comment>see also CEILING, FLOOR, EVEN, ODD, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> +</section> + +<section id="Section6"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164375"> + <bookmark_value>SQRT function</bookmark_value> + <bookmark_value>square roots;positive numbers</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WURZEL" id="bm_id3164387" localize="false"/> + +<h2 id="hd_id3164375">SQRT</h2> +<paragraph id="par_id3164404" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_WURZEL">Returns the positive square root of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164437" role="code" xml-lang="en-US">SQRT(Number)</paragraph> +<paragraph id="par_id3164451" role="paragraph" xml-lang="en-US">Returns the positive square root of <emph>Number</emph>.</paragraph> +<paragraph id="par_id6870021" role="paragraph" xml-lang="en-US">Number must be positive.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3164484" role="paragraph" xml-lang="en-US"><item type="input">=SQRT(16)</item> returns 4.</paragraph> +<paragraph id="par_id3591723" role="paragraph" xml-lang="en-US"><item type="input">=SQRT(-16)</item> returns an <item type="literal">invalid argument</item> error.</paragraph><comment>see also SQRTPI, POWER</comment> +</section> + +<section id="Section5"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164560"> + <bookmark_value>SQRTPI function</bookmark_value> + <bookmark_value>square roots;products of Pi</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_SQRTPI" id="bm_id3164572" localize="false"/> + +<h2 id="hd_id3164560">SQRTPI</h2> +<paragraph id="par_id3164596" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_SQRTPI">Returns the square root of (PI times a number).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164627" role="code" xml-lang="en-US">SQRTPI(Number)</paragraph> +<paragraph id="par_id1501510" role="paragraph" xml-lang="en-US">Returns the positive square root of (PI multiplied by <emph>Number</emph>).</paragraph> +<paragraph id="par_id9929197" role="paragraph" xml-lang="en-US">This is equivalent to <item type="literal">SQRT(PI()*Number)</item>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3164654" role="paragraph" xml-lang="en-US"><item type="input">=SQRTPI(2)</item> returns the squareroot of (2PI), approximately 2.506628.</paragraph><comment>see also SQRT</comment> +</section> + +<section id="Section4"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164669"> +<bookmark_value>random numbers; between limits</bookmark_value> +<bookmark_value>RANDBETWEEN function</bookmark_value> +</bookmark> +<comment>mw changed "random numbers;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_RANDBETWEEN" id="bm_id3164680" localize="false"/> + +<h2 id="hd_id3164669">RANDBETWEEN</h2> +<paragraph id="par_id3164711" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_RANDBETWEEN">Returns an integer random number in a specified range.</ahelp></paragraph> +<embed href="text/scalc/01/ful_func.xhp#func_volatile"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164758" role="code" xml-lang="en-US">RANDBETWEEN(Bottom; Top)</paragraph> +<paragraph id="par_id7112338" role="paragraph" xml-lang="en-US">Returns an integer random number between integers <emph>Bottom</emph> and <emph>Top</emph> (both inclusive).</paragraph> +<paragraph id="par_id2855616" role="paragraph" xml-lang="en-US">This function produces a new random number each time Calc recalculates. To force Calc to recalculate manually press F9.</paragraph> +<paragraph id="par_id2091433" role="paragraph" xml-lang="en-US">To generate random numbers which never recalculate, copy cells containing this function, and use <item type="menuitem">Edit - Paste Special</item> (with <item type="menuitem">Paste All</item> and <item type="menuitem">Formulas</item> not marked and <item type="menuitem">Numbers</item> marked).</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3164785" role="paragraph" xml-lang="en-US"><item type="input">=RANDBETWEEN(20;30)</item> returns an integer of between 20 and 30.</paragraph><comment>see also RAND</comment> +</section> +<section id="randbetween_nv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id461590241346526"> +<bookmark_value>random numbers non-volatile; between limits</bookmark_value> +<bookmark_value>RANDBETWEEN.NV function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RANDBETWEEN_NV" id="bm_id601590240409484" localize="false"/> +<h2 id="hd_id171590240366277">RANDBETWEEN.NV</h2> +<paragraph role="paragraph" id="par_id391590240473510"><ahelp hid="HID_FUNC_RANDBETWEEN_NV">Returns an non-volatile integer random number in a specified range.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id181590240522012">RANDBETWEEN.NV(Bottom; Top)</paragraph> +<paragraph role="paragraph" id="par_id91590242400917">Returns an non-volatile integer random number between integers <emph>Bottom</emph> and <emph>Top</emph> (both inclusive). A non-volatile function is not recalculated at new input events or pressing <keycode>F9</keycode>. However, the function is recalculated when pressing <keycode>F9</keycode> with the cursor on the cell containing the function, when opening the file, when using the <link href="text/scalc/01/recalculate_hard.xhp" name="recalculate hard"><menuitem>Recalculate Hard</menuitem></link> command (<keycode>Shift</keycode>+<switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline>+<keycode>F9</keycode>) and when <emph>Top</emph> or <emph>Bottom</emph> are recalculated.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id151590240999839"><input>=RANDBETWEEN.NV(20;30)</input> returns a non-volatile integer between 20 and 30.</paragraph> +<paragraph role="paragraph" id="par_id1001590241005601"><input>=RANDBETWEEN.NV(A1;30)</input> returns a non-volatile integer between the value of cell A1 and 30. The function is recalculated when the contents of cell A1 change.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#7.0"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311650873986703" localize="false"><literal>ORG.LIBREOFFICE.RANDBETWEEN.NV</literal></paragraph> +</section> + +<section id="Section3"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164800"> +<bookmark_value>RAND function</bookmark_value> +<bookmark_value>random numbers;between 0 and 1</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZUFALLSZAHL" id="bm_id3164812" localize="false"/> + +<h2 id="hd_id3164800">RAND</h2> +<paragraph id="par_id3164829" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZUFALLSZAHL">Returns a random number between 0 and 1.</ahelp><comment>The value of 0 can be returned, the value of 1 not.</comment><comment>this is really true after issue 53642 will be fixed</comment></paragraph> +<embed href="text/scalc/01/ful_func.xhp#func_volatile"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164884" role="code" xml-lang="en-US">RAND()</paragraph> +<paragraph id="par_id5092318" role="paragraph" xml-lang="en-US">This function produces a new random number each time Calc recalculates. To force Calc to recalculate manually press F9.</paragraph> +<paragraph id="par_id9312417" role="paragraph" xml-lang="en-US">To generate random numbers which never recalculate, either:</paragraph> +<list type="unordered"> +<listitem> + <paragraph id="par_id451590242105253" role="listitem">Copy cells each containing =RAND(), and use <menuitem>Edit - Paste Special</menuitem> (with <emph>Paste All</emph> and <emph>Formulas</emph> not marked and <emph>Numbers</emph> marked).</paragraph> +</listitem> +<listitem> + <paragraph id="par_id801590242114296" role="listitem">Use the Fill Cell command with random numbers (<menuitem>Sheet - Fill Cells - Fill Random Numbers</menuitem>).</paragraph> +</listitem> +<listitem> + <paragraph id="par_id41590242118383" role="listitem">Use the RAND.NV() function for non-volatile random numbers.</paragraph> + </listitem> +</list> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id9569078" role="paragraph" xml-lang="en-US"><item type="input">=RAND()</item> returns a random number between 0 and 1.</paragraph><comment>see also RANDBETWEEN</comment> +</section> +<section id="rand_nv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id341590241488944"> +<bookmark_value>random numbers non-volatile;between 0 and 1</bookmark_value> +<bookmark_value>RAND.NV function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RAND_NV" id="bm_id111590240232198" localize="false"/> +<h2 id="hd_id71590238179170">RAND.NV</h2> +<paragraph role="paragraph" id="par_id101590238875834"><ahelp hid="HID_FUNC_RAND_NV">Returns a non-volatile random number between 0 and 1.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id391590238945182">RAND.NV()</paragraph> +<paragraph role="paragraph" id="par_id271590239748534">This function produces a non-volatile random number on input. A non-volatile function is not recalculated at new input events. The function does not recalculate when pressing <keycode>F9</keycode>, except when the cursor is on the cell containing the function or using the <link href="text/scalc/01/recalculate_hard.xhp" name="recalculate hard"><menuitem>Recalculate Hard</menuitem></link> command (<keycode>Shift</keycode>+<switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline>+<keycode>F9</keycode>). The function is recalculated when opening the file.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id191590241215013"><input>=RAND.NV()</input> returns a non-volatile random number between 0 and 1.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#7.0"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.LIBREOFFICE.RAND.NV</literal></paragraph> +</section> +</sort> + +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> + +</helpdocument> |