diff options
71 files changed, 956 insertions, 930 deletions
diff --git a/AllLangHelp_scalc.mk b/AllLangHelp_scalc.mk index 9daadf9a6a..b04311c82e 100644 --- a/AllLangHelp_scalc.mk +++ b/AllLangHelp_scalc.mk @@ -223,6 +223,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,scalc,\ helpcontent2/source/text/scalc/01/func_minifs \ helpcontent2/source/text/scalc/01/func_minute \ helpcontent2/source/text/scalc/01/func_month \ + helpcontent2/source/text/scalc/01/common_func \ helpcontent2/source/text/scalc/01/common_func_workdaysintl \ helpcontent2/source/text/scalc/01/func_networkdays \ helpcontent2/source/text/scalc/01/func_networkdays.intl \ diff --git a/source/text/scalc/01/04060101.xhp b/source/text/scalc/01/04060101.xhp index f7d9995d0d..39630fea8d 100644 --- a/source/text/scalc/01/04060101.xhp +++ b/source/text/scalc/01/04060101.xhp @@ -418,10 +418,10 @@ <paragraph xml-lang="en-US" id="hd_id3150882" role="heading" level="2">DCOUNT</paragraph> <paragraph xml-lang="en-US" id="par_id3156133" role="paragraph"><ahelp hid="HID_FUNC_DBANZAHL">DCOUNT counts the number of rows (records) in a database that match the specified search criteria and contain numerical values in the DatabaseField column.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3156099" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153218" role="code">DCOUNT(Database; [DatabaseField]; SearchCriteria)</paragraph> <paragraph xml-lang="en-US" id="par_id3153273" role="paragraph">If the DatabaseField argument is omitted, DCOUNT returns the count of all records that satisfy Criteria. <embedvar href="text/scalc/01/04060101.xhp#quotes"/></paragraph> - <paragraph xml-lang="en-US" id="hd_id3154743" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153623" role="paragraph">In the example above (scroll up, please), we want to know how many children have to travel more than 600 meters to school. The result is to be stored in cell B16. Set the cursor in cell B16. Enter the formula <item type="input">=DCOUNT(A1:E10;D1;A13:E14)</item> in B16. The <emph>Function Wizard</emph> helps you to input ranges.</paragraph> <paragraph xml-lang="en-US" id="par_id3149142" role="paragraph"> <emph>Database</emph> is the range of data to be evaluated, including its headers: in this case A1:E10. <emph>DatabaseField</emph> specifies the column for the search criteria: in this case, the column with the numerical distance values. <emph>SearchCriteria</emph> is the range where you can enter the search parameters: in this case, A13:E14.</paragraph> @@ -436,10 +436,10 @@ <paragraph xml-lang="en-US" id="hd_id3156123" role="heading" level="2">DCOUNTA</paragraph> <paragraph xml-lang="en-US" id="par_id3156110" role="paragraph"><ahelp hid="HID_FUNC_DBANZAHL2">DCOUNTA counts the number of rows (records) in a database that match the specified search conditions, and contain numeric or alphanumeric values.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3143228" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3146893" role="code">DCOUNTA(Database; [DatabaseField]; SearchCriteria)</paragraph> <paragraph xml-lang="en-US" id="par_id3153274" role="paragraph">If the DatabaseField argument is omitted, DCOUNTA returns the count of all records that satisfy Criteria. <embedvar href="text/scalc/01/04060101.xhp#quotes"/></paragraph> - <paragraph xml-lang="en-US" id="hd_id3149751" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153982" role="paragraph">In the example above (scroll up, please), you can search for the number of children whose name starts with an E or a subsequent letter. Edit the formula in B16 to read <item type="input">=DCOUNTA(A1:E10;"Name";A13:E14)</item>. Delete the old search criteria and enter <item type="input">>=E</item> under Name in field A14. The result is 5. If you now delete all number values for Greta in row 8, the result changes to 4. Row 8 is no longer included in the count because it does not contain any values. The name Greta is text, not a value. Note that the DatabaseField parameter must point to a column that can contain values.<comment>see i25407</comment></paragraph> </section> <section id="Section3"> @@ -451,10 +451,10 @@ <paragraph xml-lang="en-US" id="hd_id3147256" role="heading" level="2">DGET</paragraph> <paragraph xml-lang="en-US" id="par_id3152801" role="paragraph"><ahelp hid="HID_FUNC_DBAUSZUG">DGET returns the contents of the referenced cell in a database which matches the specified search criteria.</ahelp> In case of an error, the function returns either #VALUE! for no row found, or Err502 for more than one cell found.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3159344" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154696" role="code">DGET(Database; DatabaseField; SearchCriteria)</paragraph> <embed href="text/scalc/01/04060101.xhp#quotes"/> - <paragraph xml-lang="en-US" id="hd_id3153909" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3155388" role="paragraph">In the above example (scroll up, please), we want to determine what grade a child is in, whose name was entered in cell A14. The formula is entered in cell B16 and differs slightly from the earlier examples because only one column (one database field) can be entered for <emph>DatabaseField</emph>. Enter the following formula:</paragraph> <paragraph xml-lang="en-US" id="par_id3153096" role="paragraph"> <item type="input">=DGET(A1:E10;"Grade";A13:E14)</item> @@ -475,10 +475,10 @@ <paragraph xml-lang="en-US" id="hd_id3149766" role="heading" level="2">DMAX</paragraph> <paragraph xml-lang="en-US" id="par_id3154903" role="paragraph"><ahelp hid="HID_FUNC_DBMAX">DMAX returns the maximum content of a cell (field) in a database (all records) that matches the specified search conditions.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3150771" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3159157" role="code">DMAX(Database; DatabaseField; SearchCriteria)</paragraph> <embed href="text/scalc/01/04060101.xhp#quotes"/> - <paragraph xml-lang="en-US" id="hd_id3145420" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3148442" role="paragraph">To find out how much the heaviest child in each grade weighed in the above example (scroll up, please), enter the following formula in B16:</paragraph> <paragraph xml-lang="en-US" id="par_id3148804" role="paragraph"> <item type="input">=DMAX(A1:E10;"Weight";A13:E14)</item> @@ -494,10 +494,10 @@ <paragraph xml-lang="en-US" id="hd_id3159141" role="heading" level="2">DMIN</paragraph> <paragraph xml-lang="en-US" id="par_id3154261" role="paragraph"><ahelp hid="HID_FUNC_DBMIN">DMIN returns the minimum content of a cell (field) in a database that matches the specified search criteria.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3147238" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3148479" role="code">DMIN(Database; DatabaseField; SearchCriteria)</paragraph> <embed href="text/scalc/01/04060101.xhp#quotes"/> - <paragraph xml-lang="en-US" id="hd_id3151050" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3148925" role="paragraph">To find the shortest distance to school for the children in each grade in the above example (scroll up, please), enter the following formula in B16:</paragraph> <paragraph xml-lang="en-US" id="par_id3149161" role="paragraph"> <item type="input">=DMIN(A1:E10;"Distance to School";A13:E14)</item> @@ -513,10 +513,10 @@ <paragraph xml-lang="en-US" id="hd_id3154274" role="heading" level="2">DAVERAGE</paragraph> <paragraph xml-lang="en-US" id="par_id3166453" role="paragraph"><ahelp hid="HID_FUNC_DBMITTELWERT">DAVERAGE returns the average of the values of all cells (fields) in all rows (database records) that match the specified search criteria.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3146955" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150710" role="code">DAVERAGE(Database; DatabaseField; SearchCriteria)</paragraph> <embed href="text/scalc/01/04060101.xhp#quotes"/> - <paragraph xml-lang="en-US" id="hd_id3152943" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149104" role="paragraph">To find the average weight of all children of the same age in the above example (scroll up, please), enter the following formula in B16:</paragraph> <paragraph xml-lang="en-US" id="par_id3153688" role="paragraph"> <item type="input">=DAVERAGE(A1:E10;"Weight";A13:E14)</item> @@ -531,10 +531,10 @@ <paragraph xml-lang="en-US" id="hd_id3159269" role="heading" level="2">DPRODUCT</paragraph> <paragraph xml-lang="en-US" id="par_id3152879" role="paragraph"><ahelp hid="HID_FUNC_DBPRODUKT">DPRODUCT multiplies all cells of a data range where the cell contents match the search criteria.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3149966" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154854" role="code">DPRODUCT(Database; DatabaseField; SearchCriteria)</paragraph> <embed href="text/scalc/01/04060101.xhp#quotes"/> - <paragraph xml-lang="en-US" id="hd_id3149802" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3148986" role="paragraph">With the birthday party example above (scroll up, please), there is no meaningful application of this function.</paragraph> </section> <section id="Section8"> @@ -545,10 +545,10 @@ <paragraph xml-lang="en-US" id="hd_id3148462" role="heading" level="2">DSTDEV</paragraph> <paragraph xml-lang="en-US" id="par_id3154605" role="paragraph"><ahelp hid="HID_FUNC_DBSTDABW">DSTDEV calculates the standard deviation of a population based on a sample, using the numbers in a database column that match the given conditions.</ahelp> The records are treated as a sample of data. That means that the children in the example represent a cross section of all children. Note that a representative result can not be obtained from a sample of less than one thousand.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3149427" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3148661" role="code">DSTDEV(Database; DatabaseField; SearchCriteria)</paragraph> <embed href="text/scalc/01/04060101.xhp#quotes"/> - <paragraph xml-lang="en-US" id="hd_id3153945" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149934" role="paragraph">To find the standard deviation of the weight for all children of the same age in the example (scroll up, please), enter the following formula in B16:</paragraph> <paragraph xml-lang="en-US" id="par_id3150630" role="paragraph"> <item type="input">=DSTDEV(A1:E10;"Weight";A13:E14)</item> @@ -563,10 +563,10 @@ <paragraph xml-lang="en-US" id="hd_id3150429" role="heading" level="2">DSTDEVP</paragraph> <paragraph xml-lang="en-US" id="par_id3145598" role="paragraph"><ahelp hid="HID_FUNC_DBSTDABWN">DSTDEVP calculates the standard deviation of a population based on all cells of a data range which match the search criteria.</ahelp> The records from the example are treated as the whole population.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3145307" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149484" role="code">DSTDEVP(Database; DatabaseField; SearchCriteria)</paragraph> <embed href="text/scalc/01/04060101.xhp#quotes"/> - <paragraph xml-lang="en-US" id="hd_id3153322" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3155431" role="paragraph">To find the standard deviation of the weight for all children of the same age at Joe's birthday party (scroll up, please), enter the following formula in B16:</paragraph> <paragraph xml-lang="en-US" id="par_id3148411" role="paragraph"> <item type="input">=DSTDEVP(A1:E10;"Weight";A13:E14)</item> @@ -582,10 +582,10 @@ <paragraph xml-lang="en-US" id="hd_id3154794" role="heading" level="2">DSUM</paragraph> <paragraph xml-lang="en-US" id="par_id3149591" role="paragraph"><ahelp hid="HID_FUNC_DBSUMME">DSUM returns the total of all cells in a database field in all rows (records) that match the specified search criteria.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3146128" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150989" role="code">DSUM(Database; DatabaseField; SearchCriteria)</paragraph> <embed href="text/scalc/01/04060101.xhp#quotes"/> - <paragraph xml-lang="en-US" id="hd_id3159079" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3152766" role="paragraph">To find the length of the combined distance to school of all children at Joe's birthday party (scroll up, please) who are in second grade, enter the following formula in B16:</paragraph> <paragraph xml-lang="en-US" id="par_id3151312" role="paragraph"> <item type="input">=DSUM(A1:E10;"Distance to School";A13:E14)</item> @@ -600,10 +600,10 @@ <paragraph xml-lang="en-US" id="hd_id3155614" role="heading" level="2">DVAR</paragraph> <paragraph xml-lang="en-US" id="par_id3154418" role="paragraph"><ahelp hid="HID_FUNC_DBVARIANZ">DVAR returns the variance of all cells of a database field in all records that match the specified search criteria.</ahelp> The records from the example are treated as a sample of data. A representative result cannot be obtained from a sample population of less than one thousand.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3154825" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3156138" role="code">DVAR(Database; DatabaseField; SearchCriteria)</paragraph> <embed href="text/scalc/01/04060101.xhp#quotes"/> - <paragraph xml-lang="en-US" id="hd_id3151257" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153701" role="paragraph">To find the variance of the weight of all children of the same age of the above example (scroll up, please), enter the following formula in B16:</paragraph> <paragraph xml-lang="en-US" id="par_id3153676" role="paragraph"> <item type="input">=DVAR(A1:E10;"Weight";A13:E14)</item> @@ -618,10 +618,10 @@ <paragraph xml-lang="en-US" id="hd_id3153880" role="heading" level="2">DVARP</paragraph> <paragraph xml-lang="en-US" id="par_id3155119" role="paragraph"><ahelp hid="HID_FUNC_DBVARIANZEN">DVARP calculates the variance of all cell values in a database field in all records that match the specified search criteria.</ahelp> The records are from the example are treated as an entire population.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3145774" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153776" role="code">DVARP(Database; DatabaseField; SearchCriteria)</paragraph> <embed href="text/scalc/01/04060101.xhp#quotes"/> - <paragraph xml-lang="en-US" id="hd_id3151110" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3147099" role="paragraph">To find the variance of the weight for all children of the same age at Joe's birthday party (scroll up, please), enter the following formula in B16:</paragraph> <paragraph xml-lang="en-US" id="par_id3147322" role="paragraph"> <item type="input">=DVARP(A1:E10;"Weight";A13:E14)</item> diff --git a/source/text/scalc/01/04060103.xhp b/source/text/scalc/01/04060103.xhp index d9dc2d47a5..4592d9d5f0 100644 --- a/source/text/scalc/01/04060103.xhp +++ b/source/text/scalc/01/04060103.xhp @@ -43,7 +43,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_AMORDEGRC" id="bm_id3152578" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153366" role="heading" level="2">AMORDEGRC</paragraph> <paragraph xml-lang="en-US" id="par_id3147434" role="paragraph"><ahelp hid="HID_AAI_FUNC_AMORDEGRC">Calculates the amount of depreciation for a settlement period as degressive amortization.</ahelp> Unlike AMORLINC, a depreciation coefficient that is independent of the depreciable life is used here.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3155855" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3147427" role="code">AMORDEGRC(Cost; DatePurchased; FirstPeriod; Salvage; Period; Rate; Basis)</paragraph> <paragraph xml-lang="en-US" id="par_id3147125" role="paragraph"> <emph>Cost</emph> is the acquisition costs.</paragraph> @@ -66,7 +66,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_AMORLINC" id="bm_id3153711" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153765" role="heading" level="2">AMORLINC</paragraph> <paragraph xml-lang="en-US" id="par_id3159264" role="paragraph"><ahelp hid="HID_AAI_FUNC_AMORLINC">Calculates the amount of depreciation for a settlement period as linear amortization. If the capital asset is purchased during the settlement period, the proportional amount of depreciation is considered.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3150044" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3147363" role="code">AMORLINC(Cost; DatePurchased; FirstPeriod; Salvage; Period; Rate; Basis)</paragraph> <paragraph xml-lang="en-US" id="par_id3146920" role="paragraph"> <emph>Cost</emph> means the acquisition costs.</paragraph> @@ -90,7 +90,7 @@ <bookmark xml-lang="en-US" branch="index" id="bm_id3151276"><bookmark_value>accrued interests;periodic payments</bookmark_value> </bookmark><comment>mw changed "accrued interests"</comment> <paragraph xml-lang="en-US" id="par_id3151276" role="paragraph"><ahelp hid="HID_AAI_FUNC_ACCRINT">Calculates the accrued interest of a security in the case of periodic payments.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3152581" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3159092" role="code">ACCRINT(Issue; FirstInterest; Settlement; Rate; Par; Frequency; Basis)</paragraph> <paragraph xml-lang="en-US" id="par_id3150519" role="paragraph"> <emph>Issue</emph> (required) is the issue date of the security.</paragraph> @@ -105,7 +105,7 @@ <paragraph xml-lang="en-US" id="par_id3149406" role="paragraph"> <emph>Frequency</emph> (required) is the number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> - <paragraph xml-lang="en-US" id="hd_id3148699" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3148599" role="paragraph">A security is issued on 2001-02-28. First interest is set for 2001-08-31. The settlement date is 2001-05-01. The Rate is 0.1 or 10% and Par is 1000 currency units. Interest is paid half-yearly (frequency is 2). The basis is the US method (0). How much interest has accrued?</paragraph> <paragraph xml-lang="en-US" id="par_id3148840" role="paragraph"> <item type="input">=ACCRINT("2001-02-28";"2001-08-31";"2001-05-01";0.1;1000;2;0)</item> returns 16.94444.</paragraph> @@ -117,7 +117,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_ACCRINTM" id="bm_id3148866" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3151240" role="heading" level="2">ACCRINTM</paragraph> <paragraph xml-lang="en-US" id="par_id3157981" role="paragraph"><ahelp hid="HID_AAI_FUNC_ACCRINTM">Calculates the accrued interest of a security in the case of one-off payment at the settlement date.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3159097" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3147074" role="code">ACCRINTM(Issue; Settlement; Rate; Par; Basis)</paragraph> <paragraph xml-lang="en-US" id="par_id3144773" role="paragraph"> <emph>Issue</emph> (required) is the issue date of the security.</paragraph> @@ -128,7 +128,7 @@ <paragraph xml-lang="en-US" id="par_id3159204" role="paragraph"> <emph>Par</emph> (optional) is the par value of the security.</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> - <paragraph xml-lang="en-US" id="hd_id3155384" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3154541" role="paragraph">A security is issued on 2001-04-01. The maturity date is set for 2001-06-15. The Rate is 0.1 or 10% and Par is 1000 currency units. The basis of the daily/annual calculation is the daily balance (3). How much interest has accrued?</paragraph> <paragraph xml-lang="en-US" id="par_id3149128" role="paragraph"> <item type="input">=ACCRINTM("2001-04-01";"2001-06-15";0.1;1000;3)</item> returns 20.54795.</paragraph> @@ -140,7 +140,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_RECEIVED" id="bm_id3143218" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3145753" role="heading" level="2">RECEIVED</paragraph> <paragraph xml-lang="en-US" id="par_id3150051" role="paragraph"><ahelp hid="HID_AAI_FUNC_RECEIVED">Calculates the amount received that is paid for a fixed-interest security at a given point in time.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3149385" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3145362" role="code">RECEIVED("Settlement"; "Maturity"; Investment; Discount; Basis)</paragraph> <paragraph xml-lang="en-US" id="par_id3154654" role="paragraph"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -151,7 +151,7 @@ <paragraph xml-lang="en-US" id="par_id3155760" role="paragraph"> <emph>Discount</emph> is the percentage discount on acquisition of the security.</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> - <paragraph xml-lang="en-US" id="hd_id3154710" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3154735" role="paragraph">Settlement date: February 15 1999, maturity date: May 15 1999, investment sum: 1000 currency units, discount: 5.75 per cent, basis: Daily balance/360 = 2.</paragraph> <paragraph xml-lang="en-US" id="par_id3146108" role="paragraph">The amount received on the maturity date is calculated as follows:</paragraph> <paragraph xml-lang="en-US" id="par_id3147246" role="paragraph"> @@ -167,7 +167,7 @@ <paragraph xml-lang="en-US" id="par_id3153301" role="paragraph"><ahelp hid="HID_FUNC_BW">Returns the present value of an investment resulting from a series of regular payments.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id3146099" role="paragraph">Use this function to calculate the amount of money needed to be invested at a fixed rate today, to receive a specific amount, an annuity, over a specified number of periods. You can also determine how much money is to remain after the elapse of the period. Specify as well if the amount is to be paid out at the beginning or at the end of each period.</paragraph> <paragraph xml-lang="en-US" id="par_id3153334" role="paragraph">Enter these values either as numbers, expressions or references. If, for example, interest is paid annually at 8%, but you want to use month as your period, enter 8%/12 under <emph>Rate</emph> and <item type="productname">%PRODUCTNAME</item> Calc with automatically calculate the correct factor.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3147407" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150395" role="code">PV(Rate; NPer; Pmt; FV; Type)</paragraph> <paragraph xml-lang="en-US" id="par_id3151341" role="paragraph"> <emph>Rate</emph> defines the interest rate per period.</paragraph> @@ -182,7 +182,7 @@ <paragraph xml-lang="en-US" id="par_idN10B13" role="paragraph" localize="false"> <embedvar href="text/scalc/00/00000004.xhp#optional"/> </paragraph> - <paragraph xml-lang="en-US" id="hd_id3150037" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3145225" role="paragraph">What is the present value of an investment, if 500 currency units are paid out monthly and the annual interest rate is 8%? The payment period is 48 months and 20,000 currency units are to remain at the end of the payment period.</paragraph> <paragraph xml-lang="en-US" id="par_id3155907" role="paragraph"> <item type="input">=PV(8%/12;48;500;20000)</item> = -35,019.37 currency units. Under the named conditions, you must deposit 35,019.37 currency units today, if you want to receive 500 currency units per month for 48 months and have 20,000 currency units left over at the end. Cross-checking shows that 48 x 500 currency units + 20,000 currency units = 44,000 currency units. The difference between this amount and the 35,000 currency units deposited represents the interest paid.</paragraph> @@ -198,7 +198,7 @@ <paragraph xml-lang="en-US" id="hd_id3152978" role="heading" level="2">SYD</paragraph> <paragraph xml-lang="en-US" id="par_id3148732" role="paragraph"><ahelp hid="HID_FUNC_DIA">Returns the arithmetic-declining depreciation rate.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id3149886" role="paragraph">Use this function to calculate the depreciation amount for one period of the total depreciation span of an object. Arithmetic declining depreciation reduces the depreciation amount from period to period by a fixed sum.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3149431" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150483" role="code">SYD(Cost; Salvage; Life; Period)</paragraph> <paragraph xml-lang="en-US" id="par_id3146879" role="paragraph"> <emph>Cost</emph> is the initial cost of an asset.</paragraph> @@ -208,7 +208,7 @@ <emph>Life</emph> is the period fixing the time span over which an asset is depreciated.</paragraph> <paragraph xml-lang="en-US" id="par_id3147473" role="paragraph"> <emph>Period</emph> defines the period for which the depreciation is to be calculated.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3148434" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149688" role="paragraph">A video system initially costing 50,000 currency units is to be depreciated annually for the next 5 years. The salvage value is to be 10,000 currency units. You want to calculate depreciation for the first year.</paragraph> <paragraph xml-lang="en-US" id="par_id3150900" role="paragraph"> <item type="input">=SYD(50000;10000;5;1)</item>=13,333.33 currency units. The depreciation amount for the first year is 13,333.33 currency units.</paragraph> @@ -540,7 +540,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DISC" id="bm_id3149290" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3155104" role="heading" level="2">DISC</paragraph> <paragraph xml-lang="en-US" id="par_id3153891" role="paragraph"><ahelp hid="HID_AAI_FUNC_DISC">Calculates the allowance (discount) of a security as a percentage.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3153982" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149756" role="code">DISC("Settlement"; "Maturity"; Price; Redemption; Basis)</paragraph> <paragraph xml-lang="en-US" id="par_id3156014" role="paragraph"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -551,7 +551,7 @@ <paragraph xml-lang="en-US" id="par_id3147253" role="paragraph"> <emph>Redemption</emph> is the redemption value of the security per 100 currency units of par value.</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> - <paragraph xml-lang="en-US" id="hd_id3151174" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3155902" role="paragraph">A security is purchased on 2001-01-25; the maturity date is 2001-11-15. The price (purchase price) is 97, the redemption value is 100. Using daily balance calculation (basis 3) how high is the settlement (discount)?</paragraph> <paragraph xml-lang="en-US" id="par_id3152797" role="paragraph"> <item type="input">=DISC("2001-01-25";"2001-11-15";97;100;3)</item> returns about 0.0372 or 3.72 per cent.</paragraph> @@ -565,7 +565,7 @@ <paragraph xml-lang="en-US" id="hd_id3154695" role="heading" level="2">DURATION_ADD</paragraph> <paragraph xml-lang="en-US" id="par_id3145768" role="paragraph"><ahelp hid="HID_AAI_FUNC_DURATION">Calculates the duration of a fixed interest security in years.</ahelp></paragraph> <embed href="text/scalc/01/04060102.xhp#ADD_note"/> - <paragraph xml-lang="en-US" id="hd_id3153904" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153373" role="code">DURATION_ADD("Settlement"; "Maturity"; Coupon; Yield; Frequency; Basis)</paragraph> <paragraph xml-lang="en-US" id="par_id3155397" role="paragraph"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -578,7 +578,7 @@ <paragraph xml-lang="en-US" id="par_id3149906" role="paragraph"> <emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> - <paragraph xml-lang="en-US" id="hd_id3146995" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3148834" role="paragraph">A security is purchased on 2001-01-01; the maturity date is 2006-01-01. The Coupon rate of interest is 8%. The yield is 9.0%. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how long is the duration?</paragraph> <paragraph xml-lang="en-US" id="par_id3154902" role="paragraph"> <item type="input">=DURATION_ADD("2001-01-01";"2006-01-01";0.08;0.09;2;3)</item> @@ -594,13 +594,13 @@ <paragraph xml-lang="en-US" id="hd_id3159147" role="heading" level="2">EFFECTIVE</paragraph> <paragraph xml-lang="en-US" id="par_id3154204" role="paragraph"><ahelp hid="HID_FUNC_EFFEKTIV">Returns the net annual interest rate for a nominal interest rate.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id3145417" role="paragraph">Nominal interest refers to the amount of interest due at the end of a calculation period. Effective interest increases with the number of payments made. In other words, interest is often paid in installments (for example, monthly or quarterly) before the end of the calculation period.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3150510" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3148805" role="code">EFFECTIVE(Nom; P)</paragraph> <paragraph xml-lang="en-US" id="par_id3149768" role="paragraph"> <emph>Nom</emph> is the nominal interest.</paragraph> <paragraph xml-lang="en-US" id="par_id3149334" role="paragraph"> <emph>P</emph> is the number of interest payment periods per year.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3154223" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3144499" role="paragraph">If the annual nominal interest rate is 9.75% and four interest calculation periods are defined, what is the actual interest rate (effective rate)?</paragraph> <paragraph xml-lang="en-US" id="par_id3150772" role="paragraph"> <item type="input">=EFFECTIVE(9.75%;4)</item> = 10.11% The annual effective rate is therefore 10.11%.</paragraph> @@ -613,13 +613,13 @@ <paragraph xml-lang="en-US" id="hd_id3147241" role="heading" level="2">EFFECT_ADD</paragraph> <paragraph xml-lang="en-US" id="par_id3147524" role="paragraph"><ahelp hid="HID_AAI_FUNC_EFFECT">Calculates the effective annual rate of interest on the basis of the nominal interest rate and the number of interest payments per annum.</ahelp></paragraph> <embed href="text/scalc/01/04060102.xhp#ADD_note"/> - <paragraph xml-lang="en-US" id="hd_id3155364" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155118" role="code">EFFECT_ADD(NominalRate; NPerY)</paragraph> <paragraph xml-lang="en-US" id="par_id3148907" role="paragraph"> <emph>NominalRate</emph> is the annual nominal rate of interest.</paragraph> <paragraph xml-lang="en-US" id="par_id3154274" role="paragraph"> <emph>NPerY </emph>is the number of interest payments per year.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3149156" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3158426" role="paragraph">What is the effective annual rate of interest for a 5.25% nominal rate and quarterly payment.</paragraph> <paragraph xml-lang="en-US" id="par_id3148927" role="paragraph"> <item type="input">=EFFECT_ADD(0.0525;4)</item> returns 0.053543 or 5.3543%.</paragraph> @@ -634,7 +634,7 @@ <paragraph xml-lang="en-US" id="hd_id3149998" role="heading" level="2">DDB</paragraph> <paragraph xml-lang="en-US" id="par_id3159190" role="paragraph"><ahelp hid="HID_FUNC_GDA">Returns the depreciation of an asset for a specified period using the arithmetic-declining method.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id3152361" role="paragraph">Use this form of depreciation if you require a higher initial depreciation value as opposed to linear depreciation. The depreciation value gets less with each period and is usually used for assets whose value loss is higher shortly after purchase (for example, vehicles, computers). Please note that the book value will never reach zero under this calculation type.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3156038" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3166452" role="code">DDB(Cost; Salvage; Life; Period; Factor)</paragraph> <paragraph xml-lang="en-US" id="par_id3153237" role="paragraph"> <emph>Cost</emph> fixes the initial cost of an asset.</paragraph> @@ -646,7 +646,7 @@ <emph>Period</emph> states the period for which the value is to be calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id3150243" role="paragraph"> <emph>Factor</emph> (optional) is the factor by which depreciation decreases. If a value is not entered, the default is factor 2.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3159274" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3152882" role="paragraph">A computer system with an initial cost of 75,000 currency units is to be depreciated monthly over 5 years. The value at the end of the depreciation is to be 1 currency unit. The factor is 2.</paragraph> <paragraph xml-lang="en-US" id="par_id3154106" role="paragraph"> <item type="input">=DDB(75000;1;60;12;2) </item>= 1,721.81 currency units. Therefore, the double-declining depreciation in the twelfth month after purchase is 1,721.81 currency units.</paragraph> @@ -661,7 +661,7 @@ <paragraph xml-lang="en-US" id="hd_id3149962" role="heading" level="2">DB</paragraph> <paragraph xml-lang="en-US" id="par_id3148989" role="paragraph"><ahelp hid="HID_FUNC_GDA2">Returns the depreciation of an asset for a specified period using the fixed-declining balance method.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id3156213" role="paragraph">This form of depreciation is used if you want to get a higher depreciation value at the beginning of the depreciation (as opposed to linear depreciation). The depreciation value is reduced with every depreciation period by the depreciation already deducted from the initial cost.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3149807" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153349" role="code">DB(Cost; Salvage; Life; Period; Month)</paragraph> <paragraph xml-lang="en-US" id="par_id3148462" role="paragraph"> <emph>Cost</emph> is the initial cost of an asset.</paragraph> @@ -673,7 +673,7 @@ <emph>Period</emph> is the length of each period. The length must be entered in the same date unit as the depreciation period.</paragraph> <paragraph xml-lang="en-US" id="par_id3150829" role="paragraph"> <emph>Month</emph> (optional) denotes the number of months for the first year of depreciation. If an entry is not defined, 12 is used as the default.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3151130" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3156147" role="paragraph">A computer system with an initial cost of 25,000 currency units is to be depreciated over a three year period. The salvage value is to be 1,000 currency units. One period is 30 days.</paragraph> <paragraph xml-lang="en-US" id="par_id3149513" role="paragraph"> <item type="input">=DB(25000;1000;36;1;6)</item> = 1,075.00 currency units</paragraph> @@ -688,13 +688,13 @@ <paragraph xml-lang="en-US" id="hd_id3153948" role="heading" level="2">IRR</paragraph> <paragraph xml-lang="en-US" id="par_id3143282" role="paragraph"><ahelp hid="HID_FUNC_IKV">Calculates the internal rate of return for an investment.</ahelp> The values represent cash flow values at regular intervals, at least one value must be negative (payments), and at least one value must be positive (income).</paragraph> <paragraph id="par_idN10E621" role="paragraph" xml-lang="en-US">If the payments take place at irregular intervals, use the <link href="text/scalc/01/04060118.xhp#xirr" name="XIRR">XIRR</link> function.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3150599" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155427" role="code">IRR(Values; Guess)</paragraph> <paragraph xml-lang="en-US" id="par_id3144758" role="paragraph"> <emph>Values</emph> represents an array containing the values.</paragraph> <paragraph xml-lang="en-US" id="par_id3149233" role="paragraph"> <emph>Guess</emph> (optional) is the estimated value. An iterative method is used to calculate the internal rate of return. If you can provide only few values, you should provide an initial guess to enable the iteration.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3151258" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150630" role="paragraph">Under the assumption that cell contents are A1=<item type="input">-10000</item>, A2=<item type="input">3500</item>, A3=<item type="input">7600</item> and A4=<item type="input">1000</item>, the formula <item type="input">=IRR(A1:A4)</item> gives a result of 11,33%.</paragraph> <paragraph xml-lang="en-US" id="par_id461513468030965" role="warning">Because of the iterative method used, it is possible for IRR to fail and return <link href="text/scalc/05/02140000.xhp" name="Error 523">Error 523</link>, with "Error: Calculation does not converge" in the status bar. In that case, try another value for Guess.</paragraph> </section> @@ -706,7 +706,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISPMT" id="bm_id3149491" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3151012" role="heading" level="2">ISPMT</paragraph> <paragraph xml-lang="en-US" id="par_id3148693" role="paragraph"><ahelp hid="HID_FUNC_ISPMT">Calculates the level of interest for unchanged amortization installments.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3154661" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3146070" role="code">ISPMT(Rate; Period; TotalPeriods; Invest)</paragraph> <paragraph xml-lang="en-US" id="par_id3148672" role="paragraph"> <emph>Rate</emph> sets the periodic interest rate.</paragraph> @@ -716,7 +716,7 @@ <emph>TotalPeriods</emph> is the total number of installment periods.</paragraph> <paragraph xml-lang="en-US" id="par_id3159390" role="paragraph"> <emph>Invest</emph> is the amount of the investment.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3156162" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149558" role="paragraph">For a credit amount of 120,000 currency units with a two-year term and monthly installments, at a yearly interest rate of 12% the level of interest after 1.5 years is required.</paragraph> <paragraph xml-lang="en-US" id="par_id3150949" role="paragraph"> <item type="input">=ISPMT(1%;18;24;120000)</item> = -300 currency units. The monthly interest after 1.5 years amounts to 300 currency units.</paragraph> diff --git a/source/text/scalc/01/04060104.xhp b/source/text/scalc/01/04060104.xhp index 38c38016e1..db7bb6c02f 100644 --- a/source/text/scalc/01/04060104.xhp +++ b/source/text/scalc/01/04060104.xhp @@ -155,7 +155,7 @@ <paragraph id="hd_id5787224" role="heading" level="2" xml-lang="en-US">INFO</paragraph> <paragraph id="par_id1507309" role="paragraph" xml-lang="en-US">Returns specific information about the current working environment. The function receives a single text argument and returns data depending on that parameter.</paragraph> -<paragraph id="hd_id7693411" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3928952" role="code" xml-lang="en-US">INFO("Type")</paragraph> <paragraph id="par_id5206762" role="paragraph" xml-lang="en-US">The following table lists the values for the text parameter <item type="literal">Type</item> and the return values of the INFO function.</paragraph> @@ -212,7 +212,7 @@ <paragraph id="par_id1161534" role="note" xml-lang="en-US">Other spreadsheet applications may accept localized values for the <item type="literal">Type</item> parameter, but %PRODUCTNAME Calc will only accept the English values.</paragraph> -<paragraph id="hd_id5459456" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3994567" role="paragraph" xml-lang="en-US"><item type="input">=INFO("release")</item> returns the product release number of the %PRODUCTNAME in use.<comment>Do not translate "release"</comment></paragraph> <paragraph id="par_id2873622" role="paragraph" xml-lang="en-US"><item type="input">=INFO(D5)</item> with cell <item type="literal">D5</item> containing a text string <item type="literal">system</item> returns the operation system type.<comment>Do not translate the hlp_literal system</comment></paragraph> </section> @@ -227,10 +227,10 @@ <paragraph id="hd_id3155625" role="heading" level="2" xml-lang="en-US">CURRENT</paragraph> <paragraph id="par_id3157975" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_AKTUELL">This function returns the result to date of evaluating the formula of which it is a part (in other words the result as far as that evaluation has got). Its main use is together with the STYLE() function to apply selected styles to a cell depending on the cell contents.</ahelp></paragraph> -<paragraph id="hd_id3148880" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150930" role="code" xml-lang="en-US">CURRENT()</paragraph> -<paragraph id="hd_id3145629" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id5919064" role="paragraph" xml-lang="en-US"><item type="input">=1+2+CURRENT()</item></paragraph> <paragraph id="par_id8751792" role="paragraph" xml-lang="en-US">The example returns 6. The formula is calculated from left to right as: 1 + 2 equals 3, giving the result to date when CURRENT() is encountered; CURRENT() therefore yields 3, which is added to the original 3 to give 6.</paragraph> <paragraph id="par_id5863826" role="paragraph" xml-lang="en-US"><item type="input">=A2+B2+STYLE(IF(CURRENT()>10;”Red”;”Default”))</item></paragraph> @@ -251,12 +251,12 @@ <paragraph id="hd_id3150688" role="heading" level="2" xml-lang="en-US">FORMULA</paragraph> <paragraph id="par_id3158417" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FORMEL">Displays the formula of a formula cell as a text string.</ahelp></paragraph> -<paragraph id="hd_id3154954" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3147535" role="code" xml-lang="en-US">FORMULA(Reference)</paragraph> <paragraph id="par_id3014313" role="paragraph" xml-lang="en-US"><emph>Reference</emph> is a reference to a cell containing a formula.</paragraph> <paragraph id="par_id8857081" role="paragraph" xml-lang="en-US">An invalid reference or a reference to a cell with no formula results in the error value #N/A.</paragraph> -<paragraph id="hd_id3152820" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3153179" role="paragraph" xml-lang="en-US">If cell A8 contains the formula <item type="input">=SUM(1;2;3)</item> then</paragraph> <paragraph id="par_id3153923" role="paragraph" xml-lang="en-US"><item type="input">=FORMULA(A8)</item> returns the text =SUM(1;2;3).</paragraph> </section> @@ -274,11 +274,11 @@ <paragraph id="par_id3153723" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTBEZUG">Tests if the argument is a reference.</ahelp> Returns TRUE if the argument is a reference, returns FALSE otherwise. When given a reference this function does not examine the value being referenced.<comment>i82565</comment></paragraph> <embed href="text/shared/00/00000001.xhp#wahr"/> -<paragraph id="hd_id3147175" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149821" role="code" xml-lang="en-US">ISREF(Value)</paragraph> <paragraph id="par_id3146152" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the value to be tested, to determine whether it is a reference.</paragraph> -<paragraph id="hd_id3083448" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154317" role="paragraph" xml-lang="en-US"><item type="input">=ISREF(C5)</item> returns the result TRUE because C5 is a valid reference.</paragraph> <paragraph id="par_id9728072" role="paragraph" xml-lang="en-US"><item type="input">=ISREF("abcdef")</item> returns always FALSE because a text can never be a reference.</paragraph> <paragraph id="par_id2131544" role="paragraph" xml-lang="en-US"><item type="input">=ISREF(4)</item> returns FALSE.</paragraph> @@ -298,11 +298,11 @@ <paragraph id="par_id3149282" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTFEHL">Tests for error conditions, except the #N/A error value, and returns TRUE or FALSE.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#wahr"/> -<paragraph id="hd_id3149450" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3156312" role="code" xml-lang="en-US">ISERR(Value)</paragraph> <paragraph id="par_id3146857" role="paragraph" xml-lang="en-US"><emph>Value</emph> is any value or expression which is tested to see whether an error value other than #N/A is present.</paragraph> -<paragraph id="hd_id3153212" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3153276" role="paragraph" xml-lang="en-US"><item type="input">=ISERR(C8)</item> where cell C8 contains <item type="input">=1/0</item> returns TRUE, because 1/0 is an error.</paragraph> <paragraph id="par_id8456984" role="paragraph" xml-lang="en-US"><item type="input">=ISERR(C9)</item> where cell C9 contains <item type="input">=NA()</item> returns FALSE, because ISERR() ignores the #N/A error.</paragraph> </section> @@ -319,11 +319,11 @@ <paragraph id="par_id3156316" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTFEHLER">Tests for error conditions, including the #N/A error value, and returns TRUE or FALSE.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#wahr"/> -<paragraph id="hd_id3147569" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3153155" role="code" xml-lang="en-US">ISERROR(Value)</paragraph> <paragraph id="par_id3154047" role="paragraph" xml-lang="en-US"><emph>Value</emph> is or refers to the value to be tested. ISERROR() returns TRUE if there is an error and FALSE if not.</paragraph> -<paragraph id="hd_id3155994" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3150256" role="paragraph" xml-lang="en-US"><item type="input">=ISERROR(C8)</item> where cell C8 contains <item type="input">=1/0</item> returns TRUE, because 1/0 is an error.</paragraph> <paragraph id="par_id1889095" role="paragraph" xml-lang="en-US"><item type="input">=ISERROR(C9)</item> where cell C9 contains <item type="input">=NA()</item> returns TRUE.</paragraph> </section> @@ -339,12 +339,12 @@ <paragraph id="hd_id31470811" role="heading" level="2" xml-lang="en-US">IFERROR</paragraph> <paragraph id="par_id31563161" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_IFERROR">Returns the value if the cell does not contains an error value, or the alternative value if it does.</ahelp></paragraph> -<paragraph id="hd_id31475691" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id31531551" role="code" xml-lang="en-US">IFERROR(Value;Alternate_value)</paragraph> <paragraph id="par_id31540471" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the value or expression to be returned if it is not equal or results in an error.</paragraph> <paragraph id="par_id31540472" role="paragraph" xml-lang="en-US"><emph>Alternate_value</emph> is the value or expression to be returned if the expression or value of <emph>Value</emph> is equal or results in an error.</paragraph> -<paragraph id="hd_id31559941" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id31502561" role="paragraph" xml-lang="en-US"><item type="input">=IFERROR(C8;C9)</item> where cell C8 contains <item type="input">=1/0</item> returns the value of C9, because 1/0 is an error.</paragraph> <paragraph id="par_id18890951" role="paragraph" xml-lang="en-US"><item type="input">=IFERROR(C8;C9)</item> where cell C8 contains <item type="input">13</item> returns 13, the value of C8, which is not an error.</paragraph> </section> @@ -362,11 +362,11 @@ <paragraph id="par_id3149138" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTFORMEL">Returns TRUE if a cell is a formula cell.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#wahr"/> -<paragraph id="hd_id3155100" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3143230" role="code" xml-lang="en-US">ISFORMULA(Reference)</paragraph> <paragraph id="par_id3150150" role="paragraph" xml-lang="en-US"><emph>Reference</emph> indicates the reference to a cell in which a test will be performed to determine if it contains a formula.</paragraph> -<paragraph id="hd_id3147491" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3159182" role="paragraph" xml-lang="en-US"><item type="input">=ISFORMULA(C4)</item> returns FALSE if the cell C4 contains the number <item type="input">5</item>.</paragraph> </section> @@ -381,12 +381,12 @@ <paragraph id="hd_id3156048" role="heading" level="2" xml-lang="en-US">ISEVEN</paragraph> <paragraph id="par_id3149170" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTGERADE">Returns TRUE if the value is an even integer, or FALSE if the value is odd.</ahelp></paragraph> -<paragraph id="hd_id3146928" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3151203" role="code" xml-lang="en-US">ISEVEN(Value)</paragraph> <paragraph id="par_id3150491" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the value to be checked.</paragraph> <paragraph id="par_id3445844" role="paragraph" xml-lang="en-US">If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored.</paragraph> -<paragraph id="hd_id3154136" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3163813" role="paragraph" xml-lang="en-US"><item type="input">=ISEVEN(48)</item> returns TRUE</paragraph> <paragraph id="par_id8378856" role="paragraph" xml-lang="en-US"><item type="input">=ISEVEN(33)</item> returns FALSE</paragraph> <paragraph id="par_id7154759" role="paragraph" xml-lang="en-US"><item type="input">=ISEVEN(0)</item> returns TRUE</paragraph> @@ -405,11 +405,11 @@ <paragraph id="par_id3147253" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ISEVEN">Tests for even numbers. Returns 1 if the number divided by 2 returns a whole number.</ahelp></paragraph> <embed href="text/scalc/01/04060102.xhp#ADD_note"/> -<paragraph id="hd_id3152799" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149202" role="code" xml-lang="en-US">ISEVEN_ADD(Number)</paragraph> <paragraph id="par_id3151168" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number to be tested.</paragraph> -<paragraph id="hd_id3150115" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3153904" role="paragraph" xml-lang="en-US"><item type="input">=ISEVEN_ADD(5)</item> returns 0.</paragraph> <paragraph id="par_id6238308" role="paragraph" xml-lang="en-US"><item type="input">=ISEVEN_ADD(A1)</item> returns 1 if cell A1 contains the number <item type="input">2</item>.</paragraph> </section> @@ -426,11 +426,11 @@ <paragraph id="par_id3155330" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTKTEXT">Tests if the cell contents are text or numbers, and returns FALSE if the contents are text.</ahelp></paragraph> <paragraph id="par_id5719779" role="paragraph" xml-lang="en-US">If an error occurs, the function returns TRUE.</paragraph> -<paragraph id="hd_id3154931" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148829" role="code" xml-lang="en-US">ISNONTEXT(Value)</paragraph> <paragraph id="par_id3146992" role="paragraph" xml-lang="en-US"><emph>Value</emph> is any value or expression where a test is performed to determine whether it is a text or numbers or a Boolean value.</paragraph> -<paragraph id="hd_id3150525" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3149906" role="paragraph" xml-lang="en-US"><item type="input">=ISNONTEXT(D2)</item> returns FALSE if cell D2 contains the text <item type="input">abcdef</item>.</paragraph> <paragraph id="par_id3150777" role="paragraph" xml-lang="en-US"><item type="input">=ISNONTEXT(D9)</item> returns TRUE if cell D9 contains the number <item type="input">8</item>.</paragraph> </section> @@ -448,11 +448,11 @@ <paragraph id="par_id3148800" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTLEER">Returns TRUE if the reference to a cell is blank.</ahelp> This function is used to determine if the content of a cell is empty. A cell with a formula inside is not empty.</paragraph> <embed href="text/shared/00/00000001.xhp#wahr"/> -<paragraph id="hd_id3159162" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3158406" role="code" xml-lang="en-US">ISBLANK(Value)</paragraph> <paragraph id="par_id3154212" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the content to be tested.</paragraph> -<paragraph id="hd_id3147508" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3147234" role="paragraph" xml-lang="en-US"><item type="input">=ISBLANK(D2)</item> returns FALSE as a result.</paragraph> </section> @@ -469,11 +469,11 @@ <paragraph id="par_id3148926" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTLOG">Tests for a logical value (TRUE or FALSE).</ahelp></paragraph> <paragraph id="par_id3541062" role="paragraph" xml-lang="en-US">If an error occurs, the function returns FALSE.</paragraph> -<paragraph id="hd_id3149162" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148918" role="code" xml-lang="en-US">ISLOGICAL(Value)</paragraph> <paragraph id="par_id3146946" role="paragraph" xml-lang="en-US">Returns TRUE if <emph>Value</emph> is a logical value (TRUE or FALSE), and returns FALSE otherwise.</paragraph> -<paragraph id="hd_id3150709" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3166442" role="paragraph" xml-lang="en-US"><item type="input">=ISLOGICAL(99)</item> returns FALSE, because 99 is a number, not a logical value.</paragraph> <paragraph id="par_id3556016" role="paragraph" xml-lang="en-US"><item type="input">=ISLOGICAL(ISNA(D4))</item> returns TRUE whatever the contents of cell D4, because ISNA() returns a logical value.</paragraph> </section> @@ -490,11 +490,11 @@ <paragraph id="par_id3149105" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTNV">Returns TRUE if a cell contains the #N/A (value not available) error value.</ahelp></paragraph> <paragraph id="par_id6018860" role="paragraph" xml-lang="en-US">If an error occurs, the function returns FALSE.</paragraph> -<paragraph id="hd_id3152947" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3153748" role="code" xml-lang="en-US">ISNA(Value)</paragraph> <paragraph id="par_id3152884" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the value or expression to be tested.</paragraph> -<paragraph id="hd_id3149964" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154852" role="paragraph" xml-lang="en-US"><item type="input">=ISNA(D3)</item> returns FALSE as a result.</paragraph> </section> @@ -509,12 +509,12 @@ <paragraph id="hd_id31536851" role="heading" level="2" xml-lang="en-US">IFNA</paragraph> <paragraph id="par_id31491051" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_IFNA">Returns the value if the cell does not contains the #N/A (value not available) error value, or the alternative value if it does.</ahelp></paragraph> -<paragraph id="hd_id31529471" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id31537481" role="code" xml-lang="en-US">IFNA(Value;Alternate_value)</paragraph> <paragraph id="par_id31528841" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the value or expression to be returned if it is not equal or results in an #N/A error.</paragraph> <paragraph id="par_id31528842" role="paragraph" xml-lang="en-US"><emph>Alternate_value</emph> is the value or expression to be returned if the expression or value of <emph>Value</emph> is equal or results in an #N/A error.</paragraph> -<paragraph id="hd_id31499641" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id31548521" role="paragraph" xml-lang="en-US"><item type="input">=IFNA(D3;D4)</item> returns the value of D3 if D3 does not result in an #N/A error, or D4 if it does.</paragraph> </section> @@ -530,11 +530,11 @@ <paragraph id="par_id3145368" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTTEXT">Returns TRUE if the cell contents refer to text.</ahelp></paragraph> <paragraph id="par_id6779686" role="paragraph" xml-lang="en-US">If an error occurs, the function returns FALSE.</paragraph> -<paragraph id="hd_id3154332" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148649" role="code" xml-lang="en-US">ISTEXT(Value)</paragraph> <paragraph id="par_id3150417" role="paragraph" xml-lang="en-US"><emph>Value</emph> is a value, number, Boolean value, or an error value to be tested.</paragraph> -<paragraph id="hd_id3149239" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3144756" role="paragraph" xml-lang="en-US"><item type="input">=ISTEXT(D9)</item> returns TRUE if cell D9 contains the text <item type="input">abcdef</item>.</paragraph> <paragraph id="par_id3148416" role="paragraph" xml-lang="en-US"><item type="input">=ISTEXT(C3)</item> returns FALSE if cell C3 contains the number <item type="input">3</item>.</paragraph> </section> @@ -550,12 +550,12 @@ <paragraph id="hd_id3156034" role="heading" level="2" xml-lang="en-US">ISODD</paragraph> <paragraph id="par_id3155920" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTUNGERADE">Returns TRUE if the value is odd, or FALSE if the number is even.</ahelp></paragraph> -<paragraph id="hd_id3151006" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3151375" role="code" xml-lang="en-US">ISODD(value)</paragraph> <paragraph id="par_id3155139" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the value to be checked.</paragraph> <paragraph id="par_id9027680" role="paragraph" xml-lang="en-US">If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored.</paragraph> -<paragraph id="hd_id3163723" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3155345" role="paragraph" xml-lang="en-US"><item type="input">=ISODD(33)</item> returns TRUE</paragraph> <paragraph id="par_id9392986" role="paragraph" xml-lang="en-US"><item type="input">=ISODD(48)</item> returns FALSE</paragraph> <paragraph id="par_id5971251" role="paragraph" xml-lang="en-US"><item type="input">=ISODD(3.999)</item> returns TRUE</paragraph> @@ -573,11 +573,11 @@ <paragraph id="par_id3153538" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ISODD">Returns TRUE (1) if the number does not return a whole number when divided by 2.</ahelp></paragraph> <embed href="text/scalc/01/04060102.xhp#ADD_note"/> -<paragraph id="hd_id3145601" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149485" role="code" xml-lang="en-US">ISODD_ADD(Number)</paragraph> <paragraph id="par_id3153315" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number to be tested.</paragraph> -<paragraph id="hd_id3143274" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154793" role="paragraph" xml-lang="en-US"><item type="input">=ISODD_ADD(5)</item> returns 1.</paragraph> </section> @@ -593,11 +593,11 @@ <paragraph id="par_id3154618" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTZAHL">Returns TRUE if the value refers to a number.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#wahr"/> -<paragraph id="hd_id3152769" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150595" role="code" xml-lang="en-US">ISNUMBER(Value)</paragraph> <paragraph id="par_id3150351" role="paragraph" xml-lang="en-US"><emph>Value</emph> is any expression to be tested to determine whether it is a number or text.</paragraph> -<paragraph id="hd_id3146793" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3155614" role="paragraph" xml-lang="en-US"><item type="input">=ISNUMBER(C3)</item> returns TRUE if the cell C3 contains the number <item type="input">4</item>.</paragraph> <paragraph id="par_id3154417" role="paragraph" xml-lang="en-US"><item type="input">=ISNUMBER(C2)</item> returns FALSE if the cell C2 contains the text <item type="input">abcdef</item>.</paragraph> </section> @@ -613,11 +613,11 @@ <paragraph id="par_id3150405" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_N">Returns the numeric value of the given parameter. Returns 0 if parameter is text or FALSE.</ahelp></paragraph> <paragraph id="par_id9115573" role="paragraph" xml-lang="en-US">If an error occurs the function returns the error value.</paragraph> -<paragraph id="hd_id3145774" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3153883" role="code" xml-lang="en-US">N(Value)</paragraph> <paragraph id="par_id3151101" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the parameter to be converted into a number. N() returns the numeric value if it can. It returns the logical values TRUE and FALSE as 1 and 0 respectively. It returns text as 0.</paragraph> -<paragraph id="hd_id3147097" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154117" role="paragraph" xml-lang="en-US"><item type="input">=N(123)</item> returns 123</paragraph> <paragraph id="par_id2337717" role="paragraph" xml-lang="en-US"><item type="input">=N(TRUE())</item> returns 1</paragraph> <paragraph id="par_id3153781" role="paragraph" xml-lang="en-US"><item type="input">=N(FALSE())</item> returns 0</paragraph> @@ -636,10 +636,10 @@ <paragraph id="hd_id3156275" role="heading" level="2" xml-lang="en-US">NA</paragraph> <paragraph id="par_id3156161" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_NV">Returns the error value #N/A.</ahelp></paragraph> -<paragraph id="hd_id3147532" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149563" role="code" xml-lang="en-US">NA()</paragraph> -<paragraph id="hd_id3155128" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154481" role="paragraph" xml-lang="en-US"><item type="input">=NA()</item> converts the contents of the cell into #N/A.</paragraph> </section> @@ -654,7 +654,7 @@ <paragraph id="par_id3155900" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TYP">Returns the type of value, where 1 = number, 2 = text, 4 = Boolean value, 8 = formula, 16 = error value, 64 = array.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#wahr"/> -<paragraph id="hd_id3149992" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148400" role="code" xml-lang="en-US">TYPE(Value)</paragraph> <paragraph id="par_id3150830" role="paragraph" xml-lang="en-US"><emph>Value</emph> is a specific value for which the data type is determined.</paragraph> @@ -675,7 +675,7 @@ <paragraph id="hd_id3155509" role="heading" level="2" xml-lang="en-US">CELL</paragraph> <paragraph id="par_id3153196" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZELLE">Returns information on address, formatting or contents of a cell.</ahelp></paragraph> -<paragraph id="hd_id3149323" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3147355" role="code" xml-lang="en-US">CELL("InfoType"; Reference)</paragraph> <paragraph id="par_id3154716" role="paragraph" xml-lang="en-US"><emph>InfoType</emph> is the character string that specifies the type of information. The character string is always in English. Upper or lower case is optional.</paragraph> diff --git a/source/text/scalc/01/04060105.xhp b/source/text/scalc/01/04060105.xhp index 9a78019ae3..63c8289ec8 100644 --- a/source/text/scalc/01/04060105.xhp +++ b/source/text/scalc/01/04060105.xhp @@ -63,11 +63,11 @@ <paragraph xml-lang="en-US" id="hd_id3147505" role="heading" level="2">AND</paragraph> <paragraph xml-lang="en-US" id="par_id3153959" role="paragraph"><ahelp hid="HID_FUNC_UND">Returns TRUE if all arguments are TRUE.</ahelp> If one of the elements is FALSE, this function returns the FALSE value.</paragraph> <paragraph xml-lang="en-US" id="par_id3146100" role="paragraph">The arguments are either logical expressions themselves (TRUE, 1<5, 2+3=7, B8<10) that return logical values, or arrays (A1:C3) containing logical values.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3150374" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3159123" role="code">AND(LogicalValue1; LogicalValue2 ...LogicalValue30)</paragraph> <paragraph xml-lang="en-US" id="par_id3150038" role="paragraph"> <emph>LogicalValue1; LogicalValue2 ...LogicalValue30</emph> are conditions to be checked. All conditions can be either TRUE or FALSE. If a range is entered as a parameter, the function uses all values of the range. The result is TRUE if the logical value in all cells within the cell range is TRUE.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3149143" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153123" role="paragraph">The logical values of entries 12<13; 14>12, and 7<6 are to be checked:</paragraph> <paragraph xml-lang="en-US" id="par_id3145632" role="paragraph"> <item type="input">=AND(12<13;14>12;7<6)</item> returns FALSE.</paragraph> @@ -80,9 +80,9 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FALSCH" id="bm_id3154678" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3149015" role="heading" level="2">FALSE</paragraph> <paragraph xml-lang="en-US" id="par_id3149890" role="paragraph"><ahelp hid="HID_FUNC_FALSCH">Returns the logical value FALSE.</ahelp> The FALSE() function does not require any arguments, and always returns the logical value FALSE.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3146939" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150030" role="code">FALSE()</paragraph> - <paragraph xml-lang="en-US" id="hd_id3150697" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3154842" role="paragraph"> <item type="input">=FALSE()</item> returns FALSE</paragraph> <paragraph xml-lang="en-US" id="par_id3147468" role="paragraph"> @@ -94,7 +94,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WENN" id="bm_id3152789" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3150141" role="heading" level="2">IF</paragraph> <paragraph xml-lang="en-US" id="par_id3148740" role="paragraph"><ahelp hid="HID_FUNC_WENN">Specifies a logical test to be performed.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3153325" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154558" role="code">IF(Test; ThenValue; OtherwiseValue)</paragraph> <paragraph xml-lang="en-US" id="par_id3149727" role="paragraph"> <emph>Test</emph> is any value or expression that can be TRUE or FALSE.</paragraph> @@ -105,7 +105,7 @@ <paragraph xml-lang="en-US" id="par_idN107FA" role="paragraph" localize="false"> <embedvar href="text/scalc/00/00000004.xhp#optional"/> </paragraph> - <paragraph xml-lang="en-US" id="hd_id3149507" role="heading" level="3">Examples</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150867" role="paragraph"> <item type="input">=IF(A1>5;100;"too small")</item> If the value in A1 is higher than 5, the value 100 is entered in the current cell; otherwise, the text “too small” (without quotes) is entered.</paragraph> </section> @@ -115,11 +115,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NICHT" id="bm_id3145168" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3155954" role="heading" level="2">NOT</paragraph> <paragraph xml-lang="en-US" id="par_id3153570" role="paragraph"><ahelp hid="HID_FUNC_NICHT">Complements (inverts) a logical value.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3147372" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3157996" role="code">NOT(LogicalValue)</paragraph> <paragraph xml-lang="en-US" id="par_id3148766" role="paragraph"> <emph>LogicalValue</emph> is any value to be complemented.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3149884" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150132" role="paragraph"> <item type="input">=NOT(A)</item>. If A=TRUE then NOT(A) will evaluate FALSE.</paragraph> </section> @@ -130,11 +130,11 @@ <paragraph xml-lang="en-US" id="hd_id3148394" role="heading" level="2">OR</paragraph> <paragraph xml-lang="en-US" id="par_id3156060" role="paragraph"><ahelp hid="HID_FUNC_ODER">Returns TRUE if at least one argument is TRUE.</ahelp> This function returns the value FALSE, if all the arguments have the logical value FALSE.</paragraph> <paragraph xml-lang="en-US" id="par_id3148771" role="paragraph">The arguments are either logical expressions themselves (TRUE, 1<5, 2+3=7, B8<10) that return logical values, or arrays (A1:C3) containing logical values.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3155517" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150468" role="code">OR(LogicalValue1; LogicalValue2 ...LogicalValue30)</paragraph> <paragraph xml-lang="en-US" id="par_id3155819" role="paragraph"> <emph>LogicalValue1; LogicalValue2 ...LogicalValue30</emph> are conditions to be checked. All conditions can be either TRUE or FALSE. If a range is entered as a parameter, the function uses all values of the range.<comment>UFI: first try to fix bugtraq 4905779</comment></paragraph> - <paragraph xml-lang="en-US" id="hd_id3153228" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3154870" role="paragraph">The logical values of entries 12<11; 13>22, and 45=45 are to be checked.</paragraph> <paragraph xml-lang="en-US" id="par_id3155371" role="paragraph"> <item type="input">=OR(12<11;13>22;45=45)</item> returns TRUE.</paragraph> @@ -147,9 +147,9 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WAHR" id="bm_id3148426" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3156256" role="heading" level="2">TRUE</paragraph> <paragraph xml-lang="en-US" id="par_id3155985" role="paragraph"><ahelp hid="HID_FUNC_WAHR">The logical value is set to TRUE.</ahelp> The TRUE() function does not require any arguments, and always returns the logical value TRUE.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153717" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3152590" role="code">TRUE()</paragraph> - <paragraph xml-lang="en-US" id="hd_id3147175" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3146148" role="paragraph">If A=TRUE and B=FALSE the following examples appear:</paragraph> <paragraph xml-lang="en-US" id="par_id3083285" role="paragraph"> <item type="input">=AND(A;B)</item> returns FALSE</paragraph> @@ -165,9 +165,9 @@ <paragraph xml-lang="en-US" id="hd_id3156257" role="heading" level="2">XOR</paragraph> <paragraph xml-lang="en-US" id="par_id3155987" role="paragraph"><ahelp hid="HID_FUNC_XOR">Returns true if an odd number of arguments evaluates to TRUE.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id3148772" role="paragraph">The arguments are either logical expressions themselves (TRUE, 1<5, 2+3=7, B8<10) that return logical values, or arrays (A1:C3) containing logical values.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153718" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150469" role="code">XOR(LogicalValue1; LogicalValue2 ...LogicalValue30)</paragraph> - <paragraph xml-lang="en-US" id="hd_id3147176" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3083286" role="paragraph"> <item type="input">=XOR(TRUE;TRUE)</item> returns FALSE</paragraph> <paragraph xml-lang="en-US" id="par_id3083445" role="paragraph"> diff --git a/source/text/scalc/01/04060106.xhp b/source/text/scalc/01/04060106.xhp index 297f91c12c..5523e4b198 100644 --- a/source/text/scalc/01/04060106.xhp +++ b/source/text/scalc/01/04060106.xhp @@ -51,11 +51,11 @@ <paragraph id="hd_id3146944" role="heading" level="2" xml-lang="en-US">ABS</paragraph> <paragraph id="par_id3154546" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ABS">Returns the absolute value of a number.</ahelp></paragraph> -<paragraph id="hd_id3154843" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3155823" role="heading" level="3" xml-lang="en-US">Example</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> @@ -71,12 +71,12 @@ <paragraph id="hd_id3153114" role="heading" level="2" xml-lang="en-US">ACOS</paragraph> <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> -<paragraph id="hd_id3153565" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3149882" role="heading" level="3" xml-lang="en-US">Example</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"/> @@ -92,12 +92,12 @@ <paragraph id="hd_id3145355" role="heading" level="2" xml-lang="en-US">ACOSH</paragraph> <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> -<paragraph id="hd_id3145295" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3150566" role="heading" level="3" xml-lang="en-US">Example</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"/> @@ -113,12 +113,12 @@ <paragraph id="hd_id3149027" role="heading" level="2" xml-lang="en-US">ACOT</paragraph> <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> -<paragraph id="hd_id3153225" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3147538" role="heading" level="3" xml-lang="en-US">Example</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"/> @@ -134,12 +134,12 @@ <paragraph id="hd_id3148426" role="heading" level="2" xml-lang="en-US">ACOTH</paragraph> <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> -<paragraph id="hd_id3152585" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3083452" role="heading" level="3" xml-lang="en-US">Example</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> @@ -160,12 +160,12 @@ <paragraph id="hd_id3145084" role="heading" level="2" xml-lang="en-US">ASIN</paragraph> <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> -<paragraph id="hd_id3149716" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3149448" role="heading" level="3" xml-lang="en-US">Example</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> @@ -182,11 +182,11 @@ <paragraph id="hd_id3151266" role="heading" level="2" xml-lang="en-US">ASINH</paragraph> <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> -<paragraph id="hd_id3150763" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3153212" role="heading" level="3" xml-lang="en-US">Example</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"/> @@ -202,12 +202,12 @@ <paragraph id="hd_id3155996" role="heading" level="2" xml-lang="en-US">ATAN</paragraph> <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> -<paragraph id="hd_id3151294" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3154054" role="heading" level="3" xml-lang="en-US">Example</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"/> @@ -223,14 +223,14 @@ <paragraph id="hd_id3153983" role="heading" level="2" xml-lang="en-US">ATAN2</paragraph> <paragraph id="par_id3154297" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCTAN2">Returns the inverse trigonometric tangent of the specified x and y coordinates.</ahelp></paragraph> -<paragraph id="hd_id3149758" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<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_id3151168" 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> <paragraph id="par_id5036164" role="paragraph" xml-lang="en-US">ATAN2 returns the inverse trigonometric tangent, that is, the angle (in radians) between the x-axis and a line from point NumberX, NumberY to the origin. The angle returned is between -PI and PI.</paragraph> <paragraph id="par_id3001800" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph> -<paragraph id="hd_id3145663" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154692" role="paragraph" xml-lang="en-US"><item type="input">=ATAN2(20;20)</item> returns 0.785398163397448 (PI/4 radians).</paragraph> <paragraph id="par_id1477095" role="paragraph" xml-lang="en-US"><item type="input">=DEGREES(ATAN2(12.3;12.3))</item> returns 45. The tangent of 45 degrees is 1.</paragraph><comment>see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN, ACOT</comment> <embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> @@ -246,12 +246,12 @@ <paragraph id="hd_id3155398" role="heading" level="2" xml-lang="en-US">ATANH</paragraph> <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> -<paragraph id="hd_id3146997" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3148450" role="heading" level="3" xml-lang="en-US">Example</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> @@ -266,12 +266,12 @@ <paragraph id="hd_id3153062" role="heading" level="2" xml-lang="en-US">COS</paragraph> <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> -<paragraph id="hd_id3150779" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3153579" role="heading" level="3" xml-lang="en-US">Examples</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"/> @@ -287,11 +287,11 @@ <paragraph id="hd_id3154277" role="heading" level="2" xml-lang="en-US">COSH</paragraph> <paragraph id="par_id3146946" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COSHYP">Returns the hyperbolic cosine of a number.</ahelp></paragraph> -<paragraph id="hd_id3149792" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3153234" role="heading" level="3" xml-lang="en-US">Example</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> @@ -306,7 +306,7 @@ <paragraph id="hd_id3152888" role="heading" level="2" xml-lang="en-US">COT</paragraph> <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> -<paragraph id="hd_id3152943" role="heading" level="3" xml-lang="en-US">Syntax</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> @@ -328,11 +328,11 @@ <paragraph id="hd_id3154337" role="heading" level="2" xml-lang="en-US">COTH</paragraph> <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> -<paragraph id="hd_id3149242" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3155422" role="heading" level="3" xml-lang="en-US">Example</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> @@ -347,12 +347,12 @@ <paragraph id="hd_id9523234" role="heading" level="2" xml-lang="en-US">CSC</paragraph> <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> -<paragraph id="hd_id3534032" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<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> -<paragraph id="hd_id2577161" role="heading" level="3" xml-lang="en-US">Examples</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"/> @@ -368,11 +368,11 @@ <paragraph id="hd_id4325650" role="heading" level="2" xml-lang="en-US">CSCH</paragraph> <paragraph id="par_id579916" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COSECANTHYP">Returns the hyperbolic cosecant of a number.</ahelp></paragraph> -<paragraph id="hd_id5336768" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<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> -<paragraph id="hd_id6037477" role="heading" level="3" xml-lang="en-US">Example</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> @@ -388,11 +388,11 @@ <paragraph id="hd_id3145314" role="heading" level="2" xml-lang="en-US">DEGREES</paragraph> <paragraph id="par_id3149939" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_DEG">Converts radians into degrees.</ahelp></paragraph> -<paragraph id="hd_id3150623" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3669545" role="heading" level="3" xml-lang="en-US">Example</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> @@ -406,11 +406,11 @@ <paragraph id="hd_id3148698" role="heading" level="2" xml-lang="en-US">EXP</paragraph> <paragraph id="par_id3150592" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_EXP">Returns e raised to the power of a number.</ahelp> The constant e has a value of approximately 2.71828182845904.</paragraph> -<paragraph id="hd_id3150351" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3154418" role="heading" level="3" xml-lang="en-US">Example</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 e to Calc's accuracy.</paragraph><comment>see also POWER, LN</comment> </section> @@ -425,13 +425,13 @@ <paragraph id="hd_id3145781" role="heading" level="2" xml-lang="en-US">FACT</paragraph> <paragraph id="par_id3151109" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FAKULTAET">Returns the factorial of a number.</ahelp></paragraph> -<paragraph id="hd_id3146902" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3154569" role="heading" level="3" xml-lang="en-US">Example</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> @@ -448,12 +448,12 @@ <paragraph id="hd_id3159084" role="heading" level="2" xml-lang="en-US">INT</paragraph> <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> -<paragraph id="hd_id3146132" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3155118" role="heading" level="3" xml-lang="en-US">Example</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> @@ -470,11 +470,11 @@ <paragraph id="hd_id3150938" role="heading" level="2" xml-lang="en-US">EVEN</paragraph> <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> -<paragraph id="hd_id3148401" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3155508" role="heading" level="3" xml-lang="en-US">Examples</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> @@ -493,11 +493,11 @@ <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> -<paragraph id="hd_id3150643" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3154524" role="code" xml-lang="en-US">GCD(Integer1; Integer2; ...; Integer30)</paragraph> <paragraph id="par_id3149340" role="paragraph" xml-lang="en-US"><emph>Integer1 To 30</emph> are up to 30 integers whose greatest common divisor is to be calculated.</paragraph> -<paragraph id="hd_id3147317" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<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> @@ -513,11 +513,11 @@ <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"/> -<paragraph id="hd_id3147548" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3156205" role="code" xml-lang="en-US">GCD_EXCEL2003(Number(s))</paragraph> <paragraph id="par_id3145150" role="paragraph" xml-lang="en-US"><emph>Number(s)</emph> is a list of up to 30 numbers.</paragraph> -<paragraph id="hd_id3150239" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<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> @@ -533,11 +533,11 @@ <paragraph id="hd_id3145213" role="heading" level="2" xml-lang="en-US">LCM</paragraph> <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> -<paragraph id="hd_id3148632" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3147279" role="code" xml-lang="en-US">LCM(Integer1; Integer2; ...; Integer30)</paragraph> <paragraph id="par_id3156348" role="paragraph" xml-lang="en-US"><emph>Integer1 to 30</emph> are up to 30 integers whose lowest common multiple is to be calculated.</paragraph> -<paragraph id="hd_id3156431" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154914" role="paragraph" xml-lang="en-US">If you enter the numbers <item type="input">512</item>;<item type="input">1024</item> and <item type="input">2000</item> in the Integer 1;2 and 3 text boxes, 128000 will be returned as the result.</paragraph> </section> @@ -552,11 +552,11 @@ <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"/> -<paragraph id="hd_id3153132" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3154395" role="code" xml-lang="en-US">LCM_EXCEL2003(Number(s))</paragraph> <paragraph id="par_id3147377" role="paragraph" xml-lang="en-US"><emph>Number(s)</emph> is a list of up to 30 numbers.</paragraph> -<paragraph id="hd_id3145122" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<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> @@ -571,14 +571,14 @@ <paragraph id="hd_id3155802" role="heading" level="2" xml-lang="en-US">COMBIN</paragraph> <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> -<paragraph id="hd_id3156193" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3153171" role="heading" level="3" xml-lang="en-US">Example</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> @@ -593,14 +593,14 @@ <paragraph id="hd_id3150284" role="heading" level="2" xml-lang="en-US">COMBINA</paragraph> <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> -<paragraph id="hd_id3145752" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3154584" role="heading" level="3" xml-lang="en-US">Example</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> @@ -615,14 +615,14 @@ <paragraph id="hd_id3156086" role="heading" level="2" xml-lang="en-US">TRUNC</paragraph> <paragraph id="par_id3157866" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KUERZEN">Truncates a number by removing decimal places.</ahelp></paragraph> -<paragraph id="hd_id3148499" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148511" role="code" xml-lang="en-US">TRUNC(Number; Count)</paragraph> <paragraph id="par_id3150796" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> with at most <emph>Count</emph> decimal places. Excess decimal places are simply removed, irrespective of sign.</paragraph> <paragraph id="par_id3150816" role="paragraph" xml-lang="en-US"><item type="literal">TRUNC(Number; 0)</item> behaves as <item type="literal">INT(Number)</item> for positive numbers, but effectively rounds towards zero for negative numbers.</paragraph> <paragraph id="par_id3148548" role="warning" xml-lang="en-US">The <emph>visible</emph> decimal places of the result are specified in <switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences </caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - <link href="text/shared/optionen/01060500.xhp">%PRODUCTNAME Calc - Calculate</link>.</paragraph> -<paragraph id="hd_id3152555" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3152569" role="paragraph" xml-lang="en-US"><item type="input">=TRUNC(1.239;2)</item> returns 1.23. The 9 is lost.</paragraph> <paragraph id="par_id7050080" role="paragraph" xml-lang="en-US"><item type="input">=TRUNC(-1.234999;3)</item> returns -1.234. All the 9s are lost.</paragraph><comment>see also INT, ROUND, ROUNDDOWN, ROUNDUP, CEILING, FLOOR, EVEN, ODD, MROUND</comment> </section> @@ -638,11 +638,11 @@ <paragraph id="hd_id3153601" role="heading" level="2" xml-lang="en-US">LN</paragraph> <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> -<paragraph id="hd_id3154993" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3153852" role="heading" level="3" xml-lang="en-US">Example</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> @@ -658,12 +658,12 @@ <paragraph id="hd_id3109813" role="heading" level="2" xml-lang="en-US">LOG</paragraph> <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> -<paragraph id="hd_id3144719" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3152860" role="heading" level="3" xml-lang="en-US">Example</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> @@ -679,11 +679,11 @@ <paragraph id="hd_id3154187" role="heading" level="2" xml-lang="en-US">LOG10</paragraph> <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> -<paragraph id="hd_id3155494" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3159328" role="heading" level="3" xml-lang="en-US">Example</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> @@ -698,14 +698,14 @@ <paragraph id="hd_id3152518" role="heading" level="2" xml-lang="en-US">CEILING</paragraph> <paragraph id="par_id3153422" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_OBERGRENZE">Rounds a number up to the nearest multiple of Significance.</ahelp></paragraph> -<paragraph id="hd_id3153440" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3153454" role="code" xml-lang="en-US">CEILING(Number; Significance; Mode)</paragraph> <paragraph id="par_id3153467" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number that is to be rounded up.</paragraph> <paragraph id="par_id3155000" role="paragraph" xml-lang="en-US"><emph>Significance</emph> is the number to whose multiple the value is to be rounded up.</paragraph> <paragraph id="par_id3155020" role="paragraph" xml-lang="en-US"><emph>Mode</emph> is an optional value. If the Mode value is given and not equal to zero, and if Number and Significance are negative, then rounding is done based on the absolute value of Number, i.e. negative numbers are rounded away from zero. If the Mode value is equal to zero or is not given, negative numbers are rounded towards zero.</paragraph> <paragraph id="par_id3163792" role="warning" xml-lang="en-US">If the spreadsheet is exported to Microsoft Excel, the CEILING function is exported as the equivalent CEILING.MATH function that exists since Excel 2013. If you plan to use the spreadsheet with earlier Excel versions, use either CEILING.PRECISE that exists since Excel 2010, or CEILING.XCL that is exported as the CEILING function compatible with all Excel versions. Note that CEILING.XCL always rounds away from zero.</paragraph> -<paragraph id="hd_id3145697" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3145710" role="paragraph" xml-lang="en-US"><item type="input">=CEILING(-11;-2)</item> returns -10</paragraph> <paragraph id="par_id3145725" role="paragraph" xml-lang="en-US"><item type="input">=CEILING(-11;-2;0)</item> returns -10</paragraph> <paragraph id="par_id3145740" role="paragraph" xml-lang="en-US"><item type="input">=CEILING(-11;-2;1)</item> returns -12</paragraph><comment>see also FLOOR, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> @@ -722,12 +722,12 @@ <paragraph id="hd_id2952518" role="heading" level="2" xml-lang="en-US">CEILING.PRECISE</paragraph> <paragraph id="par_id2953422" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CEIL_MS">Rounds a number up to the nearest multiple of Significance, regardless of sign of Significance</ahelp></paragraph> -<paragraph id="hd_id2953440" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2953454" role="code" xml-lang="en-US">CEILING.PRECISE(Number; Significance)</paragraph> <paragraph id="par_id2953467" role="paragraph" xml-lang="en-US"><emph>Number</emph> (required) is the number that is to be rounded up.</paragraph> <paragraph id="par_id2955000" role="paragraph" xml-lang="en-US"><emph>Significance</emph> (optional) is the number to whose multiple the value is to be rounded up.</paragraph> -<paragraph id="hd_id2945697" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2945710" role="paragraph" xml-lang="en-US"><item type="input">=CEILING.PRECISE(-11;-2)</item> returns -10</paragraph><comment>see also FLOOR, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> </section> @@ -738,13 +738,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CEIL_MATH" id="bm_id511516997249645" localize="false"/> <paragraph role="heading" id="hd_id91516997330445" level="2" xml-lang="en-US">CEILING.MATH</paragraph> <paragraph role="paragraph" id="par_id81516997342088" xml-lang="en-US"><ahelp hid="HID_FUNC_CEIL_MATH">Rounds a number up to the nearest multiple of Significance.</ahelp></paragraph> - <paragraph role="heading" id="hd_id971516997377435" level="3" xml-lang="en-US">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id841516997669932" xml-lang="en-US">CEILING.MATH(Number; Significance; Mode)</paragraph> <paragraph role="paragraph" id="par_id651516997706287" xml-lang="en-US"><emph>Number</emph> is the number that is to be rounded up.</paragraph> <paragraph role="paragraph" id="par_id491516997725772" xml-lang="en-US"><emph>Significance</emph> is the number to whose multiple the value is to be rounded up.</paragraph> <paragraph role="paragraph" id="par_id451516997742909" xml-lang="en-US"><emph>Mode</emph> is an optional value. If the Mode value is given and not equal to zero, and if Number and Significance are negative, then rounding is done based on the absolute value of Number, i.e. negative numbers are rounded away from zero. If the Mode value is equal to zero or is not given, negative numbers are rounded towards zero.</paragraph> <paragraph xml-lang="en-US" id="par_id291516998575663" role="warning">This function exists for interoperability with Microsoft Excel 2013 or newer.</paragraph> - <paragraph role="heading" id="hd_id561516997761868" level="3" xml-lang="en-US">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id111516997803684" xml-lang="en-US"><item type="input">=CEILING.MATH(-10;-3)</item> returns -9</paragraph> <paragraph role="paragraph" id="par_id1001516997821483" xml-lang="en-US"><item type="input">=CEILING.MATH(-10;-3;0)</item> returns -9</paragraph> <paragraph role="paragraph" id="par_id641516997837754" xml-lang="en-US"><item type="item_type">=CEILING.MATH(-10;-3;1)</item> returns -12</paragraph> @@ -756,12 +756,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CEIL_MS" id="bm_id221516998652517" localize="false"/> <paragraph role="heading" id="hd_id411516998838823" level="2" xml-lang="en-US">CEILING.XCL</paragraph> <paragraph role="paragraph" id="par_id811516998845826" xml-lang="en-US"><ahelp hid="HID_FUNC_CEIL_MS">Rounds a number away from zero to the nearest multiple of Significance.</ahelp></paragraph> - <paragraph role="heading" id="hd_id361516998851918" level="3" xml-lang="en-US">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id251516998856873" xml-lang="en-US">CEILING.XCL(Number; Significance)</paragraph> <paragraph role="paragraph" id="par_id671516998874263" xml-lang="en-US"><emph>Number</emph> is the number that is to be rounded.</paragraph> <paragraph role="paragraph" id="par_id151516998882622" xml-lang="en-US"><emph>Significance</emph> is the number to whose multiple the value is to be rounded.</paragraph> <paragraph xml-lang="en-US" id="par_id341516998889754" role="warning">This function exists for interoperability with Microsoft Excel 2007 or older versions.</paragraph> - <paragraph role="heading" id="hd_id81516998896303" level="3" xml-lang="en-US">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id91516998917254" xml-lang="en-US"><item type="input">=CEILING.XCL(1;3)</item> returns 3</paragraph> <paragraph role="paragraph" id="par_id761516998929693" xml-lang="en-US"><item type="input">=CEILING.XCL(7;4)</item> returns 8</paragraph> <paragraph role="paragraph" id="par_id671516998958873" xml-lang="en-US"><item type="item_type">=CEILING.XCL(-10;-3)</item> returns -12</paragraph> @@ -777,12 +777,12 @@ <paragraph id="hd_id8952518" role="heading" level="2" xml-lang="en-US">ISO.CEILING</paragraph> <paragraph id="par_id8953422" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CEIL_ISO">Rounds a number up to the nearest multiple of Significance, regardless of sign of Significance</ahelp></paragraph> -<paragraph id="hd_id8953440" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id8953454" role="code" xml-lang="en-US">ISO.CEILING(Number; Significance)</paragraph> <paragraph id="par_id8953467" role="paragraph" xml-lang="en-US"><emph>Number</emph> (required) is the number that is to be rounded up.</paragraph> <paragraph id="par_id8955000" role="paragraph" xml-lang="en-US"><emph>Significance</emph> (optional) is the number to whose multiple the value is to be rounded up.</paragraph> -<paragraph id="hd_id8945697" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id8945710" role="paragraph" xml-lang="en-US"><item type="input">=ISO.CEILING(-11;-2)</item> returns -10</paragraph><comment>see also FLOOR, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> </section> @@ -796,10 +796,10 @@ <paragraph id="hd_id3157762" role="heading" level="2" xml-lang="en-US">PI</paragraph> <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> -<paragraph id="hd_id3157809" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3157822" role="code" xml-lang="en-US">PI()</paragraph> -<paragraph id="hd_id3157836" role="heading" level="3" xml-lang="en-US">Example</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> @@ -813,11 +813,11 @@ <paragraph id="hd_id3152418" role="heading" level="2" xml-lang="en-US">MULTINOMIAL</paragraph> <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> -<paragraph id="hd_id3155646" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3155660" role="code" xml-lang="en-US">MULTINOMIAL(Number(s))</paragraph> <paragraph id="par_id3155673" role="paragraph" xml-lang="en-US"><emph>Number(s)</emph> is a list of up to 30 numbers.</paragraph> -<paragraph id="hd_id3155687" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<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> @@ -831,13 +831,13 @@ <paragraph id="hd_id3155717" role="heading" level="2" xml-lang="en-US">POWER</paragraph> <paragraph id="par_id3159495" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_POTENZ">Returns a number raised to another number.</ahelp></paragraph> -<paragraph id="hd_id3159513" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3159580" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<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> @@ -853,7 +853,7 @@ <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;coefficients) = coefficient_1*x^n + coefficient_2*x^(n+m) + coefficient_3*x^(n+2m) +...+ coefficient_i*x^(n+(i-1)m)</paragraph> -<paragraph id="hd_id3152724" role="heading" level="3" xml-lang="en-US">Syntax</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> @@ -873,12 +873,12 @@ <paragraph id="hd_id3144386" role="heading" level="2" xml-lang="en-US">PRODUCT</paragraph> <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> -<paragraph id="hd_id3144433" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3144446" role="code" xml-lang="en-US">PRODUCT(Number1; Number2; ...; Number30)</paragraph> <paragraph id="par_id3144460" role="paragraph" xml-lang="en-US"><emph>Number1 to 30</emph> are up to 30 arguments whose product is to be calculated.</paragraph> <paragraph id="par_id1589098" role="paragraph" xml-lang="en-US">PRODUCT returns number1 * number2 * number3 * ...</paragraph> -<paragraph id="hd_id3144480" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<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> @@ -894,11 +894,11 @@ <paragraph id="hd_id3160340" role="heading" level="2" xml-lang="en-US">SUMSQ</paragraph> <paragraph id="par_id3160368" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_QUADRATESUMME">If you want to calculate the sum of the squares of numbers (totaling up of the squares of the arguments), enter these into the text fields.</ahelp></paragraph> -<paragraph id="hd_id3160388" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3160402" role="code" xml-lang="en-US">SUMSQ(Number1; Number2; ...; Number30)</paragraph> <paragraph id="par_id3160415" role="paragraph" xml-lang="en-US"><emph>Number1 to 30</emph> are up to 30 arguments the sum of whose squares is to be calculated.</paragraph> -<paragraph id="hd_id3160436" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3160449" role="paragraph" xml-lang="en-US">If you enter the numbers <item type="input">2</item>; <item type="input">3</item> and <item type="input">4</item> in the Number 1; 2 and 3 text boxes, 29 is returned as the result.</paragraph> </section> @@ -913,12 +913,12 @@ <paragraph id="hd_id3158247" role="heading" level="2" xml-lang="en-US">MOD</paragraph> <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> -<paragraph id="hd_id3158294" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3158361" role="heading" level="3" xml-lang="en-US">Example</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> @@ -934,12 +934,12 @@ <paragraph id="hd_id3144592" role="heading" level="2" xml-lang="en-US">QUOTIENT</paragraph> <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> -<paragraph id="hd_id3144646" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3144674" role="heading" level="3" xml-lang="en-US">Example</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> @@ -954,11 +954,11 @@ <paragraph id="hd_id3144702" role="heading" level="2" xml-lang="en-US">RADIANS</paragraph> <paragraph id="par_id3158025" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RAD">Converts degrees to radians.</ahelp></paragraph> -<paragraph id="hd_id3158042" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id876186" role="heading" level="3" xml-lang="en-US">Example</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> @@ -976,12 +976,12 @@ <paragraph id="hd_id3158121" role="heading" level="2" xml-lang="en-US">ROUND</paragraph> <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> -<paragraph id="hd_id3158169" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3145863" role="heading" level="3" xml-lang="en-US">Example</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> @@ -999,12 +999,12 @@ <paragraph id="hd_id3145991" role="heading" level="2" xml-lang="en-US">ROUNDDOWN</paragraph> <paragraph id="par_id3146020" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ABRUNDEN">Rounds a number down, toward zero, to a certain precision.</ahelp></paragraph> -<paragraph id="hd_id3146037" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3146051" role="code" xml-lang="en-US">ROUNDDOWN(Number; Count)</paragraph> <paragraph id="par_id3146064" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded down (towards zero) to <emph>Count</emph> decimal places. If Count is omitted or zero, the function rounds down to an integer. If Count is negative, the function rounds down to the next 10, 100, 1000, etc.</paragraph> <paragraph id="par_id2188787" role="paragraph" xml-lang="en-US">This function rounds towards zero. See ROUNDUP and ROUND for alternatives.</paragraph> -<paragraph id="hd_id3163164" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3163178" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDDOWN(1.234;2)</item> returns 1.23.</paragraph> <paragraph id="par_id5833307" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDDOWN(45.67;0)</item> returns 45.</paragraph> <paragraph id="par_id7726676" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDDOWN(-45.67)</item> returns -45.</paragraph> @@ -1021,12 +1021,12 @@ <paragraph id="hd_id3163268" role="heading" level="2" xml-lang="en-US">ROUNDUP</paragraph> <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> -<paragraph id="hd_id3163315" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3163381" role="heading" level="3" xml-lang="en-US">Example</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> @@ -1044,12 +1044,12 @@ <paragraph id="hd_id5187204" role="heading" level="2" xml-lang="en-US">SEC</paragraph> <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> -<paragraph id="hd_id422243" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<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> -<paragraph id="hd_id9878918" role="heading" level="3" xml-lang="en-US">Examples</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"/> @@ -1065,11 +1065,11 @@ <paragraph id="hd_id8661934" role="heading" level="2" xml-lang="en-US">SECH</paragraph> <paragraph id="par_id408174" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SECANTHYP">Returns the hyperbolic secant of a number.</ahelp></paragraph> -<paragraph id="hd_id875988" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<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> -<paragraph id="hd_id9838764" role="heading" level="3" xml-lang="en-US">Example</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> @@ -1084,12 +1084,12 @@ <paragraph id="hd_id3144877" role="heading" level="2" xml-lang="en-US">SIN</paragraph> <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> -<paragraph id="hd_id3144923" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3144969" role="heading" level="3" xml-lang="en-US">Example</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"/> @@ -1105,11 +1105,11 @@ <paragraph id="hd_id3163397" role="heading" level="2" xml-lang="en-US">SINH</paragraph> <paragraph id="par_id3163426" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SINHYP">Returns the hyperbolic sine of a number.</ahelp></paragraph> -<paragraph id="hd_id3163444" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3163491" role="heading" level="3" xml-lang="en-US">Example</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> @@ -1125,11 +1125,11 @@ <paragraph id="hd_id3163596" role="heading" level="2" xml-lang="en-US"><variable id="sum_head"><link href="text/scalc/01/04060106.xhp#Section16">SUM</link></variable></paragraph> <paragraph id="par_id3163625" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMME">Adds all the numbers in a range of cells.</ahelp></paragraph> -<paragraph id="hd_id3163643" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3163656" role="code" xml-lang="en-US">SUM(Number1; Number2; ...; Number30)</paragraph> <paragraph id="par_id3163671" role="paragraph" xml-lang="en-US"><emph>Number 1 to Number 30</emph> are up to 30 arguments whose sum is to be calculated.</paragraph> -<paragraph id="hd_id3163690" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3163704" role="paragraph" xml-lang="en-US">If you enter the numbers <item type="input">2</item>; <item type="input">3 </item>and <item type="input">4</item> in the Number 1; 2 and 3 text boxes, 9 will be returned as the result.</paragraph> <paragraph id="par_id3151740" role="paragraph" xml-lang="en-US"><item type="input">=SUM(A1;A3;B5)</item> calculates the sum of the three cells. <item type="input">=SUM (A1:E10)</item> calculates the sum of all cells in the A1 to E10 cell range.</paragraph> <paragraph id="par_id3151756" role="paragraph" xml-lang="en-US">Conditions linked by AND can be used with the function SUM() in the following manner:</paragraph> @@ -1154,14 +1154,14 @@ <paragraph id="par_id3151986" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEWENN">Adds the cells specified by a given criteria.</ahelp> This function is used to browse a range when you search for a certain value.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> -<paragraph id="hd_id3152015" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3152028" role="code" xml-lang="en-US">SUMIF(Range; Criteria; SumRange)</paragraph> <paragraph id="par_id3152043" role="paragraph" xml-lang="en-US"><emph>Range</emph> is the range to which the criteria are to be applied.</paragraph> <paragraph id="par_id3152062" role="paragraph" xml-lang="en-US"><emph>Criteria</emph> is the cell in which the search criterion is shown, or the search criterion itself. If the criteria is written into the formula, it has to be surrounded by double quotes.</paragraph> <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> <paragraph id="par_id8347422" role="note" xml-lang="en-US">SUMIF supports the reference concatenation operator (~) only in the Criteria parameter, and only if the optional SumRange parameter is not given.</paragraph> -<paragraph id="hd_id3152110" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<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:10)</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> @@ -1187,12 +1187,12 @@ <paragraph id="hd_id3152195" role="heading" level="2" xml-lang="en-US">TAN</paragraph> <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> -<paragraph id="hd_id3152242" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3152287" role="heading" level="3" xml-lang="en-US">Example</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"/> @@ -1208,11 +1208,11 @@ <paragraph id="hd_id3165434" role="heading" level="2" xml-lang="en-US">TANH</paragraph> <paragraph id="par_id3165462" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TANHYP">Returns the hyperbolic tangent of a number.</ahelp></paragraph> -<paragraph id="hd_id3165480" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3165527" role="heading" level="3" xml-lang="en-US">Example</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> @@ -1230,7 +1230,7 @@ <paragraph id="hd_id3165633" role="heading" level="2" xml-lang="en-US">SUBTOTAL</paragraph> <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> -<paragraph id="hd_id3165704" role="heading" level="3" xml-lang="en-US">Syntax</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> @@ -1374,7 +1374,7 @@ <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> -<paragraph id="hd_id3143625" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<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"> @@ -1473,7 +1473,7 @@ <paragraph id="hd_id3143672" role="heading" level="2" xml-lang="en-US">EUROCONVERT<comment>insert link in financial</comment></paragraph> <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> -<paragraph id="par_id3143731" role="heading" level="3" xml-lang="en-US"><emph>Syntax</emph></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> @@ -1496,10 +1496,10 @@ <paragraph id="par_id0908200902131122" role="paragraph" xml-lang="en-US"><ahelp hid=".">Converts a value from one unit of measurement to another unit of measurement. The conversion factors are given in a list in the configuration.</ahelp></paragraph> <paragraph id="par_id0908200902475420" role="paragraph" xml-lang="en-US">At one time the list of conversion factors included the legacy European currencies and the Euro (see examples below). We suggest using the new function EUROCONVERT for converting these currencies.</paragraph> -<paragraph id="hd_id0908200902131071" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id0908200902131191" role="code" xml-lang="en-US">CONVERT_OOO(value;"text";"text")</paragraph> -<paragraph id="hd_id0908200902131152" role="heading" level="3" xml-lang="en-US">Example</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">=CONVERT_OOO(100;"EUR";"DEM") converts 100 Euros into German Marks.</paragraph> </section> @@ -1515,11 +1515,11 @@ <paragraph id="hd_id3157177" role="heading" level="2" xml-lang="en-US">ODD</paragraph> <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> -<paragraph id="hd_id3157223" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3157270" role="heading" level="3" xml-lang="en-US">Example</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> @@ -1537,12 +1537,12 @@ <paragraph id="hd_id2957404" role="heading" level="2" xml-lang="en-US">FLOOR.PRECISE</paragraph> <paragraph id="par_id2957432" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FLOOR_MS">Rounds a number down to the nearest multiple of Significance, regardless of sign of Significance</ahelp></paragraph> -<paragraph id="hd_id2957451" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2957464" role="code" xml-lang="en-US">FLOOR.PRECISE(Number; Significance)</paragraph> <paragraph id="par_id2957478" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number that is to be rounded down.</paragraph> <paragraph id="par_id2957497" role="paragraph" xml-lang="en-US"><emph>Significance</emph> is the value to whose multiple the number is to be rounded down.</paragraph> -<paragraph id="hd_id2963932" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2963945" role="paragraph" xml-lang="en-US"><item type="input">=FLOOR.PRECISE( -11;-2)</item> returns -12</paragraph><comment>see also CEILING, EVEN, ODD, MROUND,INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> </section> @@ -1557,14 +1557,14 @@ <paragraph id="hd_id3157404" role="heading" level="2" xml-lang="en-US">FLOOR</paragraph> <paragraph id="par_id3157432" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_UNTERGRENZE">Rounds a number down to the nearest multiple of Significance.</ahelp></paragraph> -<paragraph id="hd_id3157451" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3157464" role="code" xml-lang="en-US">FLOOR(Number; Significance; Mode)</paragraph> <paragraph id="par_id3157478" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number that is to be rounded down.</paragraph> <paragraph id="par_id3157497" role="paragraph" xml-lang="en-US"><emph>Significance</emph> is the value to whose multiple the number is to be rounded down.</paragraph> <paragraph id="par_id3157517" role="paragraph" xml-lang="en-US"><emph>Mode</emph> is an optional value. If the Mode value is given and not equal to zero, and if Number and Significance are negative, then rounding is done based on the absolute value of Number, i.e. negative numbers are rounded towards zero. If the Mode value is equal to zero or is not given, negative numbers are rounded away from zero.</paragraph> <paragraph id="par_id3163894" role="warning" xml-lang="en-US">If the spreadsheet is exported to Microsoft Excel, the FLOOR function is exported as the equivalent FLOOR.MATH function that exists since Excel 2013. If you plan to use the spreadsheet with earlier Excel versions, use either FLOOR.PRECISE that exists since Excel 2010, or FLOOR.XCL that is exported as the FLOOR function compatible with all Excel versions. Note that FLOOR.XCL always rounds towards zero.</paragraph> -<paragraph id="hd_id3163932" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3163945" role="paragraph" xml-lang="en-US"><item type="input">=FLOOR( -11;-2)</item> returns -12</paragraph> <paragraph id="par_id3163966" role="paragraph" xml-lang="en-US"><item type="input">=FLOOR( -11;-2;0)</item> returns -12</paragraph> <paragraph id="par_id3163988" role="paragraph" xml-lang="en-US"><item type="input">=FLOOR( -11;-2;1)</item> returns -10</paragraph><comment>see also CEILING, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> @@ -1581,11 +1581,11 @@ <paragraph id="hd_id3164086" role="heading" level="2" xml-lang="en-US">SIGN</paragraph> <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> -<paragraph id="hd_id3164136" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3164183" role="heading" level="3" xml-lang="en-US">Example</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> @@ -1601,12 +1601,12 @@ <paragraph id="hd_id3164252" role="heading" level="2" xml-lang="en-US">MROUND</paragraph> <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> -<paragraph id="hd_id3164306" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3164333" role="heading" level="3" xml-lang="en-US">Example</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> @@ -1622,12 +1622,12 @@ <paragraph id="hd_id3164375" role="heading" level="2" xml-lang="en-US">SQRT</paragraph> <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> -<paragraph id="hd_id3164424" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3164471" role="heading" level="3" xml-lang="en-US">Example</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> @@ -1643,12 +1643,12 @@ <paragraph id="hd_id3164560" role="heading" level="2" xml-lang="en-US">SQRTPI</paragraph> <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> -<paragraph id="hd_id3164614" role="heading" level="3" xml-lang="en-US">Syntax</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> -<paragraph id="hd_id3164641" role="heading" level="3" xml-lang="en-US">Example</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> @@ -1663,14 +1663,14 @@ <paragraph id="hd_id3164669" role="heading" level="2" xml-lang="en-US">RANDBETWEEN</paragraph> <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> -<paragraph id="hd_id3164745" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<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 Shift+<switchinline select="sys"><caseinline select="MAC">Command </caseinline><defaultinline>Ctrl</defaultinline></switchinline>+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> -<paragraph id="hd_id3164772" role="heading" level="3" xml-lang="en-US">Example</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> @@ -1685,12 +1685,12 @@ <paragraph id="hd_id3164800" role="heading" level="2" xml-lang="en-US">RAND</paragraph> <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> -<paragraph id="hd_id3164870" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<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, copy cells each containing =RAND(), 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> -<paragraph id="hd_id9089022" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<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> </sort> diff --git a/source/text/scalc/01/04060107.xhp b/source/text/scalc/01/04060107.xhp index 51e44773d9..a0d00beda1 100644 --- a/source/text/scalc/01/04060107.xhp +++ b/source/text/scalc/01/04060107.xhp @@ -365,16 +365,16 @@ <paragraph id="hd_id3158446" role="heading" level="2" xml-lang="en-US">MUNIT</paragraph> <paragraph id="par_id3154121" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_EINHEITSMATRIX">Returns the unitary square array of a certain size.</ahelp> The unitary array is a square array where the main diagonal elements equal 1 and all other array elements are equal to 0.</paragraph> -<paragraph id="hd_id3155123" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3156271" role="code" xml-lang="en-US">MUNIT(Dimensions)</paragraph> <paragraph id="par_id3159390" role="paragraph" xml-lang="en-US"><emph>Dimensions</emph> refers to the size of the array unit.</paragraph> <paragraph id="par_idN10C9B" role="note" xml-lang="en-US">You can find a general introduction to Array functions at the top of this page.</paragraph> -<paragraph id="hd_id3156162" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3150949" role="paragraph" xml-lang="en-US">Select a square range within the spreadsheet, for example, from A1 to E5.</paragraph> <paragraph id="par_id3151260" role="paragraph" xml-lang="en-US">Without deselecting the range, select the MUNIT function. Mark the <emph>Array</emph> check box. Enter the desired dimensions for the array unit, in this case <item type="input">5</item>, and click <emph>OK</emph>.</paragraph> -<paragraph id="par_id3150403" role="paragraph" xml-lang="en-US">You can also enter the <item type="input">=Munit(5)</item> formula in the last cell of the selected range (E5), and press <switchinline select="sys"><caseinline select="MAC">Shift+Command+Enter -</caseinline><defaultinline>Shift+Ctrl+Enter</defaultinline></switchinline>.</paragraph> +<paragraph id="par_id3150403" role="paragraph" xml-lang="en-US">You can also enter the <item type="input">=Munit(5)</item> formula in the last cell of the selected range (E5), and press <switchinline select="sys"><caseinline select="MAC"><item type="keycode">Shift+Command+Enter</item> + </caseinline><defaultinline><item type="keycode">Shift+Ctrl+Enter</item></defaultinline></switchinline>.</paragraph> <paragraph id="par_id3156143" role="paragraph" xml-lang="en-US">You now see a unit array with a range of A1:E5.</paragraph> <paragraph id="par_idN10FA7" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> </section> @@ -389,13 +389,13 @@ <paragraph id="hd_id3159084" role="heading" level="2" xml-lang="en-US">FREQUENCY</paragraph> <paragraph id="par_id3145777" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_HAEUFIGKEIT">Indicates the frequency distribution in a one-column-array.</ahelp> The function counts the number of values in the Data array that are within the values given by the Classes array.</paragraph> -<paragraph id="hd_id3153347" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3155498" role="code" xml-lang="en-US">FREQUENCY(Data; Classes)</paragraph> <paragraph id="par_id3154352" role="paragraph" xml-lang="en-US"><emph>Data</emph> represents the reference to the values to be counted.</paragraph> <paragraph id="par_id3148402" role="paragraph" xml-lang="en-US"><emph>Classes</emph> represents the array of the limit values.</paragraph> <paragraph id="par_idN10D71" role="note" xml-lang="en-US">You can find a general introduction to Array functions at the top of this page.</paragraph> -<paragraph id="hd_id3148981" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3155904" role="paragraph" xml-lang="en-US">In the following table, column A lists unsorted measurement values. Column B contains the upper limit you entered for the classes into which you want to divide the data in column A. According to the limit entered in B1, the FREQUENCY function returns the number of measured values less than or equal to 5. As the limit in B2 is 10, the FREQUENCY function returns the second result as the number of measured values that are greater than 5 and less than or equal to 10. The text you entered in B6, ">25", is only for reference purposes.<comment>i77461: replace old text: As the limit in B2 is 10, the FREQUENCY function returns the second result as the number of measured values that are greater than 5 or greater than or equal to 10.</comment></paragraph><comment>UFI: replace table by picture</comment> <table id="tbl_id3150680"> @@ -573,7 +573,7 @@ <paragraph id="hd_id3151030" role="heading" level="2" xml-lang="en-US">MDETERM</paragraph> <paragraph id="par_id3154073" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_MDET">Returns the array determinant of an array.</ahelp> This function returns a value in the current cell; it is not necessary to define a range for the results.</paragraph> -<paragraph id="hd_id3156366" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3156380" role="code" xml-lang="en-US">MDETERM(Array)</paragraph> <paragraph id="par_id3150290" role="paragraph" xml-lang="en-US"><emph>Array</emph> represents a square array in which the determinants are defined.</paragraph> <paragraph id="par_idN11635" role="note" xml-lang="en-US">You can find a general introduction to using Array functions on top of this page.</paragraph> @@ -591,12 +591,12 @@ <paragraph id="hd_id3151348" role="heading" level="2" xml-lang="en-US">MINVERSE</paragraph> <paragraph id="par_id3145569" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_MINV">Returns the inverse array.</ahelp></paragraph> -<paragraph id="hd_id3156072" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3156085" role="code" xml-lang="en-US">MINVERSE(Array)</paragraph> <paragraph id="par_id3157849" role="paragraph" xml-lang="en-US"><emph>Array</emph> represents a square array that is to be inverted.</paragraph> <paragraph id="par_idN113EE" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> -<paragraph id="hd_id3157868" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3149638" role="paragraph" xml-lang="en-US">Select a square range and select MINVERSE. Select the output array, select the <emph>Array</emph> field and click <emph>OK</emph>.</paragraph> </section> @@ -610,13 +610,13 @@ <paragraph id="hd_id3148546" role="heading" level="2" xml-lang="en-US">MMULT</paragraph> <paragraph id="par_id3148518" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_MMULT">Calculates the array product of two arrays.</ahelp> The number of columns for array 1 must match the number of rows for array 2. The square array has an equal number of rows and columns.</paragraph> -<paragraph id="hd_id3146767" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150798" role="code" xml-lang="en-US">MMULT(Array; Array)</paragraph> <paragraph id="par_id3150812" role="paragraph" xml-lang="en-US"><emph>Array</emph> at first place represents the first array used in the array product.</paragraph> <paragraph id="par_id3152553" role="paragraph" xml-lang="en-US"><emph>Array</emph> at second place represents the second array with the same number of rows.</paragraph> <paragraph id="par_idN114C3" role="note" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> -<paragraph id="hd_id3152574" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3146826" role="paragraph" xml-lang="en-US">Select a square range. Choose the MMULT function. Select the first <emph>Array</emph>, then select the second <emph>Array</emph>. Using <emph>Function Wizard</emph>, mark the <emph>Array</emph> check box. Click <emph>OK</emph>. The output array will appear in the first selected range.</paragraph> </section> @@ -630,12 +630,12 @@ <paragraph id="hd_id3154970" role="heading" level="2" xml-lang="en-US">TRANSPOSE</paragraph> <paragraph id="par_id3155276" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_MTRANS">Transposes the rows and columns of an array.</ahelp></paragraph> -<paragraph id="hd_id3155294" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3153843" role="code" xml-lang="en-US">TRANSPOSE(Array)</paragraph> <paragraph id="par_id3153857" role="paragraph" xml-lang="en-US"><emph>Array</emph> represents the array in the spreadsheet that is to be transposed.</paragraph> <paragraph id="par_idN11035" role="note" xml-lang="en-US">You can find a general introduction to using Array functions on top of this page.</paragraph> -<paragraph id="hd_id3159352" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3159366" role="paragraph" xml-lang="en-US">In the spreadsheet, select the range in which the transposed array can appear. If the original array has n rows and m columns, your selected range must have at least m rows and n columns. Then enter the formula directly, select the original array and press <switchinline select="sys"><caseinline select="MAC">Shift+Command+Enter </caseinline><defaultinline>Shift+Ctrl+Enter</defaultinline></switchinline>. Or, if you are using the <emph>Function Wizard</emph>, mark the <emph>Array</emph> check box. The transposed array appears in the selected target range and is protected automatically against changes.</paragraph> @@ -766,7 +766,7 @@ <paragraph id="hd_id3109846" role="heading" level="2" xml-lang="en-US">LINEST</paragraph> <paragraph id="par_id3144733" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RGP">Returns a table of statistics for a straight line that best fits a data set.</ahelp><comment>changed based on https://wiki.documentfoundation.org/Documentation/How_Tos/Calc:_LINEST_function (issue 76142)</comment></paragraph> -<paragraph id="hd_id3152825" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3152839" role="code" xml-lang="en-US">LINEST(data_Y; data_X; linearType; stats)</paragraph> <paragraph id="par_id3152853" role="paragraph" xml-lang="en-US"><emph>data_Y</emph> is a single row or column range specifying the y coordinates in a set of data points.</paragraph> <paragraph id="par_id3154428" role="paragraph" xml-lang="en-US"><emph>data_X</emph> is a corresponding single row or column range specifying the x coordinates. If <emph>data_X</emph> is omitted it defaults to <item type="literal">1, 2, 3, ..., n</item>. If there is more than one set of variables <emph>data_X</emph> may be a range with corresponding multiple rows or columns.</paragraph> @@ -778,7 +778,7 @@ <paragraph id="par_idN11416" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> <paragraph id="par_idN116C6" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> -<paragraph id="hd_id3154162" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154176" role="paragraph" xml-lang="en-US">This function returns an array and is handled in the same way as the other array functions. Select a range for the answers and then the function. Select <emph>data_Y</emph>. If you want, you can enter other parameters. Select <emph>Array</emph> and click <emph>OK</emph>.</paragraph> <paragraph id="par_id3155468" role="paragraph" xml-lang="en-US">The results returned by the system (if <emph>stats</emph> = 0), will at least show the slope of the regression line and its intersection with the Y axis. If <emph>stats</emph> does not equal 0, other results are to be displayed.</paragraph> @@ -1048,7 +1048,7 @@ <paragraph id="hd_id3146009" role="heading" level="2" xml-lang="en-US">LOGEST</paragraph> <paragraph id="par_id3146037" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RKP">This function calculates the adjustment of the entered data as an exponential regression curve (y=b*m^x).</ahelp><comment>UFI: see http://support.microsoft.com/default.aspx?kbid=828528&product=xl2003 for bug #i31051#</comment></paragraph> -<paragraph id="hd_id3146056" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3163123" role="code" xml-lang="en-US">LOGEST(DataY; DataX; FunctionType; Stats)</paragraph> <paragraph id="par_id3163137" role="paragraph" xml-lang="en-US"><emph>DataY</emph> represents the Y Data array.</paragraph> <paragraph id="par_id3163155" role="paragraph" xml-lang="en-US"><emph>DataX</emph> (optional) represents the X Data array.</paragraph> @@ -1057,7 +1057,7 @@ <paragraph id="par_idN118F7" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> <paragraph id="par_idN11BC3" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> -<paragraph id="hd_id3163216" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3163230" role="paragraph" xml-lang="en-US">See LINEST. However, no square sum will be returned.</paragraph> </section> @@ -1074,12 +1074,12 @@ <paragraph id="hd_id3163286" role="heading" level="2" xml-lang="en-US">SUMPRODUCT</paragraph> <paragraph id="par_id3163314" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMENPRODUKT">Multiplies corresponding elements in the given arrays, and returns the sum of those products.</ahelp></paragraph> -<paragraph id="hd_id3163334" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3163347" role="code" xml-lang="en-US">SUMPRODUCT(Array1; Array2...Array30)</paragraph> <paragraph id="par_id3163362" role="paragraph" xml-lang="en-US"><emph>Array1, Array2...Array30</emph> represent arrays whose corresponding elements are to be multiplied.</paragraph> <paragraph id="par_idN11B19" role="paragraph" xml-lang="en-US">At least one array must be part of the argument list. If only one array is given, all array elements are summed.</paragraph> -<paragraph id="par_idN11B1C" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <table id="tbl_id6215704"> <tablerow> @@ -1168,7 +1168,7 @@ <paragraph id="hd_id3144842" role="heading" level="2" xml-lang="en-US">SUMX2MY2</paragraph> <paragraph id="par_id3144871" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEX2MY2">Returns the sum of the difference of squares of corresponding values in two arrays.</ahelp></paragraph> -<paragraph id="hd_id3144889" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3144903" role="code" xml-lang="en-US">SUMX2MY2(ArrayX; ArrayY)</paragraph> <paragraph id="par_id3144916" role="paragraph" xml-lang="en-US"><emph>ArrayX</emph> represents the first array whose elements are to be squared and added.</paragraph> <paragraph id="par_id3144936" role="paragraph" xml-lang="en-US"><emph>ArrayY</emph> represents the second array whose elements are to be squared and subtracted.</paragraph> @@ -1185,7 +1185,7 @@ <paragraph id="hd_id3145026" role="heading" level="2" xml-lang="en-US">SUMX2PY2</paragraph> <paragraph id="par_id3145055" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEX2PY2">Returns the sum of the sum of squares of corresponding values in two arrays.</ahelp></paragraph> -<paragraph id="hd_id3163390" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3163404" role="code" xml-lang="en-US">SUMX2PY2(ArrayX; ArrayY)</paragraph> <paragraph id="par_id3163417" role="paragraph" xml-lang="en-US"><emph>ArrayX</emph> represents the first array whose elements are to be squared and added.</paragraph> <paragraph id="par_id3163437" role="paragraph" xml-lang="en-US"><emph>ArrayY</emph> represents the second array, whose elements are to be squared and added.</paragraph> @@ -1202,7 +1202,7 @@ <paragraph id="hd_id3163527" role="heading" level="2" xml-lang="en-US">SUMXMY2</paragraph> <paragraph id="par_id3163556" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEXMY2">Adds the squares of the variance between corresponding values in two arrays.</ahelp></paragraph> -<paragraph id="hd_id3163574" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3163588" role="code" xml-lang="en-US">SUMXMY2(ArrayX; ArrayY)</paragraph> <paragraph id="par_id3163601" role="paragraph" xml-lang="en-US"><emph>ArrayX</emph> represents the first array whose elements are to be subtracted and squared.</paragraph> <paragraph id="par_id3163621" role="paragraph" xml-lang="en-US"><emph>ArrayY</emph> represents the second array, whose elements are to be subtracted and squared.</paragraph> @@ -1219,7 +1219,7 @@ <paragraph id="hd_id3166062" role="heading" level="2" xml-lang="en-US">TREND</paragraph> <paragraph id="par_id3166091" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TREND">Returns values along a linear trend.</ahelp></paragraph> -<paragraph id="hd_id3166109" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3166122" role="code" xml-lang="en-US">TREND(DataY; DataX; NewDataX; LinearType)</paragraph> <paragraph id="par_id3166137" role="paragraph" xml-lang="en-US"><emph>DataY</emph> represents the Y Data array.</paragraph> <paragraph id="par_id3166156" role="paragraph" xml-lang="en-US"><emph>DataX</emph> (optional) represents the X Data array.</paragraph> @@ -1228,7 +1228,7 @@ <paragraph id="par_idN11D2F" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> <paragraph id="par_idN12019" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> -<paragraph id="hd_id3166231" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3166245" role="paragraph" xml-lang="en-US">Select a spreadsheet range in which the trend data will appear. Select the function. Enter the output data or select it with the mouse. Mark the <emph>Array</emph> field. click <emph>OK</emph>. The trend data calculated from the output data is displayed.</paragraph> </section> @@ -1243,7 +1243,7 @@ <paragraph id="hd_id3166317" role="heading" level="2" xml-lang="en-US">GROWTH</paragraph> <paragraph id="par_id3166346" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_VARIATION">Calculates the points of an exponential trend in an array.</ahelp></paragraph> -<paragraph id="hd_id3166364" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3166377" role="code" xml-lang="en-US">GROWTH(DataY; DataX; NewDataX; FunctionType)</paragraph> <paragraph id="par_id3166392" role="paragraph" xml-lang="en-US"><emph>DataY</emph> represents the Y Data array.</paragraph> <paragraph id="par_id3166411" role="paragraph" xml-lang="en-US"><emph>DataX</emph> (optional) represents the X Data array.</paragraph> @@ -1252,7 +1252,7 @@ <paragraph id="par_idN11DFD" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> <paragraph id="par_idN12113" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> -<paragraph id="hd_id3173839" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3173852" role="paragraph" xml-lang="en-US">This function returns an array and is handled in the same way as the other array functions. Select a range where you want the answers to appear and select the function. Select DataY. Enter any other parameters, mark <emph>Array</emph> and click <emph>OK</emph>.</paragraph> </section> </sort> diff --git a/source/text/scalc/01/04060109.xhp b/source/text/scalc/01/04060109.xhp index cffee7eb82..93fcb7dbbe 100644 --- a/source/text/scalc/01/04060109.xhp +++ b/source/text/scalc/01/04060109.xhp @@ -54,7 +54,7 @@ <paragraph xml-lang="en-US" id="par_id102720080230162" role="note">Do not save a spreadsheet in the old ODF 1.0/1.1 format if the ADDRESS function's new fourth parameter was used with a value of 0.</paragraph> <paragraph xml-lang="en-US" id="par_id1027200802301756" role="note">The INDIRECT function is saved without conversion to ODF 1.0/1.1 format. If the second parameter was present, an older version of Calc will return an error for that function.</paragraph> </section> - <paragraph xml-lang="en-US" id="hd_id3151196" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154707" role="code">ADDRESS(Row; Column; Abs; A1; "Sheet")</paragraph> <paragraph xml-lang="en-US" id="par_id3147505" role="paragraph"> <emph>Row</emph> represents the row number for the cell reference</paragraph> @@ -82,10 +82,10 @@ <paragraph xml-lang="en-US" id="hd_id3150372" role="heading" level="2">AREAS</paragraph> <paragraph xml-lang="en-US" id="par_id3150036" role="paragraph"><ahelp hid="HID_FUNC_BEREICHE">Returns the number of individual ranges that belong to a multiple range.</ahelp> A range can consist of contiguous cells or a single cell.</paragraph> <paragraph xml-lang="en-US" id="par_id061020090307073" role="paragraph">The function expects a single argument. If you state multiple ranges, you must enclose them into additional parentheses. Multiple ranges can be entered using the semicolon (;) as divider, but this gets automatically converted to the tilde (~) operator. The tilde is used to join ranges.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3145222" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155907" role="code">AREAS(Reference)</paragraph> <paragraph xml-lang="en-US" id="par_id3153118" role="paragraph">Reference represents the reference to a cell or cell range.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3148891" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149946" role="paragraph"> <item type="input">=AREAS((A1:B3;F2;G1))</item> returns 3, as it is a reference to three cells and/or areas. After entry this gets converted to =AREAS((A1:B3~F2~G1)).</paragraph> <paragraph xml-lang="en-US" id="par_id3146820" role="paragraph"> @@ -97,7 +97,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DDE" id="bm_id3154680" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3148727" role="heading" level="2">DDE</paragraph> <paragraph xml-lang="en-US" id="par_id3149434" role="paragraph"><ahelp hid="HID_FUNC_DDE">Returns the result of a DDE-based link.</ahelp> If the contents of the linked range or section changes, the returned value will also change. You must reload the spreadsheet or choose <emph>Edit - Links</emph> to see the updated links. Cross-platform links, for example from a <item type="productname">%PRODUCTNAME</item> installation running on a Windows machine to a document created on a Linux machine, are not allowed.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3150700" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3148886" role="code">DDE("Server"; "File"; "Range"; Mode)</paragraph> <paragraph xml-lang="en-US" id="par_id3154842" role="paragraph"> <emph>Server</emph> is the name of a server application. <item type="productname">%PRODUCTNAME</item> applications have the server name "soffice".</paragraph> @@ -146,7 +146,7 @@ </tablerow> </table> - <paragraph xml-lang="en-US" id="hd_id3149546" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3148734" role="paragraph"> <item type="input">=DDE("soffice";"c:\office\document\data1.ods";"sheet1.A1")</item> reads the contents of cell A1 in sheet1 of the <item type="productname">%PRODUCTNAME</item> Calc spreadsheet data1.ods.</paragraph> <paragraph xml-lang="en-US" id="par_id3153081" role="paragraph"> @@ -160,11 +160,11 @@ <paragraph xml-lang="en-US" id="par_id3148568" role="paragraph"><ahelp hid="HID_FUNC_FEHLERTYP">Returns the number corresponding to an <link href="text/scalc/05/02140000.xhp" name="error value">error value</link> occurring in a different cell.</ahelp> With the aid of this number, you can generate an error message text.</paragraph> <embed href="text/shared/00/00000001.xhp#wahr"/> <paragraph xml-lang="en-US" id="par_id3149877" role="note">The Status Bar displays the predefined error code from <item type="productname">%PRODUCTNAME</item> if you click the cell containing the error.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3154327" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3151322" role="code">ERRORTYPE(Reference)</paragraph> <paragraph xml-lang="en-US" id="par_id3150132" role="paragraph"> <emph>Reference</emph> contains the address of the cell in which the error occurs.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3145248" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3146904" role="paragraph">If cell A1 displays Err:518, the function <item type="input">=ERRORTYPE(A1)</item> returns the number 518.</paragraph> </section> <section id="error_type"> @@ -177,7 +177,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_INDEX" id="bm_id3157989" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3151221" role="heading" level="2">INDEX</paragraph> <paragraph xml-lang="en-US" id="par_id3150268" role="paragraph"><ahelp hid="HID_FUNC_INDEX">INDEX returns a sub range, specified by row and column number, or an optional range index. Depending on context, INDEX returns a reference or content.</ahelp><comment>UFI: will change with i4904; see http://so-web.germany.sun.com/iBIS/servlet/edit.ControlPanel?tid=i57108</comment><comment>changed by i83070</comment></paragraph> - <paragraph xml-lang="en-US" id="hd_id3156063" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149007" role="code">INDEX(Reference; Row; Column; Range)</paragraph> <paragraph xml-lang="en-US" id="par_id3153260" role="paragraph"> <emph>Reference</emph> is a reference, entered either directly or by specifying a range name. If the reference consists of multiple ranges, you must enclose the reference or range name in parentheses.</paragraph> @@ -187,7 +187,7 @@ <emph>Column</emph> (optional) represents the column index of the reference range, for which to return a value. In case of zero (no specific column) all referenced columns are returned.</paragraph> <paragraph xml-lang="en-US" id="par_id3155514" role="paragraph"> <emph>Range</emph> (optional) represents the index of the subrange if referring to a multiple range.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3145264" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3159112" role="paragraph"> <item type="input">=INDEX(Prices;4;1)</item> returns the value from row 4 and column 1 of the database range defined in <emph>Data - Define</emph> as <emph>Prices</emph>.</paragraph> <paragraph xml-lang="en-US" id="par_id3150691" role="paragraph"> @@ -210,14 +210,14 @@ <paragraph xml-lang="en-US" id="hd_id3153181" role="heading" level="2">INDIRECT</paragraph> <paragraph xml-lang="en-US" id="par_id3147169" role="paragraph"><ahelp hid="HID_FUNC_INDIREKT">Returns the <emph>reference</emph> specified by a text string.</ahelp> This function can also be used to return the area of a corresponding string.</paragraph> <embed href="text/scalc/01/04060109.xhp#r1c1"/> - <paragraph xml-lang="en-US" id="hd_id3153717" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149824" role="code">INDIRECT(Ref; A1)</paragraph> <paragraph xml-lang="en-US" id="par_id3154317" role="paragraph"> <emph>Ref</emph> represents a reference to a cell or an area (in text form) for which to return the contents.</paragraph> <paragraph xml-lang="en-US" id="par_id1027200802470312" role="paragraph"> <emph>A1</emph> (optional) - if set to 0, the R1C1 notation is used. If this parameter is absent or set to another value than 0, the A1 notation is used.</paragraph> <paragraph xml-lang="en-US" id="par_idN10CAE" role="note">If you open an Excel spreadsheet that uses indirect addresses calculated from string functions, the sheet addresses will not be translated automatically. For example, the Excel address in INDIRECT("[filename]sheetname!"&B1) is not converted into the Calc address in INDIRECT("filename#sheetname."&B1).<comment>UFI: for #i34465#</comment></paragraph> - <paragraph xml-lang="en-US" id="hd_id3150389" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150608" role="paragraph"> <item type="input">=INDIRECT(A1)</item> equals 100 if A1 contains C108 as a reference and cell C108 contains a value of <item type="input">100</item>.</paragraph> <paragraph xml-lang="en-US" id="par_id3083286" role="paragraph"> @@ -229,12 +229,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SPALTE" id="bm_id3156378" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3154818" role="heading" level="2">COLUMN</paragraph> <paragraph xml-lang="en-US" id="par_id3149711" role="paragraph"><ahelp hid="HID_FUNC_SPALTE">Returns the column number of a cell reference.</ahelp> If the reference is a cell the column number of the cell is returned; if the parameter is a cell area, the corresponding column numbers are returned in a single-row <link href="text/scalc/01/04060107.xhp#wasmatrix" name="array">array</link> if the formula is entered <link href="text/scalc/01/04060107.xhp#somatrixformel" name="as an array formula">as an array formula</link>. If the COLUMN function with an area reference parameter is not used for an array formula, only the column number of the first cell within the area is determined.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3149283" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149447" role="code">COLUMN(Reference)</paragraph> <paragraph xml-lang="en-US" id="par_id3156310" role="paragraph"> <emph>Reference</emph> is the reference to a cell or cell area whose first column number is to be found.</paragraph> <paragraph xml-lang="en-US" id="par_id3155837" role="paragraph">If no reference is entered, the column number of the cell in which the formula is entered is found. <item type="productname">%PRODUCTNAME</item> Calc automatically sets the reference to the current cell.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3152932" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3147571" role="paragraph"> <item type="input">=COLUMN(A1)</item> equals 1. Column A is the first column in the table.</paragraph> <paragraph xml-lang="en-US" id="par_id3147079" role="paragraph"> @@ -254,11 +254,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SPALTEN" id="bm_id3156134" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3154643" role="heading" level="2">COLUMNS</paragraph> <paragraph xml-lang="en-US" id="par_id3151182" role="paragraph"><ahelp hid="HID_FUNC_SPALTEN">Returns the number of columns in the given reference.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3149141" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154047" role="code">COLUMNS(Array)</paragraph> <paragraph xml-lang="en-US" id="par_id3154745" role="paragraph"> <emph>Array</emph> is the reference to a cell range whose total number of columns is to be found. The argument can also be a single cell.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153622" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149577" role="paragraph"> <item type="input">=COLUMNS(B5)</item> returns 1 because a cell only contains one column.</paragraph> <paragraph xml-lang="en-US" id="par_id3145649" role="paragraph"> @@ -274,7 +274,7 @@ <paragraph xml-lang="en-US" id="hd_id3153152" role="heading" level="2">VLOOKUP</paragraph> <paragraph xml-lang="en-US" id="par_id3149984" role="paragraph"><ahelp hid="HID_FUNC_SVERWEIS">Vertical search with reference to adjacent cells to the right.</ahelp> This function checks if a specific value is contained in the first column of an array. The function then returns the value in the same row of the column named by <item type="literal">Index</item>. If the <item type="literal">Sorted</item> parameter is omitted or set to TRUE or one, it is assumed that the data is sorted in ascending order. In this case, if the exact <item type="literal">SearchCriterion</item> is not found, the last value that is smaller than the criterion will be returned. If <item type="literal">Sorted</item> is set to FALSE or zero, an exact match must be found, otherwise the error <emph>Error: Value Not Available</emph> will be the result. Thus with a value of zero the data does not need to be sorted in ascending order.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3146898" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150156" role="code">=VLOOKUP(SearchCriterion; Array; Index; Sorted)</paragraph> <paragraph xml-lang="en-US" id="par_id3149289" role="paragraph"> <emph>SearchCriterion</emph> is the value searched for in the first column of the array.</paragraph> @@ -285,7 +285,7 @@ <paragraph xml-lang="en-US" id="par_id3151208" role="paragraph"> <emph>Sorted</emph> is an optional parameter that indicates whether the first column in the array is sorted in ascending order. Enter the Boolean value FALSE or zero if the first column is not sorted in ascending order. Sorted columns can be searched much faster and the function always returns a value, even if the search value was not matched exactly, if it is between the lowest and highest value of the sorted list. In unsorted lists, the search value must be matched exactly. Otherwise the function will return this message: <emph>Error: Value Not Available</emph>.</paragraph> <embed href="text/scalc/05/empty_cells.xhp#empty_cells"/> - <paragraph xml-lang="en-US" id="hd_id3147487" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3154129" role="paragraph">You want to enter the number of a dish on the menu in cell A1, and the name of the dish is to appear as text in the neighboring cell (B1) immediately. The Number to Name assignment is contained in the D1:E100 array. D1 contains <item type="input">100</item>, E1 contains the name <item type="input">Vegetable Soup</item>, and so forth, for 100 menu items. The numbers in column D are sorted in ascending order; thus, the optional <item type="literal">Sorted</item> parameter is not necessary.</paragraph> <paragraph xml-lang="en-US" id="par_id3145663" role="paragraph">Enter the following formula in B1:</paragraph> <paragraph xml-lang="en-US" id="par_id3151172" role="paragraph"> @@ -300,11 +300,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TABELLE" id="bm_id3154693" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153905" role="heading" level="2">SHEET</paragraph> <paragraph xml-lang="en-US" id="par_id3150309" role="paragraph"><ahelp hid="HID_FUNC_TABELLE">Returns the sheet number of a reference or a string representing a sheet name.</ahelp> If you do not enter any parameters, the result is the sheet number of the spreadsheet containing the formula.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3148564" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153095" role="code">SHEET(Reference)</paragraph> <paragraph xml-lang="en-US" id="par_id3154588" role="paragraph"> <emph>Reference</emph> is optional and is the reference to a cell, an area, or a sheet name string.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3155399" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3146988" role="paragraph"> <item type="input">=SHEET(Sheet2.A1)</item> returns 2 if Sheet2 is the second sheet in the spreadsheet document.</paragraph> </section> @@ -315,11 +315,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TABELLEN" id="bm_id3150524" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3148829" role="heading" level="2">SHEETS</paragraph> <paragraph xml-lang="en-US" id="par_id3148820" role="paragraph"><ahelp hid="HID_FUNC_TABELLEN">Determines the number of sheets in a reference.</ahelp> If you do not enter any parameters, it returns the number of sheets in the current document.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3154220" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150777" role="code">SHEETS(Reference)</paragraph> <paragraph xml-lang="en-US" id="par_id3153060" role="paragraph"> <emph>Reference</emph> is the reference to a sheet or an area. This parameter is optional.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3149766" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150507" role="paragraph"> <item type="input">=SHEETS(Sheet1.A1:Sheet3.G12)</item> returns 3 if Sheet1, Sheet2, and Sheet3 exist in the sequence indicated.</paragraph> </section> @@ -329,7 +329,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VERGLEICH" id="bm_id3154210" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3158407" role="heading" level="2">MATCH</paragraph> <paragraph xml-lang="en-US" id="par_id3154896" role="paragraph"><ahelp hid="HID_FUNC_VERGLEICH">Returns the relative position of an item in an array that matches a specified value.</ahelp> The function returns the position of the value found in the lookup_array as a number.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153834" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3159152" role="code">MATCH(SearchCriterion; LookupArray; Type)</paragraph> <paragraph xml-lang="en-US" id="par_id3149336" role="paragraph"> <emph>SearchCriterion</emph> is the value which is to be searched for in the single-row or single-column array.</paragraph> @@ -340,7 +340,7 @@ <paragraph xml-lang="en-US" id="par_id3154265" role="paragraph">If Type = 0, only exact matches are found. If the search criterion is found more than once, the function returns the index of the first matching value. Only if Type = 0 can you search for regular expressions (if enabled in calculation options) or wildcards (if enabled in calculation options).</paragraph> <paragraph xml-lang="en-US" id="par_id3147528" role="paragraph">If Type = 1 or the third parameter is missing, the index of the last value that is smaller or equal to the search criterion is returned. This applies even when the search array is not sorted. For Type = -1, the first value that is larger or equal is returned.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3155119" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3155343" role="paragraph"> <item type="input">=MATCH(200;D1:D100)</item> searches the area D1:D100, which is sorted by column D, for the value 200. As soon as this value is reached, the number of the row in which it was found is returned. If a higher value is found during the search in the column, the number of the previous row is returned.</paragraph> </section> @@ -350,7 +350,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VERSCHIEBUNG" id="bm_id3148926" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3158430" role="heading" level="2">OFFSET</paragraph> <paragraph xml-lang="en-US" id="par_id3149167" role="paragraph"><ahelp hid="HID_FUNC_VERSCHIEBUNG">Returns the value of a cell offset by a certain number of rows and columns from a given reference point.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3146952" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3159194" role="code">OFFSET(Reference; Rows; Columns; Height; Width)</paragraph> <paragraph xml-lang="en-US" id="par_id3152360" role="paragraph"> <emph>Reference</emph> is the reference from which the function searches for the new reference.</paragraph> @@ -367,7 +367,7 @@ <paragraph xml-lang="en-US" id="par_idN1104B" role="paragraph" localize="false"> <embedvar href="text/scalc/00/00000004.xhp#optional"/> </paragraph> - <paragraph xml-lang="en-US" id="hd_id3155586" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149744" role="paragraph"> <item type="input">=OFFSET(A1;2;2)</item> returns the value in cell C3 (A1 moved by two rows and two columns down). If C3 contains the value <item type="input">100</item> this function returns the value 100.</paragraph> <paragraph xml-lang="en-US" id="par_id7439802" role="paragraph"> @@ -390,7 +390,7 @@ <paragraph xml-lang="en-US" id="par_id3153389" role="paragraph"><ahelp hid="HID_FUNC_VERWEIS">Returns the contents of a cell either from a one-row or one-column range.</ahelp> Optionally, the assigned value (of the same index) is returned in a different column and row. As opposed to <link href="text/scalc/01/04060109.xhp#Section9" name="VLOOKUP">VLOOKUP</link> and <link href="text/scalc/01/04060109.xhp#Section17" name="HLOOKUP">HLOOKUP</link>, search and result vector may be at different positions; they do not have to be adjacent. Additionally, the search vector for the LOOKUP must be sorted ascending, otherwise the search will not return any usable results.</paragraph> <paragraph xml-lang="en-US" id="par_id4484084" role="note">If LOOKUP cannot find the search criterion, it matches the largest value in the search vector that is less than or equal to the search criterion.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3152947" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154104" role="code">LOOKUP(SearchCriterion; SearchVector; ResultVector)</paragraph> <paragraph xml-lang="en-US" id="par_id3150646" role="paragraph"> <emph>SearchCriterion</emph> is the value to be searched for; entered either directly or as a reference.</paragraph> @@ -399,7 +399,7 @@ <paragraph xml-lang="en-US" id="par_id3149925" role="paragraph"> <emph>ResultVector</emph> is another single-row or single-column range from which the result of the function is taken. The result is the cell of the result vector with the same index as the instance found in the search vector.</paragraph> <embed href="text/scalc/05/empty_cells.xhp#empty_cells"/> - <paragraph xml-lang="en-US" id="hd_id3148624" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149809" role="paragraph"> <item type="input">=LOOKUP(A1;D1:D100;F1:F100)</item> searches the corresponding cell in range D1:D100 for the number you entered in A1. For the instance found, the index is determined, for example, the 12th cell in this range. Then, the contents of the 12th cell are returned as the value of the function (in the result vector).</paragraph> </section> @@ -409,7 +409,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VORLAGE" id="bm_id3154342" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3149425" role="heading" level="2">STYLE</paragraph> <paragraph xml-lang="en-US" id="par_id3150826" role="paragraph"><ahelp hid="HID_FUNC_VORLAGE">Applies a style to the cell containing the formula.</ahelp> After a set amount of time, another style can be applied. This function always returns the value 0, allowing you to add it to another function without changing the value. Together with the CURRENT function you can apply a color to a cell depending on the value. For example: =...+STYLE(IF(CURRENT()>3;"red";"green")) applies the style "red" to the cell if the value is greater than 3, otherwise the style "green" is applied. Both cell formats, "red" and "green" have to be defined beforehand.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3145373" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149302" role="code">STYLE("Style"; Time; "Style2")</paragraph> <paragraph xml-lang="en-US" id="par_id3150596" role="paragraph"> <emph>Style</emph> is the name of a cell style assigned to the cell. Style names must be entered in quotation marks.</paragraph> @@ -420,7 +420,7 @@ <paragraph xml-lang="en-US" id="par_idN111CA" role="paragraph" localize="false"> <embedvar href="text/scalc/00/00000004.xhp#optional"/> </paragraph> - <paragraph xml-lang="en-US" id="hd_id3159254" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3151374" role="paragraph"> <item type="input">=STYLE("Invisible";60;"Default")</item> formats the cell in transparent format for 60 seconds after the document was recalculated or loaded, then the Default format is assigned. Both cell formats have to be defined beforehand.</paragraph> <paragraph xml-lang="en-US" id="par_id8056886" role="paragraph">Since STYLE() has a numeric return value of zero, this return value gets appended to a string. This can be avoided using T() as in the following example:</paragraph> @@ -435,13 +435,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WAHL" id="bm_id3153947" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3150430" role="heading" level="2">CHOOSE</paragraph> <paragraph xml-lang="en-US" id="par_id3143270" role="paragraph"><ahelp hid="HID_FUNC_WAHL">Uses an index to return a value from a list of up to 30 values.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3153533" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155425" role="code">CHOOSE(Index; Value1; ...; Value30)</paragraph> <paragraph xml-lang="en-US" id="par_id3144755" role="paragraph"> <emph>Index</emph> is a reference or number between 1 and 30 indicating which value is to be taken from the list.</paragraph> <paragraph xml-lang="en-US" id="par_id3149939" role="paragraph"> <emph>Value1, Value2, ..., Value30</emph> is the list of values entered as a reference to a cell or as individual values.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3151253" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150625" role="paragraph"> <item type="input">=CHOOSE(A1;B1;B2;B3;"Today";"Yesterday";"Tomorrow")</item>, for example, returns the contents of cell B2 for A1 = 2; for A1 = 4, the function returns the text "Today".</paragraph> </section> @@ -452,7 +452,7 @@ <paragraph xml-lang="en-US" id="hd_id3151001" role="heading" level="2">HLOOKUP</paragraph> <paragraph xml-lang="en-US" id="par_id3148688" role="paragraph"><ahelp hid="HID_FUNC_WVERWEIS">Searches for a value and reference to the cells below the selected area.</ahelp> This function verifies if the first row of an array contains a certain value. The function returns then the value in a row of the array, named in the <emph>Index</emph>, in the same column.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> - <paragraph xml-lang="en-US" id="hd_id3154661" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3146070" role="code">HLOOKUP(SearchCriterion; Array; Index; Sorted)</paragraph> <paragraph xml-lang="en-US" id="par_id3148672" role="paragraph">See also: <link href="text/scalc/01/04060109.xhp#Section9" name="VLOOKUP">VLOOKUP</link> (columns and rows are exchanged)</paragraph> <embed href="text/scalc/05/empty_cells.xhp#empty_cells"/> @@ -463,12 +463,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZEILE" id="bm_id3147333" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3147321" role="heading" level="2">ROW</paragraph> <paragraph xml-lang="en-US" id="par_id3154564" role="paragraph"><ahelp hid="HID_FUNC_ZEILE">Returns the row number of a cell reference.</ahelp> If the reference is a cell, it returns the row number of the cell. If the reference is a cell range, it returns the corresponding row numbers in a one-column <link href="text/scalc/01/04060107.xhp#wasmatrix" name="Array">Array</link> if the formula is entered <link href="text/scalc/01/04060107.xhp#somatrixformel" name="as an array formula">as an array formula</link>. If the ROW function with a range reference is not used in an array formula, only the row number of the first range cell will be returned.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3158439" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154916" role="code">ROW(Reference)</paragraph> <paragraph xml-lang="en-US" id="par_id3156336" role="paragraph"> <emph>Reference</emph> is a cell, an area, or the name of an area.</paragraph> <paragraph xml-lang="en-US" id="par_id3151109" role="paragraph">If you do not indicate a reference, the row number of the cell in which the formula is entered will be found. <item type="productname">%PRODUCTNAME</item> Calc automatically sets the reference to the current cell.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3155609" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3154830" role="paragraph"> <item type="input">=ROW(B3)</item> returns 3 because the reference refers to the third row in the table.</paragraph> <paragraph xml-lang="en-US" id="par_id3147094" role="paragraph"> @@ -488,11 +488,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZEILEN" id="bm_id3150667" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3145772" role="heading" level="2">ROWS</paragraph> <paragraph xml-lang="en-US" id="par_id3148971" role="paragraph"><ahelp hid="HID_FUNC_ZEILEN">Returns the number of rows in a reference or array.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3156051" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154357" role="code">ROWS(Array)</paragraph> <paragraph xml-lang="en-US" id="par_id3155942" role="paragraph"> <emph>Array</emph> is the reference or named area whose total number of rows is to be determined.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3155869" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3154725" role="paragraph"> <item type="input">=Rows(B5)</item> returns 1 because a cell only contains one row.</paragraph> <paragraph xml-lang="en-US" id="par_id3150102" role="paragraph"> @@ -508,12 +508,12 @@ <paragraph xml-lang="en-US" id="par_idN117F1" role="paragraph"><ahelp hid="HID_FUNC_HYPERLINK">When you click a cell that contains the HYPERLINK function, the hyperlink opens.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_idN11800" role="paragraph">If you use the optional <emph>CellText</emph> parameter, the formula locates the URL, and then displays the text or number.</paragraph> <paragraph xml-lang="en-US" id="par_idN11803" role="tip">To open a hyperlinked cell with the keyboard, select the cell, press F2 to enter the Edit mode, move the cursor in front of the hyperlink, press Shift+F10, and then choose <emph>Open Hyperlink</emph>.</paragraph> - <paragraph xml-lang="en-US" id="par_idN1180A" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_idN1180E" role="code">HYPERLINK("URL") or HYPERLINK("URL"; "CellText")</paragraph> <paragraph xml-lang="en-US" id="par_idN11811" role="paragraph"> <emph>URL</emph> specifies the link target. The optional <emph>CellText</emph> parameter is the text or a number that is displayed in the cell and will be returned as the result. If the <emph>CellText</emph> parameter is not specified, the <emph>URL</emph> is displayed in the cell text and will be returned as the result.</paragraph> <paragraph xml-lang="en-US" id="par_id0907200912224576" role="paragraph">The number 0 is returned for empty cells and matrix elements.</paragraph> - <paragraph xml-lang="en-US" id="par_idN11823" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_idN11827" role="paragraph"> <item type="input">=HYPERLINK("http://www.example.org")</item> displays the text "http://www.example.org" in the cell and executes the hyperlink http://www.example.org when clicked.</paragraph> <paragraph xml-lang="en-US" id="par_idN1182A" role="paragraph"> @@ -534,12 +534,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GETPIVOTDATA" id="bm_id897854" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3747062" role="heading" level="2">GETPIVOTDATA</paragraph> <paragraph xml-lang="en-US" id="par_id3593859" role="paragraph"><ahelp hid=".">The GETPIVOTDATA function returns a result value from a pivot table. The value is addressed using field and item names, so it remains valid if the layout of the pivot table changes.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id9741508" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id909451" role="paragraph">Two different syntax definitions can be used:</paragraph> <paragraph xml-lang="en-US" id="par_id1665089" role="code">GETPIVOTDATA(TargetField; pivot table; [ Field 1; Item 1; ... ])</paragraph> <paragraph xml-lang="en-US" id="par_id4997100" role="code">GETPIVOTDATA(pivot table; Constraints)</paragraph> <paragraph xml-lang="en-US" id="par_id1672109" role="paragraph">The second syntax is assumed if exactly two parameters are given, of which the first parameter is a cell or cell range reference. The first syntax is assumed in all other cases. The Function Wizard shows the first syntax.</paragraph> - <paragraph xml-lang="en-US" id="hd_id9464094" role="heading" level="3">First Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id9302346" role="paragraph"> <emph>TargetField</emph> is a string that selects one of the pivot table's data fields. The string can be the name of the source column, or the data field name as shown in the table (like "Sum - Sales").</paragraph> <paragraph xml-lang="en-US" id="par_id8296151" role="paragraph"> @@ -549,7 +549,7 @@ <paragraph xml-lang="en-US" id="par_id79042" role="paragraph">If the source data contains entries that are hidden by settings of the pivot table, they are ignored. The order of the Field/Item pairs is not significant. Field and item names are not case-sensitive.</paragraph> <paragraph xml-lang="en-US" id="par_id7928708" role="paragraph">If no constraint for a page field is given, the field's selected value is implicitly used. If a constraint for a page field is given, it must match the field's selected value, or an error is returned. Page fields are the fields at the top left of a pivot table, populated using the "Page Fields" area of the pivot table layout dialog. From each page field, an item (value) can be selected, which means only that item is included in the calculation.</paragraph> <paragraph xml-lang="en-US" id="par_id3864253" role="paragraph">Subtotal values from the pivot table are only used if they use the function "auto" (except when specified in the constraint, see <item type="literal">Second Syntax</item> below).</paragraph> - <paragraph xml-lang="en-US" id="hd_id3144016" role="heading" level="3">Second Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id9937131" role="paragraph"> <emph>pivot table</emph> has the same meaning as in the first syntax.</paragraph> <paragraph xml-lang="en-US" id="par_id5616626" role="paragraph"> diff --git a/source/text/scalc/01/04060110.xhp b/source/text/scalc/01/04060110.xhp index e6f8f98290..162145bd2a 100644 --- a/source/text/scalc/01/04060110.xhp +++ b/source/text/scalc/01/04060110.xhp @@ -52,11 +52,11 @@ <paragraph id="hd_id3149384" role="heading" level="2" xml-lang="en-US">ARABIC</paragraph> <paragraph id="par_id3153558" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARABISCH">Calculates the value of a Roman number. The value range must be between 0 and 3999.</ahelp></paragraph> -<paragraph id="hd_id3153011" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3155523" role="code" xml-lang="en-US">ARABIC("Text")</paragraph> <paragraph id="par_id3151193" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text that represents a Roman number.</paragraph> -<paragraph id="hd_id3155758" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154621" role="paragraph" xml-lang="en-US"> <item type="input">=ARABIC("MXIV")</item> returns 1014</paragraph> <paragraph id="par_id3147553" role="paragraph" xml-lang="en-US"> <item type="input">=ARABIC("MMII")</item> returns 2002</paragraph> </section> @@ -72,7 +72,7 @@ <paragraph id="par_id8455153" role="paragraph" xml-lang="en-US"><ahelp hid=".">The ASC function converts full-width to half-width ASCII and katakana characters. Returns a text string.</ahelp></paragraph> <paragraph id="par_id9912411" role="paragraph" xml-lang="en-US">See <link href="https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions" name="wiki.documentfoundation.org Calc/Features/JIS and ASC functions">https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions</link> for a conversion table.</paragraph> -<paragraph id="hd_id9204992" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id1993774" role="code" xml-lang="en-US">ASC("Text")</paragraph> <paragraph id="par_id2949919" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text that contains characters to be converted.</paragraph> <paragraph id="par_id2355113" role="paragraph" xml-lang="en-US">See also JIS function.</paragraph> @@ -88,11 +88,11 @@ <paragraph id="hd_id6695455" role="heading" level="2" xml-lang="en-US">BAHTTEXT</paragraph> <paragraph id="par_id354014" role="paragraph" xml-lang="en-US">Converts a number to Thai text, including the Thai currency names.</paragraph> -<paragraph id="hd_id9942014" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id8780785" role="code" xml-lang="en-US">BAHTTEXT(Number)</paragraph> <paragraph id="par_id1539353" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is any number. "Baht" is appended to the integral part of the number, and "Satang" is appended to the decimal part of the number.</paragraph> -<paragraph id="hd_id9694814" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3289284" role="paragraph" xml-lang="en-US"> <item type="input">=BAHTTEXT(12.65)</item> returns a string in Thai characters with the meaning of "Twelve Baht and sixty five Satang".</paragraph> </section> @@ -106,13 +106,13 @@ <paragraph id="hd_id3153072" role="heading" level="2" xml-lang="en-US">BASE</paragraph> <paragraph id="par_id3153289" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BASIS">Converts a positive integer to a specified base into a text from the <link href="text/shared/00/00000005.xhp#zahlensystem" name="numbering system">numbering system</link>.</ahelp> The digits 0-9 and the letters A-Z are used.</paragraph> -<paragraph id="hd_id3146097" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3155743" role="code" xml-lang="en-US">BASE(Number; Radix; [MinimumLength])</paragraph> <paragraph id="par_id3151339" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is the positive integer to be converted.</paragraph> <paragraph id="par_id3159262" role="paragraph" xml-lang="en-US"> <emph>Radix</emph> indicates the base of the number system. It may be any positive integer between 2 and 36.</paragraph> <paragraph id="par_id3148746" role="paragraph" xml-lang="en-US"> <emph>MinimumLength</emph> (optional) determines the minimum length of the character sequence that has been created. If the text is shorter than the indicated minimum length, zeros are added to the left of the string.</paragraph> -<paragraph id="hd_id3146323" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <bookmark xml-lang="en-US" branch="index" id="bm_id3156399"> <bookmark_value>decimal system; converting to</bookmark_value> </bookmark> @@ -141,11 +141,11 @@ <paragraph id="par_id3149150" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZEICHEN">Converts a number into a character according to the current code table.</ahelp> The number can be a two-digit or three-digit integer number.</paragraph> <embed href="text/scalc/00/00000004.xhp#codes"/> -<paragraph id="hd_id3149945" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3145634" role="code" xml-lang="en-US">CHAR(Number)</paragraph> <paragraph id="par_id3155906" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is a number between 1 and 255 representing the code value for the character.</paragraph> -<paragraph id="hd_id3152982" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3149890" role="paragraph" xml-lang="en-US"> <item type="input">=CHAR(100)</item> returns the character d.</paragraph> <paragraph id="par_id0907200910283297" role="paragraph" xml-lang="en-US">="abc" & CHAR(10) & "def" inserts a newline character into the string.</paragraph> </section> @@ -160,7 +160,7 @@ <paragraph id="hd_id3149009" role="heading" level="2" xml-lang="en-US">CLEAN</paragraph> <paragraph id="par_id3150482" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SAEUBERN">All non-printing characters are removed from the string.</ahelp></paragraph> -<paragraph id="hd_id3146880" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3147472" role="code" xml-lang="en-US">CLEAN("Text")</paragraph> <paragraph id="par_id3150695" role="paragraph" xml-lang="en-US"> <emph>Text</emph> refers to the text from which to remove all non-printable characters.</paragraph> </section> @@ -175,12 +175,12 @@ <paragraph id="hd_id3155498" role="heading" level="2" xml-lang="en-US">CODE</paragraph> <paragraph id="par_id3152770" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CODE">Returns a numeric code for the first character in a text string.</ahelp></paragraph> -<paragraph id="hd_id3155830" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149188" role="code" xml-lang="en-US">CODE("Text")</paragraph> <paragraph id="par_id3154383" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text for which the code of the first character is to be found.</paragraph> <embed href="text/scalc/00/00000004.xhp#codes"/> -<paragraph id="hd_id3154394" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3159209" role="paragraph" xml-lang="en-US"> <item type="input">=CODE("Hieronymus")</item> returns 72, <item type="input">=CODE("hieroglyphic")</item> returns 104.</paragraph> <paragraph id="par_id3150280" role="note" xml-lang="en-US">The code used here does not refer to ASCII, but to the code table currently loaded.</paragraph> </section> @@ -195,11 +195,11 @@ <paragraph id="hd_id3149688" role="heading" level="2" xml-lang="en-US">CONCATENATE</paragraph> <paragraph id="par_id3154524" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_VERKETTEN">Combines several text strings into one string.</ahelp></paragraph> -<paragraph id="hd_id3149542" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3155954" role="code" xml-lang="en-US">CONCATENATE("Text1"; ...; "Text30")</paragraph> <paragraph id="par_id3146847" role="paragraph" xml-lang="en-US"> <emph>Text 1; Text 2; ...</emph> represent up to 30 text passages which are to be combined into one string.</paragraph> -<paragraph id="hd_id3153110" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3150008" role="paragraph" xml-lang="en-US"> <item type="input">=CONCATENATE("Good ";"Morning ";"Mrs. ";"Doe")</item> returns: Good Morning Mrs. Doe.</paragraph> </section> @@ -214,12 +214,12 @@ <paragraph id="par_id3156361" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_DEZIMAL">Converts text with characters from a <link href="text/shared/00/00000005.xhp#zahlensystem" name="number system">number system</link> to a positive integer in the base radix given.</ahelp> The radix must be in the range 2 to 36. Spaces and tabs are ignored. The <emph>Text</emph> field is not case-sensitive.</paragraph> <paragraph id="par_id3157994" role="paragraph" xml-lang="en-US">If the radix is 16, a leading x or X or 0x or 0X, and an appended h or H, is disregarded. If the radix is 2, an appended b or B is disregarded. Other characters that do not belong to the number system generate an error.</paragraph> -<paragraph id="hd_id3150014" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3154328" role="code" xml-lang="en-US">DECIMAL("Text"; Radix)</paragraph> <paragraph id="par_id3150128" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text to be converted. To differentiate between a hexadecimal number, such as A1 and the reference to cell A1, you must place the number in quotation marks, for example, "A1" or "FACE".</paragraph> <paragraph id="par_id3145241" role="paragraph" xml-lang="en-US"> <emph>Radix</emph> indicates the base of the number system. It may be any positive integer between 2 and 36.</paragraph> -<paragraph id="hd_id3156062" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3145355" role="paragraph" xml-lang="en-US"> <item type="input">=DECIMAL("17";10)</item> returns 17.</paragraph> <paragraph id="par_id3155622" role="paragraph" xml-lang="en-US"> <item type="input">=DECIMAL("FACE";16)</item> returns 64206.</paragraph> <paragraph id="par_id3151015" role="paragraph" xml-lang="en-US"> <item type="input">=DECIMAL("0101";2)</item> returns 5.</paragraph> @@ -236,12 +236,12 @@ <paragraph id="par_id3153049" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_DM">Converts a number to an amount in the currency format, rounded to a specified decimal place.</ahelp> In the <item type="literal">Value</item> field enter the number to be converted to currency. Optionally, you may enter the number of decimal places in the <item type="literal">Decimals</item> field. If no value is specified, all numbers in currency format will be displayed with two decimal places. </paragraph> <paragraph id="par_id3151280" role="paragraph" xml-lang="en-US">You set the currency format in your system settings.</paragraph> -<paragraph id="hd_id3150569" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3154188" role="code" xml-lang="en-US">DOLLAR(Value; Decimals)</paragraph> <paragraph id="par_id3145299" role="paragraph" xml-lang="en-US"> <emph>Value</emph> is a number, a reference to a cell containing a number, or a formula which returns a number.</paragraph> <paragraph id="par_id3145629" role="paragraph" xml-lang="en-US"> <emph>Decimals</emph> is the optional number of decimal places.</paragraph> -<paragraph id="hd_id3149030" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3153546" role="paragraph" xml-lang="en-US"> <item type="input">=DOLLAR(255)</item> returns $255.00.</paragraph> <paragraph id="par_id3154635" role="paragraph" xml-lang="en-US"> <item type="input">=DOLLAR(367.456;2)</item> returns $367.46. Use the decimal separator that corresponds to the <link href="text/shared/optionen/01140000.xhp" name="current locale setting">current locale setting</link>.</paragraph> </section> @@ -256,12 +256,12 @@ <paragraph id="hd_id3150685" role="heading" level="2" xml-lang="en-US">EXACT</paragraph> <paragraph id="par_id3158413" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_IDENTISCH">Compares two text strings and returns TRUE if they are identical.</ahelp> This function is case-sensitive.</paragraph> -<paragraph id="hd_id3152817" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148594" role="code" xml-lang="en-US">EXACT("Text1"; "Text2")</paragraph> <paragraph id="par_id3153224" role="paragraph" xml-lang="en-US"> <emph>Text1</emph> refers to the first text to compare.</paragraph> <paragraph id="par_id3148637" role="paragraph" xml-lang="en-US"> <emph>Text2</emph> is the second text to compare.</paragraph> -<paragraph id="hd_id3149777" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3156263" role="paragraph" xml-lang="en-US"> <item type="input">=EXACT("microsystems";"Microsystems")</item> returns FALSE.</paragraph> </section> @@ -275,13 +275,13 @@ <paragraph id="hd_id3152589" role="heading" level="2" xml-lang="en-US">FIND</paragraph> <paragraph id="par_id3146149" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FINDEN">Returns the position of a string of text within another string.</ahelp>You can also define where to begin the search. The search term can be a number or any string of characters. The search is case-sensitive.</paragraph> -<paragraph id="hd_id3083284" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3083452" role="code" xml-lang="en-US">FIND("FindText"; "Text"; Position)</paragraph> <paragraph id="par_id3150608" role="paragraph" xml-lang="en-US"> <emph>FindText</emph> refers to the text to be found.</paragraph> <paragraph id="par_id3152374" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text where the search takes place.</paragraph> <paragraph id="par_id3152475" role="paragraph" xml-lang="en-US"> <emph>Position</emph> (optional) is the position in the text from which the search starts.</paragraph> -<paragraph id="hd_id3154812" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3156375" role="paragraph" xml-lang="en-US"> <item type="input">=FIND(76;998877665544)</item> returns 6.</paragraph> </section> @@ -295,13 +295,13 @@ <paragraph id="hd_id3149268" role="heading" level="2" xml-lang="en-US">FIXED</paragraph> <paragraph id="par_id3155833" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FEST">Returns a number as text with a specified number of decimal places and optional thousands separators.</ahelp></paragraph> -<paragraph id="hd_id3152470" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3147567" role="code" xml-lang="en-US">FIXED(Number; Decimals; NoThousandsSeparators)</paragraph> <paragraph id="par_id3151272" role="paragraph" xml-lang="en-US"> <emph>Number</emph> refers to the number to be formatted.</paragraph> <paragraph id="par_id3156322" role="paragraph" xml-lang="en-US"> <emph>Decimals</emph> refers to the number of decimal places to be displayed.</paragraph> <paragraph id="par_id3150877" role="paragraph" xml-lang="en-US"> <emph>NoThousandsSeparators</emph> (optional) determines whether the thousands separator is used. If the parameter is a number not equal to 0, the thousands separator is suppressed. If the parameter is equal to 0 or if it is missing altogether, the thousands separators of your <link href="text/shared/optionen/01140000.xhp" name="current locale setting">current locale setting</link> are displayed.</paragraph> -<paragraph id="hd_id3149040" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3145208" role="paragraph" xml-lang="en-US"> <item type="input">=FIXED(1234567.89;3)</item> returns 1,234,567.890 as a text string. </paragraph> <paragraph id="par_id5282143" role="paragraph" xml-lang="en-US"> <item type="input">=FIXED(1234567.89;3;1)</item> returns 1234567.890 as a text string.</paragraph> </section> @@ -317,7 +317,7 @@ <paragraph id="par_id964384" role="paragraph" xml-lang="en-US"><ahelp hid=".">The JIS function converts half-width to full-width ASCII and katakana characters. Returns a text string.</ahelp></paragraph> <paragraph id="par_id1551561" role="paragraph" xml-lang="en-US">See <link href="https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions" name="wiki.documentfoundation.org Calc/Features/JIS and ASC functions">https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions</link> for a conversion table.</paragraph> -<paragraph id="hd_id2212897" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2504654" role="code" xml-lang="en-US">JIS("Text")</paragraph> <paragraph id="par_id5292519" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text that contains characters to be converted.</paragraph> <paragraph id="par_id3984496" role="paragraph" xml-lang="en-US">See also ASC function.</paragraph> @@ -333,12 +333,12 @@ <paragraph id="hd_id3147083" role="heading" level="2" xml-lang="en-US">LEFT</paragraph> <paragraph id="par_id3153622" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LINKS">Returns the first character or characters of a text.</ahelp></paragraph> -<paragraph id="hd_id3156116" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3146786" role="code" xml-lang="en-US">LEFT("Text"; Number)</paragraph> <paragraph id="par_id3147274" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text where the initial partial words are to be determined.</paragraph> <paragraph id="par_id3153152" role="paragraph" xml-lang="en-US"> <emph>Number</emph> (optional) specifies the number of characters for the start text. If this parameter is not defined, one character is returned.</paragraph> -<paragraph id="hd_id3150260" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3149141" role="paragraph" xml-lang="en-US"> <item type="input">=LEFT("output";3)</item> returns “out”.</paragraph> </section> @@ -352,12 +352,12 @@ <paragraph id="hd_id2947083" role="heading" level="2" xml-lang="en-US">LEFTB</paragraph> <paragraph id="par_id2953622" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LEFTB">Returns the first characters of a DBCS text.</ahelp></paragraph> -<paragraph id="hd_id2956116" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2946786" role="code" xml-lang="en-US">LEFTB("Text"; Number_bytes)</paragraph> <paragraph id="par_id2947274" role="paragraph" xml-lang="en-US"><emph>Text</emph> is the text where the initial partial words are to be determined.</paragraph> <paragraph id="par_id2953152" role="paragraph" xml-lang="en-US"><emph>Number_bytes</emph> (optional) specifies the number of characters you want LEFTB to extract, based on bytes. If this parameter is not defined, one character is returned.</paragraph> -<paragraph id="hd_id2950260" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2949141" role="paragraph" xml-lang="en-US"><item type="input">LEFTB("中国";1)</item> returns " " (1 byte is only half a DBCS character and a space character is returned instead).</paragraph> <paragraph id="par_id2949151" role="paragraph" xml-lang="en-US"><item type="input">LEFTB("中国";2)</item> returns "中" (2 bytes constitute one complete DBCS character).</paragraph> <paragraph id="par_id2949161" role="paragraph" xml-lang="en-US"><item type="input">LEFTB("中国";3)</item> returns "中 " (3 bytes constitute one DBCS character and a half; the last character returned is therefore a space character).</paragraph> @@ -375,11 +375,11 @@ <paragraph id="hd_id3156110" role="heading" level="2" xml-lang="en-US">LEN</paragraph> <paragraph id="par_id3150147" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LAENGE">Returns the length of a string including spaces.</ahelp></paragraph> -<paragraph id="hd_id3155108" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3154063" role="code" xml-lang="en-US">LEN("Text")</paragraph> <paragraph id="par_id3146894" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text whose length is to be determined.</paragraph> -<paragraph id="hd_id3153884" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3156008" role="paragraph" xml-lang="en-US"> <item type="input">=LEN("Good Afternoon")</item> returns 14.</paragraph> <paragraph id="par_id3154300" role="paragraph" xml-lang="en-US"> <item type="input">=LEN(12345.67)</item> returns 8.</paragraph> </section> @@ -394,11 +394,11 @@ <paragraph id="hd_id2956110" role="heading" level="2" xml-lang="en-US">LENB</paragraph> <paragraph id="par_id2950147" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LENB">For double-byte character set (DBCS) languages, returns the number of bytes used to represent the characters in a text string.</ahelp></paragraph> -<paragraph id="hd_id2955108" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2954063" role="code" xml-lang="en-US">LENB("Text")</paragraph> <paragraph id="par_id2946894" role="paragraph" xml-lang="en-US"><emph>Text</emph> is the text whose length is to be determined.</paragraph> -<paragraph id="hd_id2953884" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2956018" role="paragraph" xml-lang="en-US"><item type="input">LENB("中")</item> returns 2 (1 DBCS character consisting of 2 bytes).</paragraph> <paragraph id="par_id2956028" role="paragraph" xml-lang="en-US"><item type="input">LENB("中国")</item> returns 4 (2 DBCS characters each consisting of 2 bytes).</paragraph> <paragraph id="par_id2956038" role="paragraph" xml-lang="en-US"><item type="input">LENB("office")</item> returns 6 (6 non-DBCS characters each consisting of 1 byte).</paragraph> @@ -416,11 +416,11 @@ <paragraph id="hd_id3153983" role="heading" level="2" xml-lang="en-US">LOWER</paragraph> <paragraph id="par_id3152791" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KLEIN">Converts all uppercase letters in a text string to lowercase.</ahelp></paragraph> -<paragraph id="hd_id3155902" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150121" role="code" xml-lang="en-US">LOWER("Text")</paragraph> <paragraph id="par_id3153910" role="paragraph" xml-lang="en-US"> <emph>Text</emph> refers to the text to be converted.</paragraph> -<paragraph id="hd_id3159343" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3155329" role="paragraph" xml-lang="en-US"> <item type="input">=LOWER("Sun")</item> returns sun.</paragraph> </section> @@ -434,13 +434,13 @@ <paragraph id="hd_id3154589" role="heading" level="2" xml-lang="en-US">MID</paragraph> <paragraph id="par_id3154938" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TEIL">Returns a text string of a text. The parameters specify the starting position and the number of characters.</ahelp></paragraph> -<paragraph id="hd_id3148829" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150526" role="code" xml-lang="en-US">MID("Text"; Start; Number)</paragraph> <paragraph id="par_id3148820" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text containing the characters to extract.</paragraph> <paragraph id="par_id3150774" role="paragraph" xml-lang="en-US"> <emph>Start</emph> is the position of the first character in the text to extract.</paragraph> <paragraph id="par_id3153063" role="paragraph" xml-lang="en-US"> <emph>Number</emph> specifies the number of characters in the part of the text.</paragraph> -<paragraph id="hd_id3150509" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3158407" role="paragraph" xml-lang="en-US"> <item type="input">=MID("office";2;2)</item> returns ff.</paragraph> </section> @@ -454,13 +454,13 @@ <paragraph id="hd_id2954589" role="heading" level="2" xml-lang="en-US">MIDB</paragraph> <paragraph id="par_id2954938" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_MIDB">Returns a text string of a DBCS text. The parameters specify the starting position and the number of characters.</ahelp></paragraph> -<paragraph id="hd_id2948829" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2950526" role="code" xml-lang="en-US">MIDB("Text"; Start; Number_bytes)</paragraph> <paragraph id="par_id2948820" role="paragraph" xml-lang="en-US"><emph>Text</emph> is the text containing the characters to extract.</paragraph> <paragraph id="par_id2950774" role="paragraph" xml-lang="en-US"><emph>Start</emph> is the position of the first character in the text to extract.</paragraph> <paragraph id="par_id2953063" role="paragraph" xml-lang="en-US"><emph>Number_bytes</emph> specifies the number of characters MIDB will return from text, in bytes.</paragraph> -<paragraph id="hd_id2950509" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2958417" role="paragraph" xml-lang="en-US"><item type="input">MIDB("中国";1;0)</item> returns "" (0 bytes is always an empty string).</paragraph> <paragraph id="par_id2958427" role="paragraph" xml-lang="en-US"><item type="input">MIDB("中国";1;1)</item> returns " " (1 byte is only half a DBCS character and therefore the result is a space character).</paragraph> <paragraph id="par_id2958437" role="paragraph" xml-lang="en-US"><item type="input">MIDB("中国";1;2)</item> returns "中" (2 bytes constitute one complete DBCS character).</paragraph> @@ -484,11 +484,11 @@ <paragraph id="hd_id3159143" role="heading" level="2" xml-lang="en-US">PROPER</paragraph> <paragraph id="par_id3149768" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GROSS2">Capitalizes the first letter in all words of a text string.</ahelp></paragraph> -<paragraph id="hd_id3153573" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3154260" role="code" xml-lang="en-US">PROPER("Text")</paragraph> <paragraph id="par_id3147509" role="paragraph" xml-lang="en-US"> <emph>Text</emph> refers to the text to be converted.</paragraph> -<paragraph id="hd_id3147529" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3155364" role="paragraph" xml-lang="en-US"> <item type="input">=PROPER("open office")</item> returns Open Office.</paragraph> </section> @@ -503,14 +503,14 @@ <paragraph id="par_id3148925" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ERSETZEN">Replaces part of a text string with a different text string.</ahelp> This function can be used to replace both characters and numbers (which are automatically converted to text). The result of the function is always displayed as text. If you intend to perform further calculations with a number which has been replaced by text, you will need to convert it back to a number using the <link href="text/scalc/01/04060110.xhp" name="VALUE">VALUE</link> function.</paragraph> <paragraph id="par_id3158426" role="paragraph" xml-lang="en-US">Any text containing numbers must be enclosed in quotation marks if you do not want it to be interpreted as a number and automatically converted to text.</paragraph> -<paragraph id="hd_id3149159" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3147286" role="code" xml-lang="en-US">REPLACE("Text"; Position; Length; "NewText")</paragraph> <paragraph id="par_id3149797" role="paragraph" xml-lang="en-US"> <emph>Text</emph> refers to text of which a part will be replaced.</paragraph> <paragraph id="par_id3166451" role="paragraph" xml-lang="en-US"> <emph>Position</emph> refers to the position within the text where the replacement will begin.</paragraph> <paragraph id="par_id3156040" role="paragraph" xml-lang="en-US"> <emph>Length</emph> is the number of characters in <emph>Text</emph> to be replaced.</paragraph> <paragraph id="par_id3159188" role="paragraph" xml-lang="en-US"> <emph>NewText</emph> refers to the text which replaces <emph>Text</emph>.</paragraph> -<paragraph id="hd_id3146958" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154096" role="paragraph" xml-lang="en-US"> <item type="input">=REPLACE("1234567";1;1;"444")</item> returns "444234567". One character at position 1 is replaced by the complete <item type="literal">NewText</item>.</paragraph> </section> @@ -524,13 +524,13 @@ <paragraph id="hd_id3149741" role="heading" level="2" xml-lang="en-US">REPT</paragraph> <paragraph id="par_id3153748" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_WIEDERHOLEN">Repeats a character string by the given <emph>number</emph> of copies.</ahelp></paragraph> -<paragraph id="hd_id3152884" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150494" role="code" xml-lang="en-US">REPT("Text"; Number)</paragraph> <paragraph id="par_id3154859" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text to be repeated.</paragraph> <paragraph id="par_id3150638" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is the number of repetitions.</paragraph> <paragraph id="par_id3149922" role="paragraph" xml-lang="en-US">The result can be a maximum of 255 characters.</paragraph> -<paragraph id="hd_id3156213" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3148626" role="paragraph" xml-lang="en-US"> <item type="input">=REPT("Good morning";2)</item> returns Good morningGood morning.</paragraph> </section> @@ -544,12 +544,12 @@ <paragraph id="hd_id3149805" role="heading" level="2" xml-lang="en-US">RIGHT</paragraph> <paragraph id="par_id3145375" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RECHTS">Returns the last character or characters of a text.</ahelp></paragraph> -<paragraph id="hd_id3150837" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3154344" role="code" xml-lang="en-US">RIGHT("Text"; Number)</paragraph> <paragraph id="par_id3149426" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text of which the right part is to be determined.</paragraph> <paragraph id="par_id3153350" role="paragraph" xml-lang="en-US"> <emph>Number</emph> (optional) is the number of characters from the right part of the text.</paragraph> -<paragraph id="hd_id3148661" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3151132" role="paragraph" xml-lang="en-US"> <item type="input">=RIGHT("Sun";2)</item> returns un.</paragraph> </section> @@ -563,12 +563,12 @@ <paragraph id="hd_id2949805" role="heading" level="2" xml-lang="en-US">RIGHTB</paragraph> <paragraph id="par_id2945375" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RIGHTB">Returns the last character or characters of a text with double bytes characters sets (DBCS).</ahelp></paragraph> -<paragraph id="hd_id2950837" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2954344" role="code" xml-lang="en-US">RIGHTB("Text"; Number_bytes)</paragraph> <paragraph id="par_id2949426" role="paragraph" xml-lang="en-US"><emph>Text</emph> is the text of which the right part is to be determined.</paragraph> <paragraph id="par_id2953350" role="paragraph" xml-lang="en-US"><emph>Number_bytes</emph> (optional) specifies the number of characters you want RIGHTB to extract, based on bytes.</paragraph> -<paragraph id="hd_id2948661" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2951132" role="paragraph" xml-lang="en-US"><item type="input">RIGHTB("中国";1)</item> returns " " (1 byte is only half a DBCS character and a space character is returned instead).</paragraph> <paragraph id="par_id2951142" role="paragraph" xml-lang="en-US"><item type="input">RIGHTB("中国";2)</item> returns "国" (2 bytes constitute one complete DBCS character).</paragraph> <paragraph id="par_id2951152" role="paragraph" xml-lang="en-US"><item type="input">RIGHTB("中国";3)</item> returns " 国" (3 bytes constitute one half DBCS character and one whole DBCS character; a space is returned for the first half).</paragraph> @@ -586,12 +586,12 @@ <paragraph id="hd_id3153534" role="heading" level="2" xml-lang="en-US">ROMAN</paragraph> <paragraph id="par_id3151256" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ROEMISCH">Converts a number into a Roman numeral. The value range must be between 0 and 3999, the modes can be integers from 0 to 4.</ahelp></paragraph> -<paragraph id="hd_id3149299" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150593" role="code" xml-lang="en-US">ROMAN(Number; Mode)</paragraph> <paragraph id="par_id3156139" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is the number that is to be converted into a Roman numeral.</paragraph> <paragraph id="par_id3153318" role="paragraph" xml-lang="en-US"> <emph>Mode</emph> (optional) indicates the degree of simplification. The higher the value, the greater is the simplification of the Roman number.</paragraph> -<paragraph id="hd_id3145306" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3151371" role="paragraph" xml-lang="en-US"> <item type="input">=ROMAN(999)</item> returns CMXCIX</paragraph> <paragraph id="par_id3153938" role="paragraph" xml-lang="en-US"> <item type="input">=ROMAN(999;0)</item> returns CMXCIX</paragraph> <paragraph id="par_id3148412" role="paragraph" xml-lang="en-US"> <item type="input">=ROMAN (999;1)</item> returns LMVLIV</paragraph> @@ -611,13 +611,13 @@ <paragraph id="par_id3148692" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUCHEN">Returns the position of a text segment within a character string.</ahelp> You can set the start of the search as an option. The search text can be a number or any sequence of characters. The search is not case-sensitive. If the text is not found, returns error 519 (#VALUE).</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> -<paragraph id="hd_id3152964" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3154671" role="code" xml-lang="en-US">SEARCH("FindText"; "Text"; Position)</paragraph> <paragraph id="par_id3146080" role="paragraph" xml-lang="en-US"> <emph>FindText</emph> is the text to be searched for.</paragraph> <paragraph id="par_id3154111" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text where the search will take place.</paragraph> <paragraph id="par_id3149559" role="paragraph" xml-lang="en-US"> <emph>Position</emph> (optional) is the position in the text where the search is to start.</paragraph> -<paragraph id="hd_id3147322" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154564" role="paragraph" xml-lang="en-US"> <item type="input">=SEARCH(54;998877665544)</item> returns 10.</paragraph> </section> @@ -631,14 +631,14 @@ <paragraph id="hd_id3154830" role="heading" level="2" xml-lang="en-US">SUBSTITUTE</paragraph> <paragraph id="par_id3153698" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_WECHSELN">Substitutes new text for old text in a string.</ahelp></paragraph> -<paragraph id="hd_id3150994" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3147582" role="code" xml-lang="en-US">SUBSTITUTE("Text"; "SearchText"; "NewText"; Occurrence)</paragraph> <paragraph id="par_id3153675" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text in which text segments are to be exchanged.</paragraph> <paragraph id="par_id3156155" role="paragraph" xml-lang="en-US"> <emph>SearchText </emph>is the text segment that is to be replaced (a number of times).</paragraph> <paragraph id="par_id3145779" role="paragraph" xml-lang="en-US"> <emph>NewText</emph> is the text that is to replace the text segment.</paragraph> <paragraph id="par_id3150348" role="paragraph" xml-lang="en-US"> <emph>Occurrence</emph> (optional) indicates which occurrence of the search text is to be replaced. If this parameter is missing the search text is replaced throughout.</paragraph> -<paragraph id="hd_id3150946" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3150412" role="paragraph" xml-lang="en-US"> <item type="input">=SUBSTITUTE("123123123";"3";"abc")</item> returns 12abc12abc12abc.</paragraph> <paragraph id="par_id3154915" role="paragraph" xml-lang="en-US"> <item type="input">=SUBSTITUTE("123123123";"3";"abc";2)</item> returns 12312abc123.</paragraph> </section> @@ -653,11 +653,11 @@ <paragraph id="hd_id3148977" role="heading" level="2" xml-lang="en-US">T</paragraph> <paragraph id="par_id3154359" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_T">This function returns the target text, or a blank text string if the target is not text.</ahelp></paragraph> -<paragraph id="hd_id3155858" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3155871" role="code" xml-lang="en-US">T(Value)</paragraph> <paragraph id="par_id3154726" role="paragraph" xml-lang="en-US">If <emph>Value</emph> is a text string or refers to a text string, T returns that text string; otherwise it returns a blank text string.</paragraph> -<paragraph id="hd_id3155544" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3151062" role="paragraph" xml-lang="en-US"> <item type="input">=T(12345)</item> returns an empty string. </paragraph> <paragraph id="par_id4650105" role="paragraph" xml-lang="en-US"> <item type="input">=T("12345")</item> returns the string 12345.</paragraph> </section> @@ -672,12 +672,12 @@ <paragraph id="hd_id3147132" role="heading" level="2" xml-lang="en-US">TEXT</paragraph> <paragraph id="par_id3147213" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TEXT">Converts a number into text according to a given format.</ahelp></paragraph> -<paragraph id="hd_id3153129" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3147377" role="code" xml-lang="en-US">TEXT(Number; Format)</paragraph> <paragraph id="par_id3147389" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is the numerical value to be converted.</paragraph> <paragraph id="par_id3156167" role="paragraph" xml-lang="en-US"> <emph>Format</emph> is the text which defines the format. Use decimal and thousands separators according to the language set in the cell format.</paragraph> -<paragraph id="hd_id1243629" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id9044770" role="paragraph" xml-lang="en-US"> <item type="input">=TEXT(12.34567;"###.##")</item> returns the text 12.35</paragraph> <paragraph id="par_id3674123" role="paragraph" xml-lang="en-US"> <item type="input">=TEXT(12.34567;"000.00")</item> returns the text 012.35</paragraph> @@ -694,11 +694,11 @@ <paragraph id="hd_id3151039" role="heading" level="2" xml-lang="en-US">TRIM</paragraph> <paragraph id="par_id3157888" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GLAETTEN">Removes spaces from a string, leaving only a single space character between words.</ahelp></paragraph> -<paragraph id="hd_id3152913" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3151349" role="code" xml-lang="en-US">TRIM("Text")</paragraph> <paragraph id="par_id3151362" role="paragraph" xml-lang="en-US"> <emph>Text</emph> refers to text in which spaces are to be removed.</paragraph> -<paragraph id="hd_id3146838" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3156074" role="paragraph" xml-lang="en-US"> <item type="input">=TRIM(" hello world ")</item> returns hello world without leading and trailing spaces and with single space between words.</paragraph> </section> @@ -712,10 +712,10 @@ <paragraph id="hd_id0907200904022525" role="heading" level="2" xml-lang="en-US">UNICHAR</paragraph> <paragraph id="par_id0907200904022538" role="paragraph" xml-lang="en-US"><ahelp hid=".">Converts a code number into a Unicode character or letter.</ahelp></paragraph> -<paragraph id="hd_id0907200904123753" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id0907200904123753" role="paragraph" xml-lang="en-US"><item type="literal">UNICHAR(number)</item></paragraph> -<paragraph id="hd_id0907200904123720" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id090720090412378" role="paragraph" xml-lang="en-US">=UNICHAR(169) returns the Copyright character <emph>©</emph>.</paragraph> <paragraph id="par_id050220170755399756" role="tip" xml-lang="en-US">See also the UNICODE() function.</paragraph> </section> @@ -730,10 +730,10 @@ <paragraph id="hd_id0907200904022588" role="heading" level="2" xml-lang="en-US">UNICODE</paragraph> <paragraph id="par_id0907200904022594" role="paragraph" xml-lang="en-US"><ahelp hid=".">Returns the numeric code for the first Unicode character in a text string.</ahelp></paragraph> -<paragraph id="hd_id0907200904123874" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id0907200904123846" role="paragraph" xml-lang="en-US"><item type="literal">UNICODE("Text")</item></paragraph> -<paragraph id="hd_id0907200904123899" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id0907200904123919" role="paragraph" xml-lang="en-US">=UNICODE("©") returns the Unicode number 169 for the Copyright character.</paragraph> <paragraph id="par_id050220170755393174" role="tip" xml-lang="en-US">See also the UNICHAR() function.</paragraph> </section> @@ -748,11 +748,11 @@ <paragraph id="hd_id3145178" role="heading" level="2" xml-lang="en-US">UPPER</paragraph> <paragraph id="par_id3162905" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GROSS">Converts the string specified in the <emph>text</emph> field to uppercase.</ahelp></paragraph> -<paragraph id="hd_id3148526" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148539" role="code" xml-lang="en-US">UPPER("Text")</paragraph> <paragraph id="par_id3148496" role="paragraph" xml-lang="en-US"> <emph>Text</emph> refers to the lower case letters you want to convert to upper case.</paragraph> -<paragraph id="hd_id3148516" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3146757" role="paragraph" xml-lang="en-US"> <item type="input">=UPPER("Good Morning")</item> returns GOOD MORNING.</paragraph> </section> @@ -766,11 +766,11 @@ <paragraph id="hd_id3150802" role="heading" level="2" xml-lang="en-US">VALUE</paragraph> <paragraph id="par_id3152551" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_WERT">Converts a text string into a number.</ahelp></paragraph> -<paragraph id="hd_id3152568" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3153638" role="code" xml-lang="en-US">VALUE("Text")</paragraph> <paragraph id="par_id3153651" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text to be converted to a number.</paragraph> -<paragraph id="hd_id3144719" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3144733" role="paragraph" xml-lang="en-US"> <item type="input">=VALUE("4321")</item> returns 4321.</paragraph> </section> </sort> diff --git a/source/text/scalc/01/04060111.xhp b/source/text/scalc/01/04060111.xhp index 536a70604c..fbcfe2f7cf 100644 --- a/source/text/scalc/01/04060111.xhp +++ b/source/text/scalc/01/04060111.xhp @@ -34,7 +34,7 @@ <paragraph role="paragraph" id="par_id3147427" xml-lang="en-US"><variable id="addintext">The following describes and lists some of the available add-in functions. </variable></paragraph> <paragraph role="paragraph" id="par_id3163713" xml-lang="en-US"><link href="text/scalc/01/04060112.xhp#addinconcept">Add-in concept</link></paragraph> -<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US">You will also find a <link href="text/scalc/01/04060112.xhp">description of the $[officename] Calc add-in interface</link> in the Help. In addition, important functions and their parameters are described in the Help for the <switchinline select="sys"><caseinline select="UNIX">Shared Library +<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US">You will also find a <link href="text/scalc/01/04060112.xhp">description of the $[officename] Calc add-in interface</link> in the Help. In addition, important functions and their parameters are described in the Help for the <switchinline select="sys"><caseinline select="UNIX">Shared Library </caseinline><defaultinline>$[officename] Calc add-in DLL</defaultinline></switchinline>.</paragraph> <paragraph role="heading" id="hd_id3151075" xml-lang="en-US" level="2">Add-ins supplied</paragraph> <paragraph role="paragraph" id="par_id3156285" xml-lang="en-US">$[officename] contains examples for the add-in interface of $[officename] Calc.</paragraph> @@ -47,11 +47,11 @@ </bookmark><comment>mw added one entry</comment> <paragraph role="heading" id="hd_id3149566" xml-lang="en-US" level="2">ISLEAPYEAR</paragraph> <paragraph role="paragraph" id="par_id3150297" xml-lang="en-US"><ahelp hid=".">Determines whether a year is a leap year.</ahelp> If yes, the function will return the value 1 (TRUE); if not, it will return 0 (FALSE).</paragraph> -<paragraph role="heading" id="hd_id3148487" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3150205" xml-lang="en-US">ISLEAPYEAR(Date)</paragraph> <paragraph role="paragraph" id="par_id3159239" xml-lang="en-US"> <emph>Date</emph> specifies whether a given date falls within a leap year. The Date parameter must be a valid date.</paragraph> -<paragraph role="heading" id="hd_id3149817" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3150786" xml-lang="en-US">=ISLEAPYEAR(A1) returns 1, if A1 contains 1968-02-29, the valid date 29th of February 1968 in your locale setting.</paragraph> <paragraph role="paragraph" id="par_idN107E7" xml-lang="en-US">You may also use =ISLEAPYEAR(DATE(1968;2;29)) or =ISLEAPYEAR("1968-02-29") giving the date string in the ISO 8601 notation.</paragraph> <paragraph role="paragraph" id="par_idN107EA" xml-lang="en-US">Never use =ISLEAPYEAR(2/29/68), because this would first evaluate 2 divided by 29 divided by 68, and then calculate the ISLEAPYEAR function from this small number as a serial date number.</paragraph> @@ -63,7 +63,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_DIFFYEARS" id="bm_id3150368" localize="false"/> <paragraph role="heading" id="hd_id3154656" xml-lang="en-US" level="2">YEARS</paragraph> <paragraph role="paragraph" id="par_id3150886" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_DIFFYEARS">Calculates the difference in years between two dates.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3154370" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3146114" xml-lang="en-US">YEARS(StartDate; EndDate; Type)</paragraph> <paragraph role="paragraph" id="par_id3145387" xml-lang="en-US"> <emph>StartDate</emph> is the first date</paragraph> @@ -79,7 +79,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_DIFFMONTHS" id="bm_id3148839" localize="false"/> <paragraph role="heading" id="hd_id3152898" xml-lang="en-US" level="2">MONTHS</paragraph> <paragraph role="paragraph" id="par_id3153066" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_DIFFMONTHS">Calculates the difference in months between two dates.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3151240" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3146869" xml-lang="en-US">MONTHS(StartDate; EndDate; Type)</paragraph> <paragraph role="paragraph" id="par_id3145075" xml-lang="en-US"> <emph>StartDate</emph> is the first date</paragraph> @@ -95,7 +95,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_ROT13" id="bm_id3153283" localize="false"/> <paragraph role="heading" id="hd_id3159094" xml-lang="en-US" level="2">ROT13</paragraph> <paragraph role="paragraph" id="par_id3146781" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_ROT13">Encrypts a character string by moving the characters 13 positions in the alphabet.</ahelp> After the letter Z, the alphabet begins again (Rotation). By applying the encryption function again to the resulting code, you can decrypt the text.</paragraph> -<paragraph role="heading" id="hd_id3150893" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3159205" xml-lang="en-US">ROT13(Text)</paragraph> <paragraph role="paragraph" id="par_id3153249" xml-lang="en-US"> <emph>Text</emph> is the character string to be encrypted. ROT13(ROT13(Text)) decrypts the code.</paragraph> @@ -107,11 +107,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_DAYSINYEAR" id="bm_id3153972" localize="false"/> <paragraph role="heading" id="hd_id3151300" xml-lang="en-US" level="2">DAYSINYEAR</paragraph> <paragraph role="paragraph" id="par_id3143220" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_DAYSINYEAR">Calculates the number of days of the year in which the date entered occurs.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3145358" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3154651" xml-lang="en-US">DAYSINYEAR(Date)</paragraph> <paragraph role="paragraph" id="par_id3153803" xml-lang="en-US"> <emph>Date</emph> is any date in the respective year. The Date parameter must be a valid date according to the locale settings of %PRODUCTNAME.</paragraph> -<paragraph role="heading" id="hd_id3153487" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3153811" xml-lang="en-US">=DAYSINYEAR(A1) returns 366 days if A1 contains 1968-02-29, a valid date for the year 1968.</paragraph> </section> <section id="daysinmonth"> @@ -121,11 +121,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_DAYSINMONTH" id="bm_id3155593" localize="false"/> <paragraph role="heading" id="hd_id3154737" xml-lang="en-US" level="2">DAYSINMONTH</paragraph> <paragraph role="paragraph" id="par_id3149316" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_DAYSINMONTH">Calculates the number of days of the month in which the date entered occurs.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3145114" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3150955" xml-lang="en-US">DAYSINMONTH(Date)</paragraph> <paragraph role="paragraph" id="par_id3147501" xml-lang="en-US"> <emph>Date</emph> is any date in the respective month of the desired year. The Date parameter must be a valid date according to the locale settings of %PRODUCTNAME.</paragraph> -<paragraph role="heading" id="hd_id3149871" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3155742" xml-lang="en-US">=DAYSINMONTH(A1) returns 29 days if A1 contains 1968-02-17, a valid date for February 1968.</paragraph> </section> <section id="weeks"> @@ -135,7 +135,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_DIFFWEEKS" id="bm_id3150435" localize="false"/> <paragraph role="heading" id="hd_id3149048" xml-lang="en-US" level="2">WEEKS</paragraph> <paragraph role="paragraph" id="par_id3153340" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_DIFFWEEKS">Calculates the difference in weeks between two dates.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3150393" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3147402" xml-lang="en-US">WEEKS(StartDate; EndDate; Type)</paragraph> <paragraph role="paragraph" id="par_id3151387" xml-lang="en-US"> <emph>StartDate</emph> is the first date</paragraph> @@ -151,11 +151,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_WEEKSINYEAR" id="bm_id3146883" localize="false"/> <paragraph role="heading" id="hd_id3145237" xml-lang="en-US" level="2">WEEKSINYEAR</paragraph> <paragraph role="paragraph" id="par_id3147410" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_WEEKSINYEAR">Calculates the number of weeks of the year in which the date entered occurs.</ahelp> The number of weeks is defined as follows: a week that spans two years is added to the year in which most days of that week occur.</paragraph> -<paragraph role="heading" id="hd_id3149719" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3145638" xml-lang="en-US">WEEKSINYEAR(Date)</paragraph> <paragraph role="paragraph" id="par_id3149946" xml-lang="en-US"> <emph>Date</emph> is any date in the respective year. The Date parameter must be a valid date according to the locale settings of %PRODUCTNAME.</paragraph> -<paragraph role="heading" id="hd_id3150037" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3147614" xml-lang="en-US">WEEKSINYEAR(A1) returns 53 if A1 contains 1970-02-17, a valid date for the year 1970.</paragraph> </section> </sort> diff --git a/source/text/scalc/01/04060115.xhp b/source/text/scalc/01/04060115.xhp index 0f2d555bb3..1f367d4fdf 100644 --- a/source/text/scalc/01/04060115.xhp +++ b/source/text/scalc/01/04060115.xhp @@ -50,12 +50,12 @@ <paragraph id="hd_id3153334" role="heading" level="2" xml-lang="en-US">BESSELI</paragraph> <paragraph id="par_id3153960" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BESSELI">Calculates the modified Bessel function of the first kind In(x).</ahelp></paragraph> -<paragraph id="hd_id3150392" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3147295" role="code" xml-lang="en-US">BESSELI(X; N)</paragraph> <paragraph id="par_id3151338" role="paragraph" xml-lang="en-US"> <emph>X</emph> is the value on which the function will be calculated.</paragraph> <paragraph id="par_id3151392" role="paragraph" xml-lang="en-US"> <emph>N</emph> is a positive integer (N >= 0) representing the order of the Bessel function In(x)</paragraph> -<paragraph id="hd_id050220171032372604" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id050220171019072404" role="paragraph" xml-lang="en-US">=BESSELI(3.45, 4), returns 0.651416873060081</paragraph> <paragraph id="par_id050220171019072953" role="paragraph" xml-lang="en-US">=BESSELI(3.45, 4.333), returns 0.651416873060081, same as above because the fractional part of N is ignored.</paragraph> <paragraph id="par_id050220171019075086" role="paragraph" xml-lang="en-US">=BESSELI(-1, 3), returns -0.022168424924332</paragraph> @@ -67,12 +67,12 @@ <paragraph id="hd_id3153027" role="heading" level="2" xml-lang="en-US">BESSELJ</paragraph> <paragraph id="par_id3153015" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BESSELJ">Calculates the Bessel function of the first kind Jn(x) (cylinder function).</ahelp></paragraph> -<paragraph id="hd_id3146884" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150032" role="code" xml-lang="en-US">BESSELJ(X; N)</paragraph> <paragraph id="par_id3150378" role="paragraph" xml-lang="en-US"> <emph>X</emph> is the value on which the function will be calculated.</paragraph> <paragraph id="par_id3145638" role="paragraph" xml-lang="en-US"> <emph>N</emph> is a positive integer (N >= 0) representing the order of the Bessel function Jn(x)</paragraph> -<paragraph id="hd_id050220171032372274" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id050220171019077179" role="paragraph" xml-lang="en-US">=BESSELJ(3.45, 4), returns 0.196772639864984</paragraph> <paragraph id="par_id050220171019078280" role="paragraph" xml-lang="en-US">=BESSELJ(3.45, 4.333), returns 0.196772639864984, same as above because the fractional part of N is ignored.</paragraph> <paragraph id="par_id050220171019079818" role="paragraph" xml-lang="en-US">=BESSELJ(-1, 3), returns -0.019563353982668</paragraph> @@ -84,12 +84,12 @@ <paragraph id="hd_id3149946" role="heading" level="2" xml-lang="en-US">BESSELK</paragraph> <paragraph id="par_id3159122" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BESSELK">Calculates the modified Bessel function of the second kind Kn(x).</ahelp></paragraph> -<paragraph id="hd_id3150650" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149354" role="code" xml-lang="en-US">BESSELK(X; N)</paragraph> <paragraph id="par_id3150481" role="paragraph" xml-lang="en-US"> <emph>X</emph> is the strictly positive value (X > 0) on which the function will be calculated.</paragraph> <paragraph id="par_id3150024" role="paragraph" xml-lang="en-US"> <emph>N</emph> is a positive integer (N >= 0) representing the order of the Bessel function Kn(x)</paragraph> -<paragraph id="hd_id050220171032373675" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id050220171019073898" role="paragraph" xml-lang="en-US">=BESSELK(3.45, 4), returns 0.144803466373734</paragraph> <paragraph id="par_id050220171019079889" role="paragraph" xml-lang="en-US">=BESSELK(3.45, 4.333), returns 0.144803466373734, same as above because the fractional part of N is ignored.</paragraph> <paragraph id="par_id050220171019076471" role="paragraph" xml-lang="en-US">=BESSELK(0, 3), returns Err:502 – invalid argument (X=0)</paragraph> @@ -101,12 +101,12 @@ <paragraph id="hd_id3145828" role="heading" level="2" xml-lang="en-US">BESSELY</paragraph> <paragraph id="par_id3146877" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BESSELY">Calculates the Bessel function of the second kind Yn(x).</ahelp></paragraph> -<paragraph id="hd_id3146941" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148884" role="code" xml-lang="en-US">BESSELY(X; N)</paragraph> <paragraph id="par_id3147475" role="paragraph" xml-lang="en-US"> <emph>X</emph> is the strictly positive value (X > 0) on which the function will be calculated.</paragraph> <paragraph id="par_id3147421" role="paragraph" xml-lang="en-US"> <emph>N</emph> is a positive integer (N >= 0) representing the order of the Bessel function Yn(x)</paragraph> -<paragraph id="hd_id050220171019084402" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id050220171019081114" role="paragraph" xml-lang="en-US">=BESSELY(3.45, 4), returns -0.679848116844476</paragraph> <paragraph id="par_id050220171019081288" role="paragraph" xml-lang="en-US">=BESSELY(3.45, 4.333), returns -0.679848116844476, same as above because the fractional part of N is ignored.</paragraph> <paragraph id="par_id050220171019082347" role="paragraph" xml-lang="en-US">=BESSELY(0, 3), returns Err:502 – invalid argument (X=0)</paragraph> @@ -123,11 +123,11 @@ <paragraph id="hd_id3153034" role="heading" level="2" xml-lang="en-US">BIN2DEC</paragraph> <paragraph id="par_id3144744" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BIN2DEC">The result is the decimal number for the binary number entered.</ahelp></paragraph> -<paragraph id="hd_id3145593" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149726" role="code" xml-lang="en-US">BIN2DEC(Number)</paragraph> <paragraph id="par_id3150142" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is a binary number. The number can have a maximum of 10 places (bits). The most significant bit is the sign bit. Negative numbers are entered as two's complement.</paragraph> -<paragraph id="hd_id3149250" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3145138" role="paragraph" xml-lang="en-US"> <item type="input">=BIN2DEC(1100100)</item> returns 100.</paragraph> </section> @@ -142,12 +142,12 @@ <paragraph id="hd_id3149954" role="heading" level="2" xml-lang="en-US">BIN2HEX</paragraph> <paragraph id="par_id3148585" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BIN2HEX">The result is the hexadecimal number for the binary number entered.</ahelp></paragraph> -<paragraph id="hd_id3153936" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148753" role="code" xml-lang="en-US">BIN2HEX(Number; Places)</paragraph> <paragraph id="par_id3155255" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is a binary number. The number can have a maximum of 10 places (bits). The most significant bit is the sign bit. Negative numbers are entered as two's complement.</paragraph> <paragraph id="par_id3150860" role="paragraph" xml-lang="en-US">Places means the number of places to be output.</paragraph> -<paragraph id="hd_id3155829" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3149686" role="paragraph" xml-lang="en-US"> <item type="input">=BIN2HEX(1100100;6)</item> returns 000064.</paragraph> </section> @@ -162,12 +162,12 @@ <paragraph id="hd_id3153332" role="heading" level="2" xml-lang="en-US">BIN2OCT</paragraph> <paragraph id="par_id3155951" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BIN2OCT"> The result is the octal number for the binary number entered.</ahelp></paragraph> -<paragraph id="hd_id3153001" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3154508" role="code" xml-lang="en-US">BIN2OCT(Number; Places)</paragraph> <paragraph id="par_id3153567" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is a binary number. The number can have a maximum of 10 places (bits). The most significant bit is the sign bit. Negative numbers are entered as two's complement.</paragraph> <paragraph id="par_id3155929" role="paragraph" xml-lang="en-US"> <emph>Places</emph> means the number of places to be output.</paragraph> -<paragraph id="hd_id3150128" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3153733" role="paragraph" xml-lang="en-US"> <item type="input">=BIN2OCT(1100100;4)</item> returns 0144.</paragraph> </section> @@ -182,10 +182,10 @@ <paragraph id="hd_id3150014" role="heading" level="2" xml-lang="en-US">DELTA</paragraph> <paragraph id="par_id3148760" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DELTA">The result is TRUE (1) if both numbers, which are delivered as an argument, are equal, otherwise it is FALSE (0).</ahelp></paragraph> -<paragraph id="hd_id3155435" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3145247" role="paragraph" xml-lang="en-US">DELTA(Number1; Number2)</paragraph> -<paragraph id="hd_id3149002" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3151020" role="paragraph" xml-lang="en-US"> <item type="input">=DELTA(1;2)</item> returns 0.</paragraph> </section> @@ -200,12 +200,12 @@ <paragraph id="hd_id3157971" role="heading" level="2" xml-lang="en-US">DEC2BIN</paragraph> <paragraph id="par_id3153043" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DEC2BIN"> The result is the binary number for the decimal number entered between -512 and 511.</ahelp></paragraph> -<paragraph id="hd_id3145349" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150569" role="code" xml-lang="en-US">DEC2BIN(Number; Places)</paragraph> <paragraph id="par_id3148768" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is a decimal number. If Number is negative, the function returns a binary number with 10 characters. The most significant bit is the sign bit, the other 9 bits return the value.</paragraph> <paragraph id="par_id3149537" role="paragraph" xml-lang="en-US"> <emph>Places</emph> means the number of places to be output.</paragraph> -<paragraph id="hd_id3150265" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3150662" role="paragraph" xml-lang="en-US"> <item type="input">=DEC2BIN(100;8)</item> returns 01100100.</paragraph> </section> @@ -220,12 +220,12 @@ <paragraph id="hd_id3149388" role="heading" level="2" xml-lang="en-US">DEC2HEX</paragraph> <paragraph id="par_id3149030" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DEC2HEX">The result is the hexadecimal number for the decimal number entered.</ahelp></paragraph> -<paragraph id="hd_id3150691" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3147535" role="code" xml-lang="en-US">DEC2HEX(Number; Places)</paragraph> <paragraph id="par_id3152820" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is a decimal number. If Number is negative, the function returns a hexadecimal number with 10 characters (40 bits). The most significant bit is the sign bit, the other 39 bits return the value.</paragraph> <paragraph id="par_id3153221" role="paragraph" xml-lang="en-US"> <emph>Places</emph> means the number of places to be output.</paragraph> -<paragraph id="hd_id3154869" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3150476" role="paragraph" xml-lang="en-US"> <item type="input">=DEC2HEX(100;4)</item> returns 0064.</paragraph> </section> @@ -240,12 +240,12 @@ <paragraph id="hd_id3154948" role="heading" level="2" xml-lang="en-US">DEC2OCT</paragraph> <paragraph id="par_id3153920" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DEC2OCT">The result is the octal number for the decimal number entered.</ahelp></paragraph> -<paragraph id="hd_id3153178" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148427" role="code" xml-lang="en-US">DEC2OCT(Number; Places)</paragraph> <paragraph id="par_id3155991" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is a decimal number. If Number is negative, the function returns an octal number with 10 characters (30 bits). The most significant bit is the sign bit, the other 29 bits return the value.</paragraph> <paragraph id="par_id3152587" role="paragraph" xml-lang="en-US"> <emph>Places</emph> means the number of places to be output.</paragraph> -<paragraph id="hd_id3147482" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154317" role="paragraph" xml-lang="en-US"> <item type="input">=DEC2OCT(100;4)</item> returns 0144.</paragraph> </section> @@ -260,12 +260,12 @@ <paragraph id="hd_id3083446" role="heading" level="2" xml-lang="en-US">ERF</paragraph> <paragraph id="par_id3150381" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ERF">Returns values of the Gaussian error integral.</ahelp></paragraph> -<paragraph id="hd_id3152475" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3163824" role="code" xml-lang="en-US">ERF(LowerLimit; UpperLimit)</paragraph> <paragraph id="par_id3149715" role="paragraph" xml-lang="en-US"> <emph>LowerLimit</emph> is the lower limit of the integral.</paragraph> <paragraph id="par_id3156294" role="paragraph" xml-lang="en-US"> <emph>UpperLimit</emph> is optional. It is the upper limit of the integral. If this value is missing, the calculation takes places between 0 and the lower limit.</paragraph> -<paragraph id="hd_id3154819" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3152974" role="paragraph" xml-lang="en-US"> <item type="input">=ERF(0;1)</item> returns 0.842701.</paragraph> </section> @@ -280,11 +280,11 @@ <paragraph id="hd_id2983446" role="heading" level="2" xml-lang="en-US">ERF.PRECISE</paragraph> <paragraph id="par_id2950381" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ERF_MS">Returns values of the Gaussian error integral between 0 and the given limit.</ahelp></paragraph> -<paragraph id="hd_id2952475" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2963824" role="code" xml-lang="en-US">ERF.PRECISE(LowerLimit)</paragraph> <paragraph id="par_id2949715" role="paragraph" xml-lang="en-US"><emph>LowerLimit</emph> is the limit of the integral. The calculation takes places between 0 and this limit.</paragraph> -<paragraph id="hd_id2954819" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2952974" role="paragraph" xml-lang="en-US"> <item type="input">=ERF.PRECISE(1)</item> returns 0.842701.</paragraph> </section> @@ -298,11 +298,11 @@ <paragraph id="hd_id3145082" role="heading" level="2" xml-lang="en-US">ERFC</paragraph> <paragraph id="par_id3149453" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ERFC">Returns complementary values of the Gaussian error integral between x and infinity.</ahelp></paragraph> -<paragraph id="hd_id3155839" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3153220" role="code" xml-lang="en-US">ERFC(LowerLimit)</paragraph> <paragraph id="par_id3147620" role="paragraph" xml-lang="en-US"> <emph>LowerLimit</emph> is the lower limit of the integral</paragraph> -<paragraph id="hd_id3146861" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3156102" role="paragraph" xml-lang="en-US"> <item type="input">=ERFC(1)</item> returns 0.157299.</paragraph> </section> @@ -316,11 +316,11 @@ <paragraph id="hd_id2945082" role="heading" level="2" xml-lang="en-US">ERFC.PRECISE</paragraph> <paragraph id="par_id2949453" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ERFC_MS">Returns complementary values of the Gaussian error integral between x and infinity.</ahelp></paragraph> -<paragraph id="hd_id2955839" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2953220" role="code" xml-lang="en-US">ERFC.PRECISE(LowerLimit)</paragraph> <paragraph id="par_id2947620" role="paragraph" xml-lang="en-US"> <emph>LowerLimit</emph> is the lower limit of the integral</paragraph> -<paragraph id="hd_id2946861" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2956102" role="paragraph" xml-lang="en-US"> <item type="input">=ERFC.PRECISE(1)</item> returns 0.157299.</paragraph> </section> @@ -335,10 +335,10 @@ <paragraph id="hd_id3152927" role="heading" level="2" xml-lang="en-US">GESTEP</paragraph> <paragraph id="par_id3150763" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_GESTEP">The result is 1 if <item type="literal">Number</item> is greater than or equal to <item type="literal">Step</item>.</ahelp></paragraph> -<paragraph id="hd_id3150879" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3145212" role="code" xml-lang="en-US">GESTEP(Number; Step)</paragraph> -<paragraph id="hd_id3153275" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3156132" role="paragraph" xml-lang="en-US"> <item type="input">=GESTEP(5;1)</item> returns 1.</paragraph> </section> @@ -353,12 +353,12 @@ <paragraph id="hd_id3147276" role="heading" level="2" xml-lang="en-US">HEX2BIN</paragraph> <paragraph id="par_id3150258" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_HEX2BIN">The result is the binary number for the hexadecimal number entered.</ahelp></paragraph> -<paragraph id="hd_id3156117" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3155847" role="code" xml-lang="en-US">HEX2BIN(Number; Places)</paragraph> <paragraph id="par_id3152810" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is a hexadecimal number or a string that represents a hexadecimal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement.</paragraph> <paragraph id="par_id3153758" role="paragraph" xml-lang="en-US"> <emph>Places</emph> is the number of places to be output.</paragraph> -<paragraph id="hd_id3154052" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3156002" role="paragraph" xml-lang="en-US"> <item type="input">=HEX2BIN("6a";8)</item> returns 01101010.</paragraph> </section> @@ -373,11 +373,11 @@ <paragraph id="hd_id3154742" role="heading" level="2" xml-lang="en-US">HEX2DEC</paragraph> <paragraph id="par_id3153626" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_HEX2DEC">The result is the decimal number for the hexadecimal number entered.</ahelp></paragraph> -<paragraph id="hd_id3143233" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149293" role="code" xml-lang="en-US">HEX2DEC(Number)</paragraph> <paragraph id="par_id3159176" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is a hexadecimal number or a string that represents a hexadecimal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement.</paragraph> -<paragraph id="hd_id3154304" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3146093" role="paragraph" xml-lang="en-US"> <item type="input">=HEX2DEC("6a")</item> returns 106.</paragraph> </section> @@ -392,12 +392,12 @@ <paragraph id="hd_id3149750" role="heading" level="2" xml-lang="en-US">HEX2OCT</paragraph> <paragraph id="par_id3153983" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_HEX2OCT">The result is the octal number for the hexadecimal number entered.</ahelp></paragraph> -<paragraph id="hd_id3145660" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3151170" role="code" xml-lang="en-US">HEX2OCT(Number; Places)</paragraph> <paragraph id="par_id3152795" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is a hexadecimal number or a string that represents a hexadecimal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement.</paragraph> <paragraph id="par_id3149204" role="paragraph" xml-lang="en-US"> <emph>Places</emph> is the number of places to be output.</paragraph> -<paragraph id="hd_id3153901" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3159341" role="paragraph" xml-lang="en-US"> <item type="input">=HEX2OCT("6a";4)</item> returns 0152.</paragraph> </section> </sort> diff --git a/source/text/scalc/01/04060116.xhp b/source/text/scalc/01/04060116.xhp index d88285acca..5773dbe3b8 100644 --- a/source/text/scalc/01/04060116.xhp +++ b/source/text/scalc/01/04060116.xhp @@ -42,11 +42,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMABS" id="bm_id3154541" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3154959" role="heading" level="2">IMABS</paragraph> <paragraph xml-lang="en-US" id="par_id3149895" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMABS">The result is the absolute value of a complex number.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3155382" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3151302" role="code">IMABS("ComplexNumber")</paragraph> <paragraph xml-lang="en-US" id="par_id3153974" role="paragraph"><variable id="complex"><emph>ComplexNumber</emph> is a complex number that is entered in the form "x+yi" or "x+yj". </variable><comment>no blanks allowed, see i82522</comment></paragraph> - <paragraph xml-lang="en-US" id="hd_id3149697" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3143222" role="paragraph"> <item type="input">=IMABS("5+12j")</item> returns 13.</paragraph> </section> @@ -56,10 +56,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMAGINARY" id="bm_id3154651" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3145357" role="heading" level="2">IMAGINARY</paragraph> <paragraph xml-lang="en-US" id="par_id3146965" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMAGINARY">The result is the imaginary coefficient of a complex number.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3153555" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155522" role="code">IMAGINARY("ComplexNumber")</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> - <paragraph xml-lang="en-US" id="hd_id3151193" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3155592" role="paragraph"> <item type="input">=IMAGINARY("4+3j")</item> returns 3.</paragraph> </section> @@ -69,12 +69,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMPOWER" id="bm_id3155755" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3146106" role="heading" level="2">IMPOWER</paragraph> <paragraph xml-lang="en-US" id="par_id3147245" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMPOWER">The result is the <emph>ComplexNumber</emph> raised to the power of <emph>Number</emph>.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3150954" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3147501" role="code">IMPOWER("ComplexNumber"; Number)</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> <paragraph xml-lang="en-US" id="par_id3155743" role="paragraph"> <emph>Number</emph> is the exponent.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3149048" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3151393" role="paragraph"> <item type="input">=IMPOWER("2+3i";2)</item> returns -5+12i.</paragraph> </section> @@ -84,10 +84,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMARGUMENT" id="bm_id3147297" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3148748" role="heading" level="2">IMARGUMENT</paragraph> <paragraph xml-lang="en-US" id="par_id3151341" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMARGUMENT">The result is the argument (the phi angle) of a complex number.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3150533" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3156402" role="code">IMARGUMENT("ComplexNumber")</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> - <paragraph xml-lang="en-US" id="hd_id3153019" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3159125" role="paragraph"> <item type="input">=IMARGUMENT("3+4j")</item> returns 0.927295.</paragraph> </section> @@ -137,11 +137,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMDIV" id="bm_id3154679" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3150024" role="heading" level="2">IMDIV</paragraph> <paragraph xml-lang="en-US" id="par_id3145825" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMDIV">The result is the division of two complex numbers.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3150465" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3146942" role="code">IMDIV("Numerator"; "Denominator")</paragraph> <paragraph xml-lang="en-US" id="par_id3150741" role="paragraph"> <emph>Numerator</emph>, <emph>Denominator</emph> are complex numbers that are entered in the form "x+yi" or "x+yj".</paragraph> - <paragraph xml-lang="en-US" id="hd_id3151229" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3148440" role="paragraph"> <item type="input">=IMDIV("-238+240i";"10+24i")</item> returns 5+12i.</paragraph> </section> @@ -151,10 +151,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMEXP" id="bm_id3147468" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153039" role="heading" level="2">IMEXP</paragraph> <paragraph xml-lang="en-US" id="par_id3144741" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMEXP">The result is the power of e and the complex number.</ahelp> The constant e has a value of approximately 2.71828182845904.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3145591" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154810" role="code">IMEXP("ComplexNumber")</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> - <paragraph xml-lang="en-US" id="hd_id3148581" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149253" role="paragraph"> <item type="input">=IMEXP("1+j") </item>returns 1.47+2.29j (rounded).</paragraph> </section> @@ -164,10 +164,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMCONJUGATE" id="bm_id3152782" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3149955" role="heading" level="2">IMCONJUGATE</paragraph> <paragraph xml-lang="en-US" id="par_id3155263" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMCONJUGATE">The result is the conjugated complex complement to a complex number.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3148750" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153082" role="code">IMCONJUGATE("ComplexNumber")</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> - <paragraph xml-lang="en-US" id="hd_id3153326" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149688" role="paragraph"> <item type="input">=IMCONJUGATE("1+j")</item> returns 1-j.</paragraph> </section> @@ -177,10 +177,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMLN" id="bm_id3149190" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3150898" role="heading" level="2">IMLN</paragraph> <paragraph xml-lang="en-US" id="par_id3146853" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMLN">The result is the natural logarithm (to the base e) of a complex number.</ahelp> The constant e has a value of approximately 2.71828182845904.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3150008" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155954" role="code">IMLN("ComplexNumber")</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> - <paragraph xml-lang="en-US" id="hd_id3153565" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153736" role="paragraph"> <item type="input">=IMLN("1+j")</item> returns 0.35+0.79j (rounded).</paragraph> </section> @@ -190,10 +190,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMLOG10" id="bm_id3148765" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3155929" role="heading" level="2">IMLOG10</paragraph> <paragraph xml-lang="en-US" id="par_id3149882" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMLOG10">The result is the common logarithm (to the base 10) of a complex number.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3154327" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150128" role="code">IMLOG10("ComplexNumber")</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> - <paragraph xml-lang="en-US" id="hd_id3149003" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3151021" role="paragraph"> <item type="input">=IMLOG10("1+j")</item> returns 0.15+0.34j (rounded).</paragraph> </section> @@ -203,10 +203,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMLOG2" id="bm_id3157975" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3155623" role="heading" level="2">IMLOG2</paragraph> <paragraph xml-lang="en-US" id="par_id3150932" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMLOG2">The result is the binary logarithm of a complex number.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3153046" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3145355" role="code">IMLOG2("ComplexNumber")</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> - <paragraph xml-lang="en-US" id="hd_id3148768" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149536" role="paragraph"> <item type="input">=IMLOG2("1+j")</item> returns 0.50+1.13j (rounded).</paragraph> </section> @@ -216,10 +216,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMPRODUCT" id="bm_id3150661" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3145626" role="heading" level="2">IMPRODUCT</paragraph> <paragraph xml-lang="en-US" id="par_id3153545" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMPRODUCT">The result is the product of up to 29 complex numbers.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3149388" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149027" role="code">IMPRODUCT("ComplexNumber"; "ComplexNumber1"; ...)</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> - <paragraph xml-lang="en-US" id="hd_id3153228" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3155815" role="paragraph"> <item type="input">=IMPRODUCT("3+4j";"5-3j")</item> returns 27+11j.</paragraph> </section> @@ -229,10 +229,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMREAL" id="bm_id3148596" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3147539" role="heading" level="2">IMREAL</paragraph> <paragraph xml-lang="en-US" id="par_id3155372" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMREAL">The result is the real coefficient of a complex number.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3154951" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153927" role="code">IMREAL("ComplexNumber")</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> - <paragraph xml-lang="en-US" id="hd_id3155409" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3155986" role="paragraph"> <item type="input">=IMREAL("1+3j")</item> returns 1.</paragraph> </section> @@ -282,10 +282,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMSUB" id="bm_id3152481" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3163826" role="heading" level="2">IMSUB</paragraph> <paragraph xml-lang="en-US" id="par_id3149277" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMSUB">The result is the subtraction of two complex numbers.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3149264" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149710" role="code">IMSUB("ComplexNumber1"; "ComplexNumber2")</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> - <paragraph xml-lang="en-US" id="hd_id3155833" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150963" role="paragraph"> <item type="input">=IMSUB("13+4j";"5+3j")</item> returns 8+j.</paragraph> </section> @@ -295,10 +295,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMSUM" id="bm_id3149454" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3156312" role="heading" level="2">IMSUM</paragraph> <paragraph xml-lang="en-US" id="par_id3153215" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMSUM">The result is the sum of up to 29 complex numbers.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3156095" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3152930" role="code">IMSUM("ComplexNumber1"; "ComplexNumber2"; ...)</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> - <paragraph xml-lang="en-US" id="hd_id3154640" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3147081" role="paragraph"> <item type="input">=IMSUM("13+4j";"5+3j")</item> returns 18+7j.</paragraph> </section> @@ -308,10 +308,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMSQRT" id="bm_id3151189" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3147570" role="heading" level="2">IMSQRT</paragraph> <paragraph xml-lang="en-US" id="par_id3156131" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMSQRT">The result is the square root of a complex number.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3145202" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150760" role="code">IMSQRT("ComplexNumber")</paragraph> <embed href="text/scalc/01/04060116.xhp#complex"/> - <paragraph xml-lang="en-US" id="hd_id3147268" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3152807" role="paragraph"> <item type="input">=IMSQRT("3+4i")</item> returns 2+1i.</paragraph> </section> @@ -321,7 +321,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_COMPLEX" id="bm_id3156116" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3154054" role="heading" level="2">COMPLEX</paragraph> <paragraph xml-lang="en-US" id="par_id3156111" role="paragraph"><ahelp hid="HID_AAI_FUNC_COMPLEX">The result is a complex number which is returned from a real coefficient and an imaginary coefficient.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3154744" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155999" role="code">COMPLEX(RealNum; INum; Suffix)</paragraph> <paragraph xml-lang="en-US" id="par_id3153626" role="paragraph"> <emph>RealNum</emph> is the real coefficient of the complex number.</paragraph> @@ -329,7 +329,7 @@ <emph>INum</emph> is the imaginary coefficient of the complex number.</paragraph> <paragraph xml-lang="en-US" id="par_id3155849" role="paragraph"> <emph>Suffix</emph> is a list of options, "i" or "j".</paragraph> - <paragraph xml-lang="en-US" id="hd_id3145659" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3143229" role="paragraph"> <item type="input">=COMPLEX(3;4;"j")</item> returns 3+4j.</paragraph> </section> @@ -340,13 +340,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_OCT2BIN" id="bm_id3149290" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3155103" role="heading" level="2">OCT2BIN</paragraph> <paragraph xml-lang="en-US" id="par_id3146898" role="paragraph"><ahelp hid="HID_AAI_FUNC_OCT2BIN">The result is the binary number for the octal number entered.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3146088" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154303" role="code">OCT2BIN(Number; Places)</paragraph> <paragraph xml-lang="en-US" id="par_id3156013" role="paragraph"> <emph>Number</emph> is the octal number. The number can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement.</paragraph> <paragraph xml-lang="en-US" id="par_id3153984" role="paragraph"> <emph>Places</emph> is the number of places to be output.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3147493" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3147260" role="paragraph"> <item type="input">=OCT2BIN(3;3)</item> returns 011.</paragraph> </section> @@ -357,11 +357,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_OCT2DEZ" id="bm_id3151168" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3152791" role="heading" level="2">OCT2DEC</paragraph> <paragraph xml-lang="en-US" id="par_id3149199" role="paragraph"><ahelp hid="HID_AAI_FUNC_OCT2DEZ">The result is the decimal number for the octal number entered.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3159337" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153902" role="code">OCT2DEC(Number)</paragraph> <paragraph xml-lang="en-US" id="par_id3155326" role="paragraph"> <emph>Number</emph> is the octal number. The number can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3154698" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3154930" role="paragraph"> <item type="input">=OCT2DEC(144)</item> returns 100.</paragraph> </section> @@ -372,13 +372,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_OCT2HEX" id="bm_id3149904" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3155391" role="heading" level="2">OCT2HEX</paragraph> <paragraph xml-lang="en-US" id="par_id3148831" role="paragraph"><ahelp hid="HID_AAI_FUNC_OCT2HEX"> The result is the hexadecimal number for the octal number entered.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3146988" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150523" role="code">OCT2HEX(Number; Places)</paragraph> <paragraph xml-lang="en-US" id="par_id3159162" role="paragraph"> <emph>Number</emph> is the octal number. The number can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement.</paragraph> <paragraph xml-lang="en-US" id="par_id3145420" role="paragraph"> <emph>Places</emph> is the number of places to be output.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3150504" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3148802" role="paragraph"> <item type="input">=OCT2HEX(144;4)</item> returns 0064.</paragraph> </section> @@ -690,7 +690,7 @@ </tablerow> </table> <embed href="text/scalc/01/04060102.xhp#ADD_note"/> - <paragraph xml-lang="en-US" id="hd_id3146125" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153695" role="code">CONVERT(Number; "FromUnit"; "ToUnit")</paragraph> <paragraph xml-lang="en-US" id="par_id3147522" role="paragraph"> <emph>Number</emph> is the number to be converted.</paragraph> @@ -698,7 +698,7 @@ <emph>FromUnit</emph> is the unit from which conversion is taking place.</paragraph> <paragraph xml-lang="en-US" id="par_id3153790" role="paragraph"> <emph>ToUnit</emph> is the unit to which conversion is taking place. Both units must be of the same type.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3156270" role="heading" level="3">Examples</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3156336" role="paragraph"> <item type="input">=CONVERT(10;"HP";"PS") </item>returns, rounded to two decimal places, 10.14. 10 HP equal 10.14 PS.</paragraph> <paragraph xml-lang="en-US" id="par_id3154834" role="paragraph"> @@ -711,7 +711,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_FACTDOUBLE" id="bm_id3150950" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3147096" role="heading" level="2">FACTDOUBLE</paragraph> <paragraph xml-lang="en-US" id="par_id3151309" role="paragraph"><ahelp hid="HID_AAI_FUNC_FACTDOUBLE">Returns the double factorial of a number.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3154666" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155121" role="code">FACTDOUBLE(Number)</paragraph> <paragraph xml-lang="en-US" id="par_id3158440" role="paragraph">Returns <emph>Number</emph> <emph>!!</emph>, the double factorial of <emph>Number</emph>, where <emph>Number</emph> is an integer greater than or equal to zero.</paragraph> @@ -720,7 +720,7 @@ <paragraph xml-lang="en-US" id="par_id2927335" role="paragraph">For odd numbers FACTDOUBLE(n) returns:</paragraph> <paragraph xml-lang="en-US" id="par_id2107303" role="paragraph">1*3*5*7* ... *n</paragraph> <paragraph xml-lang="en-US" id="par_id4071779" role="paragraph">FACTDOUBLE(0) returns 1 by definition.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3154622" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id7844477" role="paragraph"> <item type="input">=FACTDOUBLE(5)</item> returns 15.</paragraph> <paragraph xml-lang="en-US" id="par_id3154116" role="paragraph"> diff --git a/source/text/scalc/01/04060118.xhp b/source/text/scalc/01/04060118.xhp index 0ecb0f41bb..c77a6775ea 100644 --- a/source/text/scalc/01/04060118.xhp +++ b/source/text/scalc/01/04060118.xhp @@ -42,7 +42,7 @@ <paragraph id="hd_id3145112" role="heading" level="2" xml-lang="en-US">ODDFPRICE</paragraph> <paragraph id="par_id3147250" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ODDFPRICE">Calculates the price per 100 currency units par value of a security, if the first interest date falls irregularly.</ahelp></paragraph> -<paragraph id="hd_id3153074" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3146098" role="code" xml-lang="en-US">ODDFPRICE(Settlement; Maturity; Issue; FirstCoupon; Rate; Yield; Redemption; Frequency; Basis)</paragraph> <paragraph id="par_id3153337" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> <paragraph id="par_id3149051" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> @@ -65,7 +65,7 @@ <paragraph id="hd_id3157871" role="heading" level="2" xml-lang="en-US">ODDFYIELD</paragraph> <paragraph id="par_id3147414" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ODDFYIELD">Calculates the yield of a security if the first interest date falls irregularly.</ahelp></paragraph> -<paragraph id="hd_id3150651" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3152982" role="code" xml-lang="en-US">ODDFYIELD(Settlement; Maturity; Issue; FirstCoupon; Rate; Price; Redemption; Frequency; Basis)</paragraph> <paragraph id="par_id3157906" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> <paragraph id="par_id3150026" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> @@ -88,7 +88,7 @@ <paragraph id="hd_id3153933" role="heading" level="2" xml-lang="en-US">ODDLPRICE</paragraph> <paragraph id="par_id3145145" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ODDLPRICE">Calculates the price per 100 currency units par value of a security, if the last interest date falls irregularly.</ahelp></paragraph> -<paragraph id="hd_id3152784" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3155262" role="code" xml-lang="en-US">ODDLPRICE(Settlement; Maturity; LastInterest; Rate; Yield; Redemption; Frequency; Basis)</paragraph> <paragraph id="par_id3149689" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> <paragraph id="par_id3148753" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> @@ -99,7 +99,7 @@ <paragraph id="par_id3149726" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph id="hd_id3153111" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3152999" role="paragraph" xml-lang="en-US">Settlement date: February 7 1999, maturity date: June 15 1999, last interest: October 15 1998. Interest rate: 3.75 per cent, yield: 4.05 per cent, redemption value: 100 currency units, frequency of payments: half-yearly = 2, basis: = 0</paragraph> <paragraph id="par_id3148567" role="paragraph" xml-lang="en-US">The price per 100 currency units per value of a security, which has an irregular last interest date, is calculated as follows:</paragraph> <paragraph id="par_id3150332" role="paragraph" xml-lang="en-US">=ODDLPRICE("1999-02-07";"1999-06-15";"1998-10-15"; 0.0375; 0.0405;100;2;0) returns 99.87829.</paragraph> @@ -115,7 +115,7 @@ <paragraph id="hd_id3153564" role="heading" level="2" xml-lang="en-US">ODDLYIELD</paragraph> <paragraph id="par_id3158002" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ODDLYIELD">Calculates the yield of a security if the last interest date falls irregularly.</ahelp></paragraph> -<paragraph id="hd_id3147366" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150018" role="code" xml-lang="en-US">ODDLYIELD(Settlement; Maturity; LastInterest; Rate; Price; Redemption; Frequency; Basis)</paragraph> <paragraph id="par_id3159132" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> <paragraph id="par_id3150134" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> @@ -126,7 +126,7 @@ <paragraph id="par_id3155622" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph id="hd_id3145303" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3145350" role="paragraph" xml-lang="en-US">Settlement date: April 20 1999, maturity date: June 15 1999, last interest: October 15 1998. Interest rate: 3.75 per cent, price: 99.875 currency units, redemption value: 100 currency units, frequency of payments: half-yearly = 2, basis: = 0</paragraph> <paragraph id="par_id3157990" role="paragraph" xml-lang="en-US">The yield of the security, that has an irregular last interest date, is calculated as follows:</paragraph> <paragraph id="par_id3150572" role="paragraph" xml-lang="en-US">=ODDLYIELD("1999-04-20";"1999-06-15"; "1998-10-15"; 0.0375; 99.875; 100;2;0) returns 0.044873 or 4.4873%.</paragraph> @@ -144,7 +144,7 @@ <paragraph id="hd_id3148768" role="heading" level="2" xml-lang="en-US">VDB</paragraph> <paragraph id="par_id3154636" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_VDB">Returns the depreciation of an asset for a specified or partial period using a variable declining balance method.</ahelp></paragraph> -<paragraph id="hd_id3155519" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149025" role="code" xml-lang="en-US">VDB(Cost; Salvage; Life; S; End; Factor; NoSwitch)</paragraph> <paragraph id="par_id3150692" role="paragraph" xml-lang="en-US"><emph>Cost</emph> is the initial value of an asset.</paragraph> <paragraph id="par_id3155369" role="paragraph" xml-lang="en-US"><emph>Salvage</emph> is the value of an asset at the end of the depreciation.</paragraph> @@ -155,7 +155,7 @@ <paragraph id="par_id3154865" role="paragraph" xml-lang="en-US"><emph>NoSwitch</emph>is an optional parameter. NoSwitch = 0 (default) means a switch to linear depreciation. In NoSwitch = 1 no switch is made.</paragraph> <paragraph id="par_idN10A0D" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> -<paragraph id="hd_id3148429" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3153927" role="paragraph" xml-lang="en-US">What is the declining-balance double-rate depreciation for a period if the initial cost is 35,000 currency units and the value at the end of the depreciation is 7,500 currency units. The depreciation period is 3 years. The depreciation from the 10th to the 20th period is calculated.</paragraph> <paragraph id="par_id3155991" role="paragraph" xml-lang="en-US"><item type="input">=VDB(35000;7500;36;10;20;2)</item> = 8603.80 currency units. The depreciation during the period between the 10th and the 20th period is 8,603.80 currency units.</paragraph> </section> @@ -173,12 +173,12 @@ <paragraph id="par_id3145614" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_XIRR">Calculates the internal rate of return for a list of payments which take place on different dates.</ahelp> The calculation is based on a 365 days per year basis, ignoring leap years.</paragraph> <paragraph id="par_idN10E62" role="paragraph" xml-lang="en-US">If the payments take place at regular intervals, use the <link href="text/scalc/01/04060103.xhp#irr" name="IRR">IRR</link> function.</paragraph> -<paragraph id="hd_id3146149" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149826" role="code" xml-lang="en-US">XIRR(Values; Dates; Guess)</paragraph> <paragraph id="par_id3163821" role="paragraph" xml-lang="en-US"><emph>Values</emph> and <emph>Dates</emph> refer to a series of payments and the series of associated date values. The first pair of dates defines the start of the payment plan. All other date values must be later, but need not be in any order. The series of values must contain at least one negative and one positive value (receipts and deposits).</paragraph> <paragraph id="par_id3149708" role="paragraph" xml-lang="en-US"><emph>Guess</emph> (optional) is a guess that can be input for the internal rate of return. The default is 10%.</paragraph> -<paragraph id="hd_id3145085" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3149273" role="paragraph" xml-lang="en-US">Calculation of the internal rate of return for the following five payments:</paragraph> <table id="tbl_id3152970"> @@ -278,12 +278,12 @@ <paragraph id="par_id3153904" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_XNPV">Calculates the capital value (net present value) for a list of payments which take place on different dates.</ahelp> The calculation is based on a 365 days per year basis, ignoring leap years.</paragraph> <paragraph id="par_idN11138" role="paragraph" xml-lang="en-US">If the payments take place at regular intervals, use the <link href="text/scalc/01/04060119.xhp#npv" name="NPV">NPV</link> function.</paragraph> -<paragraph id="hd_id3155323" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150117" role="code" xml-lang="en-US">XNPV(Rate; Values; Dates)</paragraph> <paragraph id="par_id3153100" role="paragraph" xml-lang="en-US"><emph>Rate</emph> is the internal rate of return for the payments.</paragraph> <paragraph id="par_id3155395" role="paragraph" xml-lang="en-US"><emph>Values</emph> and <emph>Dates</emph> refer to a series of payments and the series of associated date values. The first pair of dates defines the start of the payment plan. All other date values must be later, but need not be in any order. The series of values must contain at least one negative and one positive value (receipts and deposits)</paragraph> -<paragraph id="hd_id3148832" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3150525" role="paragraph" xml-lang="en-US">Calculation of the net present value for the above-mentioned five payments for a notional internal rate of return of 6%.</paragraph> <paragraph id="par_id3149910" role="paragraph" xml-lang="en-US"><item type="input">=XNPV(0.06;B1:B5;A1:A5)</item> returns 323.02.</paragraph> </section> @@ -299,13 +299,13 @@ <paragraph id="hd_id3148822" role="heading" level="2" xml-lang="en-US">RRI</paragraph> <paragraph id="par_id3154293" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZGZ">Calculates the interest rate resulting from the profit (return) of an investment.</ahelp></paragraph> -<paragraph id="hd_id3148444" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148804" role="code" xml-lang="en-US">RRI(P; PV; FV)</paragraph> <paragraph id="par_id3154901" role="paragraph" xml-lang="en-US"><emph>P</emph> is the number of periods needed for calculating the interest rate.</paragraph> <paragraph id="par_id3159149" role="paragraph" xml-lang="en-US"><emph>PV</emph> is the present (current) value. The cash value is the deposit of cash or the current cash value of an allowance in kind. As a deposit value a positive value must be entered; the deposit must not be 0 or <0.</paragraph> <paragraph id="par_id3149771" role="paragraph" xml-lang="en-US"><emph>FV</emph> determines what is desired as the cash value of the deposit.</paragraph> -<paragraph id="hd_id3148941" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154212" role="paragraph" xml-lang="en-US">For four periods (years) and a cash value of 7,500 currency units, the interest rate of the return is to be calculated if the future value is 10,000 currency units.</paragraph> <paragraph id="par_id3150775" role="paragraph" xml-lang="en-US"><item type="input">=RRI(4;7500;10000)</item> = 7.46 %</paragraph> <paragraph id="par_id3145413" role="paragraph" xml-lang="en-US">The interest rate must be 7.46 % so that 7,500 currency units will become 10,000 currency units.</paragraph> @@ -323,7 +323,7 @@ <paragraph id="hd_id3154267" role="heading" level="2" xml-lang="en-US">RATE</paragraph> <paragraph id="par_id3151052" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZINS">Returns the constant interest rate per period of an annuity.</ahelp></paragraph> -<paragraph id="hd_id3154272" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3158423" role="code" xml-lang="en-US">RATE(NPer; Pmt; PV; FV; Type; Guess)</paragraph> <paragraph id="par_id3148910" role="paragraph" xml-lang="en-US"><emph>NPer</emph> is the total number of periods, during which payments are made (payment period).</paragraph> <paragraph id="par_id3148925" role="paragraph" xml-lang="en-US"><emph>Pmt</emph> is the constant payment (annuity) paid during each period.</paragraph> @@ -333,7 +333,7 @@ <paragraph id="par_id3146949" role="paragraph" xml-lang="en-US"><emph>Guess</emph> (optional) determines the estimated value of the interest with iterative calculation.</paragraph> <paragraph id="par_idN10E2A" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> -<paragraph id="hd_id3149791" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3150706" role="paragraph" xml-lang="en-US">What is the constant interest rate for a payment period of 3 periods if 10 currency units are paid regularly and the present cash value is 900 currency units.</paragraph> <paragraph id="par_id3155586" role="paragraph" xml-lang="en-US"><item type="input">=RATE(3;-10;900)</item> = -75.63% The interest rate is therefore 75.63%.</paragraph> </section> @@ -348,7 +348,7 @@ <paragraph id="hd_id3149106" role="heading" level="2" xml-lang="en-US">INTRATE</paragraph> <paragraph id="par_id3149918" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_INTRATE">Calculates the annual interest rate that results when a security (or other item) is purchased at an investment value and sold at a redemption value. No interest is paid.</ahelp></paragraph> -<paragraph id="hd_id3149974" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149800" role="code" xml-lang="en-US">INTRATE(Settlement; Maturity; Investment; Redemption; Basis)</paragraph> <paragraph id="par_id3148618" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> <paragraph id="par_id3148988" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security is sold.</paragraph> @@ -356,7 +356,7 @@ <paragraph id="par_id3154337" role="paragraph" xml-lang="en-US"><emph>Redemption</emph> is the selling price.</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph id="hd_id3145380" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3149426" role="paragraph" xml-lang="en-US">A painting is bought on 1990-01-15 for 1 million and sold on 2002-05-05 for 2 million. The basis is daily balance calculation (basis = 3). What is the average annual level of interest?</paragraph> <paragraph id="par_id3151125" role="paragraph" xml-lang="en-US">=INTRATE("1990-01-15"; "2002-05-05"; 1000000; 2000000; 3) returns 8.12%.</paragraph> </section> @@ -371,14 +371,14 @@ <paragraph id="hd_id3148654" role="heading" level="2" xml-lang="en-US">COUPNCD</paragraph> <paragraph id="par_id3149927" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_COUPNCD">Returns the date of the first interest date after the settlement date. Format the result as a date.</ahelp></paragraph> -<paragraph id="hd_id3153317" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150423" role="code" xml-lang="en-US">COUPNCD(Settlement; Maturity; Frequency; Basis)</paragraph> <paragraph id="par_id3150628" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> <paragraph id="par_id3153536" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> <paragraph id="par_id3145313" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph id="hd_id3155424" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154794" role="paragraph" xml-lang="en-US">A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) when is the next interest date?</paragraph> <paragraph id="par_id3159251" role="paragraph" xml-lang="en-US">=COUPNCD("2001-01-25"; "2001-11-15"; 2; 3) returns 2001-05-15.</paragraph> </section> @@ -393,14 +393,14 @@ <paragraph id="hd_id3143281" role="heading" level="2" xml-lang="en-US">COUPDAYS</paragraph> <paragraph id="par_id3149488" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_COUPDAYS">Returns the number of days in the current interest period in which the settlement date falls.</ahelp></paragraph> -<paragraph id="hd_id3148685" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149585" role="code" xml-lang="en-US">COUPDAYS(Settlement; Maturity; Frequency; Basis)</paragraph> <paragraph id="par_id3152767" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> <paragraph id="par_id3151250" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> <paragraph id="par_id3146126" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph id="hd_id3153705" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3147530" role="paragraph" xml-lang="en-US">A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how many days are there in the interest period in which the settlement date falls?</paragraph> <paragraph id="par_id3156338" role="paragraph" xml-lang="en-US">=COUPDAYS("2001-01-25"; "2001-11-15"; 2; 3) returns 181.</paragraph> </section> @@ -415,14 +415,14 @@ <paragraph id="hd_id3154832" role="heading" level="2" xml-lang="en-US">COUPDAYSNC</paragraph> <paragraph id="par_id3147100" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_COUPDAYSNC">Returns the number of days from the settlement date until the next interest date.</ahelp></paragraph> -<paragraph id="hd_id3151312" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3155121" role="code" xml-lang="en-US">COUPDAYSNC(Settlement; Maturity; Frequency; Basis)</paragraph> <paragraph id="par_id3158440" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> <paragraph id="par_id3146075" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> <paragraph id="par_id3154620" role="paragraph" xml-lang="en-US"><emph>Frequency </emph>is number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph id="hd_id3155604" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3148671" role="paragraph" xml-lang="en-US">A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how many days are there until the next interest payment?</paragraph> <paragraph id="par_id3156158" role="paragraph" xml-lang="en-US">=COUPDAYSNC("2001-01-25"; "2001-11-15"; 2; 3) returns 110.</paragraph> </section> @@ -439,14 +439,14 @@ <paragraph id="hd_id3150408" role="heading" level="2" xml-lang="en-US">COUPDAYBS</paragraph> <paragraph id="par_id3146795" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_COUPDAYBS">Returns the number of days from the first day of interest payment on a security until the settlement date.</ahelp></paragraph> -<paragraph id="hd_id3156142" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3159083" role="code" xml-lang="en-US">COUPDAYBS(Settlement; Maturity; Frequency; Basis)</paragraph> <paragraph id="par_id3146907" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> <paragraph id="par_id3159390" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> <paragraph id="par_id3154414" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph id="hd_id3153880" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3150592" role="paragraph" xml-lang="en-US">A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how many days is this?</paragraph> <paragraph id="par_id3151103" role="paragraph" xml-lang="en-US">=COUPDAYBS("2001-01-25"; "2001-11-15"; 2; 3) returns 71.</paragraph> </section> @@ -462,14 +462,14 @@ <paragraph id="hd_id3152957" role="heading" level="2" xml-lang="en-US">COUPPCD</paragraph> <paragraph id="par_id3153678" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_COUPPCD">Returns the date of the interest date prior to the settlement date. Format the result as a date.</ahelp></paragraph> -<paragraph id="hd_id3156269" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3153790" role="code" xml-lang="en-US">COUPPCD(Settlement; Maturity; Frequency; Basis)</paragraph> <paragraph id="par_id3150989" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> <paragraph id="par_id3154667" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> <paragraph id="par_id3154569" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph id="hd_id3150826" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3148968" role="paragraph" xml-lang="en-US">A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) what was the interest date prior to purchase?</paragraph> <paragraph id="par_id3149992" role="paragraph" xml-lang="en-US">=COUPPCD("2001-01-25"; "2001-11-15"; 2; 3) returns 2000-15-11.</paragraph> </section> @@ -485,14 +485,14 @@ <paragraph id="hd_id3150673" role="heading" level="2" xml-lang="en-US">COUPNUM</paragraph> <paragraph id="par_id3154350" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_COUPNUM">Returns the number of coupons (interest payments) between the settlement date and the maturity date.</ahelp></paragraph> -<paragraph id="hd_id3148400" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3153200" role="code" xml-lang="en-US">COUPNUM(Settlement; Maturity; Frequency; Basis)</paragraph> <paragraph id="par_id3159406" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> <paragraph id="par_id3155864" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> <paragraph id="par_id3154720" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph id="hd_id3149319" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3152460" role="paragraph" xml-lang="en-US">A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how many interest dates are there?</paragraph> <paragraph id="par_id3150640" role="paragraph" xml-lang="en-US">=COUPNUM("2001-01-25"; "2001-11-15"; 2; 3) returns 2.</paragraph> </section> @@ -508,7 +508,7 @@ <paragraph id="hd_id3149339" role="heading" level="2" xml-lang="en-US">IPMT</paragraph> <paragraph id="par_id3154522" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZINSZ">Calculates the periodic amortizement for an investment with regular payments and a constant interest rate.</ahelp></paragraph> -<paragraph id="hd_id3153266" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3151283" role="code" xml-lang="en-US">IPMT(Rate; Period; NPer; PV; FV; Type)</paragraph> <paragraph id="par_id3147313" role="paragraph" xml-lang="en-US"><emph>Rate</emph> is the periodic interest rate.</paragraph> <paragraph id="par_id3145158" role="paragraph" xml-lang="en-US"><emph>Period</emph> is the period, for which the compound interest is calculated. Period=NPER if compound interest for the last period is calculated.</paragraph> @@ -517,7 +517,7 @@ <paragraph id="par_id3151213" role="paragraph" xml-lang="en-US"><emph>FV</emph> (optional) is the desired value (future value) at the end of the periods.</paragraph> <paragraph id="par_id3154195" role="paragraph" xml-lang="en-US"><emph>Type</emph> is the due date for the periodic payments.</paragraph> -<paragraph id="hd_id3150102" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3149438" role="paragraph" xml-lang="en-US">What is the interest rate during the fifth period (year) if the constant interest rate is 5% and the cash value is 15,000 currency units? The periodic payment is seven years.</paragraph> <paragraph id="par_id3150496" role="paragraph" xml-lang="en-US"><item type="input">=IPMT(5%;5;7;15000)</item> = -352.97 currency units. The compound interest during the fifth period (year) is 352.97 currency units.</paragraph> </section> @@ -534,7 +534,7 @@ <paragraph id="hd_id3151205" role="heading" level="2" xml-lang="en-US">FV</paragraph> <paragraph id="par_id3154140" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZW">Returns the future value of an investment based on periodic, constant payments and a constant interest rate (Future Value).</ahelp></paragraph> -<paragraph id="hd_id3155178" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3145215" role="code" xml-lang="en-US">FV(Rate; NPer; Pmt; PV; Type)</paragraph> <paragraph id="par_id3155136" role="paragraph" xml-lang="en-US"><emph>Rate</emph> is the periodic interest rate.</paragraph> <paragraph id="par_id3156029" role="paragraph" xml-lang="en-US"><emph>NPer</emph> is the total number of periods (payment period).</paragraph> @@ -543,7 +543,7 @@ <paragraph id="par_id3150999" role="paragraph" xml-lang="en-US"><emph>Type</emph> (optional) defines whether the payment is due at the beginning or the end of a period.</paragraph> <paragraph id="par_idN114D8" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> -<paragraph id="hd_id3146800" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3146813" role="paragraph" xml-lang="en-US">What is the value at the end of an investment if the interest rate is 4% and the payment period is two years, with a periodic payment of 750 currency units. The investment has a present value of 2,500 currency units.</paragraph> <paragraph id="par_id3149302" role="paragraph" xml-lang="en-US"><item type="input">=FV(4%;2;750;2500) </item>= -4234.00 currency units. The value at the end of the investment is 4234.00 currency units.</paragraph> </section> @@ -559,12 +559,12 @@ <paragraph id="hd_id3155912" role="heading" level="2" xml-lang="en-US">FVSCHEDULE</paragraph> <paragraph id="par_id3163726" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_FVSCHEDULE">Calculates the accumulated value of the starting capital for a series of periodically varying interest rates.</ahelp></paragraph> -<paragraph id="hd_id3149571" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148891" role="code" xml-lang="en-US">FVSCHEDULE(Principal; Schedule)</paragraph> <paragraph id="par_id3148904" role="paragraph" xml-lang="en-US"><emph>Principal</emph> is the starting capital.</paragraph> <paragraph id="par_id3148562" role="paragraph" xml-lang="en-US"><emph>Schedule</emph> is a series of interest rates, for example, as a range H3:H5 or as a (List) (see example).</paragraph> -<paragraph id="hd_id3147288" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3148638" role="paragraph" xml-lang="en-US">1000 currency units have been invested in for three years. The interest rates were 3%, 4% and 5% per annum. What is the value after three years?</paragraph> <paragraph id="par_id3156358" role="paragraph" xml-lang="en-US"><item type="input">=FVSCHEDULE(1000;{0.03;0.04;0.05})</item> returns 1124.76.</paragraph> </section> @@ -582,7 +582,7 @@ <paragraph id="hd_id3156435" role="heading" level="2" xml-lang="en-US">NPER</paragraph> <paragraph id="par_id3152363" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZZR">Returns the number of periods for an investment based on periodic, constant payments and a constant interest rate.</ahelp></paragraph> -<paragraph id="hd_id3147216" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3155934" role="code" xml-lang="en-US">NPER(Rate; Pmt; PV; FV; Type)</paragraph> <paragraph id="par_id3155946" role="paragraph" xml-lang="en-US"><emph>Rate</emph> is the periodic interest rate.</paragraph> <paragraph id="par_id3149042" role="paragraph" xml-lang="en-US"><emph>Pmt</emph> is the constant annuity paid in each period.</paragraph> @@ -591,7 +591,7 @@ <paragraph id="par_id3145127" role="paragraph" xml-lang="en-US"><emph>Type</emph> (optional) is the due date of the payment at the beginning or at the end of the period.</paragraph> <paragraph id="par_idN1166C" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> -<paragraph id="hd_id3155795" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3147378" role="paragraph" xml-lang="en-US">How many payment periods does a payment period cover with a periodic interest rate of 6%, a periodic payment of 153.75 currency units and a present cash value of 2.600 currency units.</paragraph> <paragraph id="par_id3156171" role="paragraph" xml-lang="en-US"><item type="input">=NPER(6%;153.75;2600)</item> = -12,02. The payment period covers 12.02 periods.</paragraph> </section> diff --git a/source/text/scalc/01/04060119.xhp b/source/text/scalc/01/04060119.xhp index 818c386388..fb8ad96dd8 100644 --- a/source/text/scalc/01/04060119.xhp +++ b/source/text/scalc/01/04060119.xhp @@ -40,7 +40,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KAPZ" id="bm_id3145827" localize="false"/> <paragraph role="heading" id="hd_id3150026" xml-lang="en-US" level="2">PPMT</paragraph> <paragraph role="paragraph" id="par_id3146942" xml-lang="en-US"><ahelp hid="HID_FUNC_KAPZ">Returns for a given period the payment on the principal for an investment that is based on periodic and constant payments and a constant interest rate.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3150459" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3146878" xml-lang="en-US">PPMT(Rate; Period; NPer; PV; FV; Type)</paragraph> <paragraph role="paragraph" id="par_id3151228" xml-lang="en-US"> <emph>Rate</emph> is the periodic interest rate.</paragraph> @@ -57,7 +57,7 @@ <paragraph role="paragraph" id="par_idN1067C" xml-lang="en-US" localize="false"> <embedvar href="text/scalc/00/00000004.xhp#optional"/> </paragraph> -<paragraph role="heading" id="hd_id3148582" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3154811" xml-lang="en-US">How high is the periodic monthly payment at an annual interest rate of 8.75% over a period of 3 years? The cash value is 5,000 currency units and is always paid at the beginning of a period. The future value is 8,000 currency units.</paragraph> <paragraph role="paragraph" id="par_id3149246" xml-lang="en-US"> <item type="input">=PPMT(8.75%/12;1;36;5000;8000;1)</item> = -350.99 currency units.</paragraph> @@ -72,7 +72,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KUMKAPITAL" id="bm_id3148754" localize="false"/> <paragraph role="heading" id="hd_id3146139" xml-lang="en-US" level="2">CUMPRINC</paragraph> <paragraph role="paragraph" id="par_id3150140" xml-lang="en-US"><ahelp hid="HID_FUNC_KUMKAPITAL">Returns the cumulative interest paid for an investment period with a constant interest rate.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3149188" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3148733" xml-lang="en-US">CUMPRINC(Rate; NPer; PV; S; E; Type)</paragraph> <paragraph role="paragraph" id="par_id3150864" xml-lang="en-US"> <emph>Rate</emph> is the periodic interest rate.</paragraph> @@ -86,7 +86,7 @@ <emph>E</emph> is the last period.</paragraph> <paragraph role="paragraph" id="par_id3145167" xml-lang="en-US"> <emph>Type</emph> is the due date of the payment at the beginning or end of each period.</paragraph> -<paragraph role="heading" id="hd_id3154502" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3153570" xml-lang="en-US">What are the payoff amounts if the yearly interest rate is 5.5% for 36 months? The cash value is 15,000 currency units. The payoff amount is calculated between the 10th and 18th period. The due date is at the end of the period.</paragraph> <paragraph role="paragraph" id="par_id3149884" xml-lang="en-US"> <item type="input">=CUMPRINC(5.5%/12;36;15000;10;18;0)</item> = -3669.74 currency units. The payoff amount between the 10th and 18th period is 3669.74 currency units.</paragraph> @@ -98,7 +98,7 @@ <paragraph role="heading" id="hd_id3150019" xml-lang="en-US" level="2">CUMPRINC_ADD</paragraph> <paragraph role="paragraph" id="par_id3145246" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_CUMPRINC"> Calculates the cumulative redemption of a loan in a period.</ahelp></paragraph> <embed href="text/scalc/01/04060102.xhp#ADD_note"/> -<paragraph role="heading" id="hd_id3153047" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3157970" xml-lang="en-US">CUMPRINC_ADD(Rate; NPer; PV; StartPeriod; EndPeriod; Type)</paragraph> <paragraph role="paragraph" id="par_id3145302" xml-lang="en-US"> <emph>Rate</emph> is the interest rate for each period.</paragraph> @@ -112,7 +112,7 @@ <emph>EndPeriod</emph> is the last payment period for the calculation.</paragraph> <paragraph role="paragraph" id="par_id3150570" xml-lang="en-US"> <emph>Type</emph> is the maturity of a payment at the end of each period (Type = 0) or at the start of the period (Type = 1).</paragraph> -<paragraph role="heading" id="hd_id3150269" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3148774" xml-lang="en-US">The following mortgage loan is taken out on a house:</paragraph> <paragraph role="paragraph" id="par_id3150661" xml-lang="en-US">Rate: 9.00 per cent per annum (9% / 12 = 0.0075), Duration: 30 years (payment periods = 30 * 12 = 360), NPV: 125000 currency units.</paragraph> <paragraph role="paragraph" id="par_id3155512" xml-lang="en-US">How much will you repay in the second year of the mortgage (thus from periods 13 to 24)?</paragraph> @@ -130,7 +130,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KUMZINSZ" id="bm_id3148593" localize="false"/> <paragraph role="heading" id="hd_id3155370" xml-lang="en-US" level="2">CUMIPMT</paragraph> <paragraph role="paragraph" id="par_id3158411" xml-lang="en-US"><ahelp hid="HID_FUNC_KUMZINSZ">Calculates the cumulative interest payments, that is, the total interest, for an investment based on a constant interest rate.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3155814" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3147536" xml-lang="en-US">CUMIPMT(Rate; NPer; PV; S; E; Type)</paragraph> <paragraph role="paragraph" id="par_id3150475" xml-lang="en-US"> <emph>Rate</emph> is the periodic interest rate.</paragraph> @@ -144,7 +144,7 @@ <emph>E</emph> is the last period.</paragraph> <paragraph role="paragraph" id="par_id3149777" xml-lang="en-US"> <emph>Type</emph> is the due date of the payment at the beginning or end of each period.</paragraph> -<paragraph role="heading" id="hd_id3153723" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3147478" xml-lang="en-US">What are the interest payments at a yearly interest rate of 5.5 %, a payment period of monthly payments for 2 years and a current cash value of 5,000 currency units? The start period is the 4th and the end period is the 6th period. The payment is due at the beginning of each period.</paragraph> <paragraph role="paragraph" id="par_id3149819" xml-lang="en-US"> <item type="input">=CUMIPMT(5.5%/12;24;5000;4;6;1)</item> = -57.54 currency units. The interest payments for between the 4th and 6th period are 57.54 currency units.</paragraph> @@ -156,7 +156,7 @@ <paragraph role="heading" id="hd_id3083280" xml-lang="en-US" level="2">CUMIPMT_ADD</paragraph> <paragraph role="paragraph" id="par_id3152482" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_CUMIPMT">Calculates the accumulated interest for a period.</ahelp></paragraph> <embed href="text/scalc/01/04060102.xhp#ADD_note"/> -<paragraph role="heading" id="hd_id3149713" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3145087" xml-lang="en-US">CUMIPMT_ADD(Rate; NPer; PV; StartPeriod; EndPeriod; Type)</paragraph> <paragraph role="paragraph" id="par_id3149277" xml-lang="en-US"> <emph>Rate</emph> is the interest rate for each period.</paragraph> @@ -170,7 +170,7 @@ <emph>EndPeriod</emph> is the last payment period for the calculation.</paragraph> <paragraph role="paragraph" id="par_id3150962" xml-lang="en-US"> <emph>Type</emph> is the maturity of a payment at the end of each period (Type = 0) or at the start of the period (Type = 1).</paragraph> -<paragraph role="heading" id="hd_id3152933" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3156324" xml-lang="en-US">The following mortgage loan is taken out on a house:</paragraph> <paragraph role="paragraph" id="par_id3147566" xml-lang="en-US">Rate: 9.00 per cent per annum (9% / 12 = 0.0075), Duration: 30 years (NPER = 30 * 12 = 360), Pv: 125000 currency units.</paragraph> <paragraph role="paragraph" id="par_id3151272" xml-lang="en-US">How much interest must you pay in the second year of the mortgage (thus from periods 13 to 24)?</paragraph> @@ -188,7 +188,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_PRICE" id="bm_id3153279" localize="false"/> <paragraph role="heading" id="hd_id3150878" xml-lang="en-US" level="2">PRICE</paragraph> <paragraph role="paragraph" id="par_id3153210" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_PRICE">Calculates the market value of a fixed interest security with a par value of 100 currency units as a function of the forecast yield.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3154646" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3152804" xml-lang="en-US">PRICE(Settlement; Maturity; Rate; Yield; Redemption; Frequency; Basis)</paragraph> <paragraph role="paragraph" id="par_id3156121" xml-lang="en-US"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -203,7 +203,7 @@ <paragraph role="paragraph" id="par_id3155846" xml-lang="en-US"> <emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph role="heading" id="hd_id3153148" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3150260" xml-lang="en-US">A security is purchased on 1999-02-15; the maturity date is 2007-11-15. The nominal rate of interest is 5.75%. The yield is 6.5%. The redemption value is 100 currency units. Interest is paid half-yearly (frequency is 2). With calculation on basis 0, the price is as follows:</paragraph> <paragraph role="paragraph" id="par_id3147273" xml-lang="en-US">=PRICE("1999-02-15"; "2007-11-15"; 0.0575; 0.065; 100; 2; 0) returns 95.04287.</paragraph> </section> @@ -215,7 +215,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_PRICEDISC" id="bm_id3143236" localize="false"/> <paragraph role="heading" id="hd_id3151297" xml-lang="en-US" level="2">PRICEDISC</paragraph> <paragraph role="paragraph" id="par_id3155100" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_PRICEDISC">Calculates the price per 100 currency units of par value of a non-interest- bearing security.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3149294" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3146084" xml-lang="en-US">PRICEDISC(Settlement; Maturity; Discount; Redemption; Basis)</paragraph> <paragraph role="paragraph" id="par_id3159179" xml-lang="en-US"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -226,7 +226,7 @@ <paragraph role="paragraph" id="par_id3147489" xml-lang="en-US"> <emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph role="heading" id="hd_id3152794" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3149198" xml-lang="en-US">A security is purchased on 1999-02-15; the maturity date is 1999-03-01. Discount in per cent is 5.25%. The redemption value is 100. When calculating on basis 2 the price discount is as follows:</paragraph> <paragraph role="paragraph" id="par_id3151178" xml-lang="en-US">=PRICEDISC("1999-02-15"; "1999-03-01"; 0.0525; 100; 2) returns 99.79583.</paragraph> </section> @@ -237,7 +237,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_PRICEMAT" id="bm_id3150118" localize="false"/> <paragraph role="heading" id="hd_id3154693" xml-lang="en-US" level="2">PRICEMAT</paragraph> <paragraph role="paragraph" id="par_id3153906" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_PRICEMAT">Calculates the price per 100 currency units of par value of a security, that pays interest on the maturity date.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3154933" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3155393" xml-lang="en-US">PRICEMAT(Settlement; Maturity; Issue; Rate; Yield; Basis)</paragraph> <paragraph role="paragraph" id="par_id3153102" xml-lang="en-US"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -250,7 +250,7 @@ <paragraph role="paragraph" id="par_id3146993" xml-lang="en-US"> <emph>Yield</emph> is the annual yield of the security.</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph role="heading" id="hd_id3150507" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3154289" xml-lang="en-US">Settlement date: February 15 1999, maturity date: April 13 1999, issue date: November 11 1998. Interest rate: 6.1 per cent, yield: 6.1 per cent, basis: 30/360 = 0.</paragraph> <paragraph role="paragraph" id="par_id3154905" xml-lang="en-US">The price is calculated as follows:</paragraph> <paragraph role="paragraph" id="par_id3158409" xml-lang="en-US">=PRICEMAT("1999-02-15";"1999-04-13";"1998-11-11"; 0.061; 0.061;0) returns 99.98449888.</paragraph> @@ -263,7 +263,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LAUFZEIT" id="bm_id3154208" localize="false"/> <paragraph role="heading" id="hd_id3148448" xml-lang="en-US" level="2">DURATION</paragraph> <paragraph role="paragraph" id="par_id3153056" xml-lang="en-US"><ahelp hid="HID_FUNC_LAUFZEIT">Calculates the number of periods required by an investment to attain the desired value.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3145421" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3148933" xml-lang="en-US">DURATION(Rate; PV; FV)</paragraph> <paragraph role="paragraph" id="par_id3148801" xml-lang="en-US"> <emph>Rate</emph> is a constant. The interest rate is to be calculated for the entire duration (duration period). The interest rate per period is calculated by dividing the interest rate by the calculated duration. The internal rate for an annuity is to be entered as Rate/12.</paragraph> @@ -271,7 +271,7 @@ <emph>PV</emph> is the present (current) value. The cash value is the deposit of cash or the current cash value of an allowance in kind. As a deposit value a positive value must be entered; the deposit must not be 0 or <0.</paragraph> <paragraph role="paragraph" id="par_id3147515" xml-lang="en-US"> <emph>FV</emph> is the expected value. The future value determines the desired (future) value of the deposit.</paragraph> -<paragraph role="heading" id="hd_id3153579" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3148480" xml-lang="en-US">At an interest rate of 4.75%, a cash value of 25,000 currency units and a future value of 1,000,000 currency units, a duration of 79.49 payment periods is returned. The periodic payment is the resulting quotient from the future value and the duration, in this case 1,000,000/79.49=12,850.20.</paragraph> </section> <section id="sln"> @@ -284,7 +284,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LIA" id="bm_id3154275" localize="false"/> <paragraph role="heading" id="hd_id3148912" xml-lang="en-US" level="2">SLN</paragraph> <paragraph role="paragraph" id="par_id3149154" xml-lang="en-US"><ahelp hid="HID_FUNC_LIA">Returns the straight-line depreciation of an asset for one period.</ahelp> The amount of the depreciation is constant during the depreciation period.</paragraph> -<paragraph role="heading" id="hd_id3153240" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3166456" xml-lang="en-US">SLN(Cost; Salvage; Life)</paragraph> <paragraph role="paragraph" id="par_id3146955" xml-lang="en-US"> <emph>Cost</emph> is the initial cost of an asset.</paragraph> @@ -292,7 +292,7 @@ <emph>Salvage</emph> is the value of an asset at the end of the depreciation.</paragraph> <paragraph role="paragraph" id="par_id3166444" xml-lang="en-US"> <emph>Life</emph> is the depreciation period determining the number of periods in the depreciation of the asset.</paragraph> -<paragraph role="heading" id="hd_id3155579" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3154098" xml-lang="en-US">Office equipment with an initial cost of 50,000 currency units is to be depreciated over 7 years. The value at the end of the depreciation is to be 3,500 currency units.</paragraph> <paragraph role="paragraph" id="par_id3153390" xml-lang="en-US"> <item type="input">=SLN(50000;3,500;84)</item> = 553.57 currency units. The periodic monthly depreciation of the office equipment is 553.57 currency units.</paragraph> @@ -304,7 +304,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_MDURATION" id="bm_id3153750" localize="false"/> <paragraph role="heading" id="hd_id3153739" xml-lang="en-US" level="2">MDURATION</paragraph> <paragraph role="paragraph" id="par_id3149923" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_MDURATION">Calculates the modified Macauley duration of a fixed interest security in years.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3149964" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3148987" xml-lang="en-US">MDURATION(Settlement; Maturity; Coupon; Yield; Frequency; Basis)</paragraph> <paragraph role="paragraph" id="par_id3148619" xml-lang="en-US"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -317,7 +317,7 @@ <paragraph role="paragraph" id="par_id3149423" xml-lang="en-US"> <emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph role="heading" id="hd_id3154602" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3148652" xml-lang="en-US">A security is purchased on 2001-01-01; the maturity date is 2006-01-01. The nominal rate of interest is 8%. The yield is 9.0%. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how long is the modified duration?</paragraph> <paragraph role="paragraph" id="par_id3145378" xml-lang="en-US">=MDURATION("2001-01-01"; "2006-01-01"; 0.08; 0.09; 2; 3) returns 4.02 years.</paragraph> </section> @@ -331,13 +331,13 @@ <paragraph role="paragraph" id="par_id3145308" xml-lang="en-US"><ahelp hid="HID_FUNC_NBW">Returns the present value of an investment based on a series of periodic cash flows and a discount rate. To get the net present value, subtract the cost of the project (the initial cash flow at time zero) from the returned value.</ahelp></paragraph> <paragraph id="par_idN111381" role="paragraph" xml-lang="en-US">If the payments take place at irregular intervals, use the <link href="text/scalc/01/04060118.xhp#xnpv" name="XNPV">XNPV</link> function.</paragraph> -<paragraph role="heading" id="hd_id3149937" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3153321" xml-lang="en-US">NPV(Rate; Value1; Value2; ...; Value30)</paragraph> <paragraph role="paragraph" id="par_id3150630" xml-lang="en-US"> <emph>Rate</emph> is the discount rate for a period.</paragraph> <paragraph role="paragraph" id="par_id3150427" xml-lang="en-US"> <emph>Value1, Value2, ..., Value30</emph> are up to 30 values, which represent deposits or withdrawals.</paragraph> -<paragraph role="heading" id="hd_id3153538" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3154800" xml-lang="en-US">What is the net present value of periodic payments of 10, 20 and 30 currency units with a discount rate of 8.75%. At time zero the costs were paid as -40 currency units.</paragraph> <paragraph role="paragraph" id="par_id3143270" xml-lang="en-US"> <item type="input">=NPV(8.75%;10;20;30)</item> = 49.43 currency units. The net present value is the returned value minus the initial costs of 40 currency units, therefore 9.43 currency units.</paragraph> @@ -350,13 +350,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NOMINAL" id="bm_id3145600" localize="false"/> <paragraph role="heading" id="hd_id3149484" xml-lang="en-US" level="2">NOMINAL</paragraph> <paragraph role="paragraph" id="par_id3149596" xml-lang="en-US"><ahelp hid="HID_FUNC_NOMINAL">Calculates the yearly nominal interest rate, given the effective rate and the number of compounding periods per year.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3151252" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3152769" xml-lang="en-US">NOMINAL(EffectiveRate; NPerY)</paragraph> <paragraph role="paragraph" id="par_id3147521" xml-lang="en-US"> <emph>EffectiveRate</emph> is the effective interest rate</paragraph> <paragraph role="paragraph" id="par_id3156334" xml-lang="en-US"> <emph>NPerY</emph> is the number of periodic interest payments per year.</paragraph> -<paragraph role="heading" id="hd_id3154473" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3147091" xml-lang="en-US">What is the nominal interest per year for an effective interest rate of 13.5% if twelve payments are made per year.</paragraph> <paragraph role="paragraph" id="par_id3154831" xml-lang="en-US"> <item type="input">=NOMINAL(13.5%;12)</item> = 12.73%. The nominal interest rate per year is 12.73%.</paragraph> @@ -368,13 +368,13 @@ <paragraph role="heading" id="hd_id3155123" xml-lang="en-US" level="2">NOMINAL_ADD</paragraph> <paragraph role="paragraph" id="par_id3148671" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_NOMINAL">Calculates the annual nominal rate of interest on the basis of the effective rate and the number of interest payments per annum.</ahelp></paragraph> <embed href="text/scalc/01/04060102.xhp#ADD_note"/> -<paragraph role="heading" id="hd_id3155611" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3156157" xml-lang="en-US">NOMINAL_ADD(EffectiveRate; NPerY)</paragraph> <paragraph role="paragraph" id="par_id3153777" xml-lang="en-US"> <emph>EffectiveRate</emph> is the effective annual rate of interest.</paragraph> <paragraph role="paragraph" id="par_id3150409" xml-lang="en-US"> <emph>NPerY</emph> the number of interest payments per year.</paragraph> -<paragraph role="heading" id="hd_id3146789" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3145777" xml-lang="en-US">What is the nominal rate of interest for a 5.3543% effective rate of interest and quarterly payment.</paragraph> <paragraph role="paragraph" id="par_id3156146" xml-lang="en-US"> <item type="input">=NOMINAL_ADD(5.3543%;4)</item> returns 0.0525 or 5.25%.</paragraph> @@ -386,13 +386,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DOLLARFR" id="bm_id3146907" localize="false"/> <paragraph role="heading" id="hd_id3159087" xml-lang="en-US" level="2">DOLLARFR</paragraph> <paragraph role="paragraph" id="par_id3150593" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DOLLARFR">Converts a quotation that has been given as a decimal number into a mixed decimal fraction.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3151106" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3152959" xml-lang="en-US">DOLLARFR(DecimalDollar; Fraction)</paragraph> <paragraph role="paragraph" id="par_id3149558" xml-lang="en-US"> <emph>DecimalDollar</emph> is a decimal number.</paragraph> <paragraph role="paragraph" id="par_id3153672" xml-lang="en-US"> <emph>Fraction</emph> is a whole number that is used as the denominator of the decimal fraction.</paragraph> -<paragraph role="heading" id="hd_id3156274" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3153795" xml-lang="en-US"> <item type="input">=DOLLARFR(1.125;16)</item> converts into sixteenths. The result is 1.02 for 1 plus 2/16.</paragraph> <paragraph role="paragraph" id="par_id3150995" xml-lang="en-US"> @@ -406,13 +406,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DOLLARDE" id="bm_id3154569" localize="false"/> <paragraph role="heading" id="hd_id3154671" xml-lang="en-US" level="2">DOLLARDE</paragraph> <paragraph role="paragraph" id="par_id3154418" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DOLLARDE">Converts a quotation that has been given as a decimal fraction into a decimal number.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3146124" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3150348" xml-lang="en-US">DOLLARDE(FractionalDollar; Fraction)</paragraph> <paragraph role="paragraph" id="par_id3154111" xml-lang="en-US"> <emph>FractionalDollar</emph> is a number given as a decimal fraction.</paragraph> <paragraph role="paragraph" id="par_id3153695" xml-lang="en-US"> <emph>Fraction</emph> is a whole number that is used as the denominator of the decimal fraction.</paragraph> -<paragraph role="heading" id="hd_id3153884" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3150941" xml-lang="en-US"> <item type="input">=DOLLARDE(1.02;16)</item> stands for 1 and 2/16. This returns 1.125.</paragraph> <paragraph role="paragraph" id="par_id3150830" xml-lang="en-US"> @@ -427,7 +427,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QIKV" id="bm_id3150670" localize="false"/> <paragraph role="heading" id="hd_id3148974" xml-lang="en-US" level="2">MIRR</paragraph> <paragraph role="paragraph" id="par_id3155497" xml-lang="en-US"><ahelp hid="HID_FUNC_QIKV">Calculates the modified internal rate of return of a series of investments.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3154354" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3148399" xml-lang="en-US">MIRR(Values; Investment; ReinvestRate)</paragraph> <paragraph role="paragraph" id="par_id3155896" xml-lang="en-US"> <emph>Values</emph> corresponds to the array or the cell reference for cells whose content corresponds to the payments.</paragraph> @@ -435,7 +435,7 @@ <emph>Investment</emph> is the rate of interest of the investments (the negative values of the array)</paragraph> <paragraph role="paragraph" id="par_id3159408" xml-lang="en-US"> <emph>ReinvestRate</emph>:the rate of interest of the reinvestment (the positive values of the array)</paragraph> -<paragraph role="heading" id="hd_id3154714" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3147352" xml-lang="en-US">Assuming a cell content of A1 = <item type="input">-5</item>, A2 = <item type="input">10</item>, A3 = <item type="input">15</item>, and A4 = <item type="input">8</item>, and an investment value of 0.5 and a reinvestment value of 0.1, the result is 94.16%.</paragraph> </section> <section id="yield"> @@ -446,7 +446,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YIELD" id="bm_id3152460" localize="false"/> <paragraph role="heading" id="hd_id3149323" xml-lang="en-US" level="2">YIELD</paragraph> <paragraph role="paragraph" id="par_id3150643" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_YIELD">Calculates the yield of a security.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3149344" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3149744" xml-lang="en-US">YIELD(Settlement; Maturity; Rate; Price; Redemption; Frequency; Basis)</paragraph> <paragraph role="paragraph" id="par_id3154526" xml-lang="en-US"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -461,7 +461,7 @@ <paragraph role="paragraph" id="par_id3159218" xml-lang="en-US"> <emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph role="heading" id="hd_id3147547" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3151214" xml-lang="en-US">A security is purchased on 1999-02-15. It matures on 2007-11-15. The rate of interest is 5.75%. The price is 95.04287 currency units per 100 units of par value, the redemption value is 100 units. Interest is paid half-yearly (frequency = 2) and the basis is 0. How high is the yield?</paragraph> <paragraph role="paragraph" id="par_id3154194" xml-lang="en-US">=YIELD("1999-02-15"; "2007-11-15"; 0.0575 ;95.04287; 100; 2; 0) returns 0.065 or 6.50 per cent.</paragraph> </section> @@ -472,7 +472,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YIELDDISC" id="bm_id3156206" localize="false"/> <paragraph role="heading" id="hd_id3150100" xml-lang="en-US" level="2">YIELDDISC</paragraph> <paragraph role="paragraph" id="par_id3150486" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_YIELDDISC">Calculates the annual yield of a non-interest-bearing security.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3149171" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3159191" xml-lang="en-US">YIELDDISC(Settlement; Maturity; Price; Redemption; Basis)</paragraph> <paragraph role="paragraph" id="par_id3150237" xml-lang="en-US"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -483,7 +483,7 @@ <paragraph role="paragraph" id="par_id3156049" xml-lang="en-US"> <emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph role="heading" id="hd_id3154139" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3163815" xml-lang="en-US">A non-interest-bearing security is purchased on 1999-02-15. It matures on 1999-03-01. The price is 99.795 currency units per 100 units of par value, the redemption value is 100 units. The basis is 2. How high is the yield?</paragraph> <paragraph role="paragraph" id="par_id3155187" xml-lang="en-US">=YIELDDISC("1999-02-15"; "1999-03-01"; 99.795; 100; 2) returns 0.052823 or 5.2823 per cent.</paragraph> </section> @@ -494,7 +494,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YIELDMAT" id="bm_id3156029" localize="false"/> <paragraph role="heading" id="hd_id3155140" xml-lang="en-US" level="2">YIELDMAT</paragraph> <paragraph role="paragraph" id="par_id3151332" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_YIELDMAT">Calculates the annual yield of a security, the interest of which is paid on the date of maturity.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3159100" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3159113" xml-lang="en-US">YIELDMAT(Settlement; Maturity; Issue; Rate; Price; Basis)</paragraph> <paragraph role="paragraph" id="par_id3149309" xml-lang="en-US"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -507,7 +507,7 @@ <paragraph role="paragraph" id="par_id3151067" xml-lang="en-US"> <emph>Price</emph> is the price (purchase price) of the security per 100 currency units of par value.</paragraph> <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> -<paragraph role="heading" id="hd_id3155342" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3163717" xml-lang="en-US">A security is purchased on 1999-03-15. It matures on 1999-11-03. The issue date was 1998-11-08. The rate of interest is 6.25%, the price is 100.0123 units. The basis is 0. How high is the yield?</paragraph> <paragraph role="paragraph" id="par_id3155311" xml-lang="en-US">=YIELDMAT("1999-03-15"; "1999-11-03"; "1998-11-08"; 0.0625; 100.0123; 0) returns 0.060954 or 6.0954 per cent.</paragraph> </section> @@ -519,7 +519,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RMZ" id="bm_id3148895" localize="false"/> <paragraph role="heading" id="hd_id3149577" xml-lang="en-US" level="2">PMT</paragraph> <paragraph role="paragraph" id="par_id3148563" xml-lang="en-US"><ahelp hid="HID_FUNC_RMZ">Returns the periodic payment for an annuity with constant interest rates.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3145257" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3147278" xml-lang="en-US">PMT(Rate; NPer; PV; FV; Type)</paragraph> <paragraph role="paragraph" id="par_id3147291" xml-lang="en-US"> <emph>Rate</emph> is the periodic interest rate.</paragraph> @@ -534,7 +534,7 @@ <paragraph role="paragraph" id="par_idN11645" xml-lang="en-US" localize="false"> <embedvar href="text/scalc/00/00000004.xhp#optional"/> </paragraph> -<paragraph role="heading" id="hd_id3152358" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3154222" xml-lang="en-US">What are the periodic payments at a yearly interest rate of 1.99% if the payment time is 3 years and the cash value is 25,000 currency units. There are 36 months as 36 payment periods, and the interest rate per payment period is 1.99%/12.</paragraph> <paragraph role="paragraph" id="par_id3155943" xml-lang="en-US"> <item type="input">=PMT(1.99%/12;36;25000)</item> = -715.96 currency units. The periodic monthly payment is therefore 715.96 currency units.</paragraph> @@ -547,7 +547,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_TBILLEQ" id="bm_id3147380" localize="false"/> <paragraph role="heading" id="hd_id3155799" xml-lang="en-US" level="2">TBILLEQ</paragraph> <paragraph role="paragraph" id="par_id3154403" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_TBILLEQ">Calculates the annual return on a treasury bill.</ahelp> A treasury bill is purchased on the settlement date and sold at the full par value on the maturity date, that must fall within the same year. A discount is deducted from the purchase price.</paragraph> -<paragraph role="heading" id="hd_id3155080" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3150224" xml-lang="en-US">TBILLEQ(Settlement; Maturity; Discount)</paragraph> <paragraph role="paragraph" id="par_id3156190" xml-lang="en-US"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -555,7 +555,7 @@ <emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> <paragraph role="paragraph" id="par_id3150310" xml-lang="en-US"> <emph>Discount</emph> is the percentage discount on acquisition of the security.</paragraph> -<paragraph role="heading" id="hd_id3150324" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3153173" xml-lang="en-US">Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9.14 per cent.</paragraph> <paragraph role="paragraph" id="par_id3153520" xml-lang="en-US">The return on the treasury bill corresponding to a security is worked out as follows:</paragraph> <paragraph role="paragraph" id="par_id3154382" xml-lang="en-US">=TBILLEQ("1999-03-31";"1999-06-01"; 0.0914) returns 0.094151 or 9.4151 per cent.</paragraph> @@ -568,7 +568,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_TBILLPRICE" id="bm_id3150576" localize="false"/> <paragraph role="heading" id="hd_id3151032" xml-lang="en-US" level="2">TBILLPRICE</paragraph> <paragraph role="paragraph" id="par_id3157887" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_TBILLPRICE">Calculates the price of a treasury bill per 100 currency units.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3156374" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3150284" xml-lang="en-US">TBILLPRICE(Settlement; Maturity; Discount)</paragraph> <paragraph role="paragraph" id="par_id3154059" xml-lang="en-US"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -576,7 +576,7 @@ <emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> <paragraph role="paragraph" id="par_id3145765" xml-lang="en-US"> <emph>Discount</emph> is the percentage discount upon acquisition of the security.</paragraph> -<paragraph role="heading" id="hd_id3153373" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3155542" xml-lang="en-US">Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9 per cent.</paragraph> <paragraph role="paragraph" id="par_id3154578" xml-lang="en-US">The price of the treasury bill is worked out as follows:</paragraph> <paragraph role="paragraph" id="par_id3154592" xml-lang="en-US">=TBILLPRICE("1999-03-31";"1999-06-01"; 0.09) returns 98.45.</paragraph> @@ -589,7 +589,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_TBILLYIELD" id="bm_id3151346" localize="false"/> <paragraph role="heading" id="hd_id3152912" xml-lang="en-US" level="2">TBILLYIELD</paragraph> <paragraph role="paragraph" id="par_id3145560" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_TBILLYIELD">Calculates the yield of a treasury bill.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3145578" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3156077" xml-lang="en-US">TBILLYIELD(Settlement; Maturity; Price)</paragraph> <paragraph role="paragraph" id="par_id3156091" xml-lang="en-US"> <emph>Settlement</emph> is the date of purchase of the security.</paragraph> @@ -597,7 +597,7 @@ <emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> <paragraph role="paragraph" id="par_id3149627" xml-lang="en-US"> <emph>Price</emph> is the price (purchase price) of the treasury bill per 100 currency units of par value.</paragraph> -<paragraph role="heading" id="hd_id3149642" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3145178" xml-lang="en-US">Settlement date: March 31 1999, maturity date: June 1 1999, price: 98.45 currency units.</paragraph> <paragraph role="paragraph" id="par_id3145193" xml-lang="en-US">The yield of the treasury bill is worked out as follows:</paragraph> <paragraph role="paragraph" id="par_id3148528" xml-lang="en-US">=TBILLYIELD("1999-03-31";"1999-06-01"; 98.45) returns 0.091417 or 9.1417 per cent.</paragraph> diff --git a/source/text/scalc/01/04060120.xhp b/source/text/scalc/01/04060120.xhp index da5870de07..7d8f448e82 100644 --- a/source/text/scalc/01/04060120.xhp +++ b/source/text/scalc/01/04060120.xhp @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> <helpdocument version="1.0"> - + <!-- /* * Version: MPL 1.1 / GPLv3+ / LGPLv3+ @@ -29,8 +29,8 @@ * in which case the provisions of the GPLv3+ or the LGPLv3+ are applicable * instead of those above. */ --> - - + + <meta> <topic id="textscalc0104060120xml" indexer="include"> <title id="tit" xml-lang="en-US">Bit Operation Functions</title> @@ -49,11 +49,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BITAND" id="bm_id4145827" localize="false"/> <paragraph role="heading" id="hd_id4150026" xml-lang="en-US" level="2">BITAND</paragraph> <paragraph role="paragraph" id="par_id4146942" xml-lang="en-US"><ahelp hid="HID_FUNC_BITAND">Returns a bitwise logical "and" of the parameters.</ahelp></paragraph> -<paragraph role="heading" id="hd_id4150459" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id4146878" xml-lang="en-US">BITAND(number1; number2)</paragraph> <paragraph role="paragraph" id="par_id4151228" xml-lang="en-US"> <emph>Number1</emph> and <emph>number2</emph> are positive integers less than 2 ^ 48 (281 474 976 710 656).</paragraph> -<paragraph role="heading" id="hd_id4148582" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id4149246" xml-lang="en-US"> <item type="input">=BITAND(6;10)</item> returns 2 (0110 & 1010 = 0010).</paragraph> </section> @@ -63,7 +63,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BITOR" id="bm_id4148754" localize="false"/> <paragraph role="heading" id="hd_id4146139" xml-lang="en-US" level="2">BITOR</paragraph> <paragraph role="paragraph" id="par_id4150140" xml-lang="en-US"><ahelp hid="HID_FUNC_BITOR">Returns a bitwise logical "or" of the parameters.</ahelp></paragraph> -<paragraph role="heading" id="hd_id4149188" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id4148733" xml-lang="en-US">BITOR(number1; number2)</paragraph> <paragraph role="paragraph" id="par_id4150864" xml-lang="en-US"> <emph>Number1</emph> and <emph>number2</emph> are positive integers less than 2 ^ 48 (281 474 976 710 656).</paragraph> @@ -76,11 +76,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BITXOR" id="bm_id4154330" localize="false"/> <paragraph role="heading" id="hd_id4150019" xml-lang="en-US" level="2">BITXOR</paragraph> <paragraph role="paragraph" id="par_id4145246" xml-lang="en-US"><ahelp hid="HID_FUNC_BITXOR">Returns a bitwise logical "exclusive or" of the parameters.</ahelp></paragraph> -<paragraph role="heading" id="hd_id4153047" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id4157970" xml-lang="en-US">BITXOR(number1; number2)</paragraph> <paragraph role="paragraph" id="par_id4145302" xml-lang="en-US"> <emph>Number1</emph> and <emph>number2</emph> are positive integers less than 2 ^ 48 (281 474 976 710 656).</paragraph> -<paragraph role="heading" id="hd_id4150269" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id4149394" xml-lang="en-US"> <item type="input">=BITXOR(6;10)</item> returns 12 (0110 ^ 1010 = 1100)</paragraph> </section> @@ -90,13 +90,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BITLSHIFT" id="bm_id4148593" localize="false"/> <paragraph role="heading" id="hd_id4155370" xml-lang="en-US" level="2">BITLSHIFT</paragraph> <paragraph role="paragraph" id="par_id4158411" xml-lang="en-US"><ahelp hid="HID_FUNC_BITLSHIFT">Shifts a number left by n bits.</ahelp></paragraph> -<paragraph role="heading" id="hd_id4155814" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id4147536" xml-lang="en-US">BITLSHIFT(number; shift)</paragraph> <paragraph role="paragraph" id="par_id4150475" xml-lang="en-US"> <emph>Number</emph> is a positive integer less than 2 ^ 48 (281 474 976 710 656).</paragraph> <paragraph role="paragraph" id="par_id4153921" xml-lang="en-US"> <emph>Shift</emph> is the number of positions the bits will be moved to the left. If shift is negative, it is synonymous with BITRSHIFT (number; -shift).</paragraph> -<paragraph role="heading" id="hd_id4153723" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id4149819" xml-lang="en-US"> <item type="input">=BITLSHIFT(6;1)</item> returns 12 (0110 << 1 = 1100).</paragraph> </section> @@ -106,13 +106,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BITRSHIFT" id="bm_id4154312" localize="false"/> <paragraph role="heading" id="hd_id4083280" xml-lang="en-US" level="2">BITRSHIFT</paragraph> <paragraph role="paragraph" id="par_id4152482" xml-lang="en-US"><ahelp hid="HID_FUNC_BITRSHIFT">Shifts a number right by n bits.</ahelp></paragraph> -<paragraph role="heading" id="hd_id4149713" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id4145087" xml-lang="en-US">BITRSHIFT(number; shift)</paragraph> <paragraph role="paragraph" id="par_id4149277" xml-lang="en-US"> <emph>Number</emph> is a positive integer less than 2 ^ 48 (281 474 976 710 656).</paragraph> <paragraph role="paragraph" id="par_id4149270" xml-lang="en-US"> <emph>Shift</emph> is the number of positions the bits will be moved to the right. If shift is negative, it is synonymous with BITLSHIFT (number; -shift).</paragraph> -<paragraph role="heading" id="hd_id4152933" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id4156130" xml-lang="en-US"> <item type="input">=BITRSHIFT(6;1)</item> returns 3 (0110 >> 1 = 0011).</paragraph> </section> diff --git a/source/text/scalc/01/04060181.xhp b/source/text/scalc/01/04060181.xhp index df8f67f535..ec6c2ee6a4 100644 --- a/source/text/scalc/01/04060181.xhp +++ b/source/text/scalc/01/04060181.xhp @@ -43,13 +43,13 @@ <paragraph id="hd_id3145632" role="heading" level="2" xml-lang="en-US">INTERCEPT</paragraph> <paragraph id="par_id3146887" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ACHSENABSCHNITT">Calculates the point at which a line will intersect the y-values by using known x-values and y-values.</ahelp></paragraph> -<paragraph id="hd_id3150374" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149718" role="code" xml-lang="en-US">INTERCEPT(DataY; DataX)</paragraph> <paragraph id="par_id3149947" role="paragraph" xml-lang="en-US"><emph>DataY</emph> is the dependent set of observations or data.</paragraph> <paragraph id="par_id3147412" role="paragraph" xml-lang="en-US"><emph>DataX</emph> is the independent set of observations or data.</paragraph> <paragraph id="par_id3152983" role="paragraph" xml-lang="en-US">Names, arrays or references containing numbers must be used here. Numbers can also be entered directly.</paragraph> -<paragraph id="hd_id3157906" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3148728" role="paragraph" xml-lang="en-US">To calculate the intercept, use cells D3:D9 as the y value and C3:C9 as the x value from the example spreadsheet. Input will be as follows:</paragraph> <paragraph id="par_id3149013" role="paragraph" xml-lang="en-US"><item type="input">=INTERCEPT(D3:D9;C3:C9)</item> = 2.15.</paragraph> </section> @@ -65,11 +65,11 @@ <paragraph id="hd_id3148437" role="heading" level="2" xml-lang="en-US"><variable id="count_head"><link href="text/scalc/01/04060181.xhp#count">COUNT</link></variable></paragraph> <paragraph id="par_id3150700" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ANZAHL">Counts how many numbers are in the list of arguments.</ahelp> Text entries are ignored.</paragraph> -<paragraph id="hd_id3153930" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148585" role="code" xml-lang="en-US">COUNT(Value1; Value2; ...; Value30)</paragraph> <paragraph id="par_id3155827" role="paragraph" xml-lang="en-US"><emph>Value1; Value2, ..., Value30</emph> are 1 to 30 values or ranges representing the values to be counted.</paragraph> -<paragraph id="hd_id3149254" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3149953" role="paragraph" xml-lang="en-US">The entries 2, 4, 6 and eight in the Value 1-4 fields are to be counted.</paragraph> <paragraph id="par_id3154558" role="paragraph" xml-lang="en-US"><item type="input">=COUNT(2;4;6;"eight")</item> = 3. The count of numbers is therefore 3.</paragraph> </section> @@ -85,11 +85,11 @@ <paragraph id="hd_id3149729" role="heading" level="2" xml-lang="en-US"><variable id="counta_head"><link href="text/scalc/01/04060181.xhp#counta">COUNTA</link></variable></paragraph> <paragraph id="par_id3150142" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ANZAHL2">Counts how many values are in the list of arguments.</ahelp> Text entries are also counted, even when they contain an empty string of length 0. If an argument is an array or reference, empty cells within the array or reference are ignored.<comment>UFI: fix to #i35888#</comment></paragraph> -<paragraph id="hd_id3148573" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3153111" role="code" xml-lang="en-US">COUNTA(Value1; Value2; ...; Value30)</paragraph> <paragraph id="par_id3150001" role="paragraph" xml-lang="en-US"><emph>Value1; Value2, ..., Value30</emph> are 1 to 30 arguments representing the values to be counted.</paragraph> -<paragraph id="hd_id3150334" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154508" role="paragraph" xml-lang="en-US">The entries 2, 4, 6 and eight in the Value 1-4 fields are to be counted.</paragraph> <paragraph id="par_id3158000" role="paragraph" xml-lang="en-US"><item type="input">=COUNTA(2;4;6;"eight")</item> = 4. The count of values is therefore 4.</paragraph> </section> @@ -106,11 +106,11 @@ <paragraph id="hd_id3150896" role="heading" level="2" xml-lang="en-US"><variable id="countblank_head"><link href="text/scalc/01/04060181.xhp#countblank">COUNTBLANK</link></variable></paragraph> <paragraph id="par_id3155260" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ANZAHLLEEREZELLEN">Returns the number of empty cells.</ahelp></paragraph> -<paragraph id="hd_id3145144" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3153931" role="code" xml-lang="en-US">COUNTBLANK(Range)</paragraph> <paragraph id="par_id3149512" role="paragraph" xml-lang="en-US">Returns the number of empty cells in the cell range <emph>Range</emph>.</paragraph> -<paragraph id="hd_id3146139" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3148586" role="paragraph" xml-lang="en-US"><item type="input">=COUNTBLANK(A1:B2)</item> returns 4 if cells A1, A2, B1, and B2 are all empty.</paragraph><comment>see also COUNTIF</comment> </section> @@ -126,12 +126,12 @@ <paragraph id="par_id3164926" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZAEHLENWENN">Returns the number of cells that meet with certain criteria within a cell range.</ahelp></paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> -<paragraph id="hd_id3164953" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3164967" role="code" xml-lang="en-US">COUNTIF(Range; Criteria)</paragraph> <paragraph id="par_id3164980" role="paragraph" xml-lang="en-US"><emph>Range</emph> is the range to which the criteria are to be applied.</paragraph> <paragraph id="par_id3165000" role="paragraph" xml-lang="en-US"><emph>Criteria</emph> indicates the criteria in the form of a number, an expression or a character string. These criteria determine which cells are counted. If regular expressions are enabled in calculation options you may also enter a search text in the form of a regular expression, e.g. b.* for all cells that begin with b. If wildcards are enabled in calculation options you may enter a search text with wildcards, e.g. b* for all cells that begin with b. You may also indicate a cell address that contains the search criterion. If you search for literal text, enclose the text in double quotes.</paragraph> -<paragraph id="hd_id3165037" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3166505" role="paragraph" xml-lang="en-US">A1:A10 is a cell range containing the numbers <item type="input">2000</item> to <item type="input">2009</item>. Cell B1 contains the number <item type="input">2006</item>. In cell B2, you enter a formula:</paragraph> <paragraph id="par_id3581652" role="paragraph" xml-lang="en-US"><item type="input">=COUNTIF(A1:A10;2006)</item> - this returns 1.</paragraph> <paragraph id="par_id708639" role="paragraph" xml-lang="en-US"><item type="input">=COUNTIF(A1:A10;B1)</item> - this returns 1.</paragraph> @@ -158,14 +158,14 @@ <paragraph id="hd_id3150267" role="heading" level="2" xml-lang="en-US">B</paragraph> <paragraph id="par_id3156061" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_B">Returns the probability of a sample with binomial distribution.</ahelp></paragraph> -<paragraph id="hd_id3150659" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3148392" role="code" xml-lang="en-US">B(Trials; SP; T1; T2)</paragraph> <paragraph id="par_id3149002" role="paragraph" xml-lang="en-US"><emph>Trials</emph> is the number of independent trials.</paragraph> <paragraph id="par_id3148875" role="paragraph" xml-lang="en-US"><emph>SP</emph> is the probability of success on each trial.</paragraph> <paragraph id="par_id3145352" role="paragraph" xml-lang="en-US"><emph>T1</emph> defines the lower limit for the number of trials.</paragraph> <paragraph id="par_id3149538" role="paragraph" xml-lang="en-US"><emph>T2</emph> (optional) defines the upper limit for the number of trials.</paragraph> -<paragraph id="hd_id3148768" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154633" role="paragraph" xml-lang="en-US">What is the probability with ten throws of the dice, that a six will come up exactly twice? The probability of a six (or any other number) is 1/6. The following formula combines these factors:</paragraph> <paragraph id="par_id3149393" role="paragraph" xml-lang="en-US"><item type="input">=B(10;1/6;2)</item> returns a probability of 29%.</paragraph> </section> @@ -182,12 +182,12 @@ <paragraph id="hd_id3158416" role="heading" level="2" xml-lang="en-US">RSQ</paragraph> <paragraph id="par_id3154949" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BESTIMMTHEITSMASS">Returns the square of the Pearson correlation coefficient based on the given values.</ahelp> RSQ (also called determination coefficient) is a measure for the accuracy of an adjustment and can be used to produce a regression analysis.</paragraph> -<paragraph id="hd_id3152820" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3155822" role="code" xml-lang="en-US">RSQ(DataY; DataX)</paragraph> <paragraph id="par_id3150470" role="paragraph" xml-lang="en-US"><emph>DataY</emph> is an array or range of data points.</paragraph> <paragraph id="par_id3153181" role="paragraph" xml-lang="en-US"><emph>DataX</emph> is an array or range of data points.</paragraph> -<paragraph id="hd_id3156258" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3155991" role="paragraph" xml-lang="en-US"><item type="input">=RSQ(A1:A20;B1:B20)</item> calculates the determination coefficient for both data sets in columns A and B.</paragraph> </section> @@ -202,7 +202,7 @@ <paragraph id="hd_id3145620" role="heading" level="2" xml-lang="en-US">BETAINV</paragraph> <paragraph id="par_id3149825" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BETAINV">Returns the inverse of the cumulative beta probability density function.</ahelp></paragraph> -<paragraph id="hd_id3152479" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3156300" role="code" xml-lang="en-US">BETAINV(Number; Alpha; Beta; Start; End)</paragraph> <paragraph id="par_id3149266" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value between <emph>Start</emph> and <emph>End</emph> at which to evaluate the function.</paragraph> <paragraph id="par_id3149710" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> is a parameter to the distribution.</paragraph> @@ -211,7 +211,7 @@ <paragraph id="par_id3151268" role="paragraph" xml-lang="en-US"><emph>End</emph> (optional) is the upper bound for <emph>Number</emph>.</paragraph> <paragraph id="par_idN109DF" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> -<paragraph id="hd_id3147077" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3146859" role="paragraph" xml-lang="en-US"><item type="input">=BETAINV(0.5;5;10)</item> returns the value 0.33.</paragraph> </section> @@ -226,7 +226,7 @@ <paragraph id="hd_id2945620" role="heading" level="2" xml-lang="en-US">BETA.INV</paragraph> <paragraph id="par_id2949825" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BETAINV_MS">Returns the inverse of the cumulative beta probability density function.</ahelp></paragraph> -<paragraph id="hd_id2952479" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2956300" role="code" xml-lang="en-US">BETA.INV(Number; Alpha; Beta; Start; End)</paragraph> <paragraph id="par_id2949266" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value between <emph>Start</emph> and <emph>End</emph> at which to evaluate the function.</paragraph> <paragraph id="par_id2949710" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> is a parameter to the distribution.</paragraph> @@ -235,7 +235,7 @@ <paragraph id="par_id2951268" role="paragraph" xml-lang="en-US"><emph>End</emph> (optional) is the upper bound for <emph>Number</emph>.</paragraph> <paragraph id="par_idN109DFms" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> -<paragraph id="hd_id2947077" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2946859" role="paragraph" xml-lang="en-US"><item type="input">=BETA.INV(0.5;5;10)</item> returns the value 0.3257511553.</paragraph> </section> @@ -250,7 +250,7 @@ <paragraph id="hd_id3156096" role="heading" level="2" xml-lang="en-US">BETADIST</paragraph> <paragraph id="par_id3150880" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BETAVERT">Returns the beta function.</ahelp></paragraph> -<paragraph id="hd_id3150762" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3147571" role="code" xml-lang="en-US">BETADIST(Number; Alpha; Beta; Start; End; Cumulative)</paragraph> <paragraph id="par_id3156317" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value between <emph>Start</emph> and <emph>End</emph> at which to evaluate the function.</paragraph> <paragraph id="par_id3156107" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> is a parameter to the distribution.</paragraph> @@ -260,7 +260,7 @@ <paragraph id="par_id012020091254453" role="paragraph" xml-lang="en-US"><emph>Cumulative</emph> (optional) can be 0 or False to calculate the probability density function. It can be any other value or True or omitted to calculate the cumulative distribution function.</paragraph> <paragraph id="par_idN10AB3" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> -<paragraph id="hd_id3145649" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3156118" role="paragraph" xml-lang="en-US"><item type="input">=BETADIST(0.75;3;4)</item> returns the value 0.96.</paragraph> </section> @@ -275,7 +275,7 @@ <paragraph id="hd_id2956096" role="heading" level="2" xml-lang="en-US">BETA.DIST</paragraph> <paragraph id="par_id2950880" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BETADIST_MS">Returns the beta function.</ahelp></paragraph> -<paragraph id="hd_id2950762" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2947571" role="code" xml-lang="en-US">BETA.DIST(Number; Alpha; Beta; Cumulative; Start; End)</paragraph> <paragraph id="par_id2956317" role="paragraph" xml-lang="en-US"><emph>Number</emph> (required) is the value between <emph>Start</emph> and <emph>End</emph> at which to evaluate the function.</paragraph> <paragraph id="par_id2956107" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> (required) is a parameter to the distribution.</paragraph> @@ -285,7 +285,7 @@ <paragraph id="par_id2949138" role="paragraph" xml-lang="en-US"><emph>End</emph> (optional) is the upper bound for <emph>Number</emph>.</paragraph> <paragraph id="par_idN10AB3ms" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> -<paragraph id="hd_id2945649" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2956118" role="paragraph" xml-lang="en-US"><item type="input">=BETA.DIST(2;8;10;1;1;3)</item> returns the value 0.6854706</paragraph> <paragraph id="par_id2956119" role="paragraph" xml-lang="en-US"><item type="input">=BETA.DIST(2;8;10;0;1;3)</item> returns the value 1.4837646</paragraph> </section> @@ -300,14 +300,14 @@ <paragraph id="hd_id3143228" role="heading" level="2" xml-lang="en-US">BINOMDIST</paragraph> <paragraph id="par_id3146897" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BINOMVERT">Returns the individual term binomial distribution probability.</ahelp></paragraph> -<paragraph id="hd_id3149289" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3156009" role="code" xml-lang="en-US">BINOMDIST(X; Trials; SP; C)</paragraph> <paragraph id="par_id3154304" role="paragraph" xml-lang="en-US"><emph>X</emph> is the number of successes in a set of trials.</paragraph> <paragraph id="par_id3147492" role="paragraph" xml-lang="en-US"><emph>Trials</emph> is the number of independent trials.</paragraph> <paragraph id="par_id3146085" role="paragraph" xml-lang="en-US"><emph>SP</emph> is the probability of success on each trial.</paragraph> <paragraph id="par_id3149760" role="paragraph" xml-lang="en-US"><emph>C</emph> = 0 calculates the probability of a single event and <emph>C</emph> = 1 calculates the cumulative probability.</paragraph> -<paragraph id="hd_id3151171" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3145666" role="paragraph" xml-lang="en-US"><item type="input">=BINOMDIST(A1;12;0.5;0)</item> shows (if the values <item type="input">0</item> to <item type="input">12</item> are entered in A1) the probabilities for 12 flips of a coin that <emph>Heads</emph> will come up exactly the number of times entered in A1.</paragraph> <paragraph id="par_id3150120" role="paragraph" xml-lang="en-US"><item type="input">=BINOMDIST(A1;12;0.5;1)</item> shows the cumulative probabilities for the same series. For example, if A1 = <item type="input">4</item>, the cumulative probability of the series is 0, 1, 2, 3 or 4 times <emph>Heads</emph> (non-exclusive OR).</paragraph> </section> @@ -322,14 +322,14 @@ <paragraph id="hd_id2943228" role="heading" level="2" xml-lang="en-US">BINOM.DIST</paragraph> <paragraph id="par_id2946897" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BINOM_DIST_MS">Returns the individual term binomial distribution probability.</ahelp></paragraph> -<paragraph id="hd_id2949289" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2956009" role="code" xml-lang="en-US">BINOM.DIST(X; Trials; SP; C)</paragraph> <paragraph id="par_id2954304" role="paragraph" xml-lang="en-US"><emph>X</emph> is the number of successes in a set of trials.</paragraph> <paragraph id="par_id2947492" role="paragraph" xml-lang="en-US"><emph>Trials</emph> is the number of independent trials.</paragraph> <paragraph id="par_id2946085" role="paragraph" xml-lang="en-US"><emph>SP</emph> is the probability of success on each trial.</paragraph> <paragraph id="par_id299760" role="paragraph" xml-lang="en-US"><emph>C</emph> = 0 calculates the probability of a single event and <emph>C</emph> = 1 calculates the cumulative probability.</paragraph> -<paragraph id="hd_id291171" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id295666" role="paragraph" xml-lang="en-US"><item type="input">=BINOM.DIST(A1;12;0.5;0)</item> shows (if the values <item type="input">0</item> to <item type="input">12</item> are entered in A1) the probabilities for 12 flips of a coin that <emph>Heads</emph> will come up exactly the number of times entered in A1.</paragraph> <paragraph id="par_id290120" role="paragraph" xml-lang="en-US"><item type="input">=BINOM.DIST(A1;12;0.5;1)</item> shows the cumulative probabilities for the same series. For example, if A1 = <item type="input">4</item>, the cumulative probability of the series is 0, 1, 2, 3 or 4 times <emph>Heads</emph> (non-exclusive OR).</paragraph> </section> @@ -344,13 +344,13 @@ <paragraph id="hd_id2843228" role="heading" level="2" xml-lang="en-US">BINOM.INV</paragraph> <paragraph id="par_id2846897" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BINOM_INV_MS">Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value.</ahelp></paragraph> -<paragraph id="hd_id2849289" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2856009" role="code" xml-lang="en-US">BINOM.INV(Trials; SP; Alpha)</paragraph> <paragraph id="par_id2847492" role="paragraph" xml-lang="en-US"><emph>Trials</emph> The total number of trials.</paragraph> <paragraph id="par_id2846085" role="paragraph" xml-lang="en-US"><emph>SP</emph> is the probability of success on each trial.</paragraph> <paragraph id="par_id289760" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> The border probability that is attained or exceeded.</paragraph> -<paragraph id="hd_id281171" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id285666" role="paragraph" xml-lang="en-US"><item type="input">=BINOM.INV(8;0.6;0.9)</item> returns 7, the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value.</paragraph> </section> @@ -364,7 +364,7 @@ <paragraph id="hd_id0119200902421451" role="heading" level="2" xml-lang="en-US">CHISQINV</paragraph> <paragraph id="par_id0119200902421449" role="paragraph" xml-lang="en-US"><ahelp hid=".">Returns the inverse of CHISQDIST.</ahelp></paragraph> -<paragraph id="hd_id0119200902475241" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id0119200902475286" role="paragraph" xml-lang="en-US"><emph>Probability</emph> is the probability value for which the inverse of the chi-square distribution is to be calculated.</paragraph> <paragraph id="par_id0119200902475282" role="paragraph" xml-lang="en-US"><emph>Degrees Of Freedom</emph> is the degrees of freedom for the chi-square function.</paragraph> </section> @@ -379,12 +379,12 @@ <paragraph id="hd_id2919200902421451" role="heading" level="2" xml-lang="en-US">CHISQ.INV</paragraph> <paragraph id="par_id2919200902421449" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHISQINV_MS">Returns the inverse of the left-tailed probability of the chi-square distribution.</ahelp></paragraph> -<paragraph id="hd_id2919200902475241" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id1150504" role="code" xml-lang="en-US">CHISQ.INV(Probability; DegreesFreedom)</paragraph> <paragraph id="par_id2919200902475286" role="paragraph" xml-lang="en-US"><emph>Probability</emph> is the probability value for which the inverse of the chi-square distribution is to be calculated.</paragraph> <paragraph id="par_id2919200902475282" role="paragraph" xml-lang="en-US"><emph>Degrees Of Freedom</emph> is the degrees of freedom for the chi-square function.</paragraph> -<paragraph id="hd_id271171" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id275666" role="paragraph" xml-lang="en-US"><item type="input">=CHISQ.INV(0,5;1)</item> returns 0.4549364231.</paragraph> </section> @@ -398,12 +398,12 @@ <paragraph id="hd_id3148835" role="heading" level="2" xml-lang="en-US">CHIINV</paragraph> <paragraph id="par_id3149906" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHIINV">Returns the inverse of the one-tailed probability of the chi-squared distribution.</ahelp></paragraph> -<paragraph id="hd_id3159157" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150504" role="code" xml-lang="en-US">CHIINV(Number; DegreesFreedom)</paragraph> <paragraph id="par_id3154898" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value of the error probability.</paragraph> <paragraph id="par_id3154294" role="paragraph" xml-lang="en-US"><emph>DegreesFreedom</emph> is the degrees of freedom of the experiment.</paragraph> -<paragraph id="hd_id3154208" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3150777" role="paragraph" xml-lang="en-US">A die is thrown 1020 times. The numbers on the die 1 through 6 come up 195, 151, 148, 189, 183 and 154 times (observation values). The hypothesis that the die is not fixed is to be tested.</paragraph> <paragraph id="par_id3153062" role="paragraph" xml-lang="en-US">The Chi square distribution of the random sample is determined by the formula given above. Since the expected value for a given number on the die for n throws is n times 1/6, thus 1020/6 = 170, the formula returns a Chi square value of 13.27.</paragraph> <paragraph id="par_id3148806" role="paragraph" xml-lang="en-US">If the (observed) Chi square is greater than or equal to the (theoretical) Chi square CHIINV, the hypothesis will be discarded, since the deviation between theory and experiment is too great. If the observed Chi square is less that CHIINV, the hypothesis is confirmed with the indicated probability of error.</paragraph> @@ -422,12 +422,12 @@ <paragraph id="hd_id2948835" role="heading" level="2" xml-lang="en-US">CHISQ.INV.RT</paragraph> <paragraph id="par_id2949906" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHIINV_MS">Returns the inverse of the one-tailed probability of the chi-squared distribution.</ahelp></paragraph> -<paragraph id="hd_id2959157" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2950504" role="code" xml-lang="en-US">CHISQ.INV.RT(Number; DegreesFreedom)</paragraph> <paragraph id="par_id2954898" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value of the error probability.</paragraph> <paragraph id="par_id2954294" role="paragraph" xml-lang="en-US"><emph>DegreesFreedom</emph> is the degrees of freedom of the experiment.</paragraph> -<paragraph id="hd_id2954208" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2950777" role="paragraph" xml-lang="en-US">A die is thrown 1020 times. The numbers on the die 1 through 6 come up 195, 151, 148, 189, 183 and 154 times (observation values). The hypothesis that the die is not fixed is to be tested.</paragraph> <paragraph id="par_id2953062" role="paragraph" xml-lang="en-US">The Chi square distribution of the random sample is determined by the formula given above. Since the expected value for a given number on the die for n throws is n times 1/6, thus 1020/6 = 170, the formula returns a Chi square value of 13.27.</paragraph> <paragraph id="par_id2948806" role="paragraph" xml-lang="en-US">If the (observed) Chi square is greater than or equal to the (theoretical) Chi square CHIINV, the hypothesis will be discarded, since the deviation between theory and experiment is too great. If the observed Chi square is less that CHIINV, the hypothesis is confirmed with the indicated probability of error.</paragraph> @@ -447,12 +447,12 @@ <paragraph id="par_id3151052" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHITEST">Returns the probability of a deviance from a random distribution of two test series based on the chi-squared test for independence.</ahelp> CHITEST returns the chi-squared distribution of the data.</paragraph> <paragraph id="par_id3148925" role="paragraph" xml-lang="en-US">The probability determined by CHITEST can also be determined with CHIDIST, in which case the Chi square of the random sample must then be passed as a parameter instead of the data row.</paragraph> -<paragraph id="hd_id3154280" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149162" role="code" xml-lang="en-US">CHITEST(DataB; DataE)</paragraph> <paragraph id="par_id3158421" role="paragraph" xml-lang="en-US"><emph>DataB</emph> is the array of the observations.</paragraph> <paragraph id="par_id3166453" role="paragraph" xml-lang="en-US"><emph>DataE</emph> is the range of the expected values.</paragraph> -<paragraph id="hd_id3146946" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <table id="tbl_id3153233"> <tablerow> @@ -547,12 +547,12 @@ <paragraph id="par_id2951052" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHITEST_MS">Returns the probability of a deviance from a random distribution of two test series based on the chi-squared test for independence.</ahelp> CHISQ.TEST returns the chi-squared distribution of the data.</paragraph> <paragraph id="par_id2948925" role="paragraph" xml-lang="en-US">The probability determined by CHISQ.TEST can also be determined with CHISQ.DIST, in which case the Chi square of the random sample must then be passed as a parameter instead of the data row.</paragraph> -<paragraph id="hd_id2954280" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2949162" role="code" xml-lang="en-US">CHISQ.TEST(DataB; DataE)</paragraph> <paragraph id="par_id2958421" role="paragraph" xml-lang="en-US"><emph>DataB</emph> is the array of the observations.</paragraph> <paragraph id="par_id2966453" role="paragraph" xml-lang="en-US"><emph>DataE</emph> is the range of the expected values.</paragraph> -<paragraph id="hd_id2946946" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <table id="tbl_id2953233"> <tablerow> @@ -647,12 +647,12 @@ <paragraph id="par_id3156338" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHIVERT">Returns the probability value from the indicated Chi square that a hypothesis is confirmed.</ahelp> CHIDIST compares the Chi square value to be given for a random sample that is calculated from the sum of (observed value-expected value)^2/expected value for all values with the theoretical Chi square distribution and determines from this the probability of error for the hypothesis to be tested.</paragraph> <paragraph id="par_id3151316" role="paragraph" xml-lang="en-US">The probability determined by CHIDIST can also be determined by CHITEST.</paragraph> -<paragraph id="hd_id3155123" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3158439" role="code" xml-lang="en-US">CHIDIST(Number; DegreesFreedom)</paragraph> <paragraph id="par_id3148675" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the chi-square value of the random sample used to determine the error probability.</paragraph> <paragraph id="par_id3155615" role="paragraph" xml-lang="en-US"><emph>DegreesFreedom</emph> are the degrees of freedom of the experiment.</paragraph> -<paragraph id="hd_id3146787" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3145774" role="paragraph" xml-lang="en-US"><item type="input">=CHIDIST(13.27; 5)</item> equals 0.02.</paragraph> <paragraph id="par_id3156141" role="paragraph" xml-lang="en-US">If the Chi square value of the random sample is 13.27 and if the experiment has 5 degrees of freedom, then the hypothesis is assured with a probability of error of 2%.</paragraph> </section> @@ -667,13 +667,13 @@ <paragraph id="hd_id2848690" role="heading" level="2" xml-lang="en-US">CHISQ.DIST</paragraph> <paragraph id="par_id2856338" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHISQDIST_MS">Returns the probability density function or the cumulative distribution function for the chi-square distribution.</ahelp></paragraph> -<paragraph id="hd_id2855123" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2858439" role="code" xml-lang="en-US">CHISQ.DIST(Number; DegreesFreedom; Cumulative)</paragraph> <paragraph id="par_id2848675" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the chi-square value of the random sample used to determine the error probability.</paragraph> <paragraph id="par_id2855615" role="paragraph" xml-lang="en-US"><emph>DegreesFreedom</emph> are the degrees of freedom of the experiment.</paragraph> <paragraph id="par_id282020091254453" role="paragraph" xml-lang="en-US"><emph>Cumulative</emph> can be 0 or False to calculate the probability density function. It can be any other value or True to calculate the cumulative distribution function.</paragraph> -<paragraph id="hd_id2846787" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2845774" role="paragraph" xml-lang="en-US"><item type="input">=CHISQ.DIST(3; 2; 0) </item>equals 0.1115650801, the probability density function with 2 degrees of freedom, at x = 3.</paragraph> <paragraph id="par_id2745774" role="paragraph" xml-lang="en-US"><item type="input">=CHISQ.DIST(3; 2; 1) </item>equals 0.7768698399, the cumulative chi-square distribution with 2 degrees of freedom, at the value x = 3.</paragraph> </section> @@ -689,12 +689,12 @@ <paragraph id="par_id2956338" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHIVERT_MS">Returns the probability value from the indicated Chi square that a hypothesis is confirmed.</ahelp> CHISQ.DIST.RT compares the Chi square value to be given for a random sample that is calculated from the sum of (observed value-expected value)^2/expected value for all values with the theoretical Chi square distribution and determines from this the probability of error for the hypothesis to be tested.</paragraph> <paragraph id="par_id2951316" role="paragraph" xml-lang="en-US">The probability determined by CHISQ.DIST.RT can also be determined by CHITEST.</paragraph> -<paragraph id="hd_id2955123" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2958439" role="code" xml-lang="en-US">CHISQ.DIST.RT(Number; DegreesFreedom)</paragraph> <paragraph id="par_id2948675" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the chi-square value of the random sample used to determine the error probability.</paragraph> <paragraph id="par_id2955615" role="paragraph" xml-lang="en-US"><emph>DegreesFreedom</emph> are the degrees of freedom of the experiment.</paragraph> -<paragraph id="hd_id2946787" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2945774" role="paragraph" xml-lang="en-US"><item type="input">=CHISQ.DIST.RT(13.27; 5)</item> equals 0.0209757694.</paragraph> <paragraph id="par_id2956141" role="paragraph" xml-lang="en-US">If the Chi square value of the random sample is 13.27 and if the experiment has 5 degrees of freedom, then the hypothesis is assured with a probability of error of 2%.</paragraph> </section> @@ -710,7 +710,7 @@ <paragraph id="hd_id0119200901583452" role="heading" level="2" xml-lang="en-US">CHISQDIST</paragraph> <paragraph id="par_id0119200901583471" role="paragraph" xml-lang="en-US"><ahelp hid=".">Returns the value of the probability density function or the cumulative distribution function for the chi-square distribution.</ahelp></paragraph> -<paragraph id="hd_id0119200902395520" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id0119200902395679" role="code" xml-lang="en-US">CHISQDIST(Number; Degrees Of Freedom; Cumulative)</paragraph> <paragraph id="par_id011920090239564" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number for which the function is to be calculated.</paragraph> <paragraph id="par_id0119200902395660" role="paragraph" xml-lang="en-US"><emph>Degrees Of Freedom</emph> is the degrees of freedom for the chi-square function.</paragraph> @@ -728,13 +728,13 @@ <paragraph id="hd_id3150603" role="heading" level="2" xml-lang="en-US">EXPONDIST</paragraph> <paragraph id="par_id3149563" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_EXPONVERT">Returns the exponential distribution.</ahelp></paragraph> -<paragraph id="hd_id3153789" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150987" role="code" xml-lang="en-US">EXPONDIST(Number; Lambda; C)</paragraph> <paragraph id="par_id3154663" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value of the function.</paragraph> <paragraph id="par_id3154569" role="paragraph" xml-lang="en-US"><emph>Lambda</emph> is the parameter value.</paragraph><comment>UFI removed a double bookmark</comment> <paragraph id="par_id3147332" role="paragraph" xml-lang="en-US"><emph>C</emph> is a logical value that determines the form of the function. <emph>C = 0</emph> calculates the density function, and <emph>C = 1</emph> calculates the distribution.</paragraph> -<paragraph id="hd_id3146133" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3150357" role="paragraph" xml-lang="en-US"><item type="input">=EXPONDIST(3;0.5;1)</item> returns 0.78.</paragraph> </section> @@ -749,13 +749,13 @@ <paragraph id="hd_id2950603" role="heading" level="2" xml-lang="en-US">EXPON.DIST</paragraph> <paragraph id="par_id2949563" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_EXP_DIST_MS">Returns the exponential distribution.</ahelp></paragraph> -<paragraph id="hd_id2953789" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id2950987" role="code" xml-lang="en-US">EXPON.DIST(Number; Lambda; C)</paragraph> <paragraph id="par_id2954663" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value of the function.</paragraph> <paragraph id="par_id2954569" role="paragraph" xml-lang="en-US"><emph>Lambda</emph> is the parameter value.</paragraph><comment>UFI removed a double bookmark</comment> <paragraph id="par_id2947332" role="paragraph" xml-lang="en-US"><emph>C</emph> is a logical value that determines the form of the function. <emph>C = 0</emph> calculates the density function, and <emph>C = 1</emph> calculates the distribution.</paragraph> -<paragraph id="hd_id2946133" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2950357" role="paragraph" xml-lang="en-US"><item type="input">=EXPON.DIST(3;0.5;1)</item> returns 0.7768698399.</paragraph> </section> </sort> diff --git a/source/text/scalc/01/04060182.xhp b/source/text/scalc/01/04060182.xhp index f94205c758..7c7c25bb1d 100644 --- a/source/text/scalc/01/04060182.xhp +++ b/source/text/scalc/01/04060182.xhp @@ -37,7 +37,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FINV" id="bm_id3146113" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3145388" role="heading" level="2">FINV</paragraph> <paragraph xml-lang="en-US" id="par_id3155089" role="paragraph"><ahelp hid="HID_FUNC_FINV">Returns the inverse of the F probability distribution.</ahelp> The F distribution is used for F tests in order to set the relation between two differing data sets.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153816" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153068" role="code">FINV(Number; DegreesFreedom1; DegreesFreedom2)</paragraph> <paragraph xml-lang="en-US" id="par_id3146866" role="paragraph"> <emph>Number</emph> is probability value for which the inverse F distribution is to be calculated.</paragraph> @@ -45,7 +45,7 @@ <emph>DegreesFreedom1</emph> is the number of degrees of freedom in the numerator of the F distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3148607" role="paragraph"> <emph>DegreesFreedom2</emph> is the number of degrees of freedom in the denominator of the F distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3156021" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3145073" role="paragraph"> <item type="input">=FINV(0.5;5;10)</item> yields 0.93.</paragraph> </section> @@ -58,12 +58,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_F_INV_LT" id="bm_id2946113" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2945388" role="heading" level="2">F.INV</paragraph> <paragraph xml-lang="en-US" id="par_id2955089" role="paragraph"><ahelp hid="HID_FUNC_F_INV_LT">Returns the inverse of the cumulative F distribution.</ahelp> The F distribution is used for F tests in order to set the relation between two differing data sets.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2953816" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2953068" role="code">F.INV(Number; DegreesFreedom1; DegreesFreedom2)</paragraph> <paragraph xml-lang="en-US" id="par_id2946866" role="paragraph"><emph>Number</emph> is probability value for which the inverse F distribution is to be calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id2953914" role="paragraph"><emph>DegreesFreedom1</emph> is the number of degrees of freedom in the numerator of the F distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2948607" role="paragraph"><emph>DegreesFreedom2</emph> is the number of degrees of freedom in the denominator of the F distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2956021" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2945073" role="paragraph"><item type="input">=F.INV(0.5;5;10)</item> yields 0.9319331609.</paragraph> </section> <section id="fdotinvdotrt"> @@ -75,12 +75,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_F_INV_RT" id="bm_id2846113" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2845388" role="heading" level="2">F.INV.RT</paragraph> <paragraph xml-lang="en-US" id="par_id2855089" role="paragraph"><ahelp hid="HID_FUNC_F_INV_RT">Returns the inverse right tail of the F distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2853816" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2853068" role="code">F.INV.RT(Number; DegreesFreedom1; DegreesFreedom2)</paragraph> <paragraph xml-lang="en-US" id="par_id2846866" role="paragraph"><emph>Number</emph> is probability value for which the inverse F distribution is to be calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id2853914" role="paragraph"><emph>DegreesFreedom1</emph> is the number of degrees of freedom in the numerator of the F distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2848607" role="paragraph"><emph>DegreesFreedom2</emph> is the number of degrees of freedom in the denominator of the F distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2856021" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2845073" role="paragraph"><item type="input">=F.INV.RT(0.5;5;10)</item> yields 0.9319331609.</paragraph> </section> <section id="fisher"> @@ -89,11 +89,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FISHER" id="bm_id3146782" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3150888" role="heading" level="2">FISHER</paragraph> <paragraph xml-lang="en-US" id="par_id3155384" role="paragraph"><ahelp hid="HID_FUNC_FISHER">Returns the Fisher transformation for x and creates a function close to a normal distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3149898" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3143220" role="code">FISHER(Number)</paragraph> <paragraph xml-lang="en-US" id="par_id3159228" role="paragraph"> <emph>Number</emph> is the value to be transformed.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3154763" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149383" role="paragraph"> <item type="input">=FISHER(0.5)</item> yields 0.55.</paragraph> </section> @@ -104,11 +104,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FISHERINV" id="bm_id3149317" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3155758" role="heading" level="2">FISHERINV</paragraph> <paragraph xml-lang="en-US" id="par_id3154734" role="paragraph"><ahelp hid="HID_FUNC_FISHERINV">Returns the inverse of the Fisher transformation for x and creates a function close to a normal distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3155755" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3146108" role="code">FISHERINV(Number)</paragraph> <paragraph xml-lang="en-US" id="par_id3145115" role="paragraph"> <emph>Number</emph> is the value that is to undergo reverse-transformation.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3155744" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150432" role="paragraph"> <item type="input">=FISHERINV(0.5)</item> yields 0.46.</paragraph> </section> @@ -118,13 +118,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FTEST" id="bm_id3159263" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3151390" role="heading" level="2">FTEST</paragraph> <paragraph xml-lang="en-US" id="par_id3150534" role="paragraph"><ahelp hid="HID_FUNC_FTEST">Returns the result of an F test.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3166466" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153024" role="code">FTEST(Data1; Data2)</paragraph> <paragraph xml-lang="en-US" id="par_id3150032" role="paragraph"> <emph>Data1</emph> is the first record array.</paragraph> <paragraph xml-lang="en-US" id="par_id3153018" role="paragraph"> <emph>Data2</emph> is the second record array.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153123" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3159126" role="paragraph"> <item type="input">=FTEST(A1:A30;B1:B12)</item> calculates whether the two data sets are different in their variance and returns the probability that both sets could have come from the same total population.</paragraph> </section> @@ -135,11 +135,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_F_TEST_MS" id="bm_id2959263" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2951390" role="heading" level="2">F.TEST</paragraph> <paragraph xml-lang="en-US" id="par_id2950534" role="paragraph"><ahelp hid="HID_FUNC_F_TEST_MS">Returns the result of an F test.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2966466" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2953024" role="code">F.TEST(Data1; Data2)</paragraph> <paragraph xml-lang="en-US" id="par_id2950032" role="paragraph"><emph>Data1</emph> is the first record array.</paragraph> <paragraph xml-lang="en-US" id="par_id2953018" role="paragraph"><emph>Data2</emph> is the second record array.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2953123" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2959126" role="paragraph"><item type="input">=F.TEST(A1:A30;B1:B12)</item> calculates whether the two data sets are different in their variance and returns the probability that both sets could have come from the same total population.</paragraph> </section> <section id="fdist"> @@ -148,7 +148,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FVERT" id="bm_id3149722" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3150372" role="heading" level="2">FDIST</paragraph> <paragraph xml-lang="en-US" id="par_id3152981" role="paragraph"><ahelp hid="HID_FUNC_FVERT">Calculates the values of an F distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3150484" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3145826" role="code">FDIST(Number; DegreesFreedom1; DegreesFreedom2)</paragraph> <paragraph xml-lang="en-US" id="par_id3150461" role="paragraph"> <emph>Number</emph> is the value for which the F distribution is to be calculated.</paragraph> @@ -156,7 +156,7 @@ <emph>degreesFreedom1</emph> is the degrees of freedom in the numerator in the F distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3146877" role="paragraph"> <emph>degreesFreedom2</emph> is the degrees of freedom in the denominator in the F distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3147423" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150696" role="paragraph"> <item type="input">=FDIST(0.8;8;12)</item> yields 0.61.</paragraph> </section> @@ -167,13 +167,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_F_DIST_LT" id="bm_id2949722" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2950372" role="heading" level="2">F.DIST</paragraph> <paragraph xml-lang="en-US" id="par_id2952981" role="paragraph"><ahelp hid="HID_FUNC_F_DIST_LT">Calculates the values of the left tail of the F distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2950484" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2945826" role="code">F.DIST(Number; DegreesFreedom1; DegreesFreedom2; Cumulative)</paragraph> <paragraph xml-lang="en-US" id="par_id2950461" role="paragraph"><emph>Number</emph> is the value for which the F distribution is to be calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id2950029" role="paragraph"><emph>degreesFreedom1</emph> is the degrees of freedom in the numerator in the F distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2946877" role="paragraph"><emph>degreesFreedom2</emph> is the degrees of freedom in the denominator in the F distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2946878" role="paragraph"><emph>Cumulative</emph> = 0 or False calculates the density function <emph>Cumulative</emph> = 1 or True calculates the distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2947423" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2950696" role="paragraph"><item type="input">=F.DIST(0.8;8;12;0)</item> yields 0.7095282499.</paragraph> <paragraph xml-lang="en-US" id="par_id2950697" role="paragraph"><item type="input">=F.DIST(0.8;8;12;1)</item> yields 0.3856603563.</paragraph> </section> @@ -184,12 +184,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_F_DIST_RT" id="bm_id289722" localize="false"/> <paragraph xml-lang="en-US" id="hd_id280372" role="heading" level="2">F.DIST.RT</paragraph> <paragraph xml-lang="en-US" id="par_id2852981" role="paragraph"><ahelp hid="HID_FUNC_F_DIST_RT">Calculates the values of the right tail of the F distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2850484" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2845826" role="code">F.DIST.RT(Number; DegreesFreedom1; DegreesFreedom2)</paragraph> <paragraph xml-lang="en-US" id="par_id2850461" role="paragraph"><emph>Number</emph> is the value for which the F distribution is to be calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id2850029" role="paragraph"><emph>degreesFreedom1</emph> is the degrees of freedom in the numerator in the F distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2846877" role="paragraph"><emph>degreesFreedom2</emph> is the degrees of freedom in the denominator in the F distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2847423" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2850696" role="paragraph"><item type="input">=F.DIST.RT(0.8;8;12)</item> yields 0.6143396437.</paragraph> </section> <section id="gamma"> @@ -198,7 +198,7 @@ </bookmark> <paragraph xml-lang="en-US" id="hd_id0119200903205393" role="heading" level="2">GAMMA</paragraph> <paragraph xml-lang="en-US" id="par_id0119200903205379" role="paragraph"><ahelp hid=".">Returns the Gamma function value.</ahelp> Note that GAMMAINV is not the inverse of GAMMA, but of GAMMADIST.</paragraph> - <paragraph xml-lang="en-US" id="hd_id0119200903271613" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id0119200903271614" role="paragraph"> <emph>Number</emph> is the number for which the Gamma function value is to be calculated.</paragraph> </section> @@ -208,7 +208,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GAMMAINV" id="bm_id3149249" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3154841" role="heading" level="2">GAMMAINV</paragraph> <paragraph xml-lang="en-US" id="par_id3153932" role="paragraph"><ahelp hid="HID_FUNC_GAMMAINV">Returns the inverse of the Gamma cumulative distribution GAMMADIST.</ahelp> This function allows you to search for variables with different distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3149949" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155828" role="code">GAMMAINV(Number; Alpha; Beta)</paragraph> <paragraph xml-lang="en-US" id="par_id3145138" role="paragraph"> <emph>Number</emph> is the probability value for which the inverse Gamma distribution is to be calculated.</paragraph> @@ -216,7 +216,7 @@ <emph>Alpha</emph> is the parameter Alpha of the Gamma distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3154561" role="paragraph"> <emph>Beta</emph> is the parameter Beta of the Gamma distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3148734" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153331" role="paragraph"> <item type="input">=GAMMAINV(0.8;1;1)</item> yields 1.61.</paragraph> </section> @@ -227,7 +227,7 @@ <paragraph xml-lang="en-US" id="hd_id2914841" role="heading" level="2">GAMMA.INV</paragraph> <paragraph xml-lang="en-US" id="par_id2913932" role="paragraph"><ahelp hid="HID_FUNC_GAMMAINV_MS">Returns the inverse of the Gamma cumulative distribution GAMMADIST.</ahelp> This function allows you to search for variables with different distribution.</paragraph> <paragraph id="par_id291422405814" role="paragraph" xml-lang="en-US">This function is identical to GAMMAINV and was introduced for interoperability with other office suites.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2919949" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2915828" role="code">GAMMA.INV(Number; Alpha; Beta)</paragraph> <paragraph xml-lang="en-US" id="par_id2915138" role="paragraph"> <emph>Number</emph> is the probability value for which the inverse Gamma distribution is to be calculated.</paragraph> @@ -235,7 +235,7 @@ <emph>Alpha</emph> is the parameter Alpha of the Gamma distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2914561" role="paragraph"> <emph>Beta</emph> is the parameter Beta of the Gamma distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2918734" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2913331" role="paragraph"> <item type="input">=GAMMA.INV(0.8;1;1)</item> yields 1.61.</paragraph> </section> @@ -246,11 +246,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GAMMALN" id="bm_id3149511" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3154806" role="heading" level="2">GAMMALN</paragraph> <paragraph xml-lang="en-US" id="par_id3148572" role="paragraph"><ahelp hid="HID_FUNC_GAMMALN">Returns the natural logarithm of the Gamma function: G(x).</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3152999" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153112" role="code">GAMMALN(Number)</paragraph> <paragraph xml-lang="en-US" id="par_id3154502" role="paragraph"> <emph>Number</emph> is the value for which the natural logarithm of the Gamma function is to be calculated.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153568" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153730" role="paragraph"> <item type="input">=GAMMALN(2)</item> yields 0.</paragraph> </section> @@ -261,11 +261,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GAMMALN_MS" id="bm_id2919511" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2914806" role="heading" level="2">GAMMALN.PRECISE</paragraph> <paragraph xml-lang="en-US" id="par_id2918572" role="paragraph"><ahelp hid="HID_FUNC_GAMMALN_MS">Returns the natural logarithm of the Gamma function: G(x).</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2912999" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2913112" role="code">GAMMALN.PRECISE(Number)</paragraph> <paragraph xml-lang="en-US" id="par_id2914502" role="paragraph"> <emph>Number</emph> is the value for which the natural logarithm of the Gamma function is to be calculated.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2913568" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2913730" role="paragraph"> <item type="input">=GAMMALN.PRECISE(2)</item> yields 0.</paragraph> </section> @@ -276,7 +276,7 @@ <paragraph xml-lang="en-US" id="hd_id3150132" role="heading" level="2">GAMMADIST</paragraph> <paragraph xml-lang="en-US" id="par_id3155931" role="paragraph"><ahelp hid="HID_FUNC_GAMMAVERT">Returns the values of a Gamma distribution.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id0119200903333675" role="paragraph">The inverse function is GAMMAINV.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3147373" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155436" role="code">GAMMADIST(Number; Alpha; Beta; C)</paragraph> <paragraph xml-lang="en-US" id="par_id3150571" role="paragraph"> <emph>Number</emph> is the value for which the Gamma distribution is to be calculated.</paragraph> @@ -286,7 +286,7 @@ <emph>Beta</emph> is the parameter Beta of the Gamma distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3157972" role="paragraph"> <emph>C</emph> (optional) = 0 or False calculates the density function <emph>C</emph> = 1 or True calculates the distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3149535" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3145354" role="paragraph"> <item type="input">=GAMMADIST(2;1;1;1)</item> yields 0.86.</paragraph> </section> @@ -299,13 +299,13 @@ <paragraph id="par_id2406201422414690" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GAMMADIST_MS">Returns the values of a Gamma distribution.</ahelp></paragraph> <paragraph id="par_id24061422414690" role="paragraph" xml-lang="en-US">The inverse function is GAMMAINV or GAMMA.INV.</paragraph> <paragraph id="par_id2406201422405814" role="paragraph" xml-lang="en-US">This function is identical to GAMMADIST and was introduced for interoperability with other office suites.</paragraph> -<paragraph id="hd_id2406201422383599" role="heading" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id240620142238475" role="code" xml-lang="en-US">GAMMA.DIST(Number; Alpha; Beta; C)</paragraph> <paragraph id="par_id2406201422385134" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value for which the Gamma distribution is to be calculated.</paragraph> <paragraph id="par_id2406201422385590" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> is the parameter Alpha of the Gamma distribution.</paragraph> <paragraph id="par_id2406201422390458" role="paragraph" xml-lang="en-US"><emph>Beta</emph> is the parameter Beta of the Gamma distribution.</paragraph> <paragraph id="par_id2406201422391058" role="paragraph" xml-lang="en-US"><emph>C</emph> (optional) = 0 or False calculates the density function <emph>C</emph> = 1 or True calculates the distribution.</paragraph> -<paragraph id="hd_id2406201422391870" role="heading" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id2406201422392251" role="paragraph" xml-lang="en-US"><item type="input">=GAMMA.DIST(2;1;1;1)</item> yields 0.86.</paragraph> </section> <section id="gauss"> @@ -316,11 +316,11 @@ <paragraph xml-lang="en-US" id="hd_id3150272" role="heading" level="2">GAUSS</paragraph> <paragraph xml-lang="en-US" id="par_id3149030" role="paragraph"><ahelp hid="HID_FUNC_GAUSS">Returns the standard normal cumulative distribution.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id2059694" role="paragraph">It is GAUSS(x)=NORMSDIST(x)-0.5</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153551" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155368" role="code">GAUSS(Number)</paragraph> <paragraph xml-lang="en-US" id="par_id3153228" role="paragraph"> <emph>Number</emph> is the value for which the value of the standard normal distribution is to be calculated.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3150691" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3154867" role="paragraph"> <item type="input">=GAUSS(0.19)</item> = 0.08</paragraph> <paragraph xml-lang="en-US" id="par_id3148594" role="paragraph"> @@ -333,11 +333,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GEOMITTEL" id="bm_id3149777" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3148425" role="heading" level="2">GEOMEAN</paragraph> <paragraph xml-lang="en-US" id="par_id3156257" role="paragraph"><ahelp hid="HID_FUNC_GEOMITTEL">Returns the geometric mean of a sample.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3147167" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153720" role="code">GEOMEAN(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3152585" role="paragraph"> <emph>Number1, Number2, ..., Number30</emph> are numeric arguments or ranges that represent a random sample.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3146146" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149819" role="paragraph"> <item type="input">=GEOMEAN(23;46;69)</item> = 41.79. The geometric mean value of this random sample is therefore 41.79.</paragraph> </section> @@ -348,13 +348,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GESTUTZTMITTEL" id="bm_id3145081" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3152966" role="heading" level="2">TRIMMEAN</paragraph> <paragraph xml-lang="en-US" id="par_id3149716" role="paragraph"><ahelp hid="HID_FUNC_GESTUTZTMITTEL">Returns the mean of a data set without the Alpha percent of data at the margins.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3149281" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154821" role="code">TRIMMEAN(Data; Alpha)</paragraph> <paragraph xml-lang="en-US" id="par_id3155834" role="paragraph"> <emph>Data</emph> is the array of data in the sample.</paragraph> <paragraph xml-lang="en-US" id="par_id3156304" role="paragraph"> <emph>Alpha</emph> is the percentage of the marginal data that will not be taken into consideration.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3151180" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3156130" role="paragraph"> <item type="input">=TRIMMEAN(A1:A50; 0.1)</item> calculates the mean value of numbers in A1:A50, without taking into consideration the 5 percent of the values representing the highest values and the 5 percent of the values representing the lowest ones. The percentage numbers refer to the amount of the untrimmed mean value, not to the number of summands.</paragraph> </section> @@ -364,7 +364,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GTEST" id="bm_id3147569" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153216" role="heading" level="2">ZTEST</paragraph> <paragraph xml-lang="en-US" id="par_id3150758" role="paragraph"><ahelp hid="HID_FUNC_GTEST">Calculates the probability of observing a z-statistic greater than the one computed based on a sample.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3150872" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153274" role="code">ZTEST(Data; mu; Sigma)</paragraph> <paragraph xml-lang="en-US" id="par_id3156109" role="paragraph"> <emph>Data</emph> is the given sample, drawn from a normally distributed population.</paragraph> @@ -380,12 +380,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_Z_TEST_MS" id="bm_id2947569" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2953216" role="heading" level="2">Z.TEST</paragraph> <paragraph xml-lang="en-US" id="par_id2950758" role="paragraph"><ahelp hid="HID_FUNC_Z_TEST_MS">Calculates the probability of observing a z-statistic greater than the one computed based on a sample.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id2950872" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2953274" role="code">Z.TEST(Data; mu; Sigma)</paragraph> <paragraph xml-lang="en-US" id="par_id2956109" role="paragraph"><emph>Data</emph> is the given sample, drawn from a normally distributed population.</paragraph> <paragraph xml-lang="en-US" id="par_id2949977" role="paragraph"><emph>mu</emph> is the known mean of the population.</paragraph> <paragraph xml-lang="en-US" id="par_id2954740" role="paragraph"><emph>Sigma</emph> (optional) is the known standard deviation of the population. If omitted, the standard deviation of the given sample is used.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2949539" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2948770" role="paragraph"><item type="input">=Z.TEST(A2:A20; 9; 2)</item> returns the result of a z-test on a sample A2:A20 drawn from a population with known mean 9 and known standard deviation 2.</paragraph> </section> <section id="harmean"> @@ -395,11 +395,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_HARMITTEL" id="bm_id3154052" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153623" role="heading" level="2">HARMEAN</paragraph> <paragraph xml-lang="en-US" id="par_id3155102" role="paragraph"><ahelp hid="HID_FUNC_HARMITTEL">Returns the harmonic mean of a data set.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3146900" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149287" role="code">HARMEAN(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3154303" role="paragraph"> <emph>Number1, Number2, ..., Number30</emph> are up to 30 values or ranges, that can be used to calculate the harmonic mean.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3159179" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3146093" role="paragraph"> <item type="input">=HARMEAN(23;46;69)</item> = 37.64. The harmonic mean of this random sample is thus 37.64</paragraph> </section> @@ -410,7 +410,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_HYPGEOMVERT" id="bm_id3153910" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3152801" role="heading" level="2">HYPGEOMDIST</paragraph> <paragraph xml-lang="en-US" id="par_id3159341" role="paragraph"><ahelp hid="HID_FUNC_HYPGEOMVERT">Returns the hypergeometric distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3154697" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155388" role="code">HYPGEOMDIST(X; NSample; Successes; NPopulation)</paragraph> <paragraph xml-lang="en-US" id="par_id3154933" role="paragraph"> <emph>X</emph> is the number of results achieved in the random sample.</paragraph> @@ -420,7 +420,7 @@ <emph>Successes</emph> is the number of possible results in the total population.</paragraph> <paragraph xml-lang="en-US" id="par_id3148826" role="paragraph"> <emph>NPopulation </emph>is the size of the total population.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3150529" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3154904" role="paragraph"> <item type="input">=HYPGEOMDIST(2;2;90;100)</item> yields 0.81. If 90 out of 100 pieces of buttered toast fall from the table and hit the floor with the buttered side first, then if 2 pieces of buttered toast are dropped from the table, the probability is 81%, that both will strike buttered side first.</paragraph> </section> @@ -433,14 +433,14 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_HYP_GEOM_DIST_MS" id="bm_id2953910" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2952801" role="heading" level="2">HYPGEOM.DIST</paragraph> <paragraph xml-lang="en-US" id="par_id2959341" role="paragraph"><ahelp hid="HID_FUNC_HYP_GEOM_DIST_MS">Returns the hypergeometric distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2954697" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2955388" role="code">HYPGEOM.DIST(X; NSample; Successes; NPopulation; Cumulative)</paragraph> <paragraph xml-lang="en-US" id="par_id2954933" role="paragraph"><emph>X</emph> is the number of results achieved in the random sample.</paragraph> <paragraph xml-lang="en-US" id="par_id2953106" role="paragraph"><emph>NSample</emph> is the size of the random sample.</paragraph> <paragraph xml-lang="en-US" id="par_id2946992" role="paragraph"><emph>Successes</emph> is the number of possible results in the total population.</paragraph> <paragraph xml-lang="en-US" id="par_id2948826" role="paragraph"><emph>NPopulation </emph>is the size of the total population.</paragraph> <paragraph xml-lang="en-US" id="par_id2948827" role="paragraph"><emph>Cumulative </emph>: 0 or False calculates the probability density function. Other values or True calculates the cumulative distribution function.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2950529" role="heading" level="3">Examples</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2954904" role="paragraph"><item type="input">=HYPGEOM.DIST(2;2;90;100;0)</item> yields 0.8090909091. If 90 out of 100 pieces of buttered toast fall from the table and hit the floor with the buttered side first, then if 2 pieces of buttered toast are dropped from the table, the probability is 81%, that both will strike buttered side first.</paragraph> <paragraph xml-lang="en-US" id="par_id2954905" role="paragraph"><item type="input">=HYPGEOM.DIST(2;2;90;100;1)</item> yields 1.</paragraph> </section> diff --git a/source/text/scalc/01/04060183.xhp b/source/text/scalc/01/04060183.xhp index 1b725410a9..f6ecd7cc33 100644 --- a/source/text/scalc/01/04060183.xhp +++ b/source/text/scalc/01/04060183.xhp @@ -36,13 +36,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KGROESSTE" id="bm_id3150883" localize="false"/> <paragraph role="heading" id="hd_id3149530" xml-lang="en-US" level="2">LARGE</paragraph> <paragraph role="paragraph" id="par_id3150518" xml-lang="en-US"><ahelp hid="HID_FUNC_KGROESSTE">Returns the Rank_c-th largest value in a data set.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3152990" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3154372" xml-lang="en-US">LARGE(Data; RankC)</paragraph> <paragraph role="paragraph" id="par_id3152986" xml-lang="en-US"> <emph>Data</emph> is the cell range of data.</paragraph> <paragraph role="paragraph" id="par_id3156448" xml-lang="en-US"> <emph>RankC</emph> is the ranking of the value.</paragraph> -<paragraph role="heading" id="hd_id3152889" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3148702" xml-lang="en-US"> <item type="input">=LARGE(A1:C50;2)</item> gives the second largest value in A1:C50.</paragraph> </section> @@ -52,13 +52,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KKLEINSTE" id="bm_id3148609" localize="false"/> <paragraph role="heading" id="hd_id3154532" xml-lang="en-US" level="2">SMALL</paragraph> <paragraph role="paragraph" id="par_id3157981" xml-lang="en-US"><ahelp hid="HID_FUNC_KKLEINSTE">Returns the Rank_c-th smallest value in a data set.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3154957" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3153974" xml-lang="en-US">SMALL(Data; RankC)</paragraph> <paragraph role="paragraph" id="par_id3154540" xml-lang="en-US"> <emph>Data</emph> is the cell range of data.</paragraph> <paragraph role="paragraph" id="par_id3155094" xml-lang="en-US"> <emph>RankC</emph> is the rank of the value.</paragraph> -<paragraph role="heading" id="hd_id3153247" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3149897" xml-lang="en-US"> <item type="input">=SMALL(A1:C50;2)</item> gives the second smallest value in A1:C50.</paragraph> </section> @@ -68,7 +68,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KONFIDENZ" id="bm_id3153803" localize="false"/> <paragraph role="heading" id="hd_id3153559" xml-lang="en-US" level="2">CONFIDENCE</paragraph> <paragraph role="paragraph" id="par_id3153814" xml-lang="en-US"><ahelp hid="HID_FUNC_KONFIDENZ">Returns the (1-alpha) confidence interval for a normal distribution.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3149315" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3147501" xml-lang="en-US">CONFIDENCE(Alpha; StDev; Size)</paragraph> <paragraph role="paragraph" id="par_id3149872" xml-lang="en-US"> <emph>Alpha</emph> is the level of the confidence interval.</paragraph> @@ -76,7 +76,7 @@ <emph>StDev</emph> is the standard deviation for the total population.</paragraph> <paragraph role="paragraph" id="par_id3153075" xml-lang="en-US"> <emph>Size</emph> is the size of the total population.</paragraph> -<paragraph role="heading" id="hd_id3150435" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3153335" xml-lang="en-US"> <item type="input">=CONFIDENCE(0.05;1.5;100)</item> gives 0.29.</paragraph> </section> @@ -87,7 +87,7 @@ <paragraph role="heading" id="hd_id2953559" xml-lang="en-US" level="2">CONFIDENCE.T</paragraph> <paragraph role="paragraph" id="par_id2953814" xml-lang="en-US"> <ahelp hid="HID_FUNC_CONFIDENCE_T">Returns the (1-alpha) confidence interval for a Student's t distribution.</ahelp></paragraph> -<paragraph role="heading" id="hd_id2949315" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id2947501" xml-lang="en-US">CONFIDENCE.T(Alpha; StDev; Size)</paragraph> <paragraph role="paragraph" id="par_id2949872" xml-lang="en-US"> <emph>Alpha</emph> is the level of the confidence interval.</paragraph> @@ -95,7 +95,7 @@ <emph>StDev</emph> is the standard deviation for the total population.</paragraph> <paragraph role="paragraph" id="par_id2953075" xml-lang="en-US"> <emph>Size</emph> is the size of the total population.</paragraph> -<paragraph role="heading" id="hd_id2950435" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id2953335" xml-lang="en-US"> <item type="input">=CONFIDENCE.T(0.05;1.5;100)</item> gives 0.2976325427.</paragraph> </section> @@ -106,7 +106,7 @@ <paragraph role="heading" id="hd_id2853559" xml-lang="en-US" level="2">CONFIDENCE.NORM</paragraph> <paragraph role="paragraph" id="par_id2853814" xml-lang="en-US"> <ahelp hid="HID_FUNC_CONFIDENCE_N">Returns the (1-alpha) confidence interval for a normal distribution.</ahelp></paragraph> -<paragraph role="heading" id="hd_id2849315" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id2847501" xml-lang="en-US">CONFIDENCE.NORM(Alpha; StDev; Size)</paragraph> <paragraph role="paragraph" id="par_id2849872" xml-lang="en-US"> <emph>Alpha</emph> is the level of the confidence interval.</paragraph> @@ -114,7 +114,7 @@ <emph>StDev</emph> is the standard deviation for the total population.</paragraph> <paragraph role="paragraph" id="par_id2853075" xml-lang="en-US"> <emph>Size</emph> is the size of the total population.</paragraph> -<paragraph role="heading" id="hd_id2850435" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id2853335" xml-lang="en-US"> <item type="input">=CONFIDENCE.NORM(0.05;1.5;100)</item> gives 0.2939945977.</paragraph> </section> @@ -125,13 +125,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KORREL" id="bm_id3147403" localize="false"/> <paragraph role="heading" id="hd_id3148746" xml-lang="en-US" level="2">CORREL</paragraph> <paragraph role="paragraph" id="par_id3147299" xml-lang="en-US"><ahelp hid="HID_FUNC_KORREL">Returns the correlation coefficient between two data sets.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3156397" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3153023" xml-lang="en-US">CORREL(Data1; Data2)</paragraph> <paragraph role="paragraph" id="par_id3150036" xml-lang="en-US"> <emph>Data1</emph> is the first data set.</paragraph> <paragraph role="paragraph" id="par_id3153021" xml-lang="en-US"> <emph>Data2</emph> is the second data set.</paragraph> -<paragraph role="heading" id="hd_id3149720" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3149941" xml-lang="en-US"> <item type="input">=CORREL(A1:A50;B1:B50)</item> calculates the correlation coefficient as a measure of the linear correlation of the two data sets.</paragraph> </section> @@ -141,13 +141,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KOVAR" id="bm_id3152983" localize="false"/> <paragraph role="heading" id="hd_id3150652" xml-lang="en-US" level="2">COVAR</paragraph> <paragraph role="paragraph" id="par_id3146875" xml-lang="en-US"><ahelp hid="HID_FUNC_KOVAR">Returns the covariance of the product of paired deviations.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3149013" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3150740" xml-lang="en-US">COVAR(Data1; Data2)</paragraph> <paragraph role="paragraph" id="par_id3145827" xml-lang="en-US"> <emph>Data1</emph> is the first data set.</paragraph> <paragraph role="paragraph" id="par_id3150465" xml-lang="en-US"> <emph>Data2</emph> is the second data set.</paragraph> -<paragraph role="heading" id="hd_id3154677" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3144748" xml-lang="en-US"> <item type="input">=COVAR(A1:A30;B1:B30)</item> </paragraph> @@ -159,11 +159,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COVARIANCE_P" id="bm_id2952983" localize="false"/> <paragraph role="heading" id="hd_id2950652" xml-lang="en-US" level="2">COVARIANCE.P</paragraph> <paragraph role="paragraph" id="par_id2946875" xml-lang="en-US"><ahelp hid="HID_FUNC_COVARIANCE_P">Returns the covariance of the product of paired deviations, for the entire population.</ahelp></paragraph> - <paragraph role="heading" id="hd_id2949013" xml-lang="en-US" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id2950740" xml-lang="en-US">COVARIANCE.P(Data1; Data2)</paragraph> <paragraph role="paragraph" id="par_id2945827" xml-lang="en-US"><emph>Data1</emph> is the first data set.</paragraph> <paragraph role="paragraph" id="par_id2950465" xml-lang="en-US"><emph>Data2</emph> is the second data set.</paragraph> - <paragraph role="heading" id="hd_id2954677" xml-lang="en-US" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id2944748" xml-lang="en-US"><item type="input">=COVARIANCE.P(A1:A30;B1:B30)</item></paragraph> </section> <section id="covariancedots"> @@ -173,11 +173,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COVARIANCE_S" id="bm_id2852983" localize="false"/> <paragraph role="heading" id="hd_id2850652" xml-lang="en-US" level="2">COVARIANCE.S</paragraph> <paragraph role="paragraph" id="par_id2846875" xml-lang="en-US"><ahelp hid="HID_FUNC_COVARIANCE_S">Returns the covariance of the product of paired deviations, for a sample of the population.</ahelp></paragraph> - <paragraph role="heading" id="hd_id2849013" xml-lang="en-US" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id2850740" xml-lang="en-US">COVARIANCE.S(Data1; Data2)</paragraph> <paragraph role="paragraph" id="par_id2845827" xml-lang="en-US"><emph>Data1</emph> is the first data set.</paragraph> <paragraph role="paragraph" id="par_id2850465" xml-lang="en-US"><emph>Data2</emph> is the second data set.</paragraph> - <paragraph role="heading" id="hd_id284677" xml-lang="en-US" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id2844748" xml-lang="en-US"><item type="input">=COVARIANCE.S(A1:A30;B1:B30)</item></paragraph> </section> <section id="critbinom"> @@ -186,7 +186,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KRITBINOM" id="bm_id3154848" localize="false"/> <paragraph role="heading" id="hd_id3147472" xml-lang="en-US" level="2">CRITBINOM</paragraph> <paragraph role="paragraph" id="par_id3149254" xml-lang="en-US"><ahelp hid="HID_FUNC_KRITBINOM">Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3153930" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3148586" xml-lang="en-US">CRITBINOM(Trials; SP; Alpha)</paragraph> <paragraph role="paragraph" id="par_id3145593" xml-lang="en-US"> <emph>Trials</emph> is the total number of trials.</paragraph> @@ -194,7 +194,7 @@ <emph>SP</emph> is the probability of success for one trial.</paragraph> <paragraph role="paragraph" id="par_id3149726" xml-lang="en-US"> <emph>Alpha</emph> is the threshold probability to be reached or exceeded.</paragraph> -<paragraph role="heading" id="hd_id3148752" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3148740" xml-lang="en-US"> <item type="input">=CRITBINOM(100;0.5;0.1)</item> yields 44.</paragraph> </section> @@ -204,11 +204,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KURT" id="bm_id3146847" localize="false"/> <paragraph role="heading" id="hd_id3155956" xml-lang="en-US" level="2">KURT</paragraph> <paragraph role="paragraph" id="par_id3153108" xml-lang="en-US"><ahelp hid="HID_FUNC_KURT">Returns the kurtosis of a data set (at least 4 values required).</ahelp></paragraph> -<paragraph role="heading" id="hd_id3150334" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3154508" xml-lang="en-US">KURT(Number1; Number2; ...; Number30)</paragraph> <paragraph role="paragraph" id="par_id3145167" xml-lang="en-US"> <emph>Number1, Number2, ..., Number30</emph> are numeric arguments or ranges representing a random sample of distribution.</paragraph> -<paragraph role="heading" id="hd_id3158000" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3150016" xml-lang="en-US"> <item type="input">=KURT(A1;A2;A3;A4;A5;A6)</item> </paragraph> @@ -220,7 +220,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOGINV" id="bm_id3156062" localize="false"/> <paragraph role="heading" id="hd_id3150928" xml-lang="en-US" level="2">LOGINV</paragraph> <paragraph role="paragraph" id="par_id3145297" xml-lang="en-US"><ahelp hid="HID_FUNC_LOGINV">Returns the inverse of the lognormal distribution.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3151016" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3153049" xml-lang="en-US">LOGINV(Number; Mean; StDev)</paragraph> <paragraph role="paragraph" id="par_id3148390" xml-lang="en-US"> <emph>Number</emph> is the probability value for which the inverse standard logarithmic distribution is to be calculated.</paragraph> @@ -228,7 +228,7 @@ <emph>Mean</emph> is the arithmetic mean of the standard logarithmic distribution.</paragraph> <paragraph role="paragraph" id="par_id3145355" xml-lang="en-US"> <emph>StDev</emph> is the standard deviation of the standard logarithmic distribution.</paragraph> -<paragraph role="heading" id="hd_id3148768" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3155623" xml-lang="en-US"> <item type="input">=LOGINV(0.05;0;1)</item> returns 0.1930408167.</paragraph> </section> @@ -240,7 +240,7 @@ <paragraph role="heading" id="hd_id2901928" xml-lang="en-US" level="2">LOGNORM.INV</paragraph> <paragraph role="paragraph" id="par_id2901297" xml-lang="en-US"><ahelp hid="HID_FUNC_LOGINV_MS">Returns the inverse of the lognormal distribution.</ahelp></paragraph> <paragraph id="par_id290122405814" role="paragraph" xml-lang="en-US">This function is identical to LOGINV and was introduced for interoperability with other office suites.</paragraph> -<paragraph role="heading" id="hd_id2901016" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id2901049" xml-lang="en-US">LOGNORM.INV(Number; Mean; StDev)</paragraph> <paragraph role="paragraph" id="par_id2901390" xml-lang="en-US"> <emph>Number</emph> (required) is the probability value for which the inverse standard logarithmic distribution is to be calculated.</paragraph> @@ -248,7 +248,7 @@ <emph>Mean</emph> (required) is the arithmetic mean of the standard logarithmic distribution.</paragraph> <paragraph role="paragraph" id="par_id2901355" xml-lang="en-US"> <emph>StDev</emph> (required) is the standard deviation of the standard logarithmic distribution.</paragraph> -<paragraph role="heading" id="hd_id2901768" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id2901623" xml-lang="en-US"> <item type="input">=LOGNORM.INV(0.05;0;1)</item> returns 0.1930408167.</paragraph> </section> @@ -259,7 +259,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOGNORMVERT" id="bm_id3155366" localize="false"/> <paragraph role="heading" id="hd_id3158417" xml-lang="en-US" level="2">LOGNORMDIST</paragraph> <paragraph role="paragraph" id="par_id3154953" xml-lang="en-US"><ahelp hid="HID_FUNC_LOGNORMVERT">Returns the values of a lognormal distribution.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3150474" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3150686" xml-lang="en-US">LOGNORMDIST(Number; Mean; StDev; Cumulative)</paragraph> <paragraph role="paragraph" id="par_id3154871" xml-lang="en-US"> <emph>Number</emph> is the probability value for which the standard logarithmic distribution is to be calculated.</paragraph> @@ -269,7 +269,7 @@ <emph>StDev</emph> (optional) is the standard deviation of the standard logarithmic distribution.</paragraph> <paragraph role="paragraph" id="par_id3155992" xml-lang="en-US"> <emph>Cumulative</emph> (optional) = 0 calculates the density function, Cumulative = 1 calculates the distribution.</paragraph> -<paragraph role="heading" id="hd_id3153178" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3149778" xml-lang="en-US"> <item type="input">=LOGNORMDIST(0.1;0;1)</item> returns 0.01.</paragraph> </section> @@ -280,7 +280,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOGNORMDIST_MS" id="bm_id2901366" localize="false"/> <paragraph role="heading" id="hd_id2908417" xml-lang="en-US" level="2">LOGNORM.DIST</paragraph> <paragraph role="paragraph" id="par_id2904953" xml-lang="en-US"><ahelp hid="HID_FUNC_LOGNORMDIST_MS">Returns the values of a lognormal distribution.</ahelp></paragraph> -<paragraph role="heading" id="hd_id2900474" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id2900686" xml-lang="en-US">LOGNORM.DIST(Number; Mean; StDev; Cumulative)</paragraph> <paragraph role="paragraph" id="par_id2904871" xml-lang="en-US"> <emph>Number</emph> (required) is the probability value for which the standard logarithmic distribution is to be calculated.</paragraph> @@ -290,7 +290,7 @@ <emph>StDev</emph> (required) is the standard deviation of the standard logarithmic distribution.</paragraph> <paragraph role="paragraph" id="par_id2905992" xml-lang="en-US"> <emph>Cumulative</emph> (required) = 0 calculates the density function, Cumulative = 1 calculates the distribution.</paragraph> -<paragraph role="heading" id="hd_id2903178" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id2909778" xml-lang="en-US"> <item type="input">=LOGNORM.DIST(0.1;0;1;1)</item> returns 0.0106510993.</paragraph> </section> diff --git a/source/text/scalc/01/04060184.xhp b/source/text/scalc/01/04060184.xhp index bd85e34437..94447dda06 100644 --- a/source/text/scalc/01/04060184.xhp +++ b/source/text/scalc/01/04060184.xhp @@ -37,10 +37,10 @@ <paragraph xml-lang="en-US" id="hd_id3154511" role="heading" level="2"><variable id="max_head"><link href="text/scalc/01/04060184.xhp#max">MAX</link></variable></paragraph> <paragraph xml-lang="en-US" id="par_id3153709" role="paragraph"><ahelp hid="HID_FUNC_MAX">Returns the maximum value in a list of arguments.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id9282509" role="paragraph">Returns 0 if no numeric value and no error was encountered in the cell range(s) passed as cell reference(s). Text cells are ignored by MIN() and MAX(). The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered. Passing a literal string argument to MIN() or MAX(), e.g. MIN("string"), still results in an error.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3154256" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3147340" role="code">MAX(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3149568" role="paragraph"><emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges. </paragraph> -<paragraph xml-lang="en-US" id="hd_id3153963" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3147343" role="paragraph"> <item type="input">=MAX(A1;A2;A3;50;100;200)</item> returns the largest value from the list.</paragraph> <paragraph xml-lang="en-US" id="par_id3148485" role="paragraph"> @@ -53,10 +53,10 @@ <paragraph xml-lang="en-US" id="hd_id3166426" role="heading" level="2"><variable id="maxa_head"><link href="text/scalc/01/04060184.xhp#maxa">MAXA</link></variable></paragraph> <paragraph xml-lang="en-US" id="par_id3150363" role="paragraph"><ahelp hid="HID_FUNC_MAXA">Returns the maximum value in a list of arguments. In opposite to MAX, here you can enter text. The value of the text is 0.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id7689443" role="paragraph">The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3150516" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3166431" role="code">MAXA(Value1; Value2; ...; Value30)</paragraph> <paragraph xml-lang="en-US" id="par_id3150202" role="paragraph"><emph>Value1; Value2;...; Value30</emph> are values or ranges. Text has the value of 0.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3156290" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3156446" role="paragraph"> <item type="input">=MAXA(A1;A2;A3;50;100;200;"Text")</item> returns the largest value from the list.</paragraph> <paragraph xml-lang="en-US" id="par_id3149404" role="paragraph"> @@ -68,10 +68,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MEDIAN" id="bm_id3153069" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153820" role="heading" level="2"><variable id="median_head"><link href="text/scalc/01/04060184.xhp#median">MEDIAN</link></variable></paragraph> <paragraph xml-lang="en-US" id="par_id3151241" role="paragraph"><ahelp hid="HID_FUNC_MEDIAN">Returns the median of a set of numbers. In a set containing an uneven number of values, the median will be the number in the middle of the set and in a set containing an even number of values, it will be the mean of the two values in the middle of the set.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id3148871" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155264" role="code">MEDIAN(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3150109" role="paragraph"><emph>Number1, Number2, ..., Number30</emph> are values or ranges, which represent a sample. Each number can also be replaced by a reference.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3144506" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3145078" role="paragraph">for an odd number: <item type="input">=MEDIAN(1;5;9;20;21)</item> returns 9 as the median value.</paragraph> <paragraph xml-lang="en-US" id="par_id3149126" role="paragraph">for an even number: <item type="input">=MEDIAN(1;5;9;20)</item> returns the average of the two middle values 5 and 9, thus 7.</paragraph> </section> @@ -82,10 +82,10 @@ <paragraph xml-lang="en-US" id="hd_id3154541" role="heading" level="2"><variable id="min_head"><link href="text/scalc/01/04060184.xhp#min">MIN</link></variable></paragraph> <paragraph xml-lang="en-US" id="par_id3143222" role="paragraph"><ahelp hid="HID_FUNC_MIN">Returns the minimum value in a list of arguments.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id2301400" role="paragraph">Returns 0 if no numeric value and no error was encountered in the cell range(s) passed as cell reference(s). Text cells are ignored by MIN() and MAX(). The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered. Passing a literal string argument to MIN() or MAX(), e.g. MIN("string"), still results in an error.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3154651" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3146964" role="code">MIN(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3153486" role="paragraph"><emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3155523" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3154734" role="paragraph"> <item type="input">=MIN(A1:B100)</item> returns the smallest value in the list.</paragraph> </section> @@ -96,10 +96,10 @@ <paragraph xml-lang="en-US" id="hd_id3147504" role="heading" level="2"><variable id="mina_head"><link href="text/scalc/01/04060184.xhp#mina">MINA</link></variable></paragraph> <paragraph xml-lang="en-US" id="par_id3147249" role="paragraph"><ahelp hid="HID_FUNC_MINA">Returns the minimum value in a list of arguments. Here you can also enter text. The value of the text is 0.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id4294564" role="paragraph">The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3150435" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153336" role="code">MINA(Value1; Value2; ...; Value30)</paragraph> <paragraph xml-lang="en-US" id="par_id3146098" role="paragraph"><emph>Value1, Value2, ..., Value30</emph> are values or ranges. Text has the value of 0.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3148743" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3147401" role="paragraph"> <item type="input">=MINA(1;"Text";20)</item> returns 0.</paragraph> <paragraph xml-lang="en-US" id="par_id3147295" role="paragraph"> @@ -112,10 +112,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MITTELABW" id="bm_id3156396" localize="false"/> <paragraph role="heading" id="hd_id3166465" xml-lang="en-US" level="2"><variable id="avedev_head"><link href="text/scalc/01/04060184.xhp#avedev">AVEDEV</link></variable></paragraph> <paragraph role="paragraph" id="par_id3150373" xml-lang="en-US"><ahelp hid="HID_FUNC_MITTELABW">Returns the average of the absolute deviations of data points from their mean.</ahelp> Displays the diffusion in a data set.</paragraph> -<paragraph role="heading" id="hd_id3150038" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3145636" xml-lang="en-US">AVEDEV(Number1; Number2; ...; Number30)</paragraph> <paragraph role="paragraph" id="par_id3157871" xml-lang="en-US"><emph>Number1, Number2, ..., Number30</emph> are values or ranges that represent a sample. Each number can also be replaced by a reference.</paragraph> -<paragraph role="heading" id="hd_id3149725" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3153122" xml-lang="en-US"> <item type="input">=AVEDEV(A1:A50)</item> </paragraph> @@ -126,10 +126,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MITTELWERT" id="bm_id3146878" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3145824" role="heading" level="2"><variable id="average_head"><link href="text/scalc/01/04060184.xhp#average">AVERAGE</link></variable></paragraph> <paragraph xml-lang="en-US" id="par_id3150482" role="paragraph"><ahelp hid="HID_FUNC_MITTELWERT">Returns the average of the arguments.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id3146943" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154679" role="code">AVERAGE(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3150741" role="paragraph"><emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3153039" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3151232" role="paragraph"> <item type="input">=AVERAGE(A1:A50)</item> </paragraph> @@ -140,10 +140,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MITTELWERTA" id="bm_id3149690" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3148754" role="heading" level="2"><variable id="averagea_head"><link href="text/scalc/01/04060184.xhp#averagea">AVERAGEA</link></variable></paragraph> <paragraph xml-lang="en-US" id="par_id3145138" role="paragraph"><ahelp hid="HID_FUNC_MITTELWERTA">Returns the average of the arguments. The value of a text is 0.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id3153326" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149734" role="code">AVERAGEA(Value1; Value2; ...; Value30)</paragraph> <paragraph xml-lang="en-US" id="par_id3155260" role="paragraph"><emph>Value1, Value2, ..., Value30</emph> are values or ranges. Text has the value of 0.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3149504" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150864" role="paragraph"> <item type="input">=AVERAGEA(A1:A50)</item> </paragraph> @@ -164,10 +164,10 @@ <paragraph xml-lang="en-US" id="hd_id3153933" role="heading" level="2">MODE</paragraph> <paragraph xml-lang="en-US" id="par_id3153085" role="paragraph"><ahelp hid="HID_FUNC_MODALWERT">Returns the most common value in a data set.</ahelp> If there are several values with the same frequency, it returns the smallest value. An error occurs when a value doesn't appear twice.</paragraph> <embed href="text/scalc/01/ODFF.xhp#odff"/> -<paragraph xml-lang="en-US" id="hd_id3153003" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3155950" role="code">MODE(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3150337" role="paragraph"><emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3153571" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153733" role="paragraph"> <item type="input">=MODE(A1:A50)</item> </paragraph> @@ -180,11 +180,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MODAL_VALUE_MS" id="bm_id2949253" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2953933" role="heading" level="2">MODE.SNGL</paragraph> <paragraph xml-lang="en-US" id="par_id2953085" role="paragraph"><ahelp hid="HID_FUNC_MODAL_VALUE_MS">Returns the most frequently occurring, or repetitive, value in an array or range of data.</ahelp> If there are several values with the same frequency, it returns the smallest value. An error occurs when a value doesn't appear twice.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2953003" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2955950" role="code">MODE.SNGL(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id2950337" role="paragraph"><emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges.</paragraph> <paragraph xml-lang="en-US" id="par_id2963792" role="warning">If the data set contains no duplicate data points, MODE.SNGL returns the #VALUE! error value.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2953571" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2953733" role="paragraph"><item type="input">=MODE.SNGL(A1:A50)</item></paragraph> </section> <section id="modedotmult"> @@ -194,11 +194,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MODAL_VALUE_MULTI" id="bm_id2849253" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2853933" role="heading" level="2">MODE.MULT</paragraph> <paragraph xml-lang="en-US" id="par_id2853085" role="paragraph"><ahelp hid="HID_FUNC_MODAL_VALUE_MULTI">Returns a vertical array of the statistical modes (the most frequently occurring values) within a list of supplied numbers.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id2853003" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2855950" role="code">MODE.MULT(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id2850337" role="paragraph"><emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges.</paragraph> <paragraph xml-lang="en-US" id="par_id2863792" role="warning">As the MODE.MULT function returns an array of values, it must be entered as an array formula. If the function is not entered as an array formula, only the first mode is returned, which is the same as using the MODE.SNGL function.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2853571" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2853733" role="paragraph"><item type="input">=MODE.MULT(A1:A50)</item></paragraph> </section> <section id="negbinomdist"> @@ -208,12 +208,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NEGBINOMVERT" id="bm_id3159135" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3149879" role="heading" level="2">NEGBINOMDIST</paragraph> <paragraph xml-lang="en-US" id="par_id3155437" role="paragraph"><ahelp hid="HID_FUNC_NEGBINOMVERT">Returns the negative binomial distribution.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id3145351" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150935" role="code">NEGBINOMDIST(X; R; SP)</paragraph> <paragraph xml-lang="en-US" id="par_id3153044" role="paragraph"><emph>X</emph> represents the value returned for unsuccessful tests.</paragraph> <paragraph xml-lang="en-US" id="par_id3151018" role="paragraph"><emph>R</emph> represents the value returned for successful tests.</paragraph> <paragraph xml-lang="en-US" id="par_id3148878" role="paragraph"><emph>SP</emph> is the probability of the success of an attempt.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3149539" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3148770" role="paragraph"> <item type="input">=NEGBINOMDIST(1;1;0.5)</item> returns 0.25.</paragraph> </section> @@ -224,13 +224,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NEGBINOMDIST_MS" id="bm_id2959135" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2949879" role="heading" level="2">NEGBINOM.DIST</paragraph> <paragraph xml-lang="en-US" id="par_id2955437" role="paragraph"><ahelp hid="HID_FUNC_NEGBINOMDIST_MS">Returns the negative binomial density or distribution function.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id2945351" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2950935" role="code">NEGBINOM.DIST(X; R; SP; Cumulative)</paragraph> <paragraph xml-lang="en-US" id="par_id2953044" role="paragraph"><emph>X</emph> represents the value returned for unsuccessful tests.</paragraph> <paragraph xml-lang="en-US" id="par_id2951018" role="paragraph"><emph>R</emph> represents the value returned for successful tests.</paragraph> <paragraph xml-lang="en-US" id="par_id2948878" role="paragraph"><emph>SP</emph> is the probability of the success of an attempt.</paragraph> <paragraph xml-lang="en-US" id="par_id2948879" role="paragraph"><emph>Cumulative</emph> = 0 calculates the density function, <emph>Cumulative</emph> = 1 calculates the distribution.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2949539" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2948770" role="paragraph"><item type="input">=NEGBINOM.DIST(1;1;0.5;0)</item> returns 0.25.</paragraph> <paragraph xml-lang="en-US" id="par_id2948771" role="paragraph"><item type="input">=NEGBINOM.DIST(1;1;0.5;1)</item> returns 0.75.</paragraph> </section> @@ -241,12 +241,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NORMINV" id="bm_id3149396" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3155516" role="heading" level="2">NORMINV</paragraph> <paragraph xml-lang="en-US" id="par_id3154634" role="paragraph"><ahelp hid="HID_FUNC_NORMINV">Returns the inverse of the normal cumulative distribution.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id3153227" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3147534" role="code">NORMINV(Number; Mean; StDev)</paragraph> <paragraph xml-lang="en-US" id="par_id3154950" role="paragraph"><emph>Number</emph> represents the probability value used to determine the inverse normal distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3150690" role="paragraph"><emph>Mean</emph> represents the mean value in the normal distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3148594" role="paragraph"><emph>StDev</emph> represents the standard deviation of the normal distribution.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3155822" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153921" role="paragraph"> <item type="input">=NORMINV(0.9;63;5)</item> returns 69.41. If the average egg weighs 63 grams with a standard deviation of 5, then there will be 90% probability that the egg will not be heavier than 69.41g grams.</paragraph> </section> @@ -257,12 +257,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NORMINV_MS" id="bm_id2949396" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2955516" role="heading" level="2">NORM.INV</paragraph> <paragraph xml-lang="en-US" id="par_id2954634" role="paragraph"><ahelp hid="HID_FUNC_NORMINV_MS">Returns the inverse of the normal cumulative distribution.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id2953227" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2947534" role="code">NORM.INV(Number; Mean; StDev)</paragraph> <paragraph xml-lang="en-US" id="par_id2954950" role="paragraph"><emph>Number</emph> represents the probability value used to determine the inverse normal distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2950690" role="paragraph"><emph>Mean</emph> represents the mean value in the normal distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2948594" role="paragraph"><emph>StDev</emph> represents the standard deviation of the normal distribution.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2955822" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2953921" role="paragraph"> <item type="input">=NORM.INV(0.9;63;5)</item> returns 69.4077578277. If the average egg weighs 63 grams with a standard deviation of 5, then there will be 90% probability that the egg will not be heavier than 69.41g grams.</paragraph> </section> @@ -273,13 +273,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NORMVERT" id="bm_id3147484" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153722" role="heading" level="2">NORMDIST</paragraph> <paragraph xml-lang="en-US" id="par_id3150386" role="paragraph"><ahelp hid="HID_FUNC_NORMVERT">Returns the density function or the normal cumulative distribution.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id3083282" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150613" role="code">NORMDIST(Number; Mean; StDev; C)</paragraph> <paragraph xml-lang="en-US" id="par_id3149820" role="paragraph"><emph>Number</emph> is the value of the distribution based on which the normal distribution is to be calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id3146063" role="paragraph"><emph>Mean</emph> is the mean value of the distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3156295" role="paragraph"><emph>StDev</emph> is the standard deviation of the distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3145080" role="paragraph"><emph>C</emph> is optional. <emph>C</emph> = 0 calculates the density function, <emph>C</emph> = 1 calculates the distribution.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3152972" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149283" role="paragraph"> <item type="input">=NORMDIST(70;63;5;0)</item> returns 0.03.</paragraph> <paragraph xml-lang="en-US" id="par_id3149448" role="paragraph"> @@ -292,13 +292,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NORMDIST_MS" id="bm_id2917484" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2913722" role="heading" level="2">NORM.DIST</paragraph> <paragraph xml-lang="en-US" id="par_id2910386" role="paragraph"><ahelp hid="HID_FUNC_NORMDIST_MS">Returns the density function or the normal cumulative distribution.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id2913282" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2910613" role="code">NORM.DIST(Number; Mean; StDev; C)</paragraph> <paragraph xml-lang="en-US" id="par_id2919820" role="paragraph"><emph>Number</emph> is the value of the distribution based on which the normal distribution is to be calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id2916063" role="paragraph"><emph>Mean</emph> is the mean value of the distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2916295" role="paragraph"><emph>StDev</emph> is the standard deviation of the distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2915080" role="paragraph"><emph>C</emph> = 0 calculates the density function, <emph>C</emph> = 1 calculates the distribution.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2912972" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2919283" role="paragraph"> <item type="input">=NORM.DIST(70;63;5;0)</item> returns 0.029945493.</paragraph> <paragraph xml-lang="en-US" id="par_id2919448" role="paragraph"> @@ -310,11 +310,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_PEARSON" id="bm_id3156103" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3152934" role="heading" level="2">PEARSON</paragraph> <paragraph xml-lang="en-US" id="par_id3153216" role="paragraph"><ahelp hid="HID_FUNC_PEARSON">Returns the Pearson product moment correlation coefficient r.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id3147081" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3156133" role="code">PEARSON(Data1; Data2)</paragraph> <paragraph xml-lang="en-US" id="par_id3151272" role="paragraph"><emph>Data1</emph> represents the array of the first data set.</paragraph> <paragraph xml-lang="en-US" id="par_id3153279" role="paragraph"><emph>Data2</emph> represents the array of the second data set.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3147567" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3151187" role="paragraph"> <item type="input">=PEARSON(A1:A30;B1:B30)</item> returns the Pearson correlation coefficient of both data sets.</paragraph> </section> @@ -324,10 +324,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_PHI" id="bm_id3153757" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3152806" role="heading" level="2">PHI</paragraph> <paragraph xml-lang="en-US" id="par_id3150254" role="paragraph"><ahelp hid="HID_FUNC_PHI">Returns the values of the distribution function for a standard normal distribution.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id3154748" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149976" role="code">PHI(Number)</paragraph> <paragraph xml-lang="en-US" id="par_id3156108" role="paragraph"><emph>Number</emph> represents the value based on which the standard normal distribution is calculated.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3153621" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3155849" role="paragraph"> <item type="input">=PHI(2.25) </item>= 0.03</paragraph> <paragraph xml-lang="en-US" id="par_id3143236" role="paragraph"> @@ -341,12 +341,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_POISSON" id="bm_id3156011" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153985" role="heading" level="2">POISSON</paragraph> <paragraph xml-lang="en-US" id="par_id3154298" role="paragraph"><ahelp hid="HID_FUNC_POISSON">Returns the Poisson distribution.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id3159183" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3146093" role="code">POISSON(Number; Mean; C)</paragraph> <paragraph xml-lang="en-US" id="par_id3147253" role="paragraph"><emph>Number</emph> represents the value based on which the Poisson distribution is calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id3151177" role="paragraph"><emph>Mean</emph> represents the middle value of the Poisson distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3149200" role="paragraph"><emph>C</emph> (optional) = 0 or False calculates the density function; <emph>C</emph> = 1 or True calculates the distribution. When omitted, the default value True is inserted when you save the document, for best compatibility with other programs and older versions of %PRODUCTNAME.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3159347" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150113" role="paragraph"> <item type="input">=POISSON(60;50;1)</item> returns 0.93.</paragraph> </section> @@ -357,12 +357,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_POISSON_DIST_MS" id="bm_id2956011" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2953985" role="heading" level="2">POISSON.DIST</paragraph> <paragraph xml-lang="en-US" id="par_id2954298" role="paragraph"><ahelp hid="HID_FUNC_POISSON_DIST_MS">Returns the Poisson distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2959183" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2946093" role="code">POISSON.DIST(Number; Mean; C)</paragraph> <paragraph xml-lang="en-US" id="par_id2947253" role="paragraph"><emph>Number</emph> represents the value based on which the Poisson distribution is calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id2951177" role="paragraph"><emph>Mean</emph> represents the middle value of the Poisson distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2949200" role="paragraph"><emph>C</emph> (optional) = 0 or False calculates the density function; <emph>C</emph> = 1 or True calculates the distribution. When omitted, the default value True is inserted when you save the document, for best compatibility with other programs and older versions of %PRODUCTNAME.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2959347" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2950113" role="paragraph"><item type="input">=POISSON.DIST(60;50;1)</item> returns 0.9278398202.</paragraph> </section> <section id="percentile"> @@ -371,11 +371,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QUANTIL" id="bm_id3155394" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153100" role="heading" level="2">PERCENTILE</paragraph> <paragraph xml-lang="en-US" id="par_id3154940" role="paragraph"><ahelp hid="HID_FUNC_QUANTIL">Returns the alpha-percentile of data values in an array.</ahelp> A percentile returns the scale value for a data series which goes from the smallest (Alpha=0) to the largest value (alpha=1) of a data series. For <item type="literal">Alpha</item> = 25%, the percentile means the first quartile; <item type="literal">Alpha</item> = 50% is the MEDIAN.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3150531" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3148813" role="code">PERCENTILE(Data; Alpha)</paragraph> <paragraph xml-lang="en-US" id="par_id3153054" role="paragraph"><emph>Data</emph> represents the array of data.</paragraph> <paragraph xml-lang="en-US" id="par_id3154212" role="paragraph"><emph>Alpha</emph> represents the percentage of the scale between 0 and 1.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3154290" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3159147" role="paragraph"> <item type="input">=PERCENTILE(A1:A50;0.1)</item> represents the value in the data set, which equals 10% of the total data scale in A1:A50.</paragraph> </section> @@ -387,11 +387,11 @@ <paragraph xml-lang="en-US" id="par_id2854940" role="paragraph"><ahelp hid="HID_FUNC_PERCENTILE_EXC">Returns the <item type="literal">Alpha</item>'th percentile of a supplied range of values for a given value of <item type="literal">Alpha</item>, within the range 0 to 1 (exclusive).</ahelp> A percentile returns the scale value for a data series which goes from the smallest (<item type="literal">Alpha=0</item>) to the largest value (<item type="literal">Alpha=1</item>) of a data series. For <item type="literal">Alpha</item> = 25%, the percentile means the first quartile; <item type="literal">Alpha</item> = 50% is the MEDIAN.</paragraph> <paragraph xml-lang="en-US" id="par_id2754940" role="warning">If <item type="literal">Alpha</item> is not a multiple of <item type="literal">1/(n+1)</item>, (where n is the number of values in the supplied array), the function interpolates between the values in the supplied array, to calculate the percentile value. However, if <item type="literal">Alpha</item> is less than <item type="literal">1/(n+1)</item> or <item type="literal">Alpha</item> is greater than <item type="literal">n/(n+1)</item>, the function is unable to interpolate, and so returns an error.</paragraph> <paragraph xml-lang="en-US" id="par_id2653976" role="note">The difference between <item type="input">PERCENTILE.INC</item> and <item type="input">PERCENTILE.EXC</item> is that, in the <item type="input">PERCENTILE.INC</item> function the value of alpha is is within the range 0 to 1 inclusive, and in the <item type="input">PERCENTILE.EXC</item> function, the value of alpha is within the range 0 to 1 exclusive.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2850531" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2848813" role="code">PERCENTILE.EXC(Data; Alpha)</paragraph> <paragraph xml-lang="en-US" id="par_id2853054" role="paragraph"><emph>Data</emph> represents the array of data.</paragraph> <paragraph xml-lang="en-US" id="par_id2854212" role="paragraph"><emph>Alpha</emph> represents the percentage of the scale between 0 and 1.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2854290" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2859147" role="paragraph"><item type="input">=PERCENTILE.EXC(A1:A50;10%)</item> represents the value in the data set, which equals 10% of the total data scale in A1:A50.</paragraph> </section> <section id="percentileinc"> @@ -401,11 +401,11 @@ <paragraph xml-lang="en-US" id="hd_id2953100" role="heading" level="2">PERCENTILE.INC</paragraph> <paragraph xml-lang="en-US" id="par_id2954940" role="paragraph"><ahelp hid="HID_FUNC_PERCENTILE_INC">Returns the alpha-percentile of data values in an array.</ahelp> A percentile returns the scale value for a data series which goes from the smallest (Alpha=0) to the largest value (alpha=1) of a data series. For <item type="literal">Alpha</item> = 25%, the percentile means the first quartile; <item type="literal">Alpha</item> = 50% is the MEDIAN.</paragraph> <paragraph xml-lang="en-US" id="par_id2753976" role="note">The difference between <item type="input">PERCENTILE.INC</item> and <item type="input">PERCENTILE.EXC</item> is that, in the <item type="input">PERCENTILE.INC</item> function the value of alpha is is within the range 0 to 1 inclusive, and in the <item type="input">PERCENTILE.EXC</item> function, the value of alpha is within the range 0 to 1 exclusive.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2950531" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2948813" role="code">PERCENTILE.INC(Data; Alpha)</paragraph> <paragraph xml-lang="en-US" id="par_id2953054" role="paragraph"><emph>Data</emph> represents the array of data.</paragraph> <paragraph xml-lang="en-US" id="par_id2954212" role="paragraph"><emph>Alpha</emph> represents the percentage of the scale between 0 and 1.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2954290" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2959147" role="paragraph"><item type="input">=PERCENTILE.INC(A1:A50;0.1)</item> represents the value in the data set, which equals 10% of the total data scale in A1:A50.</paragraph> </section> <section id="percentrank"> @@ -414,12 +414,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QUANTILSRANG" id="bm_id3154902" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3148807" role="heading" level="2">PERCENTRANK</paragraph> <paragraph xml-lang="en-US" id="par_id3153573" role="paragraph"><ahelp hid="HID_FUNC_QUANTILSRANG">Returns the percentage rank of a value in a sample.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id3147512" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3147238" role="code">PERCENTRANK(Data; Value; Significance)</paragraph> <paragraph xml-lang="en-US" id="par_id3154266" role="paragraph"><emph>Data</emph> represents the array of data in the sample.</paragraph> <paragraph xml-lang="en-US" id="par_id3148475" role="paragraph"><emph>Value</emph> represents the value whose percentile rank must be determined.</paragraph> <paragraph xml-lang="en-US" id="par_id2748477" role="paragraph"><emph>Significance</emph> An optional argument that specifies the number of significant digits that the returned percentage value is rounded to. If omitted, a value of 3 is used.</paragraph> -<paragraph xml-lang="en-US" id="hd_id3155364" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149163" role="paragraph"> <item type="input">=PERCENTRANK(A1:A50;50)</item> returns the percentage rank of the value 50 from the total range of all values found in A1:A50. If 50 falls outside the total range, an error message will appear.</paragraph> </section> @@ -429,12 +429,12 @@ <paragraph xml-lang="en-US" id="hd_id2848807" role="heading" level="2">PERCENTRANK.EXC</paragraph> <paragraph xml-lang="en-US" id="par_id2853573" role="paragraph"><ahelp hid="HID_FUNC_PERCENTRANK_EXC"> Returns the relative position, between 0 and 1 (exclusive), of a specified value within a supplied array.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id2553976" role="note">The difference between <item type="input">PERCENTRANK.INC</item> and <item type="input">PERCENTRANK.EXC</item> is that <item type="input">PERCENTRANK.INC</item> calculates a value in the range 0 to 1 inclusive, whereas the <item type="input">PERCENTRANK.EXC</item> function calculates a value in the range 0 to 1 exclusive.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2847512" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2847238" role="code">PERCENTRANK.EXC(Data; Value; Significance)</paragraph> <paragraph xml-lang="en-US" id="par_id2854266" role="paragraph"><emph>Data</emph> represents the array of data in the sample.</paragraph> <paragraph xml-lang="en-US" id="par_id2848475" role="paragraph"><emph>Value</emph> represents the value whose percentile rank must be determined.</paragraph> <paragraph xml-lang="en-US" id="par_id2748475" role="paragraph"><emph>Significance</emph> An optional argument that specifies the number of significant digits that the returned percentage value is rounded to.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2855364" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2849163" role="paragraph"><item type="input">=PERCENTRANK.EXC(A1:A50;50)</item> returns the percentage rank of the value 50 from the total range of all values found in A1:A50. If 50 falls outside the total range, an error message will appear.</paragraph> </section> <section id="percentrankinc"> @@ -443,12 +443,12 @@ <paragraph xml-lang="en-US" id="hd_id2948807" role="heading" level="2">PERCENTRANK.INC</paragraph> <paragraph xml-lang="en-US" id="par_id2953573" role="paragraph"><ahelp hid="HID_FUNC_PERCENTRANK_INC">Returns the relative position, between 0 and 1 (inclusive), of a specified value within a supplied array.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id2453976" role="note">The difference between <item type="input">PERCENTRANK.INC</item> and <item type="input">PERCENTRANK.EXC</item> is that <item type="input">PERCENTRANK.INC</item> calculates a value in the range 0 to 1 inclusive, whereas the <item type="input">PERCENTRANK.EXC</item> function calculates a value in the range 0 to 1 exclusive.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2947512" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2947238" role="code">PERCENTRANK.INC(Data; Value; Significance)</paragraph> <paragraph xml-lang="en-US" id="par_id2954266" role="paragraph"><emph>Data</emph> represents the array of data in the sample.</paragraph> <paragraph xml-lang="en-US" id="par_id2948475" role="paragraph"><emph>Value</emph> represents the value whose percentile rank must be determined.</paragraph> <paragraph xml-lang="en-US" id="par_id2648475" role="paragraph"><emph>Significance</emph> An optional argument that specifies the number of significant digits that the returned percentage value is rounded to.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2955364" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2949163" role="paragraph"><item type="input">=PERCENTRANK.INC(A1:A50;50)</item> returns the percentage rank of the value 50 from the total range of all values found in A1:A50. If 50 falls outside the total range, an error message will appear.</paragraph> </section> <section id="quartile"> @@ -457,11 +457,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QUARTILE" id="bm_id3150709" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3166442" role="heading" level="2">QUARTILE</paragraph> <paragraph xml-lang="en-US" id="par_id3146958" role="paragraph"><ahelp hid="HID_FUNC_QUARTILE">Returns the quartile of a data set.</ahelp></paragraph> -<paragraph xml-lang="en-US" id="hd_id3152942" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153684" role="code">QUARTILE(Data; Type)</paragraph> <paragraph xml-lang="en-US" id="par_id3153387" role="paragraph"><emph>Data</emph> represents the array of data in the sample.</paragraph> <paragraph xml-lang="en-US" id="par_id3155589" role="paragraph"><emph>Type</emph> represents the type of quartile. (0 = MIN, 1 = 25%, 2 = 50% (MEDIAN), 3 = 75% and 4 = MAX.)</paragraph> -<paragraph xml-lang="en-US" id="hd_id3149103" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3159276" role="paragraph"> <item type="input">=QUARTILE(A1:A50;2)</item> returns the value of which 50% of the scale corresponds to the lowest to highest values in the range A1:A50.</paragraph> </section> @@ -472,11 +472,11 @@ <paragraph xml-lang="en-US" id="hd_id2866442" role="heading" level="2">QUARTILE.EXC</paragraph> <paragraph xml-lang="en-US" id="par_id2846958" role="paragraph"><ahelp hid="HID_FUNC_QUARTILE_EXC">Returns a requested quartile of a supplied range of values, based on a percentile range of 0 to 1 exclusive.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id2353976" role="note">The difference between <item type="input">QUARTILE.INC</item> and <item type="input">QUARTILE.EXC</item> is that the <item type="input">QUARTILE.INC</item> function bases its calculation on a percentile range of 0 to 1 inclusive, whereas the <item type="input">QUARTILE.EXC</item> function bases its calculation on a percentile range of 0 to 1 exclusive.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2852942" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2853684" role="code">QUARTILE.EXC(Data; Type)</paragraph> <paragraph xml-lang="en-US" id="par_id2853387" role="paragraph"><emph>Data</emph> represents the range of data values for which you want to calculate the specified quartile.</paragraph> <paragraph xml-lang="en-US" id="par_id2855589" role="paragraph"><emph>Type</emph> An integer between 1 and 3, representing the required quartile. (if type = 1 or 3, the supplied array must contain more than 2 values) </paragraph> -<paragraph xml-lang="en-US" id="hd_id2849103" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2859276" role="paragraph"> <item type="input">=QUARTILE.EXC(A1:A50;2)</item> returns the value of which 50% of the scale corresponds to the lowest to highest values in the range A1:A50.</paragraph> </section> @@ -487,11 +487,11 @@ <paragraph xml-lang="en-US" id="hd_id2966442" role="heading" level="2">QUARTILE.INC</paragraph> <paragraph xml-lang="en-US" id="par_id2946958" role="paragraph"><ahelp hid="HID_FUNC_QUARTILE_INC">Returns the quartile of a data set.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id2253976" role="note">The difference between <item type="input">QUARTILE.INC</item> and <item type="input">QUARTILE.EXC</item> is that the <item type="input">QUARTILE.INC</item> function bases its calculation on a percentile range of 0 to 1 inclusive, whereas the <item type="input">QUARTILE.EXC</item> function bases its calculation on a percentile range of 0 to 1 exclusive.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2952942" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2953684" role="code">QUARTILE.INC(Data; Type)</paragraph> <paragraph xml-lang="en-US" id="par_id2953387" role="paragraph"><emph>Data</emph> represents the array of data in the sample.</paragraph> <paragraph xml-lang="en-US" id="par_id2955589" role="paragraph"><emph>Type</emph> represents the type of quartile. (0 = MIN, 1 = 25%, 2 = 50% (MEDIAN), 3 = 75% and 4 = MAX.)</paragraph> -<paragraph xml-lang="en-US" id="hd_id2949103" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2959276" role="paragraph"> <item type="input">=QUARTILE.INC(A1:A50;2)</item> returns the value of which 50% of the scale corresponds to the lowest to highest values in the range A1:A50.</paragraph> </section> diff --git a/source/text/scalc/01/04060185.xhp b/source/text/scalc/01/04060185.xhp index b838f45cc2..901aa10bd7 100644 --- a/source/text/scalc/01/04060185.xhp +++ b/source/text/scalc/01/04060185.xhp @@ -37,7 +37,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RANG" id="bm_id3146778" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3155071" role="heading" level="2">RANK</paragraph> <paragraph xml-lang="en-US" id="par_id3153976" role="paragraph"><ahelp hid="HID_FUNC_RANG">Returns the rank of a number in a sample.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3159206" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153250" role="code">RANK(Value; Data; Type)</paragraph> <paragraph xml-lang="en-US" id="par_id3154543" role="paragraph"> <emph>Value</emph> is the value, whose rank is to be determined.</paragraph> @@ -47,7 +47,7 @@ <emph>Type</emph> (optional) is the sequence order.</paragraph> <paragraph xml-lang="en-US" id="par_id9305398" role="paragraph">Type = 0 means descending from the last item of the array to the first (this is the default),</paragraph> <paragraph xml-lang="en-US" id="par_id9996948" role="paragraph">Type = 1 means ascending from the first item of the range to the last.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3143223" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3155919" role="paragraph"> <item type="input">=RANK(A10;A1:A50)</item> returns the ranking of the value in A10 in value range A1:A50. If <item type="literal">Value</item> does not exist within the range an error message is displayed.</paragraph> </section> @@ -60,14 +60,14 @@ <paragraph xml-lang="en-US" id="hd_id2955071" role="heading" level="2">RANK.AVG</paragraph> <paragraph xml-lang="en-US" id="par_id2953976" role="paragraph"><ahelp hid="HID_FUNC_RANK_AVG">Returns the statistical rank of a given value, within a supplied array of values.</ahelp> If there are duplicate values in the list, the average rank is returned.</paragraph> <paragraph xml-lang="en-US" id="par_id2653976" role="note">The difference between <item type="input">RANK.AVG</item> and <item type="input">RANK.EQ</item> occurs when there are duplicates in the list of values. The <item type="input">RANK.EQ</item> function returns the lower rank, whereas the <item type="input">RANK.AVG</item> function returns the average rank.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2959206" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2953250" role="code">RANK.AVG(Value; Data; Type)</paragraph> <paragraph xml-lang="en-US" id="par_id2954543" role="paragraph"><emph>Value</emph> is the value, whose rank is to be determined.</paragraph> <paragraph xml-lang="en-US" id="par_id2949130" role="paragraph"><emph>Data</emph> is the array or range of data in the sample.</paragraph> <paragraph xml-lang="en-US" id="par_id2950215" role="paragraph"><emph>Type</emph> (optional) is the sequence order.</paragraph> <paragraph xml-lang="en-US" id="par_id0305398" role="paragraph">Type = 0 means descending from the last item of the array to the first (this is the default),</paragraph> <paragraph xml-lang="en-US" id="par_id0996948" role="paragraph">Type = 1 means ascending from the first item of the range to the last.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2943223" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2955919" role="paragraph"><item type="input">=RANK.AVG(A10;A1:A50)</item> returns the ranking of the value in A10 in value range A1:A50. If <item type="literal">Value</item> does not exist within the range an error message is displayed.</paragraph> </section> <section id="rankeq"> @@ -79,14 +79,14 @@ <paragraph xml-lang="en-US" id="hd_id2855071" role="heading" level="2">RANK.EQ</paragraph> <paragraph xml-lang="en-US" id="par_id2853976" role="paragraph"><ahelp hid="HID_FUNC_RANK_EQ">Returns the statistical rank of a given value, within a supplied array of values.</ahelp> If there are duplicate values in the list, these are given the same rank.</paragraph> <paragraph xml-lang="en-US" id="par_id2753976" role="note">The difference between <item type="input">RANK.AVG</item> and <item type="input">RANK.EQ</item> occurs when there are duplicates in the list of values. The <item type="input">RANK.EQ</item> function returns the lower rank, whereas the <item type="input">RANK.AVG</item> function returns the average rank.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2859206" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2853250" role="code">RANK.EQ(Value; Data; Type)</paragraph> <paragraph xml-lang="en-US" id="par_id2854543" role="paragraph"><emph>Value</emph> is the value, whose rank is to be determined.</paragraph> <paragraph xml-lang="en-US" id="par_id2849130" role="paragraph"><emph>Data</emph> is the array or range of data in the sample.</paragraph> <paragraph xml-lang="en-US" id="par_id2850215" role="paragraph"><emph>Type</emph> (optional) is the sequence order.</paragraph> <paragraph xml-lang="en-US" id="par_id89305398" role="paragraph">Type = 0 means descending from the last item of the array to the first (this is the default),</paragraph> <paragraph xml-lang="en-US" id="par_id89996948" role="paragraph">Type = 1 means ascending from the first item of the range to the last.</paragraph> -<paragraph xml-lang="en-US" id="hd_id2843223" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2855919" role="paragraph"><item type="input">=RANK.EQ(A10;A1:A50)</item> returns the ranking of the value in A10 in value range A1:A50. If <item type="literal">Value</item> does not exist within the range an error message is displayed.</paragraph> </section> <section id="skew"> @@ -95,11 +95,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SCHIEFE" id="bm_id3153801" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153556" role="heading" level="2">SKEW</paragraph> <paragraph xml-lang="en-US" id="par_id3153485" role="paragraph"><ahelp hid="HID_FUNC_SCHIEFE">Returns the skewness of a distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3154733" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3151191" role="code">SKEW(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3155757" role="paragraph"> <emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153297" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3145118" role="paragraph"> <item type="input">=SKEW(A1:A50)</item> calculates the value of skew for the data referenced.</paragraph> </section> @@ -115,7 +115,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SCHAETZER" id="bm_id3146102" localize="false"/><comment>mw made "regression lines" a two level entry</comment> <paragraph xml-lang="en-US" id="hd_id3149051" role="heading" level="2">FORECAST</paragraph> <paragraph xml-lang="en-US" id="par_id3153290" role="paragraph"><ahelp hid="HID_FUNC_SCHAETZER">Extrapolates future values based on existing x and y values.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3151343" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3147404" role="code">FORECAST(Value; DataY; DataX)</paragraph> <paragraph xml-lang="en-US" id="par_id3148743" role="paragraph"> <emph>Value</emph> is the x value, for which the y value on the linear regression is to be returned.</paragraph> @@ -123,7 +123,7 @@ <emph>DataY</emph> is the array or range of known y's.</paragraph> <paragraph xml-lang="en-US" id="par_id3150536" role="paragraph"> <emph>DataX</emph> is the array or range of known x's.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3147416" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3157874" role="paragraph"> <item type="input">=FORECAST(50;A1:A50;B1;B50)</item> returns the Y value expected for the X value of 50 if the X and Y values in both references are linked by a linear trend.</paragraph> </section> @@ -135,7 +135,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FORECAST_LIN" id="bm_id3146102" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3149052" role="heading" level="2">FORECAST.LINEAR</paragraph> <paragraph xml-lang="en-US" id="par_id3153291" role="paragraph"><ahelp hid="HID_FUNC_SCHAETZER">Extrapolates future values based on existing x and y values.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3151344" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3147405" role="code">FORECAST.LINEAR(Value; DataY; DataX)</paragraph> <paragraph xml-lang="en-US" id="par_id3148744" role="paragraph"> <emph>Value</emph> is the x value, for which the y value on the linear regression is to be returned.</paragraph> @@ -143,7 +143,7 @@ <emph>DataY</emph> is the array or range of known y's.</paragraph> <paragraph xml-lang="en-US" id="par_id3150537" role="paragraph"> <emph>DataX</emph> is the array or range of known x's.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3147417" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3157875" role="paragraph"> <item type="input">=FORECAST.LINEAR(50;A1:A50;B1;B50)</item> returns the Y value expected for the X value of 50 if the X and Y values in both references are linked by a linear trend.</paragraph> </section> @@ -154,11 +154,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STABW" id="bm_id3153121" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3149143" role="heading" level="2">STDEV</paragraph> <paragraph xml-lang="en-US" id="par_id3146888" role="paragraph"><ahelp hid="HID_FUNC_STABW">Estimates the standard deviation based on a sample.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3146815" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149946" role="code">STDEV(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3157904" role="paragraph"> <emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges representing a sample based on an entire population.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3150650" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149434" role="paragraph"> <item type="input">=STDEV(A1:A50)</item> returns the estimated standard deviation based on the data referenced.</paragraph> </section> @@ -168,11 +168,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STABWA" id="bm_id3154846" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3144745" role="heading" level="2">STDEVA</paragraph> <paragraph xml-lang="en-US" id="par_id3151234" role="paragraph"><ahelp hid="HID_FUNC_STABWA">Calculates the standard deviation of an estimation based on a sample.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3148884" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3147422" role="code">STDEVA(Value1; Value2; ...; Value30)</paragraph> <paragraph xml-lang="en-US" id="par_id3154547" role="paragraph"> <emph>Value1, Value2, ..., Value30</emph> are values or ranges representing a sample derived from an entire population. Text has the value 0.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3155829" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3148581" role="paragraph"> <item type="input">=STDEVA(A1:A50)</item> returns the estimated standard deviation based on the data referenced.</paragraph> </section> @@ -183,11 +183,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STABWN" id="bm_id3146139" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3149734" role="heading" level="2">STDEVP</paragraph> <paragraph xml-lang="en-US" id="par_id3149187" role="paragraph"><ahelp hid="HID_FUNC_STABWN">Calculates the standard deviation based on the entire population.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3154387" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154392" role="code">STDEVP(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3155261" role="paragraph"> <emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges representing an entire population.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3145591" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153933" role="paragraph"> <item type="input">=STDEVP(A1:A50)</item> returns a standard deviation of the data referenced.</paragraph> </section> @@ -199,10 +199,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ST_DEV_P_MS" id="bm_id2946139" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2949734" role="heading" level="2">STDEV.P</paragraph> <paragraph xml-lang="en-US" id="par_id2949187" role="paragraph"><ahelp hid="HID_FUNC_ST_DEV_P_MS">Calculates the standard deviation based on the entire population.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2954387" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2954392" role="code">STDEV.P(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id2955261" role="paragraph"><emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges representing an entire population.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2945591" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2953933" role="paragraph"><item type="input">=STDEV.P(A1:A50)</item> returns a standard deviation of the data referenced.</paragraph> </section> <section id="stdevdots"> @@ -213,10 +213,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ST_DEV_S" id="bm_id2846139" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2849734" role="heading" level="2">STDEV.S</paragraph> <paragraph xml-lang="en-US" id="par_id2849187" role="paragraph"><ahelp hid="HID_FUNC_ST_DEV_S">Calculates the standard deviation based on sample of the population.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2854387" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2854392" role="code">STDEV.S(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id2855261" role="paragraph"><emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges representing a sample of the population.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2845591" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2853933" role="paragraph"><item type="input">=STDEV.S(A1:A50)</item> returns a standard deviation of the data referenced.</paragraph> </section> <section id="stdevpa"> @@ -225,11 +225,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STABWNA" id="bm_id3150902" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3154522" role="heading" level="2">STDEVPA</paragraph> <paragraph xml-lang="en-US" id="par_id3149549" role="paragraph"><ahelp hid="HID_FUNC_STABWNA">Calculates the standard deviation based on the entire population.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3155950" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3146851" role="code">STDEVPA(Value1; Value2; ...; Value30)</paragraph> <paragraph xml-lang="en-US" id="par_id3153109" role="paragraph"> <emph>Value1, Value2, ..., Value30</emph> are values or ranges representing an entire population. Text has the value 0.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3154506" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3145163" role="paragraph"> <item type="input">=STDEVPA(A1:A50)</item> returns the standard deviation of the data referenced.</paragraph> </section> @@ -240,7 +240,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STANDARDISIERUNG" id="bm_id3148764" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3155928" role="heading" level="2">STANDARDIZE</paragraph> <paragraph xml-lang="en-US" id="par_id3149883" role="paragraph"><ahelp hid="HID_FUNC_STANDARDISIERUNG">Converts a random variable to a normalized value.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3154330" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150132" role="code">STANDARDIZE(Number; Mean; StDev)</paragraph> <paragraph xml-lang="en-US" id="par_id3159139" role="paragraph"> <emph>Number</emph> is the value to be standardized.</paragraph> @@ -248,7 +248,7 @@ <emph>Mean</emph> is the arithmetic mean of the distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3148874" role="paragraph"> <emph>StDev</emph> is the standard deviation of the distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3145351" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3156067" role="paragraph"> <item type="input">=STANDARDIZE(11;10;1)</item> returns 1. The value 11 in a normal distribution with a mean of 10 and a standard deviation of 1 is as much above the mean of 10, as the value 1 is above the mean of the standard normal distribution.</paragraph> </section> @@ -259,11 +259,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STANDNORMINV" id="bm_id3148389" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3157986" role="heading" level="2">NORMSINV</paragraph> <paragraph xml-lang="en-US" id="par_id3151282" role="paragraph"><ahelp hid="HID_FUNC_STANDNORMINV">Returns the inverse of the standard normal cumulative distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3153261" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154195" role="code">NORMSINV(Number)</paragraph> <paragraph xml-lang="en-US" id="par_id3148772" role="paragraph"> <emph>Number</emph> is the probability to which the inverse standard normal distribution is calculated.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3150934" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149030" role="paragraph"> <item type="input">=NORMSINV(0.908789)</item> returns 1.3333.</paragraph> </section> @@ -274,11 +274,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STD_NORMINV_MS" id="bm_id2948389" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2957986" role="heading" level="2">NORM.S.INV</paragraph> <paragraph xml-lang="en-US" id="par_id2951282" role="paragraph"><ahelp hid="HID_FUNC_STD_NORMINV_MS">Returns the inverse of the standard normal cumulative distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2953261" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2954195" role="code">NORM.S.INV(Number)</paragraph> <paragraph xml-lang="en-US" id="par_id2948772" role="paragraph"> <emph>Number</emph> is the probability to which the inverse standard normal distribution is calculated.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2950934" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2949030" role="paragraph"> <item type="input">=NORM.S.INV(0.908789)</item> returns 1.333334673.</paragraph> </section> @@ -290,11 +290,11 @@ <paragraph xml-lang="en-US" id="hd_id3147538" role="heading" level="2">NORMSDIST</paragraph> <paragraph xml-lang="en-US" id="par_id3150474" role="paragraph"><ahelp hid="HID_FUNC_STANDNORMVERT">Returns the standard normal cumulative distribution function. The distribution has a mean of zero and a standard deviation of one.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id8652302" role="paragraph">It is GAUSS(x)=NORMSDIST(x)-0.5</paragraph> - <paragraph xml-lang="en-US" id="hd_id3155083" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3158411" role="code">NORMSDIST(Number)</paragraph> <paragraph xml-lang="en-US" id="par_id3154950" role="paragraph"> <emph>Number</emph> is the value to which the standard normal cumulative distribution is calculated.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153228" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3155984" role="paragraph"> <item type="input">=NORMSDIST(1)</item> returns 0.84. The area below the standard normal distribution curve to the left of X value 1 is 84% of the total area.</paragraph> </section> @@ -305,13 +305,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STD_NORMDIST_MS" id="bm_id2945269" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2947538" role="heading" level="2">NORM.S.DIST</paragraph> <paragraph xml-lang="en-US" id="par_id2950474" role="paragraph"><ahelp hid="HID_FUNC_STD_NORMDIST_MS">Returns the standard normal cumulative distribution function. The distribution has a mean of zero and a standard deviation of one.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2955083" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2958411" role="code">NORM.S.DIST(Number; Cumulative)</paragraph> <paragraph xml-lang="en-US" id="par_id2954950" role="paragraph"> <emph>Number</emph> is the value to which the standard normal cumulative distribution is calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id2954951" role="paragraph"> <emph>Cumulative</emph> 0 or FALSE calculates the probability density function. Any other value or TRUE calculates the cumulative distribution function.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2993228" role="heading" level="3">Examples</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2955984" role="paragraph"> <item type="input">=NORM.S.DIST(1;0)</item> returns 0.2419707245.</paragraph> <paragraph xml-lang="en-US" id="par_id2955985" role="paragraph"> @@ -323,13 +323,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STEIGUNG" id="bm_id3153716" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3152592" role="heading" level="2">SLOPE</paragraph> <paragraph xml-lang="en-US" id="par_id3150386" role="paragraph"><ahelp hid="HID_FUNC_STEIGUNG">Returns the slope of the linear regression line.</ahelp> The slope is adapted to the data points set in the y and x values.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3154315" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149819" role="code">SLOPE(DataY; DataX)</paragraph> <paragraph xml-lang="en-US" id="par_id3083446" role="paragraph"> <emph>DataY</emph> is the array or matrix of Y data.</paragraph> <paragraph xml-lang="en-US" id="par_id3152375" role="paragraph"> <emph>DataX</emph> is the array or matrix of X data.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3146061" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3152480" role="paragraph"> <item type="input">=SLOPE(A1:A50;B1:B50)</item> </paragraph> @@ -341,13 +341,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STFEHLERYX" id="bm_id3150964" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3155836" role="heading" level="2">STEYX</paragraph> <paragraph xml-lang="en-US" id="par_id3149446" role="paragraph"><ahelp hid="HID_FUNC_STFEHLERYX">Returns the standard error of the predicted y value for each x in the regression.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3147562" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3151267" role="code">STEYX(DataY; DataX)</paragraph> <paragraph xml-lang="en-US" id="par_id3147313" role="paragraph"> <emph>DataY</emph> is the array or matrix of Y data.</paragraph> <paragraph xml-lang="en-US" id="par_id3156097" role="paragraph"> <emph>DataX</emph> is the array or matrix of X data.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3145204" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3156131" role="paragraph"> <item type="input">=STEYX(A1:A50;B1:B50)</item> </paragraph> @@ -359,11 +359,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMQUADABW" id="bm_id3156317" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3150873" role="heading" level="2">DEVSQ</paragraph> <paragraph xml-lang="en-US" id="par_id3154748" role="paragraph"><ahelp hid="HID_FUNC_SUMQUADABW">Returns the sum of squares of deviations based on a sample mean.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3156121" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3146790" role="code">DEVSQ(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3155995" role="paragraph"> <emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges representing a sample.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3150254" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149136" role="paragraph"> <item type="input">=DEVSQ(A1:A50)</item> </paragraph> @@ -375,13 +375,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TINV" id="bm_id3153155" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3149579" role="heading" level="2">TINV</paragraph> <paragraph xml-lang="en-US" id="par_id3143232" role="paragraph"><ahelp hid="HID_FUNC_TINV">Returns the inverse of the t-distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3155101" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149289" role="code">TINV(Number; DegreesFreedom)</paragraph> <paragraph xml-lang="en-US" id="par_id3154070" role="paragraph"> <emph>Number</emph> is the probability associated with the two-tailed t-distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3155315" role="paragraph"> <emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153885" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3156010" role="paragraph"> <item type="input">=TINV(0.1;6)</item> returns 1.94</paragraph> </section> @@ -393,11 +393,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TINV_MS" id="bm_id2953155" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2949579" role="heading" level="2">T.INV</paragraph> <paragraph xml-lang="en-US" id="par_id2943232" role="paragraph"><ahelp hid="HID_FUNC_TINV_MS">Returns the one tailed inverse of the t-distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2955101" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2949289" role="code">T.INV(Number; DegreesFreedom)</paragraph> <paragraph xml-lang="en-US" id="par_id2954070" role="paragraph"><emph>Number</emph> is the probability associated with the one-tailed t-distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2955315" role="paragraph"><emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2953885" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2956010" role="paragraph"><item type="input">=T.INV(0.1;6)</item> returns -1.4397557473.</paragraph> </section> <section id="tdotinvdot2t"> @@ -408,11 +408,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TINV_2T" id="bm_id2853155" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2849579" role="heading" level="2">T.INV.2T</paragraph> <paragraph xml-lang="en-US" id="par_id2843232" role="paragraph"><ahelp hid="HID_FUNC_TINV_2T">Calculates the inverse of the two-tailed Student's T Distribution </ahelp>, which is a continuous probability distribution that is frequently used for testing hypotheses on small sample data sets.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2855101" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2849289" role="code">T.INV.2T(Number; DegreesFreedom)</paragraph> <paragraph xml-lang="en-US" id="par_id2854070" role="paragraph"><emph>Number</emph> is the probability associated with the two-tailed t-distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2855315" role="paragraph"><emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2853885" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2856010" role="paragraph"><item type="input">=T.INV.2T(0.25; 10)</item> returns 1.221255395.</paragraph> </section> <section id="ttest"> @@ -421,7 +421,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TTEST" id="bm_id3153981" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3154129" role="heading" level="2">TTEST</paragraph> <paragraph xml-lang="en-US" id="par_id3159184" role="paragraph"><ahelp hid="HID_FUNC_TTEST">Returns the probability associated with a Student's t-Test.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3147257" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3151175" role="code">TTEST(Data1; Data2; Mode; Type)</paragraph> <paragraph xml-lang="en-US" id="par_id3149202" role="paragraph"> <emph>Data1</emph> is the dependent array or range of data for the first record.</paragraph> @@ -431,7 +431,7 @@ <emph>Mode</emph> = 1 calculates the one-tailed test, <emph>Mode</emph> = 2 the two- tailed test.</paragraph> <paragraph xml-lang="en-US" id="par_id3155327" role="paragraph"> <emph>Type</emph> is the kind of t-test to perform. Type 1 means paired. Type 2 means two samples, equal variance (homoscedastic). Type 3 means two samples, unequal variance (heteroscedastic).</paragraph> - <paragraph xml-lang="en-US" id="hd_id3159342" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150119" role="paragraph"> <item type="input">=TTEST(A1:A50;B1:B50;2;2)</item> </paragraph> @@ -443,13 +443,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TTEST_MS" id="bm_id2953981" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2954129" role="heading" level="2">T.TEST</paragraph> <paragraph xml-lang="en-US" id="par_id2959184" role="paragraph"><ahelp hid="HID_FUNC_TTEST_MS">Returns the probability associated with a Student's t-Test.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2947257" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2951175" role="code">T.TEST(Data1; Data2; Mode; Type)</paragraph> <paragraph xml-lang="en-US" id="par_id2949202" role="paragraph"><emph>Data1</emph> is the dependent array or range of data for the first record.</paragraph> <paragraph xml-lang="en-US" id="par_id2945666" role="paragraph"><emph>Data2</emph> is the dependent array or range of data for the second record.</paragraph> <paragraph xml-lang="en-US" id="par_id2953903" role="paragraph"><emph>Mode</emph> = 1 calculates the one-tailed test, <emph>Mode</emph> = 2 the two- tailed test.</paragraph> <paragraph xml-lang="en-US" id="par_id2955327" role="paragraph"><emph>Type</emph> is the kind of t-test to perform. Type 1 means paired. Type 2 means two samples, equal variance (homoscedastic). Type 3 means two samples, unequal variance (heteroscedastic).</paragraph> - <paragraph xml-lang="en-US" id="hd_id2959342" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2950119" role="paragraph"><item type="input">=T.TEST(A1:A50;B1:B50;2;2)</item></paragraph> </section> <section id="tdist"> @@ -459,7 +459,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TVERT" id="bm_id3153095" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3154930" role="heading" level="2">TDIST</paragraph> <paragraph xml-lang="en-US" id="par_id3153372" role="paragraph"><ahelp hid="HID_FUNC_TVERT">Returns the t-distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3149911" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3150521" role="code">TDIST(Number; DegreesFreedom; Mode)</paragraph> <paragraph xml-lang="en-US" id="par_id3146991" role="paragraph"> <emph>Number</emph> is the value for which the t-distribution is calculated.</paragraph> @@ -467,7 +467,7 @@ <emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3149340" role="paragraph"> <emph>Mode</emph> = 1 returns the one-tailed test, <emph>Mode</emph> = 2 returns the two-tailed test.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3159150" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3149773" role="paragraph"> <item type="input">=TDIST(12;5;1)</item> </paragraph> @@ -480,12 +480,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TDIST_MS" id="bm_id2953095" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2954930" role="heading" level="2">T.DIST</paragraph> <paragraph xml-lang="en-US" id="par_id2953372" role="paragraph"><ahelp hid="HID_FUNC_TDIST_MS">Returns the t-distribution.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2949911" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2950521" role="code">T.DIST(Number; DegreesFreedom; Cumulative)</paragraph> <paragraph xml-lang="en-US" id="par_id2946991" role="paragraph"><emph>Number</emph> is the value for which the t-distribution is calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id2948824" role="paragraph"><emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2949340" role="paragraph"><emph>Cumulative</emph> = 0 or FALSE returns the probability density function, 1 or TRUE returns the cumulative distribution function.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2959150" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2949773" role="paragraph"><item type="input">=T.DIST(1; 10; TRUE)</item> returns 0.8295534338</paragraph> </section> <section id="tdotdistdot2t"> @@ -496,11 +496,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TDIST_2T" id="bm_id2853095" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2854930" role="heading" level="2">T.DIST.2T</paragraph> <paragraph xml-lang="en-US" id="par_id2853372" role="paragraph"><ahelp hid="HID_FUNC_TDIST_2T">Calculates the two-tailed Student's T Distribution, which is a continuous probability distribution that is frequently used for testing hypotheses on small sample data sets.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2849911" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2850521" role="code">T.DIST.2T(Number; DegreesFreedom)</paragraph> <paragraph xml-lang="en-US" id="par_id2846991" role="paragraph"><emph>Number</emph> is the value for which the t-distribution is calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id2848824" role="paragraph"><emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2859150" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2849773" role="paragraph"><item type="input">=T.DIST.2T(1; 10)</item> returns 0.3408931323.</paragraph> </section> <section id="tdotdistdotrt"> @@ -511,11 +511,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TDIST_RT" id="bm_id273095" localize="false"/> <paragraph xml-lang="en-US" id="hd_id274930" role="heading" level="2">T.DIST.RT</paragraph> <paragraph xml-lang="en-US" id="par_id2753372" role="paragraph"><ahelp hid="HID_FUNC_TDIST_RT">Calculates the right-tailed Student's T Distribution, which is a continuous probability distribution that is frequently used for testing hypotheses on small sample data sets.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2749911" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2750521" role="code">T.DIST.RT(Number; DegreesFreedom)</paragraph> <paragraph xml-lang="en-US" id="par_id2746991" role="paragraph"><emph>Number</emph> is the value for which the t-distribution is calculated.</paragraph> <paragraph xml-lang="en-US" id="par_id2748824" role="paragraph"><emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2759150" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2749773" role="paragraph"><item type="input">=T.DIST.RT(1; 10)</item> returns 0.1704465662.</paragraph> </section> <section id="var"> @@ -525,11 +525,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIANZ" id="bm_id3154898" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153828" role="heading" level="2">VAR</paragraph> <paragraph xml-lang="en-US" id="par_id3159165" role="paragraph"><ahelp hid="HID_FUNC_VARIANZ">Estimates the variance based on a sample.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3154286" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3153054" role="code">VAR(Number1 ; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3148938" role="paragraph"> <emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges representing a sample based on an entire population.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3147233" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153575" role="paragraph"> <item type="input">=VAR(A1:A50)</item> </paragraph> @@ -542,10 +542,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VAR_S" id="bm_id2954898" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2953828" role="heading" level="2">VAR.S</paragraph> <paragraph xml-lang="en-US" id="par_id2959165" role="paragraph"><ahelp hid="HID_FUNC_VAR_S">Estimates the variance based on a sample.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2954286" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2953054" role="code">VAR.S(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id2948938" role="paragraph"><emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges representing a sample based on an entire population.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2947233" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2953575" role="paragraph"><item type="input">=VAR.S(A1:A50)</item></paragraph> </section> <section id="vara"> @@ -554,11 +554,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIANZA" id="bm_id3148473" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3151045" role="heading" level="2">VARA</paragraph> <paragraph xml-lang="en-US" id="par_id3155122" role="paragraph"><ahelp hid="HID_FUNC_VARIANZA">Estimates a variance based on a sample. The value of text is 0.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3149176" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149999" role="code">VARA(Value1; Value2; ...; Value30)</paragraph> <paragraph xml-lang="en-US" id="par_id3158421" role="paragraph"> <emph>Value1, Value2, ..., Value30</emph> are values or ranges representing a sample derived from an entire population. Text has the value 0.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3149160" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3154279" role="paragraph"> <item type="input">=VARA(A1:A50)</item> </paragraph> @@ -569,11 +569,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIANZEN" id="bm_id3152359" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3166441" role="heading" level="2">VARP</paragraph> <paragraph xml-lang="en-US" id="par_id3159199" role="paragraph"><ahelp hid="HID_FUNC_VARIANZEN">Calculates a variance based on the entire population.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3150706" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3147282" role="code">VARP(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id3149793" role="paragraph"> <emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges representing an entire population.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3152939" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153385" role="paragraph"> <item type="input">=VARP(A1:A50)</item> </paragraph> @@ -585,10 +585,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VAR_P_MS" id="bm_id2952359" localize="false"/> <paragraph xml-lang="en-US" id="hd_id2966441" role="heading" level="2">VAR.P</paragraph> <paragraph xml-lang="en-US" id="par_id2959199" role="paragraph"><ahelp hid="HID_FUNC_VAR_P_MS">Calculates a variance based on the entire population.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id2950706" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2947282" role="code">VAR.P(Number1; Number2; ...; Number30)</paragraph> <paragraph xml-lang="en-US" id="par_id2949793" role="paragraph"><emph>Number1, Number2, ..., Number30</emph> are numerical values or ranges representing an entire population.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2952939" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2953385" role="paragraph"><item type="input">=VAR.P(A1:A50)</item></paragraph> </section> <section id="varpa"> @@ -597,11 +597,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIANZENA" id="bm_id3159276" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3153688" role="heading" level="2">VARPA</paragraph> <paragraph xml-lang="en-US" id="par_id3149109" role="paragraph"><ahelp hid="HID_FUNC_VARIANZENA">Calculates the variance based on the entire population. The value of text is 0.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3152880" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149967" role="code">VARPA(Value1; Value2; ...; Value30)</paragraph> <paragraph xml-lang="en-US" id="par_id3149920" role="paragraph"> <emph>Value1, Value2, ..., Value30</emph> are values or ranges representing an entire population.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3154862" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3156203" role="paragraph"> <item type="input">=VARPA(A1:A50)</item> </paragraph> @@ -613,13 +613,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIATIONEN" id="bm_id3154610" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3154599" role="heading" level="2">PERMUT</paragraph> <paragraph xml-lang="en-US" id="par_id3154334" role="paragraph"><ahelp hid="HID_FUNC_VARIATIONEN">Returns the number of permutations for a given number of objects.</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3149422" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3148466" role="code">PERMUT(Count1; Count2)</paragraph> <paragraph xml-lang="en-US" id="par_id3148656" role="paragraph"> <emph>Count1</emph> is the total number of objects.</paragraph> <paragraph xml-lang="en-US" id="par_id3150826" role="paragraph"> <emph>Count2</emph> is the number of objects in each permutation.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153351" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3150424" role="paragraph"> <item type="input">=PERMUT(6;3)</item> returns 120. There are 120 different possibilities, to pick a sequence of 3 playing cards out of 6 playing cards.</paragraph> </section> @@ -629,13 +629,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIATIONEN2" id="bm_id3153531" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3143276" role="heading" level="2">PERMUTATIONA</paragraph> <paragraph xml-lang="en-US" id="par_id3144759" role="paragraph"><ahelp hid="HID_FUNC_VARIATIONEN2">Returns the number of permutations for a given number of objects (repetition allowed).</ahelp></paragraph> - <paragraph xml-lang="en-US" id="hd_id3145598" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149298" role="code">PERMUTATIONA(Count1; Count2)</paragraph> <paragraph xml-lang="en-US" id="par_id3156139" role="paragraph"> <emph>Count1</emph> is the total number of objects.</paragraph> <paragraph xml-lang="en-US" id="par_id3149519" role="paragraph"> <emph>Count2</emph> is the number of objects in each permutation.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3151382" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153949" role="paragraph">How often can 2 objects be selected from a total of 11 objects?</paragraph> <paragraph xml-lang="en-US" id="par_id3149233" role="paragraph"> <item type="input">=PERMUTATIONA(11;2)</item> returns 121.</paragraph> @@ -648,7 +648,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WAHRSCHBEREICH" id="bm_id3152963" localize="false"/> <paragraph xml-lang="en-US" id="hd_id3152952" role="heading" level="2">PROB</paragraph> <paragraph xml-lang="en-US" id="par_id3154110" role="paragraph"><ahelp hid="HID_FUNC_WAHRSCHBEREICH">Returns the probability that values in a range are between two limits.</ahelp> If there is no <item type="literal">End</item> value, this function calculates the probability based on the principle that the Data values are equal to the value of <item type="literal">Start</item>.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3146810" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3147330" role="code">PROB(Data; Probability; Start; End)</paragraph> <paragraph xml-lang="en-US" id="par_id3154573" role="paragraph"> <emph>Data</emph> is the array or range of data in the sample.</paragraph> @@ -658,7 +658,7 @@ <emph>Start</emph> is the start value of the interval whose probabilities are to be summed.</paragraph> <paragraph xml-lang="en-US" id="par_id3153694" role="paragraph"> <emph>End</emph> (optional) is the end value of the interval whose probabilities are to be summed. If this parameter is missing, the probability for the <emph>Start</emph> value is calculated.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3147574" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3153666" role="paragraph"> <item type="input">=PROB(A1:A50;B1:B50;50;60)</item> returns the probability with which a value within the range of A1:A50 is also within the limits between 50 and 60. Every value within the range of A1:A50 has a probability within the range of B1:B50.</paragraph> </section> @@ -671,7 +671,7 @@ <paragraph xml-lang="en-US" id="par_id0305200911372767" role="paragraph">The Weibull distribution is a continuous probability distribution, with parameters Alpha > 0 (shape) and Beta > 0 (scale).</paragraph> <paragraph xml-lang="en-US" id="par_id0305200911372777" role="paragraph">If C is 0, WEIBULL calculates the probability density function.</paragraph> <paragraph xml-lang="en-US" id="par_id0305200911372743" role="paragraph">If C is 1, WEIBULL calculates the cumulative distribution function.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3159393" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3154478" role="code">WEIBULL(Number; Alpha; Beta; C)</paragraph> <paragraph xml-lang="en-US" id="par_id3151317" role="paragraph"> <emph>Number</emph> is the value at which to calculate the Weibull distribution.</paragraph> @@ -681,7 +681,7 @@ <emph>Beta</emph> is the scale parameter of the Weibull distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id3154825" role="paragraph"> <emph>C</emph> indicates the type of function.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3153794" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3146077" role="paragraph"> <item type="input">=WEIBULL(2;1;1;1)</item> returns 0.86.</paragraph> <paragraph xml-lang="en-US" id="par_id0305200911372899" role="paragraph">See also the <link href="https://wiki.documentfoundation.org/Documentation/How_Tos/Calc:_WEIBULL_function" name="wiki.documentfoundation.org Documentation/HowTo/Calc/WEIBULL function">Wiki page</link>.</paragraph> @@ -696,13 +696,13 @@ <paragraph xml-lang="en-US" id="par_id2905200911372767" role="paragraph">The Weibull distribution is a continuous probability distribution, with parameters Alpha > 0 (shape) and Beta > 0 (scale). </paragraph> <paragraph xml-lang="en-US" id="par_id2905200911372777" role="paragraph">If C is 0, WEIBULL.DIST calculates the probability density function.</paragraph> <paragraph xml-lang="en-US" id="par_id2905200911372743" role="paragraph">If C is 1, WEIBULL.DIST calculates the cumulative distribution function.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2959393" role="heading" level="3">Syntax</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id2954478" role="code">WEIBULL.DIST(Number; Alpha; Beta; C)</paragraph> <paragraph xml-lang="en-US" id="par_id2951317" role="paragraph"><emph>Number</emph> is the value at which to calculate the Weibull distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2958436" role="paragraph"><emph>Alpha </emph>is the shape parameter of the Weibull distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2954668" role="paragraph"><emph>Beta</emph> is the scale parameter of the Weibull distribution.</paragraph> <paragraph xml-lang="en-US" id="par_id2954825" role="paragraph"><emph>C</emph> indicates the type of function.</paragraph> - <paragraph xml-lang="en-US" id="hd_id2953794" role="heading" level="3">Example</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id2946077" role="paragraph"><item type="input">=WEIBULL.DIST(2;1;1;1)</item> returns 0.8646647168.</paragraph> <paragraph xml-lang="en-US" id="par_id2905200911372899" role="paragraph">See also the <link href="https://wiki.documentfoundation.org/Documentation/How_Tos/Calc:_WEIBULL_function" name="wiki.documentfoundation.org Documentation/HowTo/Calc/WEIBULL function">Wiki page</link>.</paragraph> </section> diff --git a/source/text/scalc/01/04060199.xhp b/source/text/scalc/01/04060199.xhp index 0e27de883e..2928f11e99 100644 --- a/source/text/scalc/01/04060199.xhp +++ b/source/text/scalc/01/04060199.xhp @@ -52,7 +52,7 @@ <paragraph role="tablehead" id="par_id3157982" xml-lang="en-US">Name</paragraph> </tablecell> <tablecell colspan="" rowspan=""> -<paragraph role="tablehead" id="par_id3159096" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> </tablecell> </tablerow> <tablerow> @@ -144,7 +144,7 @@ <paragraph role="tablehead" id="par_id3150743" xml-lang="en-US">Name</paragraph> </tablecell> <tablecell colspan="" rowspan=""> -<paragraph role="tablehead" id="par_id3146877" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> </tablecell> </tablerow> <tablerow> @@ -225,7 +225,7 @@ <paragraph role="tablehead" id="par_id3153048" xml-lang="en-US">Name</paragraph> </tablecell> <tablecell colspan="" rowspan=""> -<paragraph role="tablehead" id="par_id3149001" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> </tablecell> </tablerow> <tablerow> @@ -254,7 +254,7 @@ <paragraph role="tablehead" id="par_id3152822" xml-lang="en-US">Name</paragraph> </tablecell> <tablecell colspan="" rowspan=""> -<paragraph role="tablehead" id="par_id3154949" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> </tablecell> </tablerow> <tablerow> diff --git a/source/text/scalc/01/common_func.xhp b/source/text/scalc/01/common_func.xhp new file mode 100644 index 0000000000..b3803f646b --- /dev/null +++ b/source/text/scalc/01/common_func.xhp @@ -0,0 +1,25 @@ +<?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/. + * + --> + <meta> + <topic id="commonfunctionsytaxexample" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Common Syntax and example</title> + <filename>/text/scalc/01/common_func.xhp</filename> + </topic> + </meta> + <body> + <section id="sectionsyntax"> + <paragraph id="hd_id3152015" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> + </section> + <section id="sectionexample"> + <paragraph id="hd_id281171" role="heading" level="3" xml-lang="en-US">Example</paragraph> + </section> +</body> +</helpdocument> diff --git a/source/text/scalc/01/ex_data_stat_func.xhp b/source/text/scalc/01/ex_data_stat_func.xhp index a0f2bc98dd..bb4f701b1e 100644 --- a/source/text/scalc/01/ex_data_stat_func.xhp +++ b/source/text/scalc/01/ex_data_stat_func.xhp @@ -18,7 +18,7 @@ <body> <section id="ex_func_average"> -<paragraph id="hd_id2657394931588" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="hd_id2609201512474295" role="heading" level="4" xml-lang="en-US">Consider the following table</paragraph> <table id="table_averageif_example"> <tablerow> diff --git a/source/text/scalc/01/exponsmooth_embd.xhp b/source/text/scalc/01/exponsmooth_embd.xhp index 938a1429f9..fcaf56dc16 100644 --- a/source/text/scalc/01/exponsmooth_embd.xhp +++ b/source/text/scalc/01/exponsmooth_embd.xhp @@ -222,7 +222,7 @@ </section> <section id="exampledata"> - <paragraph id="hd_id0603201610005796" role="heading" level="2" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="hd_id0603201610005723" role="paragraph" xml-lang="en-US">The table below contains a timeline and its associated values:</paragraph> <table id="Tabela3"> <tablerow> diff --git a/source/text/scalc/01/func_aggregate.xhp b/source/text/scalc/01/func_aggregate.xhp index 2c68be5ab2..18e00aa4d7 100644 --- a/source/text/scalc/01/func_aggregate.xhp +++ b/source/text/scalc/01/func_aggregate.xhp @@ -30,7 +30,7 @@ </section> <paragraph id="par_id2209201514174453" role="note" xml-lang="en-US">AGGREGATE function is applied to vertical ranges of data with activated AutoFilter. If AutoFilter is not activated, automatic recalculation of the function result does not work for newly hidden rows. It is not supposed to work with horizontal ranges, however it can be applied to them as well, but with limitations. In particular, the AGGREGATE function applied to a horizontal data range does not recognize hiding columns, however correctly omits errors and results of SUBTOTAL and other AGGREGATE functions embedded into the row. </paragraph> -<paragraph id="hd_id239693194826384" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id200801176228491" role="code" xml-lang="en-US">AGGREGATE(Function; Option; Ref1 [; Ref2 [; …]])</paragraph> <paragraph id="par_id2309201516102726" role="paragraph" xml-lang="en-US">or</paragraph> <paragraph id="par_id30181907128680" role="code" xml-lang="en-US">AGGREGATE(Function; Option; Array [; k])</paragraph> @@ -282,7 +282,7 @@ <paragraph id="par_id2309201515555812" role="note" xml-lang="en-US">For using column labels “Automatically find columns and rows labels” function needs to be enabled.</paragraph> <paragraph id="par_id2209201514174370" role="paragraph" xml-lang="en-US"><emph>k</emph> – obligatory argument for the following functions: LARGE, SMALL, PERCENTILE.INC, QUARTILE.INC, PERCENTILE.EXC, QUARTILE.EXC. It is a numeric argument, which must correspond to the second argument of these functions.</paragraph> -<paragraph id="hd_id198071265128228" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <table id="Table_example_aggregate"> <tablerow> diff --git a/source/text/scalc/01/func_averageif.xhp b/source/text/scalc/01/func_averageif.xhp index fc30cc190b..5498a89efa 100644 --- a/source/text/scalc/01/func_averageif.xhp +++ b/source/text/scalc/01/func_averageif.xhp @@ -26,7 +26,7 @@ <paragraph id="hd_id16852304621982" role="heading" level="2" xml-lang="en-US"><variable id="averageif_head"><link href="text/scalc/01/func_averageif.xhp">AVERAGEIF</link></variable> function</paragraph> <paragraph id="par_id7281266615152" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="averageif_des">Returns the arithmetic mean of all cells in a range that satisfy a given condition. The AVERAGEIF function sums up all the results that match the logical test and divides this sum by the quantity of selected values.</variable></ahelp></paragraph> </section> -<paragraph id="hd_id210572014129502" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id200801176228491" role="code" xml-lang="en-US">AVERAGEIF(Range; Criterion [; Average_Range ])</paragraph> <paragraph id="par_id15226321619829" role="paragraph" xml-lang="en-US"><emph>Range</emph> – required argument. An array, a name of named range or a label of a column or a row containing numbers for averaging or numbers or text for the condition.</paragraph> <paragraph id="par_id24499731228013" role="paragraph" xml-lang="en-US"><emph>Criterion</emph> – required argument. A condition in the form of expression or a cell reference with expression that defines what cells should be used to calculate the mean. The expression can contain text, numbers, regular expressions (if enabled in calculation options) or wildcards (if enabled in calculation options).</paragraph> diff --git a/source/text/scalc/01/func_averageifs.xhp b/source/text/scalc/01/func_averageifs.xhp index cd6be6eabc..e127b457c5 100644 --- a/source/text/scalc/01/func_averageifs.xhp +++ b/source/text/scalc/01/func_averageifs.xhp @@ -26,7 +26,7 @@ <paragraph id="hd_id537445374453744" role="heading" level="2" xml-lang="en-US"><variable id="averageifs_head"><link href="text/scalc/01/func_averageifs.xhp">AVERAGEIFS</link></variable> function</paragraph> <paragraph id="par_id538405384053840" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="averageifs_des">Returns the arithmetic mean of all cells in a range that satisfy given multiple criteria. The AVERAGEIFS function sums up all the results that match the logical tests and divides this sum by the quantity of selected values.</variable></ahelp></paragraph> </section> -<paragraph id="hd_id538895388953889" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id21050267713178" role="code" xml-lang="en-US">AVERAGEIFS(<embedvar href="text/scalc/01/ex_data_stat_func.xhp#args" markup="ignore"/>)</paragraph> <paragraph id="par_id165832700711773" role="paragraph" xml-lang="en-US"><emph>Func_range</emph> – required argument. It is a range of cells, a name of a named range or a label of a column or a row containing values for calculating the mean.</paragraph> diff --git a/source/text/scalc/01/func_countifs.xhp b/source/text/scalc/01/func_countifs.xhp index 82c3c7716c..1a5253ee32 100644 --- a/source/text/scalc/01/func_countifs.xhp +++ b/source/text/scalc/01/func_countifs.xhp @@ -27,7 +27,7 @@ <paragraph id="hd_id456845684568" role="heading" level="2" xml-lang="en-US"><variable id="countifs_head"><link href="text/scalc/01/func_countifs.xhp">COUNTIFS</link></variable> function</paragraph> <paragraph id="par_id462646264626" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="countifs_des">Returns the count of cells that meet criteria in multiple ranges.</variable></ahelp></paragraph> </section> -<paragraph id="hd_id465746574657" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id27421466710275" role="code" xml-lang="en-US">COUNTIFS(Range1; Criterion1 [; Range2; Criterion2 [; ...]])</paragraph> <paragraph id="par_id242131304318587" role="paragraph" xml-lang="en-US"><emph>Range1</emph> – required argument. It is a range of cells, a name of a named range or a label of a column or a row containing values for counting and finding the corresponding criterion.</paragraph> <embed href="text/scalc/01/ex_data_stat_func.xhp#par00"/> diff --git a/source/text/scalc/01/func_date.xhp b/source/text/scalc/01/func_date.xhp index 14e389a2cc..7ab7182e11 100644 --- a/source/text/scalc/01/func_date.xhp +++ b/source/text/scalc/01/func_date.xhp @@ -34,7 +34,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DATUM" id="bm_id3149022" localize="false"/><paragraph role="heading" id="hd_id3155511" xml-lang="en-US" level="2"><variable id="date"><link href="text/scalc/01/func_date.xhp">DATE</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3153551" xml-lang="en-US"><ahelp hid="HID_FUNC_DATUM">This function calculates a date specified by year, month, day and displays it in the cell's formatting.</ahelp> The default format of a cell containing the DATE function is the date format, but you can format the cells with any other number format.</paragraph> -<paragraph role="heading" id="hd_id3148590" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3150474" xml-lang="en-US">DATE(Year; Month; Day)</paragraph> <paragraph role="paragraph" id="par_id3152815" xml-lang="en-US"> <emph>Year</emph> is an integer between 1583 and 9957 or between 0 and 99.</paragraph> @@ -44,7 +44,7 @@ <paragraph role="paragraph" id="par_id3153183" xml-lang="en-US"> <emph>Day</emph> is an integer indicating the day of the month.</paragraph> <paragraph role="paragraph" id="par_id3156260" xml-lang="en-US">If the values for month and day are out of bounds, they are carried over to the next digit. If you enter <item type="input">=DATE(00;12;31)</item> the result will be 2000-12-31. If, on the other hand, you enter <item type="input">=DATE(00;13;31)</item> the result will be 2001-01-31.</paragraph> -<paragraph role="heading" id="hd_id3147477" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3152589" xml-lang="en-US"> <item type="input">=DATE(00;1;31)</item> yields 1/31/00 if the cell format setting is MM/DD/YY.</paragraph> </body> diff --git a/source/text/scalc/01/func_datedif.xhp b/source/text/scalc/01/func_datedif.xhp index 0f584ead1f..c7667acfba 100644 --- a/source/text/scalc/01/func_datedif.xhp +++ b/source/text/scalc/01/func_datedif.xhp @@ -23,7 +23,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DATEDIF" id="bm_id3149022" localize="false"/><paragraph role="heading" id="hd_id3155511" xml-lang="en-US" level="2"><variable id="datedif"><link href="text/scalc/01/func_datedif.xhp">DATEDIF</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3153551" xml-lang="en-US"><ahelp hid="HID_FUNC_DATEDIF">This function returns the number of whole days, months or years between Start date and End date.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3148590" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3150474" xml-lang="en-US">DATEDIF(Start date; End date; Interval)</paragraph> <paragraph role="paragraph" id="par_id3152815" xml-lang="en-US"> <emph>Start date</emph> is the date from when the calculation is carried out.</paragraph> @@ -92,7 +92,7 @@ </tablerow> </table> -<paragraph role="heading" id="hd_id3147477" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3152589" xml-lang="en-US"> Birthday calculation. A man was born on 1974-04-17. Today is 2012-06-13.</paragraph> <paragraph role="paragraph" id="par_id3252589" xml-lang="en-US"><item type="input">=DATEDIF("1974-04-17";"2012-06-13";"y")</item> yields 38.</paragraph> diff --git a/source/text/scalc/01/func_datevalue.xhp b/source/text/scalc/01/func_datevalue.xhp index 7bd9df8077..06d27a0947 100644 --- a/source/text/scalc/01/func_datevalue.xhp +++ b/source/text/scalc/01/func_datevalue.xhp @@ -35,13 +35,13 @@ <paragraph xml-lang="en-US" id="par_id3145087" role="paragraph"><ahelp hid="HID_FUNC_DATWERT">Returns the internal date number for text in quotes.</ahelp></paragraph> <paragraph xml-lang="en-US" id="par_id3149281" role="paragraph">The internal date number is returned as a number. The number is determined by the date system that is used by $[officename] to calculate dates.</paragraph> <paragraph xml-lang="en-US" id="par_id0119200903491982" role="paragraph">If the text string also includes a time value, DATEVALUE only returns the integer part of the conversion.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3156294" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149268" role="code">DATEVALUE("Text")</paragraph> <paragraph xml-lang="en-US" id="par_id3154819" role="paragraph"> <emph>Text</emph> is a valid date expression and must be entered with quotation marks.</paragraph> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> - <paragraph xml-lang="en-US" id="hd_id3156309" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3155841" role="paragraph"> <item type="input">=DATEVALUE("1954-07-20")</item> yields 19925.</paragraph> </body> diff --git a/source/text/scalc/01/func_day.xhp b/source/text/scalc/01/func_day.xhp index f5501cc4a8..c9f2c07e8f 100644 --- a/source/text/scalc/01/func_day.xhp +++ b/source/text/scalc/01/func_day.xhp @@ -30,12 +30,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TAG" id="bm_id3151283" localize="false"/><paragraph role="heading" id="hd_id3147317" xml-lang="en-US" level="2"><variable id="day"><link href="text/scalc/01/func_day.xhp">DAY</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3147584" xml-lang="en-US"><ahelp hid="HID_FUNC_TAG">Returns the day of given date value.</ahelp> The day is returned as an integer between 1 and 31. You can also enter a negative date/time value.</paragraph> -<paragraph role="heading" id="hd_id3150487" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3149430" xml-lang="en-US">DAY(Number)</paragraph> <paragraph role="paragraph" id="par_id3149443" xml-lang="en-US"><emph>Number</emph> is the internal date number.</paragraph> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph role="heading" id="hd_id3163809" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3151200" xml-lang="en-US"><item type="input">=DAY(1)</item> returns 31 (since $[officename] starts counting at zero from December 30, 1899)</paragraph> <paragraph role="paragraph" id="par_id3154130" xml-lang="en-US"><item type="input">=DAY(NOW())</item> returns the current day.</paragraph> <paragraph role="paragraph" id="par_id3159190" xml-lang="en-US"><item type="input">=DAY(C4)</item> returns 5 if you enter 1901-08-05 in cell C4 (the date value might get formatted differently after you press Enter).</paragraph> diff --git a/source/text/scalc/01/func_days.xhp b/source/text/scalc/01/func_days.xhp index a360c42ecd..9aebd01c46 100644 --- a/source/text/scalc/01/func_days.xhp +++ b/source/text/scalc/01/func_days.xhp @@ -29,13 +29,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TAGE" id="bm_id3148893" localize="false"/><paragraph role="heading" id="hd_id3151328" xml-lang="en-US" level="2"><variable id="days"><link href="text/scalc/01/func_days.xhp">DAYS</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3155139" xml-lang="en-US"><ahelp hid="HID_FUNC_TAGE">Calculates the difference between two date values.</ahelp> The result returns the number of days between the two days.</paragraph> -<paragraph role="heading" id="hd_id3155184" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3149578" xml-lang="en-US">DAYS(Date2; Date1)</paragraph> <paragraph role="paragraph" id="par_id3151376" xml-lang="en-US"> <emph>Date1</emph> is the start date, <emph>Date2</emph> is the end date. If <emph>Date2</emph> is an earlier date than <emph>Date1</emph> the result is a negative number.</paragraph> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph role="heading" id="hd_id3151001" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3159101" xml-lang="en-US"><item type="input">=DAYS("2010-01-01"; NOW())</item> returns the number of days from today until January 1, 2010.</paragraph> <paragraph role="paragraph" id="par_id3163720" xml-lang="en-US"><item type="input">=DAYS("1990-10-10";"1980-10-10")</item> returns 3652 days.</paragraph> </body> diff --git a/source/text/scalc/01/func_days360.xhp b/source/text/scalc/01/func_days360.xhp index 972413e9dd..15d822e909 100644 --- a/source/text/scalc/01/func_days360.xhp +++ b/source/text/scalc/01/func_days360.xhp @@ -29,13 +29,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TAGE360" id="bm_id3155906" localize="false"/><paragraph role="heading" id="hd_id3148555" xml-lang="en-US" level="2"><variable id="days360"><link href="text/scalc/01/func_days360.xhp">DAYS360</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3156032" xml-lang="en-US"><ahelp hid="HID_FUNC_TAGE360">Returns the difference between two dates based on the 360 day year used in interest calculations.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3155347" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3155313" xml-lang="en-US">DAYS360("Date1"; "Date2"; Type)</paragraph> <paragraph role="paragraph" id="par_id3145263" xml-lang="en-US">If <emph>Date2</emph> is earlier than <emph>Date1</emph>, the function will return a negative number.</paragraph> <paragraph role="paragraph" id="par_id3151064" xml-lang="en-US">The optional argument <emph>Type</emph> determines the type of difference calculation. If Type = 0 or if the argument is missing, the US method (NASD, National Association of Securities Dealers) is used. If Type <> 0, the European method is used.</paragraph> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph role="heading" id="hd_id3148641" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3156348" xml-lang="en-US"><item type="input">=DAYS360("2000-01-01";NOW())</item> returns the number of interest days from January 1, 2000 until today.</paragraph> </body> </helpdocument> diff --git a/source/text/scalc/01/func_eastersunday.xhp b/source/text/scalc/01/func_eastersunday.xhp index 4ffc6f5d58..9da7e92bcf 100644 --- a/source/text/scalc/01/func_eastersunday.xhp +++ b/source/text/scalc/01/func_eastersunday.xhp @@ -29,7 +29,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_OSTERSONNTAG" id="bm_id3156270" localize="false"/><paragraph role="heading" id="hd_id3152960" xml-lang="en-US" level="2"><variable id="eastersunday"><link href="text/scalc/01/func_eastersunday.xhp">EASTERSUNDAY</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3154570" xml-lang="en-US"><ahelp hid="HID_FUNC_OSTERSONNTAG">Returns the date of Easter Sunday for the entered year.</ahelp></paragraph> -<paragraph role="heading" id="hd_id9460127" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id2113711" xml-lang="en-US">EASTERSUNDAY(Year)</paragraph> <paragraph role="paragraph" id="par_id3938413" xml-lang="en-US"> <emph>Year</emph> is an integer between 1583 and 9956 or 0 and 99. You can also calculate other holidays by simple addition with this date.</paragraph> @@ -37,7 +37,7 @@ <paragraph role="paragraph" id="par_id3147521" xml-lang="en-US">Good Friday = EASTERSUNDAY(Year) - 2</paragraph> <paragraph role="paragraph" id="par_id3146072" xml-lang="en-US">Pentecost Sunday = EASTERSUNDAY(Year) + 49</paragraph> <paragraph role="paragraph" id="par_id3149553" xml-lang="en-US">Pentecost Monday = EASTERSUNDAY(Year) + 50</paragraph> -<paragraph role="heading" id="hd_id3155120" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3154472" xml-lang="en-US"><item type="input">=EASTERSUNDAY(2000)</item> returns 2000-04-23.</paragraph> <paragraph role="paragraph" id="par_id3150940" xml-lang="en-US"><item type="input">=EASTERSUNDAY(2000)+49</item> returns the internal serial number 36688. The result is 2000-06-11. Format the serial date number as a date, for example in the format YYYY-MM-DD.</paragraph> </body> diff --git a/source/text/scalc/01/func_edate.xhp b/source/text/scalc/01/func_edate.xhp index 4ad81b867a..8cc6846499 100644 --- a/source/text/scalc/01/func_edate.xhp +++ b/source/text/scalc/01/func_edate.xhp @@ -34,7 +34,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_EDATE" id="bm_id3150761" localize="false"/><paragraph role="heading" id="hd_id3151184" xml-lang="en-US" level="2"><variable id="edate"><link href="text/scalc/01/func_edate.xhp">EDATE</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3150880" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_EDATE">The result is a date which is a number of <emph>months</emph> away from the <emph>start date</emph>. Only months are considered; days are not used for calculation.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3154647" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3153212" xml-lang="en-US">EDATE(StartDate; Months)</paragraph> <paragraph role="paragraph" id="par_id3146860" xml-lang="en-US"> <emph>StartDate</emph> is a date.</paragraph> @@ -42,7 +42,7 @@ <emph>Months</emph> is the number of months before (negative) or after (positive) the start date.</paragraph> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph role="heading" id="hd_id3151289" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3155845" xml-lang="en-US">What date is one month prior to 2001-03-31?</paragraph> <paragraph role="paragraph" id="par_id3155999" xml-lang="en-US"> <item type="input">=EDATE("2001-03-31";-1)</item> returns the serial number 36950. Formatted as a date, this is 2001-02-28.</paragraph> diff --git a/source/text/scalc/01/func_eomonth.xhp b/source/text/scalc/01/func_eomonth.xhp index f48ddf57ce..19f98584be 100644 --- a/source/text/scalc/01/func_eomonth.xhp +++ b/source/text/scalc/01/func_eomonth.xhp @@ -34,13 +34,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_EOMONTH" id="bm_id3158439" localize="false"/><paragraph role="heading" id="hd_id3150991" xml-lang="en-US" level="2"><variable id="eomonth"><link href="text/scalc/01/func_eomonth.xhp">EOMONTH</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3152766" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_EOMONTH">Returns the date of the last day of a month which falls months away from the start date.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3150597" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3150351" xml-lang="en-US">EOMONTH(StartDate; Months)</paragraph> <paragraph role="paragraph" id="par_id3146787" xml-lang="en-US"> <emph>StartDate</emph> is a date (the starting point of the calculation).</paragraph> <paragraph role="paragraph" id="par_id3155615" xml-lang="en-US"> <emph>Months</emph> is the number of months before (negative) or after (positive) the start date.</paragraph> -<paragraph role="heading" id="hd_id3156335" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3154829" xml-lang="en-US">What is the last day of the month that falls 6 months after September 14 2001?</paragraph> <paragraph role="paragraph" id="par_id3156143" xml-lang="en-US"><item type="input">=EOMONTH(DATE(2001;9;14);6)</item> returns the serial number 37346. Formatted as a date, this is 2002-03-31.</paragraph> diff --git a/source/text/scalc/01/func_error_type.xhp b/source/text/scalc/01/func_error_type.xhp index 95f9d82b6d..8a95507cb6 100644 --- a/source/text/scalc/01/func_error_type.xhp +++ b/source/text/scalc/01/func_error_type.xhp @@ -29,7 +29,7 @@ <paragraph id="par_id350283502835028" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="error_type_des">Returns a number representing a specific Error type, or the error value #N/A, if there is no error. </variable></ahelp></paragraph> </section> -<paragraph id="hd_id351323513235132" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id1861223540440" role="code" xml-lang="en-US">ERROR.TYPE(Error_value)</paragraph> <paragraph id="par_id217737315" role="paragraph" xml-lang="en-US"><emph>Error_value</emph> – required argument. The error value or a reference to a cell, whose value needs to be processed.</paragraph> @@ -109,7 +109,7 @@ </table> <embed href="text/scalc/01/ODFF.xhp#odff"/> -<paragraph id="hd_id352113521135211" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="hd_id182972884627444" role="heading" level="4" xml-lang="en-US">Simple usage</paragraph> <paragraph id="par_id15812966716957" role="paragraph" xml-lang="en-US"><item type="input">=ERROR.TYPE(#N/A)</item></paragraph> <paragraph id="par_id280533214928308" role="paragraph" xml-lang="en-US">Returns 7, because 7 is the index number of the error value #N/A.</paragraph> diff --git a/source/text/scalc/01/func_forecastetsadd.xhp b/source/text/scalc/01/func_forecastetsadd.xhp index 86bd55da4c..4f76d245e9 100644 --- a/source/text/scalc/01/func_forecastetsadd.xhp +++ b/source/text/scalc/01/func_forecastetsadd.xhp @@ -29,7 +29,7 @@ <paragraph id="par_id0603201608440530" role="paragraph" xml-lang="en-US">FORECAST.ETS.ADD calculates with the model</paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#etsadd"/> -<paragraph id="hd_id0403201618594554" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id0403201618594544" role="code" xml-lang="en-US">FORECAST.ETS.ADD(targets, values, timeline, [period_length], [data_completion], [aggregation]) </paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#target"/> <embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> diff --git a/source/text/scalc/01/func_forecastetsmult.xhp b/source/text/scalc/01/func_forecastetsmult.xhp index 5439f049fc..491d18f236 100644 --- a/source/text/scalc/01/func_forecastetsmult.xhp +++ b/source/text/scalc/01/func_forecastetsmult.xhp @@ -30,7 +30,7 @@ <paragraph id="par_id0603201608440530" role="paragraph" xml-lang="en-US">FORECAST.ETS.MULT calculates with the model </paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#etsmult"/> -<paragraph id="hd_id0403201618594554" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id0403201618594544" role="code" xml-lang="en-US">FORECAST.ETS.MULT(targets, values, timeline, [period_length], [data_completion], [aggregation]) </paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#target"/> <embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> diff --git a/source/text/scalc/01/func_forecastetspiadd.xhp b/source/text/scalc/01/func_forecastetspiadd.xhp index e883943a8a..3cc54a9d40 100644 --- a/source/text/scalc/01/func_forecastetspiadd.xhp +++ b/source/text/scalc/01/func_forecastetspiadd.xhp @@ -30,7 +30,7 @@ <paragraph id="par_id0603201610005998" role="paragraph" xml-lang="en-US">FORECAST.ETS.PI.ADD calculates with the model</paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#etsadd"/> -<paragraph id="hd_id0603201610005973" role="heading" level="2" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id0603201610010044" role="code" xml-lang="en-US">FORECAST.ETS.PI.ADD(target, values, timeline, [confidence_level], [period_length], [data_completion], [aggregation])</paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#target"/> <embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> diff --git a/source/text/scalc/01/func_forecastetspimult.xhp b/source/text/scalc/01/func_forecastetspimult.xhp index 45c1c0b41b..155ba0cab2 100644 --- a/source/text/scalc/01/func_forecastetspimult.xhp +++ b/source/text/scalc/01/func_forecastetspimult.xhp @@ -30,7 +30,7 @@ <paragraph id="par_id0603201610005998" role="paragraph" xml-lang="en-US">FORECAST.ETS.PI.MULT calculates with the model</paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#etsmult"/> -<paragraph id="hd_id0603201610005973" role="heading" level="2" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id0603201610010044" role="code" xml-lang="en-US">FORECAST.ETS.PI.MULT(target, values, timeline, [confidence_level], [period_length], [data_completion], [aggregation])</paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#target"/> <embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> diff --git a/source/text/scalc/01/func_forecastetsseason.xhp b/source/text/scalc/01/func_forecastetsseason.xhp index 942f8d2e66..22118da34a 100644 --- a/source/text/scalc/01/func_forecastetsseason.xhp +++ b/source/text/scalc/01/func_forecastetsseason.xhp @@ -30,7 +30,7 @@ <embed href="text/scalc/01/exponsmooth_embd.xhp#intro"/> <paragraph id="par_id0403201618595132" role="paragraph" xml-lang="en-US">The same result is returned with FORECAST.ETS.STAT functions when argument <emph>stat_type</emph> equals 9 (and <emph>period_length</emph> equals 1).</paragraph> -<paragraph id="hd_id0603201618013635" role="heading" level="2" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id0603201618013796" role="code" xml-lang="en-US">FORECAST.ETS.SEASONALITY (values, timeline, [data_completion], [aggregation])</paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> <embed href="text/scalc/01/exponsmooth_embd.xhp#timeline"/> diff --git a/source/text/scalc/01/func_forecastetsstatadd.xhp b/source/text/scalc/01/func_forecastetsstatadd.xhp index 6bcc705f84..9e84d6aa6a 100644 --- a/source/text/scalc/01/func_forecastetsstatadd.xhp +++ b/source/text/scalc/01/func_forecastetsstatadd.xhp @@ -32,7 +32,7 @@ <paragraph id="par_id0603201608440530" role="paragraph" xml-lang="en-US">FORECAST.ETS.STAT.ADD calculates with the model </paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#etsadd"/> -<paragraph id="par_id050320162122554" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id0603201610005728" role="code" xml-lang="en-US">FORECAST.ETS.STAT.ADD (values, timeline, stat_type, [period_length], [data_completion], [aggregation])</paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> <embed href="text/scalc/01/exponsmooth_embd.xhp#timeline"/> diff --git a/source/text/scalc/01/func_forecastetsstatmult.xhp b/source/text/scalc/01/func_forecastetsstatmult.xhp index 23fb20bcf0..07dae8f643 100644 --- a/source/text/scalc/01/func_forecastetsstatmult.xhp +++ b/source/text/scalc/01/func_forecastetsstatmult.xhp @@ -31,7 +31,7 @@ <paragraph id="par_id0603201608440530" role="paragraph" xml-lang="en-US">FORECAST.ETS.STAT.MULT calculates with the model </paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#etsmult"/> -<paragraph id="par_id050320162122554" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id0603201610005728" role="code" xml-lang="en-US">FORECAST.ETS.STAT.MULT (values, timeline, stat_type, [period_length], [data_completion], [aggregation])</paragraph> <embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> <embed href="text/scalc/01/exponsmooth_embd.xhp#timeline"/> diff --git a/source/text/scalc/01/func_hour.xhp b/source/text/scalc/01/func_hour.xhp index 1b6a48c2bb..d4409245e5 100644 --- a/source/text/scalc/01/func_hour.xhp +++ b/source/text/scalc/01/func_hour.xhp @@ -34,11 +34,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STUNDE" id="bm_id3152469" localize="false"/><paragraph role="heading" id="hd_id3154725" xml-lang="en-US" level="2"><variable id="hour"><link href="text/scalc/01/func_hour.xhp">HOUR</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3149747" xml-lang="en-US"><ahelp hid="HID_FUNC_STUNDE">Returns the hour for a given time value.</ahelp> The hour is returned as an integer between 0 and 23.</paragraph> -<paragraph role="heading" id="hd_id3149338" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3150637" xml-lang="en-US">HOUR(Number)</paragraph> <paragraph role="paragraph" id="par_id3147547" xml-lang="en-US"> <emph>Number</emph>, as a time value, is a decimal, for which the hour is to be returned.</paragraph> -<paragraph role="heading" id="hd_id3153264" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3159215" xml-lang="en-US"> <item type="input">=HOUR(NOW())</item> returns the current hour</paragraph> <paragraph role="paragraph" id="par_id3145152" xml-lang="en-US"> diff --git a/source/text/scalc/01/func_isoweeknum.xhp b/source/text/scalc/01/func_isoweeknum.xhp index 6ecc8cd68d..1e84c40402 100644 --- a/source/text/scalc/01/func_isoweeknum.xhp +++ b/source/text/scalc/01/func_isoweeknum.xhp @@ -35,13 +35,13 @@ </variable></paragraph> <paragraph role="paragraph" id="par_id3149770" xml-lang="en-US"><ahelp hid="HID_FUNC_ISOWEEKNUM">ISOWEEKNUM calculates the week number of the year for the internal date value.</ahelp></paragraph> <paragraph role="note" id="par_idN105E4" xml-lang="en-US">The International Standard ISO 8601 has decreed that Monday shall be the first day of the week. A week that lies partly in one year and partly in another is assigned a number in the year in which most of its days lie. That means that week number 1 of any year is the week that contains the January 4th.</paragraph> -<paragraph role="heading" id="hd_id3153055" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3147236" xml-lang="en-US">ISOWEEKNUM(Number)</paragraph> <paragraph role="paragraph" id="par_id3147511" xml-lang="en-US"> <emph>Number</emph> is the internal date number.</paragraph> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph role="heading" id="hd_id3146948" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3149792" xml-lang="en-US"><item type="input">=ISOWEEKNUM(DATE(1995;1;1))</item> returns 52. Week 1 starts on Monday, 1995-01-02.</paragraph> <paragraph role="paragraph" id="par_id3149794" xml-lang="en-US"><item type="input">=ISOWEEKNUM(DATE(1999;1;1))</item> returns 53. Week 1 starts on Monday, 1999-01-04.</paragraph> </body> diff --git a/source/text/scalc/01/func_maxifs.xhp b/source/text/scalc/01/func_maxifs.xhp index 9483642ee1..b3c6808b00 100644 --- a/source/text/scalc/01/func_maxifs.xhp +++ b/source/text/scalc/01/func_maxifs.xhp @@ -27,7 +27,7 @@ <paragraph id="par_id659756597565975" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="maxifs_des">Returns the maximum of the values of cells in a range that meets multiple criteria in multiple ranges.</variable></ahelp></paragraph> </section> -<paragraph id="hd_id660246602466024" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id11655988824213" role="code" xml-lang="en-US">MAXIFS(<embedvar href="text/scalc/01/ex_data_stat_func.xhp#args" markup="ignore"/>)</paragraph> <paragraph id="par_id59901690530236" role="paragraph" xml-lang="en-US"><emph>Func_Range</emph> – required argument. A range of cells, a name of a named range or a label of a column or a row containing values for calculating the maximum.</paragraph> diff --git a/source/text/scalc/01/func_minifs.xhp b/source/text/scalc/01/func_minifs.xhp index 2443e4e533..faac1635b0 100644 --- a/source/text/scalc/01/func_minifs.xhp +++ b/source/text/scalc/01/func_minifs.xhp @@ -27,7 +27,7 @@ <paragraph id="par_id659756597565975" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="minifs_des">Returns the minimum of the values of cells in a range that meets multiple criteria in multiple ranges.</variable></ahelp></paragraph> </section> -<paragraph id="hd_id660246602466024" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id11655988824213" role="code" xml-lang="en-US">MINIFS(<embedvar href="text/scalc/01/ex_data_stat_func.xhp#args" markup="ignore"/>)</paragraph> <paragraph id="par_id59901690530236" role="paragraph" xml-lang="en-US"><emph>Func_Range</emph> – required argument. A range of cells, a name of a named range or a label of a column or a row containing values for calculating the minimum.</paragraph> diff --git a/source/text/scalc/01/func_minute.xhp b/source/text/scalc/01/func_minute.xhp index 6d21596ec8..91c4cb1c09 100644 --- a/source/text/scalc/01/func_minute.xhp +++ b/source/text/scalc/01/func_minute.xhp @@ -34,11 +34,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MINUTE" id="bm_id3148616" localize="false"/><paragraph role="heading" id="hd_id3149803" xml-lang="en-US" level="2"><variable id="minute"><link href="text/scalc/01/func_minute.xhp">MINUTE</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3148988" xml-lang="en-US"><ahelp hid="HID_FUNC_MINUTE">Calculates the minute for an internal time value.</ahelp> The minute is returned as a number between 0 and 59.</paragraph> -<paragraph role="heading" id="hd_id3154343" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3148660" xml-lang="en-US">MINUTE(Number)</paragraph> <paragraph role="paragraph" id="par_id3154611" xml-lang="en-US"> <emph>Number</emph>, as a time value, is a decimal number where the number of the minute is to be returned.</paragraph> -<paragraph role="heading" id="hd_id3145374" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3148463" xml-lang="en-US"> <item type="input">=MINUTE(8.999)</item> returns 58</paragraph> <paragraph role="paragraph" id="par_id3149419" xml-lang="en-US"> diff --git a/source/text/scalc/01/func_month.xhp b/source/text/scalc/01/func_month.xhp index 4d23f5ba82..038db6f654 100644 --- a/source/text/scalc/01/func_month.xhp +++ b/source/text/scalc/01/func_month.xhp @@ -29,13 +29,13 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MONAT" id="bm_id3150628" localize="false"/><paragraph role="heading" id="hd_id3149936" xml-lang="en-US" level="2"><variable id="month"><link href="text/scalc/01/func_month.xhp">MONTH</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3153538" xml-lang="en-US"><ahelp hid="HID_FUNC_MONAT">Returns the month for the given date value.</ahelp> The month is returned as an integer between 1 and 12.</paragraph> -<paragraph role="heading" id="hd_id3149517" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3145602" xml-lang="en-US">MONTH(Number)</paragraph> <paragraph role="paragraph" id="par_id3149485" xml-lang="en-US"> <emph>Number</emph> is the internal date number.</paragraph> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph role="heading" id="hd_id3153322" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3149244" xml-lang="en-US"><item type="input">=MONTH(NOW())</item> returns the current month.</paragraph> <paragraph role="paragraph" id="par_id3154790" xml-lang="en-US"><item type="input">=MONTH(C4)</item> returns 7 if you enter 2000-07-07 to cell C4 (that date value might get formatted differently after you press Enter).</paragraph> </body> diff --git a/source/text/scalc/01/func_networkdays.intl.xhp b/source/text/scalc/01/func_networkdays.intl.xhp index 77f272f514..ee355d7c17 100644 --- a/source/text/scalc/01/func_networkdays.intl.xhp +++ b/source/text/scalc/01/func_networkdays.intl.xhp @@ -34,14 +34,14 @@ <paragraph id="hd_id231020162211573602" role="heading" level="1" xml-lang="en-US"><variable id="networkdaysintl"><link href="text/scalc/01/func_networkdays.intl.xhp">NETWORKDAYS.INTL</link></variable></paragraph> <paragraph id="par_id231020162213393086" role="paragraph" xml-lang="en-US"><ahelp hid=".">Returns the number of workdays between a start date and an end date. There are options to define weekend days and holidays. The optional weekend parameter (or a string) can be used to define the weekend days (or the non-working days in each week). Also, optionally, the user can define a holiday list. The weekend days and user-defined holidays are not counted as working days.</ahelp></paragraph> </section> -<paragraph id="par_id231020162213395472" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id231020162249539143" role="code" xml-lang="en-US">NETWORKDAYS.INTL(StartDate; EndDate; Weekend; Holidays)</paragraph> <paragraph id="par_id231020162249533010" role="paragraph" xml-lang="en-US"><emph>StartDate</emph> is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation.</paragraph> <paragraph id="par_id231020162249536398" role="paragraph" xml-lang="en-US"><emph>EndDate</emph> is the date up until when the calculation is carried out. If the end date is a workday, the day is included in the calculation.</paragraph> <embed href="text/scalc/01/common_func_workdaysintl.xhp#embed_workdays_intl"/> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph id="hd_id231020162249551873" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id231020162249554032" role="paragraph" xml-lang="en-US">How many workdays fall between December 15, 2016 and January 14, 2017? Let the start date be located in C3 and the end date in D3. Cells F3 to J3 contain five (5) holidays for Christmas and New Year in date format: December 24, 2016; December 25, 2016; December 26, 2016; December 31, 2016; and January 1, 2017.</paragraph> <paragraph id="par_id231020162249551234" role="paragraph" xml-lang="en-US"><item type="input">=NETWORKDAYS.INTL(C3;D3;;F3:J3)</item> returns 21 workdays with default for weekend days.</paragraph> <paragraph id="par_id231020162249553109" role="paragraph" xml-lang="en-US"><item type="input">=NETWORKDAYS.INTL(C3;D3;11;F3:J3)</item> returns 24 workdays with Sunday only weekends.</paragraph> diff --git a/source/text/scalc/01/func_networkdays.xhp b/source/text/scalc/01/func_networkdays.xhp index 3490b00a8d..7ad83da25e 100644 --- a/source/text/scalc/01/func_networkdays.xhp +++ b/source/text/scalc/01/func_networkdays.xhp @@ -36,7 +36,7 @@ <paragraph id="hd_id3151254" role="heading" level="2" xml-lang="en-US"><variable id="networkdays"><link href="text/scalc/01/func_networkdays.xhp">NETWORKDAYS</link></variable></paragraph> <paragraph id="par_id3153788" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_NETWORKDAYS">Returns the number of workdays between a <emph>start date and an end date</emph>. Holidays can be deducted.</ahelp></paragraph> -<paragraph id="hd_id3148677" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3145775" role="code" xml-lang="en-US">NETWORKDAYS(StartDate; EndDate; Holidays; Workdays)</paragraph> <paragraph id="par_id3153885" role="paragraph" xml-lang="en-US"><emph>StartDate</emph> is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation.</paragraph> <paragraph id="par_id3151110" role="paragraph" xml-lang="en-US"><emph>EndDate</emph> is the date up until when the calculation is carried out. If the end date is a workday, the day is included in the calculation.</paragraph> @@ -44,7 +44,7 @@ <paragraph id="par_id160920161749585013" role="paragraph" xml-lang="en-US"><emph>Workdays</emph> is an optional list of number values defining standard work week. This list starts by Sunday, workdays are indicated by zero and non-working days by non-zero value.</paragraph> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph id="hd_id3146902" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3154661" role="paragraph" xml-lang="en-US">How many workdays fall between 2001-12-15 and 2002-01-15? The start date is located in C3 and the end date in D3. Cells F3 to J3 contain the following Christmas and New Year holidays: "2001-12-24", "2001-12-25", "2001-12-26", "2001-12-31", "2002-01-01".</paragraph> <paragraph id="par_id3147328" role="paragraph" xml-lang="en-US"><item type="input">=NETWORKDAYS(C3;D3;F3:J3)</item> returns 17 workdays.</paragraph> <paragraph id="par_id160920161751233621" role="paragraph" xml-lang="en-US">How many workdays fall between September 12nd and 25th in 2016 if only Mondays, Tuesdays and Wednesdays are considered as workdays?</paragraph> diff --git a/source/text/scalc/01/func_now.xhp b/source/text/scalc/01/func_now.xhp index 1ffc8c1fb4..1d241fb8cb 100644 --- a/source/text/scalc/01/func_now.xhp +++ b/source/text/scalc/01/func_now.xhp @@ -34,10 +34,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_JETZT" id="bm_id3150532" localize="false"/><paragraph role="heading" id="hd_id3150521" xml-lang="en-US" level="2"><variable id="now"><link href="text/scalc/01/func_now.xhp">NOW</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3148829" xml-lang="en-US"><ahelp hid="HID_FUNC_JETZT">Returns the computer system date and time.</ahelp> The value is updated when you recalculate the document or each time a cell value is modified.</paragraph> -<paragraph role="heading" id="hd_id3146988" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3154897" xml-lang="en-US">NOW()</paragraph> <paragraph role="paragraph" id="par_id4598529" xml-lang="en-US">NOW is a function without arguments.</paragraph> -<paragraph role="heading" id="hd_id3154205" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3150774" xml-lang="en-US"> <item type="input">=NOW()-A1</item> returns the difference between the date in A1 and now. Format the result as a number.</paragraph> </body> diff --git a/source/text/scalc/01/func_numbervalue.xhp b/source/text/scalc/01/func_numbervalue.xhp index ee82d4a83f..cdc38aae1f 100644 --- a/source/text/scalc/01/func_numbervalue.xhp +++ b/source/text/scalc/01/func_numbervalue.xhp @@ -37,12 +37,12 @@ <ahelp hid="HID_FUNC_NUMBERVALUE">Convert text to number, in a locale-independent way.</ahelp> </paragraph> <paragraph xml-lang="en-US" id="par_id3149281" role="paragraph">Constraints: LEN(decimal_separator) = 1, decimal_separator shall not appear in group_separator</paragraph> - <paragraph xml-lang="en-US" id="hd_id3156294" role="heading" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph xml-lang="en-US" id="par_id3149268" role="code">NUMBERVALUE("Text";decimal_separator;group_separator)</paragraph> <paragraph xml-lang="en-US" id="par_id3154819" role="paragraph"><emph>Text</emph> is a valid number expression and must be entered with quotation marks.</paragraph> <paragraph xml-lang="en-US" id="par_id3154820" role="paragraph"><emph>decimal_separator</emph> (optional) defines the character used as the decimal separator.</paragraph> <paragraph xml-lang="en-US" id="par_id3154821" role="paragraph"><emph>group_separator</emph> (optional) defines the character(s) used as the group separator.</paragraph> - <paragraph xml-lang="en-US" id="hd_id3156309" role="heading" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph xml-lang="en-US" id="par_id3155841" role="paragraph"><item type="input">=NUMBERVALUE("123.456";".";",")</item> yields 123.456</paragraph> </body> </helpdocument> diff --git a/source/text/scalc/01/func_second.xhp b/source/text/scalc/01/func_second.xhp index 23ca52a2b1..a51a4801b4 100644 --- a/source/text/scalc/01/func_second.xhp +++ b/source/text/scalc/01/func_second.xhp @@ -34,11 +34,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SEKUNDE" id="bm_id3155499" localize="false"/><paragraph role="heading" id="hd_id3159390" xml-lang="en-US" level="2"><variable id="second"><link href="text/scalc/01/func_second.xhp">SECOND</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3148974" xml-lang="en-US"><ahelp hid="HID_FUNC_SEKUNDE">Returns the second for the given time value.</ahelp> The second is given as an integer between 0 and 59.</paragraph> -<paragraph role="heading" id="hd_id3154362" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3148407" xml-lang="en-US">SECOND(Number)</paragraph> <paragraph role="paragraph" id="par_id3155904" xml-lang="en-US"> <emph>Number</emph>, as a time value, is a decimal, for which the second is to be returned.</paragraph> -<paragraph role="heading" id="hd_id3149992" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3153350" xml-lang="en-US"> <item type="input">=SECOND(NOW())</item> returns the current second</paragraph> <paragraph role="paragraph" id="par_id3150831" xml-lang="en-US"> diff --git a/source/text/scalc/01/func_sumifs.xhp b/source/text/scalc/01/func_sumifs.xhp index 5065ea5b67..93a4a67c96 100644 --- a/source/text/scalc/01/func_sumifs.xhp +++ b/source/text/scalc/01/func_sumifs.xhp @@ -27,7 +27,7 @@ <paragraph id="par_id659756597565975" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="sumifs_des">Returns the sum of the values of cells in a range that meets multiple criteria in multiple ranges.</variable></ahelp></paragraph> </section> -<paragraph id="hd_id660246602466024" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id11655988824213" role="code" xml-lang="en-US">SUMIFS(<embedvar href="text/scalc/01/ex_data_stat_func.xhp#args" markup="ignore"/>)</paragraph> <paragraph id="par_id59901690530236" role="paragraph" xml-lang="en-US"><emph>Func_Range</emph> – required argument. It is a range of cells, a name of a named range or a label of a column or a row containing values for calculating the sum.</paragraph> diff --git a/source/text/scalc/01/func_time.xhp b/source/text/scalc/01/func_time.xhp index ad55bb91c4..de55b8a666 100644 --- a/source/text/scalc/01/func_time.xhp +++ b/source/text/scalc/01/func_time.xhp @@ -34,12 +34,12 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZEIT" id="bm_id3150289" localize="false"/><paragraph role="heading" id="hd_id3154073" xml-lang="en-US" level="2"><variable id="time"><link href="text/scalc/01/func_time.xhp">TIME</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3145762" xml-lang="en-US"><ahelp hid="HID_FUNC_ZEIT">TIME returns the current time value from values for hours, minutes and seconds.</ahelp> This function can be used to convert a time based on these three elements to a decimal time value.</paragraph> -<paragraph role="heading" id="hd_id3155550" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3154584" xml-lang="en-US">TIME(Hour; Minute; Second)</paragraph> <paragraph role="paragraph" id="par_id3152904" xml-lang="en-US">Use an integer to set the <emph>Hour</emph>.</paragraph> <paragraph role="paragraph" id="par_id3151346" xml-lang="en-US">Use an integer to set the <emph>Minute</emph>.</paragraph> <paragraph role="paragraph" id="par_id3151366" xml-lang="en-US">Use an integer to set the <emph>Second</emph>.</paragraph> -<paragraph role="heading" id="hd_id3145577" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3156076" xml-lang="en-US"> <item type="input">=TIME(0;0;0)</item> returns 00:00:00</paragraph> <paragraph role="paragraph" id="par_id3156090" xml-lang="en-US"> diff --git a/source/text/scalc/01/func_timevalue.xhp b/source/text/scalc/01/func_timevalue.xhp index 7a10b13c5b..eb03aada5c 100644 --- a/source/text/scalc/01/func_timevalue.xhp +++ b/source/text/scalc/01/func_timevalue.xhp @@ -32,10 +32,10 @@ <paragraph id="par_id3148502" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZEITWERT">TIMEVALUE returns the internal time number from a text enclosed by quotes and which may show a possible time entry format.</ahelp></paragraph><embed href="text/scalc/01/ODFF.xhp#odff"/> <paragraph id="par_id3150794" role="paragraph" xml-lang="en-US">The internal number indicated as a decimal is the result of the date system used under $[officename] to calculate date entries.</paragraph> <paragraph id="par_id011920090347118" role="paragraph" xml-lang="en-US">If the text string also includes a year, month, or day, TIMEVALUE only returns the fractional part of the conversion.</paragraph> -<paragraph id="hd_id3150810" role="heading" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3150823" role="code" xml-lang="en-US">TIMEVALUE("Text")</paragraph> <paragraph id="par_id3152556" role="paragraph" xml-lang="en-US"><emph>Text</emph> is a valid time expression and must be entered in quotation marks.</paragraph> -<paragraph id="hd_id3146815" role="heading" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3146829" role="paragraph" xml-lang="en-US"><item type="input">=TIMEVALUE("4PM")</item> returns 0.67. When formatting in time format HH:MM:SS, you then get 16:00:00.</paragraph> <paragraph id="par_id3153632" role="paragraph" xml-lang="en-US"><item type="input">=TIMEVALUE("24:00")</item> returns 0. If you use the HH:MM:SS time format, the value is 00:00:00.</paragraph> </body> diff --git a/source/text/scalc/01/func_today.xhp b/source/text/scalc/01/func_today.xhp index 4fb24ab4aa..35b6bfdd27 100644 --- a/source/text/scalc/01/func_today.xhp +++ b/source/text/scalc/01/func_today.xhp @@ -34,10 +34,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_HEUTE" id="bm_id3147267" localize="false"/><paragraph role="heading" id="hd_id3145659" xml-lang="en-US" level="2"><variable id="today"><link href="text/scalc/01/func_today.xhp">TODAY</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3153759" xml-lang="en-US"><ahelp hid="HID_FUNC_HEUTE">Returns the current computer system date.</ahelp> The value is updated when you reopen the document or modify the values of the document.</paragraph> -<paragraph role="heading" id="hd_id3154051" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3153154" xml-lang="en-US">TODAY()</paragraph> <paragraph role="paragraph" id="par_id3154741" xml-lang="en-US"> TODAY is a function without arguments.</paragraph> -<paragraph role="heading" id="hd_id3153627" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3156106" xml-lang="en-US"> <item type="input">TODAY()</item> returns the current computer system date.</paragraph> </body> diff --git a/source/text/scalc/01/func_webservice.xhp b/source/text/scalc/01/func_webservice.xhp index 3c20a8232d..0401cf023b 100644 --- a/source/text/scalc/01/func_webservice.xhp +++ b/source/text/scalc/01/func_webservice.xhp @@ -21,10 +21,10 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WEBSERVICE" id="bm_id3150028" localize="false"/> <paragraph role="heading" id="hd_id3149012" xml-lang="en-US" level="2">WEBSERVICE</paragraph> <paragraph role="paragraph" id="par_id3149893" xml-lang="en-US"><ahelp hid="HID_FUNC_WEBSERVICE">Get some web content from a URI.</ahelp></paragraph> - <paragraph role="heading" id="hd_id3146944" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3154844" xml-lang="en-US">WEBSERVICE(URI)</paragraph> <paragraph role="paragraph" id="par_id3147469" xml-lang="en-US"><emph>URI: </emph> URI text of the web service.</paragraph> - <paragraph role="heading" id="hd_id3150141" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3146142" xml-lang="en-US"><item type="input">=WEBSERVICE("wiki.documentfoundation.org/api.php?hidebots=1&days=7&limit=50&action=feedrecentchanges&feedformat=rss")</item></paragraph> <paragraph role="paragraph" id="par_id3146143" xml-lang="en-US">Returns the web page content of "https://wiki.documentfoundation.org/api.php?hidebots=1&days=7&limit=50&action=feedrecentchanges&feedformat=rss".</paragraph> </section> @@ -35,11 +35,11 @@ </bookmark> <paragraph role="heading" id="hd_id2949012" xml-lang="en-US" level="2">FILTERXML</paragraph> <paragraph role="paragraph" id="par_id2949893" xml-lang="en-US"><ahelp hid="HID_FUNC_FILTERXML">Apply a XPath expression to a XML document.</ahelp></paragraph> - <paragraph role="heading" id="hd_id2946944" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id2954844" xml-lang="en-US">FILTERXML(XML Document; XPath expression)</paragraph> <paragraph role="paragraph" id="par_id2947469" xml-lang="en-US"><emph>XML Document (required):</emph> String containing a valid XML stream.</paragraph> <paragraph role="paragraph" id="par_id2847469" xml-lang="en-US"><emph>XPath expression (required):</emph> String containing a valid XPath expression.</paragraph> - <paragraph role="heading" id="hd_id2950141" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id2946142" xml-lang="en-US"><item type="input">=FILTERXML(WEBSERVICE("wiki.documentfoundation.org/api.php?hidebots=1&days=7&limit=50&action=feedrecentchanges&feedformat=rss");"//lastBuildDate")</item></paragraph> <paragraph role="paragraph" id="par_id2946143" xml-lang="en-US"> Returns information on the last build date of the wiki.</paragraph> </section> @@ -51,10 +51,10 @@ <paragraph id="hd_id671517132649769" role="heading" level="2" xml-lang="en-US">ENCODEURL function</paragraph> <paragraph id="par_id51517132649769" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ENCODEURL">Returns a URL-encoded string.</ahelp></paragraph> <paragraph role="paragraph" id="par_id721517134647880" xml-lang="en-US">Use this function to transform text with symbols of national alphabets (for example accented characters, non-ASCII alphabets or Asian words) to a string of URL-standard symbols.</paragraph> - <paragraph role="heading" id="hd_id351517132879400" level="2" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id351517132879400" xml-lang="en-US">ENCODEURL(Text)</paragraph> <paragraph role="paragraph" id="par_id921517132924079" xml-lang="en-US"><emph>Text</emph>: String to encode to a sequence of URL-standard symbols.</paragraph> - <paragraph role="heading" id="hd_id901517132933934" level="2" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id651517132994921" xml-lang="en-US">If cell A1 contains the Cyrillic text "автомобиль", <item type="input">=ENCODEURL(A1)</item> returns %D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%BE%D0%B1%D0%B8%D0%BB%D1%8C (the word "автомобиль" means car in Russian).</paragraph> <paragraph role="paragraph" id="par_id991517133057478" xml-lang="en-US">If cell B1 contains the text "車", <item type="input">=ENCODEURL(B1)</item> returns %E8%BB%8A ("車" means car in Japanese).</paragraph> </section> diff --git a/source/text/scalc/01/func_weekday.xhp b/source/text/scalc/01/func_weekday.xhp index c9046cdaee..2f23bdb6d0 100644 --- a/source/text/scalc/01/func_weekday.xhp +++ b/source/text/scalc/01/func_weekday.xhp @@ -36,7 +36,7 @@ <paragraph id="hd_id3154925" role="heading" level="2" xml-lang="en-US"><variable id="weekday"><link href="text/scalc/01/func_weekday.xhp">WEEKDAY</link> </variable></paragraph> <paragraph id="par_id3154228" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_WOCHENTAG">Returns the day of the week for the given date value.</ahelp> The day is returned as an integer between 1 (Sunday) and 7 (Saturday) if no type or type=1 is specified. For other types, see the table below.</paragraph> -<paragraph id="hd_id3147217" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id3149033" role="code" xml-lang="en-US">WEEKDAY(Number; Type)</paragraph> <paragraph id="par_id3149046" role="paragraph" xml-lang="en-US"> <emph>Number</emph>, as a date value, is a decimal for which the weekday is to be returned.</paragraph> <paragraph id="par_id3154394" role="paragraph" xml-lang="en-US"> <emph>Type</emph> is optional and determines the type of calculation. </paragraph> @@ -136,7 +136,7 @@ </caseinline><defaultinline><item type="menuitem">Tools - Options</item></defaultinline></switchinline><item type="menuitem">- %PRODUCTNAME Calc - Calculate</item>.</paragraph> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph id="hd_id3153836" role="heading" level="3" xml-lang="en-US">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id3150317" role="paragraph" xml-lang="en-US"><item type="input">=WEEKDAY("2000-06-14")</item> returns 4 (the Type parameter is missing, therefore the standard count is used. The standard count starts with Sunday as day number 1. June 14, 2000 was a Wednesday and therefore day number 4).</paragraph> <paragraph id="par_id3153174" role="paragraph" xml-lang="en-US"><item type="input">=WEEKDAY("1996-07-24";2)</item> returns 3 (the Type parameter is 2, therefore Monday is day number 1. July 24, 1996 was a Wednesday and therefore day number 3).</paragraph> <paragraph id="par_id3153525" role="paragraph" xml-lang="en-US"><item type="input">=WEEKDAY("1996-07-24";1)</item> returns 4 (the Type parameter is 1, therefore Sunday is day number 1. July 24, 1996 was a Wednesday and therefore day number 4).</paragraph> diff --git a/source/text/scalc/01/func_weeknum.xhp b/source/text/scalc/01/func_weeknum.xhp index 35b56ff2d6..31695d9953 100644 --- a/source/text/scalc/01/func_weeknum.xhp +++ b/source/text/scalc/01/func_weeknum.xhp @@ -56,7 +56,7 @@ </tablecell> </tablerow> </table> -<paragraph role="heading" id="hd_id3153055" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3147236" xml-lang="en-US">WEEKNUM(Number [; Mode])</paragraph> <paragraph role="paragraph" id="par_id3147511" xml-lang="en-US"> <emph>Number</emph> is the internal date number.</paragraph> @@ -171,7 +171,7 @@ </table> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph role="heading" id="hd_id3146948" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3150704" xml-lang="en-US"><item type="input">=WEEKNUM(DATE(1995;1;1);1)</item> returns 1</paragraph> <paragraph role="paragraph" id="par_id3149792" xml-lang="en-US"><item type="input">=WEEKNUM(DATE(1995;1;1);2)</item> returns 52. If the week starts on Monday, Sunday belongs to the last week of the previous year.</paragraph> <paragraph role="paragraph" id="par_id3149793" xml-lang="en-US"><item type="input">=WEEKNUM(DATE(1995;1;1);21)</item> returns 52. Week 1 starts on Monday, 1995-01-02.</paragraph> diff --git a/source/text/scalc/01/func_weeknum_ooo.xhp b/source/text/scalc/01/func_weeknum_ooo.xhp index 4c02c7d1f0..8304d3a971 100644 --- a/source/text/scalc/01/func_weeknum_ooo.xhp +++ b/source/text/scalc/01/func_weeknum_ooo.xhp @@ -30,7 +30,7 @@ </variable></paragraph> <paragraph role="paragraph" id="par_id3149770" xml-lang="en-US"><ahelp hid="HID_FUNC_WEEKNUM_OOO">WEEKNUM_OOO calculates the week number of the year for the internal date value.</ahelp></paragraph> <paragraph role="note" id="par_idN105E4" xml-lang="en-US">This function exists for interoperability with %PRODUCTNAME releases older than 5.1.0 and OpenOffice.org. It calculates week numbers for a week numbering system in that week number 1 is the week that contains the January 4th. This function does not provide interoperability with other spreadsheet applications. For new documents use the <link href="text/scalc/01/func_weeknum.xhp">WEEKNUM</link> or <link href="text/scalc/01/func_isoweeknum.xhp">ISOWEEKNUM</link> function instead.</paragraph> -<paragraph role="heading" id="hd_id3153055" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3147236" xml-lang="en-US">WEEKNUM_OOO(Number; Mode)</paragraph> <paragraph role="paragraph" id="par_id3147511" xml-lang="en-US"> <emph>Number</emph> is the internal date number.</paragraph> @@ -41,7 +41,7 @@ <paragraph role="paragraph" id="par_id3154281" xml-lang="en-US">any other value = Monday (ISO 8601)</paragraph> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph role="heading" id="hd_id3146948" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3150704" xml-lang="en-US"><item type="input">=WEEKNUM_OOO(DATE(1995;1;1);1)</item> returns 1</paragraph> <paragraph role="paragraph" id="par_id3149792" xml-lang="en-US"><item type="input">=WEEKNUM_OOO(DATE(1995;1;1);2)</item> returns 52. Week 1 starts on Monday, 1995-01-02.</paragraph> </body> diff --git a/source/text/scalc/01/func_weeknumadd.xhp b/source/text/scalc/01/func_weeknumadd.xhp index 70b34e1bc0..53f2347739 100644 --- a/source/text/scalc/01/func_weeknumadd.xhp +++ b/source/text/scalc/01/func_weeknumadd.xhp @@ -35,13 +35,13 @@ </variable></paragraph> <paragraph role="paragraph" id="par_id3152945" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_WEEKNUM">The result indicates the number of the calendar week for a date.</ahelp></paragraph> <paragraph role="tip" id="par_idN105DD" xml-lang="en-US">The WEEKNUM_EXCEL2003 function is designed to calculate week numbers exactly as Microsoft Excel 2003 did. Use the <link href="text/scalc/01/func_weeknum.xhp">WEEKNUM</link> function for ODF OpenFormula and Excel 2010 compatibility, or <link href="text/scalc/01/func_isoweeknum.xhp">ISOWEEKNUM</link> function when you just need ISO 8601 week numbers. In releases prior to $[officename] 5.1 WEEKNUM_EXCEL2003 was named WEEKNUM_ADD.</paragraph> -<paragraph role="heading" id="hd_id3153745" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3153685" xml-lang="en-US">WEEKNUM_EXCEL2003(Date; ReturnType)</paragraph> <paragraph role="paragraph" id="par_id3159277" xml-lang="en-US"> <emph>Date</emph> is the date within the calendar week.</paragraph> <paragraph role="paragraph" id="par_id3154098" xml-lang="en-US"> <emph>ReturnType</emph> is 1 for week beginning on a Sunday, 2 for week beginning on a Monday.</paragraph> -<paragraph role="heading" id="hd_id3152886" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3149973" xml-lang="en-US">In which week number does 2001-12-24 fall?</paragraph> <paragraph role="paragraph" id="par_id3149914" xml-lang="en-US"> <item type="input">=WEEKNUM_EXCEL2003(DATE(2001;12;24);1)</item> returns 52.</paragraph> diff --git a/source/text/scalc/01/func_workday.intl.xhp b/source/text/scalc/01/func_workday.intl.xhp index 63451fe5a7..9a3e3cc2c9 100644 --- a/source/text/scalc/01/func_workday.intl.xhp +++ b/source/text/scalc/01/func_workday.intl.xhp @@ -36,14 +36,14 @@ <paragraph id="par_id23102016234837285" role="paragraph" xml-lang="en-US"><ahelp hid=".">The result is a date number that can be formatted as a date. User can see the date of a day that is a certain number of workdays away from the start date (before or after). There are options to define weekend days and holidays. The optional weekend parameter (or a string) can be used to define the weekend days (or the non-working days in each week). Also, optionally, the user can define a holiday list. The weekend days and user-defined holidays are not counted as working days.</ahelp></paragraph> </section> -<paragraph id="hd_id241020160008306802" role="heading" level="3" xml-lang="en-US">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph id="par_id241020160008306838" role="code" xml-lang="en-US">WORKDAY.INTL(StartDate; Days; Weekend; Holidays)</paragraph> <paragraph id="par_id241020160008308885" role="paragraph" xml-lang="en-US"><emph>StartDate</emph> is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation. This is required.</paragraph> <paragraph id="par_id241020160008305329" role="paragraph" xml-lang="en-US"><emph>Days</emph> is the number of workdays. Positive value for a result after the start date, negative value for a result before the start date.</paragraph> <embed href="text/scalc/01/common_func_workdaysintl.xhp#embed_workdays_intl"/> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph id="hd_id241020160012172138" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id241020160012177196" role="paragraph" xml-lang="en-US">What date comes 20 workdays after December 13, 2016? Enter the start date in C3 and the number of workdays in D3.</paragraph> <paragraph id="par_id241020160012178429" role="paragraph" xml-lang="en-US">The weekend parameter (number) may be left blank or defined as 1 for default weekend (non-working days) – Saturday and Sunday.</paragraph> <paragraph id="par_id241020160012172125" role="paragraph" xml-lang="en-US">Cells F3 to J3 contain five (5) holidays for Christmas and New Year in date format: December 24, 2016; December 25, 2016; December 26, 2016; December 31, 2016; and January 1, 2017.</paragraph> diff --git a/source/text/scalc/01/func_workday.xhp b/source/text/scalc/01/func_workday.xhp index a6038fa117..7529a7aa3c 100644 --- a/source/text/scalc/01/func_workday.xhp +++ b/source/text/scalc/01/func_workday.xhp @@ -34,7 +34,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_WORKDAY" id="bm_id3150028" localize="false"/><paragraph role="heading" id="hd_id3149012" xml-lang="en-US" level="2"><variable id="workday"><link href="text/scalc/01/func_workday.xhp">WORKDAY</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3149893" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_WORKDAY"> The result is a date number that can be formatted as a date. You then see the date of a day that is a certain number of <emph>workdays</emph> away from the <emph>start date</emph>.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3146944" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3154844" xml-lang="en-US">WORKDAY(StartDate; Days; Holidays)</paragraph> <paragraph role="paragraph" id="par_id3147469" xml-lang="en-US"> <emph>StartDate</emph> is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation.</paragraph> @@ -44,7 +44,7 @@ <emph>Holidays</emph> is a list of optional holidays. These are non-working days. Enter a cell range in which the holidays are listed individually.</paragraph> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph role="heading" id="hd_id3150141" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3152782" xml-lang="en-US">What date came 17 workdays after 1 December 2001? Enter the start date "2001-12-01" in C3 and the number of workdays in D3. Cells F3 to J3 contain the following Christmas and New Year holidays: "2001-12-24", "2001-12-25", "2001-12-26", "2001-12-31", "2002-01-01".</paragraph> <paragraph role="paragraph" id="par_id3146142" xml-lang="en-US"><item type="input">=WORKDAY(C3;D3;F3:J3)</item> returns 2001-12-28. Format the serial date number as a date, for example in the format YYYY-MM-DD.<comment>UFI: fixed #i30213#</comment></paragraph> <section id="relatedtopics"> diff --git a/source/text/scalc/01/func_year.xhp b/source/text/scalc/01/func_year.xhp index 7703540284..0adf3b23c8 100644 --- a/source/text/scalc/01/func_year.xhp +++ b/source/text/scalc/01/func_year.xhp @@ -34,11 +34,11 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_JAHR" id="bm_id3159179" localize="false"/><paragraph role="heading" id="hd_id3153982" xml-lang="en-US" level="2"><variable id="year"><link href="text/scalc/01/func_year.xhp">YEAR</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3147496" xml-lang="en-US"><ahelp hid="HID_FUNC_JAHR">Returns the year as a number according to the internal calculation rules.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3146090" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3154304" xml-lang="en-US">YEAR(Number)</paragraph> <paragraph role="paragraph" id="par_id3156013" xml-lang="en-US"> <emph>Number</emph> shows the internal date value for which the year is to be returned.</paragraph> -<paragraph role="heading" id="hd_id3152797" xml-lang="en-US" level="3">Examples</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3145668" xml-lang="en-US"> <item type="input">=YEAR(1)</item> returns 1899</paragraph> <paragraph role="paragraph" id="par_id3151168" xml-lang="en-US"> diff --git a/source/text/scalc/01/func_yearfrac.xhp b/source/text/scalc/01/func_yearfrac.xhp index 8fd42e02d4..20d5747c80 100644 --- a/source/text/scalc/01/func_yearfrac.xhp +++ b/source/text/scalc/01/func_yearfrac.xhp @@ -34,7 +34,7 @@ <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YEARFRAC" id="bm_id3149251" localize="false"/><paragraph role="heading" id="hd_id3148735" xml-lang="en-US" level="2"><variable id="yearfrac"><link href="text/scalc/01/func_yearfrac.xhp">YEARFRAC</link> </variable></paragraph> <paragraph role="paragraph" id="par_id3150899" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_YEARFRAC">The result is the number of the years (including fractional part) between <emph>StartDate</emph> and <emph>EndDate</emph>.</ahelp></paragraph> -<paragraph role="heading" id="hd_id3155259" xml-lang="en-US" level="3">Syntax</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> <paragraph role="code" id="par_id3155823" xml-lang="en-US">YEARFRAC(StartDate; EndDate; Basis)</paragraph> <paragraph role="paragraph" id="par_id3145144" xml-lang="en-US"> <emph>StartDate</emph> and <emph>EndDate</emph> are two date values.</paragraph> @@ -94,7 +94,7 @@ </section> <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> -<paragraph role="heading" id="hd_id3145626" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph role="paragraph" id="par_id3149007" xml-lang="en-US">What fraction of the year 2008 lies between 2008-01-01 and 2008-07-01?</paragraph> <paragraph role="paragraph" id="par_id3154632" xml-lang="en-US"><item type="input">=YEARFRAC("2008-01-01"; "2008-07-01";0)</item> returns 0.50.</paragraph> </body> diff --git a/source/text/scalc/01/stat_data.xhp b/source/text/scalc/01/stat_data.xhp index 04cd580c34..b201e36e53 100644 --- a/source/text/scalc/01/stat_data.xhp +++ b/source/text/scalc/01/stat_data.xhp @@ -33,7 +33,7 @@ <section id="sampledata01"> -<paragraph id="hd_id1000030" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id1000040" role="paragraph" xml-lang="en-US">The following data will be used as example </paragraph> <table id="Tabela3"> @@ -233,7 +233,7 @@ <section id="timeseries01"> -<paragraph id="hd_id1000040" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id1000550" role="paragraph" xml-lang="en-US">The following table has two time series, one representing an impulse function at time t=0 and the other an impulse function at time t=2.</paragraph> <table id="Tabela8"> @@ -396,7 +396,7 @@ <section id="datafortests"> -<paragraph id="hd_id1000050" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id1000970" role="paragraph" xml-lang="en-US">The following table has two data sets.</paragraph> <table id="Tabela9"> @@ -559,7 +559,7 @@ <section id="regressiondata"> -<paragraph id="hd_id1701201619425619" role="heading" level="3" xml-lang="en-US">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id1701201619425624" role="paragraph" xml-lang="en-US">The following table has samples of a physical phenomenon taken in 1 second interval.</paragraph> <table id="Table1"> diff --git a/source/text/scalc/01/statistics.xhp b/source/text/scalc/01/statistics.xhp index 8ae7093d0f..13c842ada2 100644 --- a/source/text/scalc/01/statistics.xhp +++ b/source/text/scalc/01/statistics.xhp @@ -48,7 +48,7 @@ <paragraph id="par_id1000080" role="paragraph" xml-lang="en-US"><emph>Sample size</emph>: Number of lines sampled from the source table.</paragraph> <paragraph id="par_id1000090" role="paragraph" xml-lang="en-US"><emph>Periodic</emph>: Picks lines in a pace defined by <emph>Period</emph>.</paragraph> <paragraph id="par_id1000100" role="paragraph" xml-lang="en-US"><emph>Period</emph>: the number of lines to skip periodically when sampling.</paragraph> -<paragraph id="hd_id1000040" role="heading" xml-lang="en-US" level="3">Example</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> <paragraph id="par_id1000110" role="paragraph" xml-lang="en-US">The following data will be used as example of source data table for sampling:</paragraph> <table id="Tabela1"> <tablerow> |