From b358fb9b95915743d8666b238acb8e117c8751ce Mon Sep 17 00:00:00 2001 From: Olivier Hallot Date: Sat, 29 Sep 2018 15:26:04 -0300 Subject: Reduce L10N workload for repetitive strings Change 'Syntax' and 'Examples' heading into an embedded string translated only once. Change-Id: Iac2eef8fedbaa4461aa2f941af7f065a3b16fb2d Reviewed-on: https://gerrit.libreoffice.org/61143 Tested-by: Jenkins Reviewed-by: Olivier Hallot --- AllLangHelp_scalc.mk | 1 + source/text/scalc/01/04060101.xhp | 48 ++-- source/text/scalc/01/04060103.xhp | 56 ++--- source/text/scalc/01/04060104.xhp | 88 +++---- source/text/scalc/01/04060105.xhp | 28 +-- source/text/scalc/01/04060106.xhp | 266 +++++++++++----------- source/text/scalc/01/04060107.xhp | 52 ++--- source/text/scalc/01/04060109.xhp | 82 +++---- source/text/scalc/01/04060110.xhp | 138 +++++------ source/text/scalc/01/04060111.xhp | 26 +-- source/text/scalc/01/04060115.xhp | 76 +++---- source/text/scalc/01/04060116.xhp | 84 +++---- source/text/scalc/01/04060118.xhp | 76 +++---- source/text/scalc/01/04060119.xhp | 96 ++++---- source/text/scalc/01/04060120.xhp | 24 +- source/text/scalc/01/04060181.xhp | 100 ++++---- source/text/scalc/01/04060182.xhp | 96 ++++---- source/text/scalc/01/04060183.xhp | 60 ++--- source/text/scalc/01/04060184.xhp | 120 +++++----- source/text/scalc/01/04060185.xhp | 160 ++++++------- source/text/scalc/01/04060199.xhp | 8 +- source/text/scalc/01/common_func.xhp | 25 ++ source/text/scalc/01/ex_data_stat_func.xhp | 2 +- source/text/scalc/01/exponsmooth_embd.xhp | 2 +- source/text/scalc/01/func_aggregate.xhp | 4 +- source/text/scalc/01/func_averageif.xhp | 2 +- source/text/scalc/01/func_averageifs.xhp | 2 +- source/text/scalc/01/func_countifs.xhp | 2 +- source/text/scalc/01/func_date.xhp | 4 +- source/text/scalc/01/func_datedif.xhp | 4 +- source/text/scalc/01/func_datevalue.xhp | 4 +- source/text/scalc/01/func_day.xhp | 4 +- source/text/scalc/01/func_days.xhp | 4 +- source/text/scalc/01/func_days360.xhp | 4 +- source/text/scalc/01/func_eastersunday.xhp | 4 +- source/text/scalc/01/func_edate.xhp | 4 +- source/text/scalc/01/func_eomonth.xhp | 4 +- source/text/scalc/01/func_error_type.xhp | 4 +- source/text/scalc/01/func_forecastetsadd.xhp | 2 +- source/text/scalc/01/func_forecastetsmult.xhp | 2 +- source/text/scalc/01/func_forecastetspiadd.xhp | 2 +- source/text/scalc/01/func_forecastetspimult.xhp | 2 +- source/text/scalc/01/func_forecastetsseason.xhp | 2 +- source/text/scalc/01/func_forecastetsstatadd.xhp | 2 +- source/text/scalc/01/func_forecastetsstatmult.xhp | 2 +- source/text/scalc/01/func_hour.xhp | 4 +- source/text/scalc/01/func_isoweeknum.xhp | 4 +- source/text/scalc/01/func_maxifs.xhp | 2 +- source/text/scalc/01/func_minifs.xhp | 2 +- source/text/scalc/01/func_minute.xhp | 4 +- source/text/scalc/01/func_month.xhp | 4 +- source/text/scalc/01/func_networkdays.intl.xhp | 4 +- source/text/scalc/01/func_networkdays.xhp | 4 +- source/text/scalc/01/func_now.xhp | 4 +- source/text/scalc/01/func_numbervalue.xhp | 4 +- source/text/scalc/01/func_second.xhp | 4 +- source/text/scalc/01/func_sumifs.xhp | 2 +- source/text/scalc/01/func_time.xhp | 4 +- source/text/scalc/01/func_timevalue.xhp | 4 +- source/text/scalc/01/func_today.xhp | 4 +- source/text/scalc/01/func_webservice.xhp | 12 +- source/text/scalc/01/func_weekday.xhp | 4 +- source/text/scalc/01/func_weeknum.xhp | 4 +- source/text/scalc/01/func_weeknum_ooo.xhp | 4 +- source/text/scalc/01/func_weeknumadd.xhp | 4 +- source/text/scalc/01/func_workday.intl.xhp | 4 +- source/text/scalc/01/func_workday.xhp | 4 +- source/text/scalc/01/func_year.xhp | 4 +- source/text/scalc/01/func_yearfrac.xhp | 4 +- source/text/scalc/01/stat_data.xhp | 8 +- source/text/scalc/01/statistics.xhp | 2 +- 71 files changed, 956 insertions(+), 930 deletions(-) create mode 100644 source/text/scalc/01/common_func.xhp 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 @@ DCOUNT DCOUNT counts the number of rows (records) in a database that match the specified search criteria and contain numerical values in the DatabaseField column. - Syntax + DCOUNT(Database; [DatabaseField]; SearchCriteria) If the DatabaseField argument is omitted, DCOUNT returns the count of all records that satisfy Criteria. - Example + 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 =DCOUNT(A1:E10;D1;A13:E14) in B16. The Function Wizard helps you to input ranges. Database is the range of data to be evaluated, including its headers: in this case A1:E10. DatabaseField specifies the column for the search criteria: in this case, the column with the numerical distance values. SearchCriteria is the range where you can enter the search parameters: in this case, A13:E14. @@ -436,10 +436,10 @@ DCOUNTA DCOUNTA counts the number of rows (records) in a database that match the specified search conditions, and contain numeric or alphanumeric values. - Syntax + DCOUNTA(Database; [DatabaseField]; SearchCriteria) If the DatabaseField argument is omitted, DCOUNTA returns the count of all records that satisfy Criteria. - Example + 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 =DCOUNTA(A1:E10;"Name";A13:E14). Delete the old search criteria and enter >=E 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.see i25407
@@ -451,10 +451,10 @@ DGET DGET returns the contents of the referenced cell in a database which matches the specified search criteria. In case of an error, the function returns either #VALUE! for no row found, or Err502 for more than one cell found. - Syntax + DGET(Database; DatabaseField; SearchCriteria) - Example + 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 DatabaseField. Enter the following formula: =DGET(A1:E10;"Grade";A13:E14) @@ -475,10 +475,10 @@ DMAX DMAX returns the maximum content of a cell (field) in a database (all records) that matches the specified search conditions. - Syntax + DMAX(Database; DatabaseField; SearchCriteria) - Example + 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: =DMAX(A1:E10;"Weight";A13:E14) @@ -494,10 +494,10 @@ DMIN DMIN returns the minimum content of a cell (field) in a database that matches the specified search criteria. - Syntax + DMIN(Database; DatabaseField; SearchCriteria) - Example + 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: =DMIN(A1:E10;"Distance to School";A13:E14) @@ -513,10 +513,10 @@ DAVERAGE DAVERAGE returns the average of the values of all cells (fields) in all rows (database records) that match the specified search criteria. - Syntax + DAVERAGE(Database; DatabaseField; SearchCriteria) - Example + 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: =DAVERAGE(A1:E10;"Weight";A13:E14) @@ -531,10 +531,10 @@ DPRODUCT DPRODUCT multiplies all cells of a data range where the cell contents match the search criteria. - Syntax + DPRODUCT(Database; DatabaseField; SearchCriteria) - Example + With the birthday party example above (scroll up, please), there is no meaningful application of this function.
@@ -545,10 +545,10 @@ DSTDEV DSTDEV calculates the standard deviation of a population based on a sample, using the numbers in a database column that match the given conditions. 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. - Syntax + DSTDEV(Database; DatabaseField; SearchCriteria) - Example + 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: =DSTDEV(A1:E10;"Weight";A13:E14) @@ -563,10 +563,10 @@ DSTDEVP DSTDEVP calculates the standard deviation of a population based on all cells of a data range which match the search criteria. The records from the example are treated as the whole population. - Syntax + DSTDEVP(Database; DatabaseField; SearchCriteria) - Example + 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: =DSTDEVP(A1:E10;"Weight";A13:E14) @@ -582,10 +582,10 @@ DSUM DSUM returns the total of all cells in a database field in all rows (records) that match the specified search criteria. - Syntax + DSUM(Database; DatabaseField; SearchCriteria) - Example + 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: =DSUM(A1:E10;"Distance to School";A13:E14) @@ -600,10 +600,10 @@ DVAR DVAR returns the variance of all cells of a database field in all records that match the specified search criteria. 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. - Syntax + DVAR(Database; DatabaseField; SearchCriteria) - Example + 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: =DVAR(A1:E10;"Weight";A13:E14) @@ -618,10 +618,10 @@ DVARP DVARP calculates the variance of all cell values in a database field in all records that match the specified search criteria. The records are from the example are treated as an entire population. - Syntax + DVARP(Database; DatabaseField; SearchCriteria) - Example + 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: =DVARP(A1:E10;"Weight";A13:E14) 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 @@ AMORDEGRC Calculates the amount of depreciation for a settlement period as degressive amortization. Unlike AMORLINC, a depreciation coefficient that is independent of the depreciable life is used here. - Syntax + AMORDEGRC(Cost; DatePurchased; FirstPeriod; Salvage; Period; Rate; Basis) Cost is the acquisition costs. @@ -66,7 +66,7 @@ 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. - Syntax + AMORLINC(Cost; DatePurchased; FirstPeriod; Salvage; Period; Rate; Basis) Cost means the acquisition costs. @@ -90,7 +90,7 @@ accrued interests;periodic payments mw changed "accrued interests" Calculates the accrued interest of a security in the case of periodic payments. - Syntax + ACCRINT(Issue; FirstInterest; Settlement; Rate; Par; Frequency; Basis) Issue (required) is the issue date of the security. @@ -105,7 +105,7 @@ Frequency (required) is the number of interest payments per year (1, 2 or 4). - Example + 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? =ACCRINT("2001-02-28";"2001-08-31";"2001-05-01";0.1;1000;2;0) returns 16.94444. @@ -117,7 +117,7 @@ ACCRINTM Calculates the accrued interest of a security in the case of one-off payment at the settlement date. - Syntax + ACCRINTM(Issue; Settlement; Rate; Par; Basis) Issue (required) is the issue date of the security. @@ -128,7 +128,7 @@ Par (optional) is the par value of the security. - Example + 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? =ACCRINTM("2001-04-01";"2001-06-15";0.1;1000;3) returns 20.54795. @@ -140,7 +140,7 @@ RECEIVED Calculates the amount received that is paid for a fixed-interest security at a given point in time. - Syntax + RECEIVED("Settlement"; "Maturity"; Investment; Discount; Basis) Settlement is the date of purchase of the security. @@ -151,7 +151,7 @@ Discount is the percentage discount on acquisition of the security. - Example + 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. The amount received on the maturity date is calculated as follows: @@ -167,7 +167,7 @@ Returns the present value of an investment resulting from a series of regular payments. 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. 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 Rate and %PRODUCTNAME Calc with automatically calculate the correct factor. - Syntax + PV(Rate; NPer; Pmt; FV; Type) Rate defines the interest rate per period. @@ -182,7 +182,7 @@ - Example + 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. =PV(8%/12;48;500;20000) = -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. @@ -198,7 +198,7 @@ SYD Returns the arithmetic-declining depreciation rate. 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. - Syntax + SYD(Cost; Salvage; Life; Period) Cost is the initial cost of an asset. @@ -208,7 +208,7 @@ Life is the period fixing the time span over which an asset is depreciated. Period defines the period for which the depreciation is to be calculated. - Example + 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. =SYD(50000;10000;5;1)=13,333.33 currency units. The depreciation amount for the first year is 13,333.33 currency units. @@ -540,7 +540,7 @@ DISC Calculates the allowance (discount) of a security as a percentage. - Syntax + DISC("Settlement"; "Maturity"; Price; Redemption; Basis) Settlement is the date of purchase of the security. @@ -551,7 +551,7 @@ Redemption is the redemption value of the security per 100 currency units of par value. - Example + 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)? =DISC("2001-01-25";"2001-11-15";97;100;3) returns about 0.0372 or 3.72 per cent. @@ -565,7 +565,7 @@ DURATION_ADD Calculates the duration of a fixed interest security in years. - Syntax + DURATION_ADD("Settlement"; "Maturity"; Coupon; Yield; Frequency; Basis) Settlement is the date of purchase of the security. @@ -578,7 +578,7 @@ Frequency is the number of interest payments per year (1, 2 or 4). - Example + 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? =DURATION_ADD("2001-01-01";"2006-01-01";0.08;0.09;2;3) @@ -594,13 +594,13 @@ EFFECTIVE Returns the net annual interest rate for a nominal interest rate. 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. - Syntax + EFFECTIVE(Nom; P) Nom is the nominal interest. P is the number of interest payment periods per year. - Example + If the annual nominal interest rate is 9.75% and four interest calculation periods are defined, what is the actual interest rate (effective rate)? =EFFECTIVE(9.75%;4) = 10.11% The annual effective rate is therefore 10.11%. @@ -613,13 +613,13 @@ EFFECT_ADD Calculates the effective annual rate of interest on the basis of the nominal interest rate and the number of interest payments per annum. - Syntax + EFFECT_ADD(NominalRate; NPerY) NominalRate is the annual nominal rate of interest. NPerY is the number of interest payments per year. - Example + What is the effective annual rate of interest for a 5.25% nominal rate and quarterly payment. =EFFECT_ADD(0.0525;4) returns 0.053543 or 5.3543%. @@ -634,7 +634,7 @@ DDB Returns the depreciation of an asset for a specified period using the arithmetic-declining method. 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. - Syntax + DDB(Cost; Salvage; Life; Period; Factor) Cost fixes the initial cost of an asset. @@ -646,7 +646,7 @@ Period states the period for which the value is to be calculated. Factor (optional) is the factor by which depreciation decreases. If a value is not entered, the default is factor 2. - Example + 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. =DDB(75000;1;60;12;2) = 1,721.81 currency units. Therefore, the double-declining depreciation in the twelfth month after purchase is 1,721.81 currency units. @@ -661,7 +661,7 @@ DB Returns the depreciation of an asset for a specified period using the fixed-declining balance method. 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. - Syntax + DB(Cost; Salvage; Life; Period; Month) Cost is the initial cost of an asset. @@ -673,7 +673,7 @@ Period is the length of each period. The length must be entered in the same date unit as the depreciation period. Month (optional) denotes the number of months for the first year of depreciation. If an entry is not defined, 12 is used as the default. - Example + 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. =DB(25000;1000;36;1;6) = 1,075.00 currency units @@ -688,13 +688,13 @@ IRR Calculates the internal rate of return for an investment. 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). If the payments take place at irregular intervals, use the XIRR function. - Syntax + IRR(Values; Guess) Values represents an array containing the values. Guess (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. - Example + Under the assumption that cell contents are A1=-10000, A2=3500, A3=7600 and A4=1000, the formula =IRR(A1:A4) gives a result of 11,33%. Because of the iterative method used, it is possible for IRR to fail and return Error 523, with "Error: Calculation does not converge" in the status bar. In that case, try another value for Guess.
@@ -706,7 +706,7 @@ ISPMT Calculates the level of interest for unchanged amortization installments. - Syntax + ISPMT(Rate; Period; TotalPeriods; Invest) Rate sets the periodic interest rate. @@ -716,7 +716,7 @@ TotalPeriods is the total number of installment periods. Invest is the amount of the investment. - Example + 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. =ISPMT(1%;18;24;120000) = -300 currency units. The monthly interest after 1.5 years amounts to 300 currency units. 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 @@ INFO Returns specific information about the current working environment. The function receives a single text argument and returns data depending on that parameter. -Syntax + INFO("Type") The following table lists the values for the text parameter Type and the return values of the INFO function. @@ -212,7 +212,7 @@ Other spreadsheet applications may accept localized values for the Type parameter, but %PRODUCTNAME Calc will only accept the English values. -Example + =INFO("release") returns the product release number of the %PRODUCTNAME in use.Do not translate "release" =INFO(D5) with cell D5 containing a text string system returns the operation system type.Do not translate the hlp_literal system @@ -227,10 +227,10 @@ CURRENT 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. -Syntax + CURRENT() -Example + =1+2+CURRENT() 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. =A2+B2+STYLE(IF(CURRENT()>10;”Red”;”Default”)) @@ -251,12 +251,12 @@ FORMULA Displays the formula of a formula cell as a text string. -Syntax + FORMULA(Reference) Reference is a reference to a cell containing a formula. An invalid reference or a reference to a cell with no formula results in the error value #N/A. -Example + If cell A8 contains the formula =SUM(1;2;3) then =FORMULA(A8) returns the text =SUM(1;2;3). @@ -274,11 +274,11 @@ Tests if the argument is a reference. Returns TRUE if the argument is a reference, returns FALSE otherwise. When given a reference this function does not examine the value being referenced.i82565 -Syntax + ISREF(Value) Value is the value to be tested, to determine whether it is a reference. -Example + =ISREF(C5) returns the result TRUE because C5 is a valid reference. =ISREF("abcdef") returns always FALSE because a text can never be a reference. =ISREF(4) returns FALSE. @@ -298,11 +298,11 @@ Tests for error conditions, except the #N/A error value, and returns TRUE or FALSE. -Syntax + ISERR(Value) Value is any value or expression which is tested to see whether an error value other than #N/A is present. -Example + =ISERR(C8) where cell C8 contains =1/0 returns TRUE, because 1/0 is an error. =ISERR(C9) where cell C9 contains =NA() returns FALSE, because ISERR() ignores the #N/A error. @@ -319,11 +319,11 @@ Tests for error conditions, including the #N/A error value, and returns TRUE or FALSE. -Syntax + ISERROR(Value) Value is or refers to the value to be tested. ISERROR() returns TRUE if there is an error and FALSE if not. -Example + =ISERROR(C8) where cell C8 contains =1/0 returns TRUE, because 1/0 is an error. =ISERROR(C9) where cell C9 contains =NA() returns TRUE. @@ -339,12 +339,12 @@ IFERROR Returns the value if the cell does not contains an error value, or the alternative value if it does. -Syntax + IFERROR(Value;Alternate_value) Value is the value or expression to be returned if it is not equal or results in an error. Alternate_value is the value or expression to be returned if the expression or value of Value is equal or results in an error. -Example + =IFERROR(C8;C9) where cell C8 contains =1/0 returns the value of C9, because 1/0 is an error. =IFERROR(C8;C9) where cell C8 contains 13 returns 13, the value of C8, which is not an error. @@ -362,11 +362,11 @@ Returns TRUE if a cell is a formula cell. -Syntax + ISFORMULA(Reference) Reference indicates the reference to a cell in which a test will be performed to determine if it contains a formula. -Example + =ISFORMULA(C4) returns FALSE if the cell C4 contains the number 5. @@ -381,12 +381,12 @@ ISEVEN Returns TRUE if the value is an even integer, or FALSE if the value is odd. -Syntax + ISEVEN(Value) Value is the value to be checked. If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored. -Example + =ISEVEN(48) returns TRUE =ISEVEN(33) returns FALSE =ISEVEN(0) returns TRUE @@ -405,11 +405,11 @@ Tests for even numbers. Returns 1 if the number divided by 2 returns a whole number. -Syntax + ISEVEN_ADD(Number) Number is the number to be tested. -Example + =ISEVEN_ADD(5) returns 0. =ISEVEN_ADD(A1) returns 1 if cell A1 contains the number 2. @@ -426,11 +426,11 @@ Tests if the cell contents are text or numbers, and returns FALSE if the contents are text. If an error occurs, the function returns TRUE. -Syntax + ISNONTEXT(Value) Value is any value or expression where a test is performed to determine whether it is a text or numbers or a Boolean value. -Example + =ISNONTEXT(D2) returns FALSE if cell D2 contains the text abcdef. =ISNONTEXT(D9) returns TRUE if cell D9 contains the number 8. @@ -448,11 +448,11 @@ Returns TRUE if the reference to a cell is blank. This function is used to determine if the content of a cell is empty. A cell with a formula inside is not empty. -Syntax + ISBLANK(Value) Value is the content to be tested. -Example + =ISBLANK(D2) returns FALSE as a result. @@ -469,11 +469,11 @@ Tests for a logical value (TRUE or FALSE). If an error occurs, the function returns FALSE. -Syntax + ISLOGICAL(Value) Returns TRUE if Value is a logical value (TRUE or FALSE), and returns FALSE otherwise. -Example + =ISLOGICAL(99) returns FALSE, because 99 is a number, not a logical value. =ISLOGICAL(ISNA(D4)) returns TRUE whatever the contents of cell D4, because ISNA() returns a logical value. @@ -490,11 +490,11 @@ Returns TRUE if a cell contains the #N/A (value not available) error value. If an error occurs, the function returns FALSE. -Syntax + ISNA(Value) Value is the value or expression to be tested. -Example + =ISNA(D3) returns FALSE as a result. @@ -509,12 +509,12 @@ 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. -Syntax + IFNA(Value;Alternate_value) Value is the value or expression to be returned if it is not equal or results in an #N/A error. Alternate_value is the value or expression to be returned if the expression or value of Value is equal or results in an #N/A error. -Example + =IFNA(D3;D4) returns the value of D3 if D3 does not result in an #N/A error, or D4 if it does. @@ -530,11 +530,11 @@ Returns TRUE if the cell contents refer to text. If an error occurs, the function returns FALSE. -Syntax + ISTEXT(Value) Value is a value, number, Boolean value, or an error value to be tested. -Example + =ISTEXT(D9) returns TRUE if cell D9 contains the text abcdef. =ISTEXT(C3) returns FALSE if cell C3 contains the number 3. @@ -550,12 +550,12 @@ ISODD Returns TRUE if the value is odd, or FALSE if the number is even. -Syntax + ISODD(value) Value is the value to be checked. If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored. -Example + =ISODD(33) returns TRUE =ISODD(48) returns FALSE =ISODD(3.999) returns TRUE @@ -573,11 +573,11 @@ Returns TRUE (1) if the number does not return a whole number when divided by 2. -Syntax + ISODD_ADD(Number) Number is the number to be tested. -Example + =ISODD_ADD(5) returns 1. @@ -593,11 +593,11 @@ Returns TRUE if the value refers to a number. -Syntax + ISNUMBER(Value) Value is any expression to be tested to determine whether it is a number or text. -Example + =ISNUMBER(C3) returns TRUE if the cell C3 contains the number 4. =ISNUMBER(C2) returns FALSE if the cell C2 contains the text abcdef. @@ -613,11 +613,11 @@ Returns the numeric value of the given parameter. Returns 0 if parameter is text or FALSE. If an error occurs the function returns the error value. -Syntax + N(Value) Value 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. -Example + =N(123) returns 123 =N(TRUE()) returns 1 =N(FALSE()) returns 0 @@ -636,10 +636,10 @@ NA Returns the error value #N/A. -Syntax + NA() -Example + =NA() converts the contents of the cell into #N/A. @@ -654,7 +654,7 @@ Returns the type of value, where 1 = number, 2 = text, 4 = Boolean value, 8 = formula, 16 = error value, 64 = array. -Syntax + TYPE(Value) Value is a specific value for which the data type is determined. @@ -675,7 +675,7 @@ CELL Returns information on address, formatting or contents of a cell. -Syntax + CELL("InfoType"; Reference) InfoType is the character string that specifies the type of information. The character string is always in English. Upper or lower case is optional. 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 @@ AND Returns TRUE if all arguments are TRUE. If one of the elements is FALSE, this function returns the FALSE value. 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. - Syntax + AND(LogicalValue1; LogicalValue2 ...LogicalValue30) LogicalValue1; LogicalValue2 ...LogicalValue30 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. - Example + The logical values of entries 12<13; 14>12, and 7<6 are to be checked: =AND(12<13;14>12;7<6) returns FALSE. @@ -80,9 +80,9 @@ FALSE Returns the logical value FALSE. The FALSE() function does not require any arguments, and always returns the logical value FALSE. - Syntax + FALSE() - Example + =FALSE() returns FALSE @@ -94,7 +94,7 @@ IF Specifies a logical test to be performed. - Syntax + IF(Test; ThenValue; OtherwiseValue) Test is any value or expression that can be TRUE or FALSE. @@ -105,7 +105,7 @@ - Examples + =IF(A1>5;100;"too small") 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. @@ -115,11 +115,11 @@ NOT Complements (inverts) a logical value. - Syntax + NOT(LogicalValue) LogicalValue is any value to be complemented. - Example + =NOT(A). If A=TRUE then NOT(A) will evaluate FALSE. @@ -130,11 +130,11 @@ OR Returns TRUE if at least one argument is TRUE. This function returns the value FALSE, if all the arguments have the logical value FALSE. 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. - Syntax + OR(LogicalValue1; LogicalValue2 ...LogicalValue30) LogicalValue1; LogicalValue2 ...LogicalValue30 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.UFI: first try to fix bugtraq 4905779 - Example + The logical values of entries 12<11; 13>22, and 45=45 are to be checked. =OR(12<11;13>22;45=45) returns TRUE. @@ -147,9 +147,9 @@ TRUE The logical value is set to TRUE. The TRUE() function does not require any arguments, and always returns the logical value TRUE. - Syntax + TRUE() - Example + If A=TRUE and B=FALSE the following examples appear: =AND(A;B) returns FALSE @@ -165,9 +165,9 @@ XOR Returns true if an odd number of arguments evaluates to TRUE. 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. - Syntax + XOR(LogicalValue1; LogicalValue2 ...LogicalValue30) - Example + =XOR(TRUE;TRUE) returns FALSE 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 @@ ABS Returns the absolute value of a number. -Syntax + ABS(Number) Number is the number whose absolute value is to be calculated. The absolute value of a number is its value without the +/- sign. -Example + =ABS(-56) returns 56. =ABS(12) returns 12. =ABS(0) returns 0.see also SIGN @@ -71,12 +71,12 @@ ACOS Returns the inverse trigonometric cosine of a number. -Syntax + ACOS(Number) This function returns the inverse trigonometric cosine of Number, that is the angle (in radians) whose cosine is Number. The angle returned is between 0 and PI. To return the angle in degrees, use the DEGREES function. -Example + =ACOS(-1) returns 3.14159265358979 (PI radians) =DEGREES(ACOS(0.5)) returns 60. The cosine of 60 degrees is 0.5.see also COS, SIN, TAN, COT, ASIN, ATAN, ATAN2, ACOT @@ -92,12 +92,12 @@ ACOSH Returns the inverse hyperbolic cosine of a number. -Syntax + ACOSH(Number) This function returns the inverse hyperbolic cosine of Number, that is the number whose hyperbolic cosine is Number. Number must be greater than or equal to 1. -Example + =ACOSH(1) returns 0. =ACOSH(COSH(4)) returns 4.see also ASINH, ATANH, ACOTH, COSH, SINH, TANH, COTH @@ -113,12 +113,12 @@ ACOT Returns the inverse cotangent (the arccotangent) of the given number. -Syntax + ACOT(Number) This function returns the inverse trigonometric cotangent of Number, that is the angle (in radians) whose cotangent is Number. The angle returned is between 0 and PI. To return the angle in degrees, use the DEGREES function. -Example + =ACOT(1) returns 0.785398163397448 (PI/4 radians). =DEGREES(ACOT(1)) returns 45. The tangent of 45 degrees is 1.see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN, ATAN2 @@ -134,12 +134,12 @@ ACOTH Returns the inverse hyperbolic cotangent of the given number. -Syntax + ACOTH(Number) This function returns the inverse hyperbolic cotangent of Number, that is the number whose hyperbolic cotangent is Number. An error results if Number is between -1 and 1 inclusive. -Example + =ACOTH(1.1) returns inverse hyperbolic cotangent of 1.1, approximately 1.52226.see also ACOSH, ASINH, ATANH, COSH, SINH, TANH, COTH @@ -160,12 +160,12 @@ ASIN Returns the inverse trigonometric sine of a number. -Syntax + ASIN(Number) This function returns the inverse trigonometric sine of Number, that is the angle (in radians) whose sine is Number. The angle returned is between -PI/2 and +PI/2. To return the angle in degrees, use the DEGREES function. -Example + =ASIN(0) returns 0. =ASIN(1) returns 1.5707963267949 (PI/2 radians). =DEGREES(ASIN(0.5)) returns 30. The sine of 30 degrees is 0.5.see also COS, SIN, TAN, COT, ACOS, ATAN, ATAN2, ACOT @@ -182,11 +182,11 @@ ASINH Returns the inverse hyperbolic sine of a number. -Syntax + ASINH(Number) This function returns the inverse hyperbolic sine of Number, that is the number whose hyperbolic sine is Number. -Example + =ASINH(-90) returns approximately -5.1929877. =ASINH(SINH(4)) returns 4.see also ACOSH, ATANH, ACOTH, COSH, SINH, TANH, COTH @@ -202,12 +202,12 @@ ATAN Returns the inverse trigonometric tangent of a number. -Syntax + ATAN(Number) This function returns the inverse trigonometric tangent of Number, that is the angle (in radians) whose tangent is Number. The angle returned is between -PI/2 and PI/2. To return the angle in degrees, use the DEGREES function. -Example + =ATAN(1) returns 0.785398163397448 (PI/4 radians). =DEGREES(ATAN(1)) returns 45. The tangent of 45 degrees is 1.see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN2, ACOT @@ -223,14 +223,14 @@ ATAN2 Returns the inverse trigonometric tangent of the specified x and y coordinates. -Syntax + ATAN2(NumberX; NumberY) NumberX is the value of the x coordinate. NumberY is the value of the y coordinate. 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. To return the angle in degrees, use the DEGREES function. -Example + =ATAN2(20;20) returns 0.785398163397448 (PI/4 radians). =DEGREES(ATAN2(12.3;12.3)) returns 45. The tangent of 45 degrees is 1.see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN, ACOT @@ -246,12 +246,12 @@ ATANH Returns the inverse hyperbolic tangent of a number. -Syntax + ATANH(Number) This function returns the inverse hyperbolic tangent of Number, that is the number whose hyperbolic tangent is Number. Number must obey the condition -1 < number < 1. -Example + =ATANH(0) returns 0.see also ACOSH, ASINH, ACOTH, COSH, SINH, TANH, COTH @@ -266,12 +266,12 @@ COS Returns the cosine of the given angle (in radians). -Syntax + COS(Number) Returns the (trigonometric) cosine of Number, the angle in radians. To return the cosine of an angle in degrees, use the RADIANS function. -Examples + =COS(PI()*2) returns 1, the cosine of 2*PI radians. =COS(RADIANS(60)) returns 0.5, the cosine of 60 degrees.see also SIN, TAN, COT, ACOS, ASIN, ATAN, ATAN2, ACOT @@ -287,11 +287,11 @@ COSH Returns the hyperbolic cosine of a number. -Syntax + COSH(Number) Returns the hyperbolic cosine of Number. -Example + =COSH(0) returns 1, the hyperbolic cosine of 0.see also SINH, TANH, COTH, ACOSH, ASINH, ATANH, ACOTH @@ -306,7 +306,7 @@ COT Returns the cotangent of the given angle (in radians). -Syntax + COT(Number) Returns the (trigonometric) cotangent of Number, the angle in radians. To return the cotangent of an angle in degrees, use the RADIANS function. @@ -328,11 +328,11 @@ COTH Returns the hyperbolic cotangent of a given number (angle). -Syntax + COTH(Number) Returns the hyperbolic cotangent of Number. -Example + =COTH(1) returns the hyperbolic cotangent of 1, approximately 1.3130.see also COSH, SINH, TANH, ACOSH, ASINH, ATANH, ACOTH @@ -347,12 +347,12 @@ CSC 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 -Syntax + CSC(Number) Returns the (trigonometric) cosecant of Number, the angle in radians. To return the cosecant of an angle in degrees, use the RADIANS function. -Examples + =CSC(PI()/4) returns approximately 1.4142135624, the inverse of the sine of PI/4 radians. =CSC(RADIANS(30)) returns 2, the cosecant of 30 degrees.see also SIN, TAN, COT, SEC, ACOS, ASIN, ATAN, ATAN2, ACOT @@ -368,11 +368,11 @@ CSCH Returns the hyperbolic cosecant of a number. -Syntax + CSCH(Number) Returns the hyperbolic cosecant of Number. -Example + =CSCH(1) returns approximately 0.8509181282, the hyperbolic cosecant of 1.see also SINH, TANH, COTH, SECH,ACOSH, ASINH, ATANH, ACOTH @@ -388,11 +388,11 @@ DEGREES Converts radians into degrees. -Syntax + DEGREES(Number) Number is the angle in radians to be converted to degrees. -Example + =DEGREES(PI()) returns 180 degrees.see also RADIANS @@ -406,11 +406,11 @@ EXP Returns e raised to the power of a number. The constant e has a value of approximately 2.71828182845904. -Syntax + EXP(Number) Number is the power to which e is to be raised. -Example + =EXP(1) returns 2.71828182845904, the mathematical constant e to Calc's accuracy.see also POWER, LN @@ -425,13 +425,13 @@ FACT Returns the factorial of a number. -Syntax + FACT(Number) Returns Number!, the factorial of Number, calculated as 1*2*3*4* ... * Number. =FACT(0) returns 1 by definition. The factorial of a negative number returns the "invalid argument" error. -Example + =FACT(3) returns 6. =FACT(0) returns 1.see also FACTDOUBLE, MULTINOMIAL, PRODUCT @@ -448,12 +448,12 @@ INT Rounds a number down to the nearest integer. -Syntax + INT(Number) Returns Number rounded down to the nearest integer. Negative numbers round down to the integer below. -Example + =INT(5.7) returns 5. =INT(-1.3) returns -2.see also TRUNC, ROUND, ROUNDDOWN, ROUNDUP, CEILING, FLOOR, EVEN, ODD, MROUND @@ -470,11 +470,11 @@ EVEN Rounds a positive number up to the next even integer and a negative number down to the next even integer. -Syntax + EVEN(Number) Returns Number rounded to the next even integer up, away from zero. -Examples + =EVEN(2.3) returns 4. =EVEN(2) returns 2. =EVEN(0) returns 0. @@ -493,11 +493,11 @@ Returns the greatest common divisor of two or more integers. The greatest common divisor is the positive largest integer which will divide, without remainder, each of the given integers. -Syntax + GCD(Integer1; Integer2; ...; Integer30) Integer1 To 30 are up to 30 integers whose greatest common divisor is to be calculated. -Example + =GCD(16;32;24) gives the result 8, because 8 is the largest number that can divide 16, 24 and 32 without a remainder. =GCD(B1:B3) where cells B1, B2, B3 contain 9, 12, 9 gives 3. @@ -513,11 +513,11 @@ The result is the greatest common divisor of a list of numbers. -Syntax + GCD_EXCEL2003(Number(s)) Number(s) is a list of up to 30 numbers. -Example + =GCD_EXCEL2003(5;15;25) returns 5. @@ -533,11 +533,11 @@ LCM Returns the least common multiple of one or more integers. -Syntax + LCM(Integer1; Integer2; ...; Integer30) Integer1 to 30 are up to 30 integers whose lowest common multiple is to be calculated. -Example + If you enter the numbers 512;1024 and 2000 in the Integer 1;2 and 3 text boxes, 128000 will be returned as the result. @@ -552,11 +552,11 @@ The result is the lowest common multiple of a list of numbers. -Syntax + LCM_EXCEL2003(Number(s)) Number(s) is a list of up to 30 numbers. -Example + =LCM_EXCEL2003(5;15;25) returns 75. @@ -571,14 +571,14 @@ COMBIN Returns the number of combinations for elements without repetition. -Syntax + COMBIN(Count1; Count2) Count1 is the number of items in the set. Count2 is the number of items to choose from the set. 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. COMBIN implements the formula: Count1!/(Count2!*(Count1-Count2)!) -Example + =COMBIN(3;2) returns 3.see also COMBINA @@ -593,14 +593,14 @@ COMBINA Returns the number of combinations of a subset of items including repetitions. -Syntax + COMBINA(Count1; Count2) Count1 is the number of items in the set. Count2 is the number of items to choose from the set. 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. COMBINA implements the formula: (Count1+Count2-1)! / (Count2!(Count1-1)!)i88052 -Example + =COMBINA(3;2) returns 6.see also COMBIN @@ -615,14 +615,14 @@ TRUNC Truncates a number by removing decimal places. -Syntax + TRUNC(Number; Count) Returns Number with at most Count decimal places. Excess decimal places are simply removed, irrespective of sign. TRUNC(Number; 0) behaves as INT(Number) for positive numbers, but effectively rounds towards zero for negative numbers. The visible decimal places of the result are specified in %PRODUCTNAME - Preferences Tools - Options - %PRODUCTNAME Calc - Calculate. -Example + =TRUNC(1.239;2) returns 1.23. The 9 is lost. =TRUNC(-1.234999;3) returns -1.234. All the 9s are lost.see also INT, ROUND, ROUNDDOWN, ROUNDUP, CEILING, FLOOR, EVEN, ODD, MROUND @@ -638,11 +638,11 @@ LN Returns the natural logarithm based on the constant e of a number. The constant e has a value of approximately 2.71828182845904. -Syntax + LN(Number) Number is the value whose natural logarithm is to be calculated. -Example + =LN(3) returns the natural logarithm of 3 (approximately 1.0986). =LN(EXP(321)) returns 321.see also LOG, LOG10, EXP @@ -658,12 +658,12 @@ LOG Returns the logarithm of a number to the specified base. -Syntax + LOG(Number; Base) Number is the value whose logarithm is to be calculated. Base (optional) is the base for the logarithm calculation. If omitted, Base 10 is assumed. -Example + =LOG(10;3) returns the logarithm to base 3 of 10 (approximately 2.0959). =LOG(7^4;7) returns 4.see also LOG10, LN, POWER @@ -679,11 +679,11 @@ LOG10 Returns the base-10 logarithm of a number. -Syntax + LOG10(Number) Returns the logarithm to base 10 of Number. -Example + =LOG10(5) returns the base-10 logarithm of 5 (approximately 0.69897).see also LOG, LN, POWER @@ -698,14 +698,14 @@ CEILING Rounds a number up to the nearest multiple of Significance. -Syntax + CEILING(Number; Significance; Mode) Number is the number that is to be rounded up. Significance is the number to whose multiple the value is to be rounded up. Mode 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. 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. -Example + =CEILING(-11;-2) returns -10 =CEILING(-11;-2;0) returns -10 =CEILING(-11;-2;1) returns -12see also FLOOR, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP @@ -722,12 +722,12 @@ CEILING.PRECISE Rounds a number up to the nearest multiple of Significance, regardless of sign of Significance -Syntax + CEILING.PRECISE(Number; Significance) Number (required) is the number that is to be rounded up. Significance (optional) is the number to whose multiple the value is to be rounded up. -Example + =CEILING.PRECISE(-11;-2) returns -10see also FLOOR, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP @@ -738,13 +738,13 @@ CEILING.MATH Rounds a number up to the nearest multiple of Significance. - Syntax + CEILING.MATH(Number; Significance; Mode) Number is the number that is to be rounded up. Significance is the number to whose multiple the value is to be rounded up. Mode 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. This function exists for interoperability with Microsoft Excel 2013 or newer. - Example + =CEILING.MATH(-10;-3) returns -9 =CEILING.MATH(-10;-3;0) returns -9 =CEILING.MATH(-10;-3;1) returns -12 @@ -756,12 +756,12 @@ CEILING.XCL Rounds a number away from zero to the nearest multiple of Significance. - Syntax + CEILING.XCL(Number; Significance) Number is the number that is to be rounded. Significance is the number to whose multiple the value is to be rounded. This function exists for interoperability with Microsoft Excel 2007 or older versions. - Example + =CEILING.XCL(1;3) returns 3 =CEILING.XCL(7;4) returns 8 =CEILING.XCL(-10;-3) returns -12 @@ -777,12 +777,12 @@ ISO.CEILING Rounds a number up to the nearest multiple of Significance, regardless of sign of Significance -Syntax + ISO.CEILING(Number; Significance) Number (required) is the number that is to be rounded up. Significance (optional) is the number to whose multiple the value is to be rounded up. -Example + =ISO.CEILING(-11;-2) returns -10see also FLOOR, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP @@ -796,10 +796,10 @@ PI Returns 3.14159265358979, the value of the mathematical constant PI to 14 decimal places. -Syntax + PI() -Example + =PI() returns 3.14159265358979. @@ -813,11 +813,11 @@ MULTINOMIAL Returns the factorial of the sum of the arguments divided by the product of the factorials of the arguments. -Syntax + MULTINOMIAL(Number(s)) Number(s) is a list of up to 30 numbers. -Example + =MULTINOMIAL(F11:H11) returns 1260, if F11 to H11 contain the values 2, 3 and 4. This corresponds to the formula =(2+3+4)! / (2!*3!*4!) @@ -831,13 +831,13 @@ POWER Returns a number raised to another number. -Syntax + POWER(Base; Exponent) Returns Base raised to the power of Exponent. The same result may be achieved by using the exponentiation operator ^: Base^Exponent -Example + =POWER(4;3) returns 64, which is 4 to the power of 3. =4^3 also returns 4 to the power of 3.see also EXP, LOG, SQRT @@ -853,7 +853,7 @@ Sums the first terms of a power series. 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) -Syntax + SERIESSUM(X; N; M; Coefficients) X is the input value for the power series. N is the initial power @@ -873,12 +873,12 @@ PRODUCT Multiplies all the numbers given as arguments and returns the product. -Syntax + PRODUCT(Number1; Number2; ...; Number30) Number1 to 30 are up to 30 arguments whose product is to be calculated. PRODUCT returns number1 * number2 * number3 * ... -Example + =PRODUCT(2;3;4) returns 24.see also FACT, SUM @@ -894,11 +894,11 @@ SUMSQ 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. -Syntax + SUMSQ(Number1; Number2; ...; Number30) Number1 to 30 are up to 30 arguments the sum of whose squares is to be calculated. -Example + If you enter the numbers 2; 3 and 4 in the Number 1; 2 and 3 text boxes, 29 is returned as the result. @@ -913,12 +913,12 @@ MOD Returns the remainder when one integer is divided by another. -Syntax + MOD(Dividend; Divisor) For integer arguments this function returns Dividend modulo Divisor, that is the remainder when Dividend is divided by Divisor. This function is implemented as Dividend - Divisor * INT(Dividend/Divisor) , and this formula gives the result if the arguments are not integer. -Example + =MOD(22;3) returns 1, the remainder when 22 is divided by 3. =MOD(11.25;2.5) returns 1.25.see also QUOTIENT, INT @@ -934,12 +934,12 @@ QUOTIENT Returns the integer part of a division operation. -Syntax + QUOTIENT(Numerator; Denominator) Returns the integer part of Numerator divided by Denominator. QUOTIENT is equivalent to INT(numerator/denominator) for same-sign numerator and denominator, except that it may report errors with different error codes. More generally, it is equivalent to INT(numerator/denominator/SIGN(numerator/denominator))*SIGN(numerator/denominator). -Example + =QUOTIENT(11;3) returns 3. The remainder of 2 is lost.see also MOD, INT @@ -954,11 +954,11 @@ RADIANS Converts degrees to radians. -Syntax + RADIANS(Number) Number is the angle in degrees to be converted to radians. -Example + =RADIANS(90) returns 1.5707963267949, which is PI/2 to Calc's accuracy.see also DEGREES @@ -976,12 +976,12 @@ ROUND Rounds a number to a certain number of decimal places. -Syntax + ROUND(Number; Count) Returns Number rounded to Count 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. This function rounds to the nearest number. See ROUNDDOWN and ROUNDUP for alternatives. -Example + =ROUND(2.348;2) returns 2.35 =ROUND(-32.4834;3) returns -32.483. Change the cell format to see all decimals. =ROUND(2.348;0) returns 2. @@ -999,12 +999,12 @@ ROUNDDOWN Rounds a number down, toward zero, to a certain precision. -Syntax + ROUNDDOWN(Number; Count) Returns Number rounded down (towards zero) to Count 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. This function rounds towards zero. See ROUNDUP and ROUND for alternatives. -Example + =ROUNDDOWN(1.234;2) returns 1.23. =ROUNDDOWN(45.67;0) returns 45. =ROUNDDOWN(-45.67) returns -45. @@ -1021,12 +1021,12 @@ ROUNDUP Rounds a number up, away from zero, to a certain precision. -Syntax + ROUNDUP(Number; Count) Returns Number rounded up (away from zero) to Count 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. This function rounds away from zero. See ROUNDDOWN and ROUND for alternatives. -Example + =ROUNDUP(1.1111;2) returns 1.12. =ROUNDUP(1.2345;1) returns 1.3. =ROUNDUP(45.67;0) returns 46. @@ -1044,12 +1044,12 @@ SEC 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 -Syntax + SEC(Number) Returns the (trigonometric) secant of Number, the angle in radians. To return the secant of an angle in degrees, use the RADIANS function. -Examples + =SEC(PI()/4) returns approximately 1.4142135624, the inverse of the cosine of PI/4 radians. =SEC(RADIANS(60)) returns 2, the secant of 60 degrees.see also SIN, TAN, COT, CSC, ACOS, ASIN, ATAN, ATAN2, ACOT @@ -1065,11 +1065,11 @@ SECH Returns the hyperbolic secant of a number. -Syntax + SECH(Number) Returns the hyperbolic secant of Number. -Example + =SECH(0) returns 1, the hyperbolic secant of 0.see also SINH, TANH, COTH, CSCH, ACOSH, ASINH, ATANH, ACOTH @@ -1084,12 +1084,12 @@ SIN Returns the sine of the given angle (in radians). -Syntax + SIN(Number) Returns the (trigonometric) sine of Number, the angle in radians. To return the sine of an angle in degrees, use the RADIANS function. -Example + =SIN(PI()/2) returns 1, the sine of PI/2 radians. =SIN(RADIANS(30)) returns 0.5, the sine of 30 degrees.see also COS, TAN, COT, ACOS, ASIN, ATAN, ATAN2, ACOT @@ -1105,11 +1105,11 @@ SINH Returns the hyperbolic sine of a number. -Syntax + SINH(Number) Returns the hyperbolic sine of Number. -Example + =SINH(0) returns 0, the hyperbolic sine of 0.see also COSH, TANH, COTH, ACOSH, ASINH, ATANH, ACOTH @@ -1125,11 +1125,11 @@ SUM Adds all the numbers in a range of cells. -Syntax + SUM(Number1; Number2; ...; Number30) Number 1 to Number 30 are up to 30 arguments whose sum is to be calculated. -Example + If you enter the numbers 2; 3 and 4 in the Number 1; 2 and 3 text boxes, 9 will be returned as the result. =SUM(A1;A3;B5) calculates the sum of the three cells. =SUM (A1:E10) calculates the sum of all cells in the A1 to E10 cell range. Conditions linked by AND can be used with the function SUM() in the following manner: @@ -1154,14 +1154,14 @@ Adds the cells specified by a given criteria. This function is used to browse a range when you search for a certain value. -Syntax + SUMIF(Range; Criteria; SumRange) Range is the range to which the criteria are to be applied. Criteria 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. SumRange is the range from which values are summed. If this parameter has not been indicated, the values found in the Range are summed. SUMIF supports the reference concatenation operator (~) only in the Criteria parameter, and only if the optional SumRange parameter is not given. -Example + To sum up only negative numbers: =SUMIF(A1:A10;"<0") =SUMIF(A1:A10;">0";B1:10) - sums values from the range B1:B10 only if the corresponding values in the range A1:A10 are >0. See COUNTIF() for some more syntax examples that can be used with SUMIF(). @@ -1187,12 +1187,12 @@ TAN Returns the tangent of the given angle (in radians). -Syntax + TAN(Number) Returns the (trigonometric) tangent of Number, the angle in radians. To return the tangent of an angle in degrees, use the RADIANS function. -Example + =TAN(PI()/4) returns 1, the tangent of PI/4 radians. =TAN(RADIANS(45)) returns 1, the tangent of 45 degrees.see also COS, SIN, COT, ACOS, ASIN, ATAN, ATAN2, ACOT @@ -1208,11 +1208,11 @@ TANH Returns the hyperbolic tangent of a number. -Syntax + TANH(Number) Returns the hyperbolic tangent of Number. -Example + =TANH(0) returns 0, the hyperbolic tangent of 0.see also COSH, SINH, COTH, ACOSH, ASINH, ATANH, ACOTH @@ -1230,7 +1230,7 @@ SUBTOTAL Calculates subtotals. 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. -Syntax + SUBTOTAL(Function; Range) Function is a number that stands for one of the following functions: @@ -1374,7 +1374,7 @@ Use numbers 1-11 to include manually hidden rows or 101-111 to exclude them; filtered-out cells are always excluded. Range is the range whose cells are included. -Example + 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: @@ -1473,7 +1473,7 @@ EUROCONVERTinsert link in financialConverts between old European national currency and to and from Euros. -Syntax +EUROCONVERT(Value; "From_currency"; "To_currency", full_precision, triangulation_precision)Value is the amount of the currency to be converted.From_currency and To_currency 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. @@ -1496,10 +1496,10 @@ Converts a value from one unit of measurement to another unit of measurement. The conversion factors are given in a list in the configuration.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. -Syntax +CONVERT_OOO(value;"text";"text") -Example +=CONVERT_OOO(100;"ATS";"EUR") returns the Euro value of 100 Austrian Schillings.=CONVERT_OOO(100;"EUR";"DEM") converts 100 Euros into German Marks. @@ -1515,11 +1515,11 @@ ODDRounds a positive number up to the nearest odd integer and a negative number down to the nearest odd integer. -Syntax +ODD(Number)Returns Number rounded to the next odd integer up, away from zero. -Example +=ODD(1.2) returns 3.=ODD(1) returns 1.=ODD(0) returns 1. @@ -1537,12 +1537,12 @@ FLOOR.PRECISERounds a number down to the nearest multiple of Significance, regardless of sign of Significance -Syntax +FLOOR.PRECISE(Number; Significance)Number is the number that is to be rounded down.Significance is the value to whose multiple the number is to be rounded down. -Example +=FLOOR.PRECISE( -11;-2) returns -12see also CEILING, EVEN, ODD, MROUND,INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP @@ -1557,14 +1557,14 @@ FLOORRounds a number down to the nearest multiple of Significance. -Syntax +FLOOR(Number; Significance; Mode)Number is the number that is to be rounded down.Significance is the value to whose multiple the number is to be rounded down.Mode 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.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. -Example +=FLOOR( -11;-2) returns -12=FLOOR( -11;-2;0) returns -12=FLOOR( -11;-2;1) returns -10see also CEILING, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP @@ -1581,11 +1581,11 @@ SIGNReturns the sign of a number. Returns 1 if the number is positive, -1 if negative and 0 if zero. -Syntax +SIGN(Number)Number is the number whose sign is to be determined. -Example +=SIGN(3.4) returns 1.=SIGN(-4.5) returns -1.see also ABS @@ -1601,12 +1601,12 @@ MROUNDReturns a number rounded to the nearest multiple of another number. -Syntax +MROUND(Number; Multiple)Returns Number rounded to the nearest multiple of Multiple.An alternative implementation would be Multiple * ROUND(Number/Multiple). -Example +=MROUND(15.5;3) returns 15, as 15.5 is closer to 15 (= 3*5) than to 18 (= 3*6).=MROUND(1.4;0.5) returns 1.5 (= 0.5*3).see also CEILING, FLOOR, EVEN, ODD, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP @@ -1622,12 +1622,12 @@ SQRTReturns the positive square root of a number. -Syntax +SQRT(Number)Returns the positive square root of Number.Number must be positive. -Example +=SQRT(16) returns 4.=SQRT(-16) returns an invalid argument error.see also SQRTPI, POWER @@ -1643,12 +1643,12 @@ SQRTPIReturns the square root of (PI times a number). -Syntax +SQRTPI(Number)Returns the positive square root of (PI multiplied by Number).This is equivalent to SQRT(PI()*Number). -Example +=SQRTPI(2) returns the squareroot of (2PI), approximately 2.506628.see also SQRT @@ -1663,14 +1663,14 @@ RANDBETWEENReturns an integer random number in a specified range. -Syntax +RANDBETWEEN(Bottom; Top)Returns an integer random number between integers Bottom and Top (both inclusive).This function produces a new random number each time Calc recalculates. To force Calc to recalculate manually press Shift+Command Ctrl+F9.To generate random numbers which never recalculate, copy cells containing this function, and use Edit - Paste Special (with Paste All and Formulas not marked and Numbers marked). -Example +=RANDBETWEEN(20;30) returns an integer of between 20 and 30.see also RAND @@ -1685,12 +1685,12 @@ RANDReturns a random number between 0 and 1.The value of 0 can be returned, the value of 1 not.this is really true after issue 53642 will be fixed -Syntax +RAND()This function produces a new random number each time Calc recalculates. To force Calc to recalculate manually press F9.To generate random numbers which never recalculate, copy cells each containing =RAND(), and use Edit - Paste Special (with Paste All and Formulas not marked and Numbers marked). -Example +=RAND() returns a random number between 0 and 1.see also RANDBETWEEN 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 @@ MUNITReturns the unitary square array of a certain size. The unitary array is a square array where the main diagonal elements equal 1 and all other array elements are equal to 0. -Syntax +MUNIT(Dimensions)Dimensions refers to the size of the array unit.You can find a general introduction to Array functions at the top of this page. -Example +Select a square range within the spreadsheet, for example, from A1 to E5.Without deselecting the range, select the MUNIT function. Mark the Array check box. Enter the desired dimensions for the array unit, in this case 5, and click OK. -You can also enter the =Munit(5) formula in the last cell of the selected range (E5), and press Shift+Command+Enter -Shift+Ctrl+Enter. +You can also enter the =Munit(5) formula in the last cell of the selected range (E5), and press Shift+Command+Enter + Shift+Ctrl+Enter.You now see a unit array with a range of A1:E5. @@ -389,13 +389,13 @@ FREQUENCYIndicates the frequency distribution in a one-column-array. The function counts the number of values in the Data array that are within the values given by the Classes array. -Syntax +FREQUENCY(Data; Classes)Data represents the reference to the values to be counted.Classes represents the array of the limit values.You can find a general introduction to Array functions at the top of this page. -Example +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.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.UFI: replace table by picture
@@ -573,7 +573,7 @@ MDETERMReturns the array determinant of an array. This function returns a value in the current cell; it is not necessary to define a range for the results. -Syntax +MDETERM(Array)Array represents a square array in which the determinants are defined.You can find a general introduction to using Array functions on top of this page. @@ -591,12 +591,12 @@ MINVERSEReturns the inverse array. -Syntax +MINVERSE(Array)Array represents a square array that is to be inverted. -Example +Select a square range and select MINVERSE. Select the output array, select the Array field and click OK. @@ -610,13 +610,13 @@ MMULTCalculates the array product of two arrays. 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. -Syntax +MMULT(Array; Array)Array at first place represents the first array used in the array product.Array at second place represents the second array with the same number of rows. -Example +Select a square range. Choose the MMULT function. Select the first Array, then select the second Array. Using Function Wizard, mark the Array check box. Click OK. The output array will appear in the first selected range. @@ -630,12 +630,12 @@ TRANSPOSETransposes the rows and columns of an array. -Syntax +TRANSPOSE(Array)Array represents the array in the spreadsheet that is to be transposed.You can find a general introduction to using Array functions on top of this page. -Example +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 Shift+Command+Enter Shift+Ctrl+Enter. Or, if you are using the Function Wizard, mark the Array check box. The transposed array appears in the selected target range and is protected automatically against changes. @@ -766,7 +766,7 @@ LINESTReturns a table of statistics for a straight line that best fits a data set.changed based on https://wiki.documentfoundation.org/Documentation/How_Tos/Calc:_LINEST_function (issue 76142) -Syntax +LINEST(data_Y; data_X; linearType; stats)data_Y is a single row or column range specifying the y coordinates in a set of data points.data_X is a corresponding single row or column range specifying the x coordinates. If data_X is omitted it defaults to 1, 2, 3, ..., n. If there is more than one set of variables data_X may be a range with corresponding multiple rows or columns. @@ -778,7 +778,7 @@ -Example +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 data_Y. If you want, you can enter other parameters. Select Array and click OK.The results returned by the system (if stats = 0), will at least show the slope of the regression line and its intersection with the Y axis. If stats does not equal 0, other results are to be displayed. @@ -1048,7 +1048,7 @@ LOGESTThis function calculates the adjustment of the entered data as an exponential regression curve (y=b*m^x).UFI: see http://support.microsoft.com/default.aspx?kbid=828528&product=xl2003 for bug #i31051# -Syntax +LOGEST(DataY; DataX; FunctionType; Stats)DataY represents the Y Data array.DataX (optional) represents the X Data array. @@ -1057,7 +1057,7 @@ -Example +See LINEST. However, no square sum will be returned. @@ -1074,12 +1074,12 @@ SUMPRODUCTMultiplies corresponding elements in the given arrays, and returns the sum of those products. -Syntax +SUMPRODUCT(Array1; Array2...Array30)Array1, Array2...Array30 represent arrays whose corresponding elements are to be multiplied.At least one array must be part of the argument list. If only one array is given, all array elements are summed. -Example +
@@ -1168,7 +1168,7 @@ SUMX2MY2 Returns the sum of the difference of squares of corresponding values in two arrays. -Syntax + SUMX2MY2(ArrayX; ArrayY) ArrayX represents the first array whose elements are to be squared and added. ArrayY represents the second array whose elements are to be squared and subtracted. @@ -1185,7 +1185,7 @@ SUMX2PY2 Returns the sum of the sum of squares of corresponding values in two arrays. -Syntax + SUMX2PY2(ArrayX; ArrayY) ArrayX represents the first array whose elements are to be squared and added. ArrayY represents the second array, whose elements are to be squared and added. @@ -1202,7 +1202,7 @@ SUMXMY2 Adds the squares of the variance between corresponding values in two arrays. -Syntax + SUMXMY2(ArrayX; ArrayY) ArrayX represents the first array whose elements are to be subtracted and squared. ArrayY represents the second array, whose elements are to be subtracted and squared. @@ -1219,7 +1219,7 @@ TREND Returns values along a linear trend. -Syntax + TREND(DataY; DataX; NewDataX; LinearType) DataY represents the Y Data array. DataX (optional) represents the X Data array. @@ -1228,7 +1228,7 @@ -Example + 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 Array field. click OK. The trend data calculated from the output data is displayed. @@ -1243,7 +1243,7 @@ GROWTH Calculates the points of an exponential trend in an array. -Syntax + GROWTH(DataY; DataX; NewDataX; FunctionType) DataY represents the Y Data array. DataX (optional) represents the X Data array. @@ -1252,7 +1252,7 @@ -Example + 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 Array and click OK. 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 @@ 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. 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. - Syntax + ADDRESS(Row; Column; Abs; A1; "Sheet") Row represents the row number for the cell reference @@ -82,10 +82,10 @@ AREAS Returns the number of individual ranges that belong to a multiple range. A range can consist of contiguous cells or a single cell. 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. - Syntax + AREAS(Reference) Reference represents the reference to a cell or cell range. - Example + =AREAS((A1:B3;F2;G1)) returns 3, as it is a reference to three cells and/or areas. After entry this gets converted to =AREAS((A1:B3~F2~G1)). @@ -97,7 +97,7 @@ DDE Returns the result of a DDE-based link. If the contents of the linked range or section changes, the returned value will also change. You must reload the spreadsheet or choose Edit - Links to see the updated links. Cross-platform links, for example from a %PRODUCTNAME installation running on a Windows machine to a document created on a Linux machine, are not allowed. - Syntax + DDE("Server"; "File"; "Range"; Mode) Server is the name of a server application. %PRODUCTNAME applications have the server name "soffice". @@ -146,7 +146,7 @@
- Example + =DDE("soffice";"c:\office\document\data1.ods";"sheet1.A1") reads the contents of cell A1 in sheet1 of the %PRODUCTNAME Calc spreadsheet data1.ods. @@ -160,11 +160,11 @@ Returns the number corresponding to an error value occurring in a different cell. With the aid of this number, you can generate an error message text. The Status Bar displays the predefined error code from %PRODUCTNAME if you click the cell containing the error. - Syntax + ERRORTYPE(Reference) Reference contains the address of the cell in which the error occurs. - Example + If cell A1 displays Err:518, the function =ERRORTYPE(A1) returns the number 518.
@@ -177,7 +177,7 @@ 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.UFI: will change with i4904; see http://so-web.germany.sun.com/iBIS/servlet/edit.ControlPanel?tid=i57108changed by i83070 - Syntax + INDEX(Reference; Row; Column; Range) Reference 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. @@ -187,7 +187,7 @@ Column (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. Range (optional) represents the index of the subrange if referring to a multiple range. - Example + =INDEX(Prices;4;1) returns the value from row 4 and column 1 of the database range defined in Data - Define as Prices. @@ -210,14 +210,14 @@ INDIRECT Returns the reference specified by a text string. This function can also be used to return the area of a corresponding string. - Syntax + INDIRECT(Ref; A1) Ref represents a reference to a cell or an area (in text form) for which to return the contents. A1 (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. 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).UFI: for #i34465# - Example + =INDIRECT(A1) equals 100 if A1 contains C108 as a reference and cell C108 contains a value of 100. @@ -229,12 +229,12 @@ COLUMN Returns the column number of a cell reference. 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 array if the formula is entered as an array formula. 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. - Syntax + COLUMN(Reference) Reference is the reference to a cell or cell area whose first column number is to be found. If no reference is entered, the column number of the cell in which the formula is entered is found. %PRODUCTNAME Calc automatically sets the reference to the current cell. - Example + =COLUMN(A1) equals 1. Column A is the first column in the table. @@ -254,11 +254,11 @@ COLUMNS Returns the number of columns in the given reference. - Syntax + COLUMNS(Array) Array is the reference to a cell range whose total number of columns is to be found. The argument can also be a single cell. - Example + =COLUMNS(B5) returns 1 because a cell only contains one column. @@ -274,7 +274,7 @@ VLOOKUP Vertical search with reference to adjacent cells to the right. 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 Index. If the Sorted 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 SearchCriterion is not found, the last value that is smaller than the criterion will be returned. If Sorted is set to FALSE or zero, an exact match must be found, otherwise the error Error: Value Not Available will be the result. Thus with a value of zero the data does not need to be sorted in ascending order. - Syntax + =VLOOKUP(SearchCriterion; Array; Index; Sorted) SearchCriterion is the value searched for in the first column of the array. @@ -285,7 +285,7 @@ Sorted 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: Error: Value Not Available. - Example + 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 100, E1 contains the name Vegetable Soup, and so forth, for 100 menu items. The numbers in column D are sorted in ascending order; thus, the optional Sorted parameter is not necessary. Enter the following formula in B1: @@ -300,11 +300,11 @@ SHEET Returns the sheet number of a reference or a string representing a sheet name. If you do not enter any parameters, the result is the sheet number of the spreadsheet containing the formula. - Syntax + SHEET(Reference) Reference is optional and is the reference to a cell, an area, or a sheet name string. - Example + =SHEET(Sheet2.A1) returns 2 if Sheet2 is the second sheet in the spreadsheet document.
@@ -315,11 +315,11 @@ SHEETS Determines the number of sheets in a reference. If you do not enter any parameters, it returns the number of sheets in the current document. - Syntax + SHEETS(Reference) Reference is the reference to a sheet or an area. This parameter is optional. - Example + =SHEETS(Sheet1.A1:Sheet3.G12) returns 3 if Sheet1, Sheet2, and Sheet3 exist in the sequence indicated. @@ -329,7 +329,7 @@ MATCH Returns the relative position of an item in an array that matches a specified value. The function returns the position of the value found in the lookup_array as a number. - Syntax + MATCH(SearchCriterion; LookupArray; Type) SearchCriterion is the value which is to be searched for in the single-row or single-column array. @@ -340,7 +340,7 @@ 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). 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. - Example + =MATCH(200;D1:D100) 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. @@ -350,7 +350,7 @@ OFFSET Returns the value of a cell offset by a certain number of rows and columns from a given reference point. - Syntax + OFFSET(Reference; Rows; Columns; Height; Width) Reference is the reference from which the function searches for the new reference. @@ -367,7 +367,7 @@ - Example + =OFFSET(A1;2;2) returns the value in cell C3 (A1 moved by two rows and two columns down). If C3 contains the value 100 this function returns the value 100. @@ -390,7 +390,7 @@ Returns the contents of a cell either from a one-row or one-column range. Optionally, the assigned value (of the same index) is returned in a different column and row. As opposed to VLOOKUP and HLOOKUP, 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. 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. - Syntax + LOOKUP(SearchCriterion; SearchVector; ResultVector) SearchCriterion is the value to be searched for; entered either directly or as a reference. @@ -399,7 +399,7 @@ ResultVector 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. - Example + =LOOKUP(A1;D1:D100;F1:F100) 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). @@ -409,7 +409,7 @@ STYLE Applies a style to the cell containing the formula. 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. - Syntax + STYLE("Style"; Time; "Style2") Style is the name of a cell style assigned to the cell. Style names must be entered in quotation marks. @@ -420,7 +420,7 @@ - Example + =STYLE("Invisible";60;"Default") 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. 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: @@ -435,13 +435,13 @@ CHOOSE Uses an index to return a value from a list of up to 30 values. - Syntax + CHOOSE(Index; Value1; ...; Value30) Index is a reference or number between 1 and 30 indicating which value is to be taken from the list. Value1, Value2, ..., Value30 is the list of values entered as a reference to a cell or as individual values. - Example + =CHOOSE(A1;B1;B2;B3;"Today";"Yesterday";"Tomorrow"), for example, returns the contents of cell B2 for A1 = 2; for A1 = 4, the function returns the text "Today". @@ -452,7 +452,7 @@ HLOOKUP Searches for a value and reference to the cells below the selected area. 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 Index, in the same column. - Syntax + HLOOKUP(SearchCriterion; Array; Index; Sorted) See also: VLOOKUP (columns and rows are exchanged) @@ -463,12 +463,12 @@ ROW Returns the row number of a cell reference. 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 Array if the formula is entered as an array formula. 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. - Syntax + ROW(Reference) Reference is a cell, an area, or the name of an area. If you do not indicate a reference, the row number of the cell in which the formula is entered will be found. %PRODUCTNAME Calc automatically sets the reference to the current cell. - Example + =ROW(B3) returns 3 because the reference refers to the third row in the table. @@ -488,11 +488,11 @@ ROWS Returns the number of rows in a reference or array. - Syntax + ROWS(Array) Array is the reference or named area whose total number of rows is to be determined. - Example + =Rows(B5) returns 1 because a cell only contains one row. @@ -508,12 +508,12 @@ When you click a cell that contains the HYPERLINK function, the hyperlink opens. If you use the optional CellText parameter, the formula locates the URL, and then displays the text or number. 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 Open Hyperlink. - Syntax + HYPERLINK("URL") or HYPERLINK("URL"; "CellText") URL specifies the link target. The optional CellText parameter is the text or a number that is displayed in the cell and will be returned as the result. If the CellText parameter is not specified, the URL is displayed in the cell text and will be returned as the result. The number 0 is returned for empty cells and matrix elements. - Example + =HYPERLINK("http://www.example.org") displays the text "http://www.example.org" in the cell and executes the hyperlink http://www.example.org when clicked. @@ -534,12 +534,12 @@ GETPIVOTDATA 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. - Syntax + Two different syntax definitions can be used: GETPIVOTDATA(TargetField; pivot table; [ Field 1; Item 1; ... ]) GETPIVOTDATA(pivot table; Constraints) 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. - First Syntax + TargetField 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"). @@ -549,7 +549,7 @@ 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. 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. Subtotal values from the pivot table are only used if they use the function "auto" (except when specified in the constraint, see Second Syntax below). - Second Syntax + pivot table has the same meaning as in the first syntax. 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 @@ ARABIC Calculates the value of a Roman number. The value range must be between 0 and 3999. -Syntax + ARABIC("Text") Text is the text that represents a Roman number. -Example + =ARABIC("MXIV") returns 1014 =ARABIC("MMII") returns 2002 @@ -72,7 +72,7 @@ The ASC function converts full-width to half-width ASCII and katakana characters. Returns a text string. See https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions for a conversion table. -Syntax + ASC("Text") Text is the text that contains characters to be converted. See also JIS function. @@ -88,11 +88,11 @@ BAHTTEXT Converts a number to Thai text, including the Thai currency names. -Syntax + BAHTTEXT(Number) Number is any number. "Baht" is appended to the integral part of the number, and "Satang" is appended to the decimal part of the number. -Example + =BAHTTEXT(12.65) returns a string in Thai characters with the meaning of "Twelve Baht and sixty five Satang". @@ -106,13 +106,13 @@ BASE Converts a positive integer to a specified base into a text from the numbering system. The digits 0-9 and the letters A-Z are used. -Syntax + BASE(Number; Radix; [MinimumLength]) Number is the positive integer to be converted. Radix indicates the base of the number system. It may be any positive integer between 2 and 36. MinimumLength (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. -Example + decimal system; converting to @@ -141,11 +141,11 @@ Converts a number into a character according to the current code table. The number can be a two-digit or three-digit integer number. -Syntax + CHAR(Number) Number is a number between 1 and 255 representing the code value for the character. -Example + =CHAR(100) returns the character d. ="abc" & CHAR(10) & "def" inserts a newline character into the string. @@ -160,7 +160,7 @@ CLEAN All non-printing characters are removed from the string. -Syntax + CLEAN("Text") Text refers to the text from which to remove all non-printable characters. @@ -175,12 +175,12 @@ CODE Returns a numeric code for the first character in a text string. -Syntax + CODE("Text") Text is the text for which the code of the first character is to be found. -Example + =CODE("Hieronymus") returns 72, =CODE("hieroglyphic") returns 104. The code used here does not refer to ASCII, but to the code table currently loaded. @@ -195,11 +195,11 @@ CONCATENATE Combines several text strings into one string. -Syntax + CONCATENATE("Text1"; ...; "Text30") Text 1; Text 2; ... represent up to 30 text passages which are to be combined into one string. -Example + =CONCATENATE("Good ";"Morning ";"Mrs. ";"Doe") returns: Good Morning Mrs. Doe. @@ -214,12 +214,12 @@ Converts text with characters from a number system to a positive integer in the base radix given. The radix must be in the range 2 to 36. Spaces and tabs are ignored. The Text field is not case-sensitive. 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. -Syntax + DECIMAL("Text"; Radix) Text 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". Radix indicates the base of the number system. It may be any positive integer between 2 and 36. -Example + =DECIMAL("17";10) returns 17. =DECIMAL("FACE";16) returns 64206. =DECIMAL("0101";2) returns 5. @@ -236,12 +236,12 @@ Converts a number to an amount in the currency format, rounded to a specified decimal place. In the Value field enter the number to be converted to currency. Optionally, you may enter the number of decimal places in the Decimals field. If no value is specified, all numbers in currency format will be displayed with two decimal places. You set the currency format in your system settings. -Syntax + DOLLAR(Value; Decimals) Value is a number, a reference to a cell containing a number, or a formula which returns a number. Decimals is the optional number of decimal places. -Example + =DOLLAR(255) returns $255.00. =DOLLAR(367.456;2) returns $367.46. Use the decimal separator that corresponds to the current locale setting. @@ -256,12 +256,12 @@ EXACT Compares two text strings and returns TRUE if they are identical. This function is case-sensitive. -Syntax + EXACT("Text1"; "Text2") Text1 refers to the first text to compare. Text2 is the second text to compare. -Example + =EXACT("microsystems";"Microsystems") returns FALSE. @@ -275,13 +275,13 @@ FIND Returns the position of a string of text within another string.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. -Syntax + FIND("FindText"; "Text"; Position) FindText refers to the text to be found. Text is the text where the search takes place. Position (optional) is the position in the text from which the search starts. -Example + =FIND(76;998877665544) returns 6. @@ -295,13 +295,13 @@ FIXED Returns a number as text with a specified number of decimal places and optional thousands separators. -Syntax + FIXED(Number; Decimals; NoThousandsSeparators) Number refers to the number to be formatted. Decimals refers to the number of decimal places to be displayed. NoThousandsSeparators (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 current locale setting are displayed. -Example + =FIXED(1234567.89;3) returns 1,234,567.890 as a text string. =FIXED(1234567.89;3;1) returns 1234567.890 as a text string. @@ -317,7 +317,7 @@ The JIS function converts half-width to full-width ASCII and katakana characters. Returns a text string. See https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions for a conversion table. -Syntax + JIS("Text") Text is the text that contains characters to be converted. See also ASC function. @@ -333,12 +333,12 @@ LEFT Returns the first character or characters of a text. -Syntax + LEFT("Text"; Number) Text is the text where the initial partial words are to be determined. Number (optional) specifies the number of characters for the start text. If this parameter is not defined, one character is returned. -Example + =LEFT("output";3) returns “out”. @@ -352,12 +352,12 @@ LEFTB Returns the first characters of a DBCS text. -Syntax + LEFTB("Text"; Number_bytes) Text is the text where the initial partial words are to be determined. Number_bytes (optional) specifies the number of characters you want LEFTB to extract, based on bytes. If this parameter is not defined, one character is returned. -Examples + LEFTB("中国";1) returns " " (1 byte is only half a DBCS character and a space character is returned instead). LEFTB("中国";2) returns "中" (2 bytes constitute one complete DBCS character). LEFTB("中国";3) returns "中 " (3 bytes constitute one DBCS character and a half; the last character returned is therefore a space character). @@ -375,11 +375,11 @@ LEN Returns the length of a string including spaces. -Syntax + LEN("Text") Text is the text whose length is to be determined. -Example + =LEN("Good Afternoon") returns 14. =LEN(12345.67) returns 8. @@ -394,11 +394,11 @@ LENB For double-byte character set (DBCS) languages, returns the number of bytes used to represent the characters in a text string. -Syntax + LENB("Text") Text is the text whose length is to be determined. -Examples + LENB("中") returns 2 (1 DBCS character consisting of 2 bytes). LENB("中国") returns 4 (2 DBCS characters each consisting of 2 bytes). LENB("office") returns 6 (6 non-DBCS characters each consisting of 1 byte). @@ -416,11 +416,11 @@ LOWER Converts all uppercase letters in a text string to lowercase. -Syntax + LOWER("Text") Text refers to the text to be converted. -Example + =LOWER("Sun") returns sun. @@ -434,13 +434,13 @@ MID Returns a text string of a text. The parameters specify the starting position and the number of characters. -Syntax + MID("Text"; Start; Number) Text is the text containing the characters to extract. Start is the position of the first character in the text to extract. Number specifies the number of characters in the part of the text. -Example + =MID("office";2;2) returns ff. @@ -454,13 +454,13 @@ MIDB Returns a text string of a DBCS text. The parameters specify the starting position and the number of characters. -Syntax + MIDB("Text"; Start; Number_bytes) Text is the text containing the characters to extract. Start is the position of the first character in the text to extract. Number_bytes specifies the number of characters MIDB will return from text, in bytes. -Examples + MIDB("中国";1;0) returns "" (0 bytes is always an empty string). MIDB("中国";1;1) returns " " (1 byte is only half a DBCS character and therefore the result is a space character). MIDB("中国";1;2) returns "中" (2 bytes constitute one complete DBCS character). @@ -484,11 +484,11 @@ PROPER Capitalizes the first letter in all words of a text string. -Syntax + PROPER("Text") Text refers to the text to be converted. -Example + =PROPER("open office") returns Open Office. @@ -503,14 +503,14 @@ Replaces part of a text string with a different text string. 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 VALUE function. 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. -Syntax + REPLACE("Text"; Position; Length; "NewText") Text refers to text of which a part will be replaced. Position refers to the position within the text where the replacement will begin. Length is the number of characters in Text to be replaced. NewText refers to the text which replaces Text. -Example + =REPLACE("1234567";1;1;"444") returns "444234567". One character at position 1 is replaced by the complete NewText. @@ -524,13 +524,13 @@ REPT Repeats a character string by the given number of copies. -Syntax + REPT("Text"; Number) Text is the text to be repeated. Number is the number of repetitions. The result can be a maximum of 255 characters. -Example + =REPT("Good morning";2) returns Good morningGood morning. @@ -544,12 +544,12 @@ RIGHT Returns the last character or characters of a text. -Syntax + RIGHT("Text"; Number) Text is the text of which the right part is to be determined. Number (optional) is the number of characters from the right part of the text. -Example + =RIGHT("Sun";2) returns un. @@ -563,12 +563,12 @@ RIGHTB Returns the last character or characters of a text with double bytes characters sets (DBCS). -Syntax + RIGHTB("Text"; Number_bytes) Text is the text of which the right part is to be determined. Number_bytes (optional) specifies the number of characters you want RIGHTB to extract, based on bytes. -Examples + RIGHTB("中国";1) returns " " (1 byte is only half a DBCS character and a space character is returned instead). RIGHTB("中国";2) returns "国" (2 bytes constitute one complete DBCS character). RIGHTB("中国";3) returns " 国" (3 bytes constitute one half DBCS character and one whole DBCS character; a space is returned for the first half). @@ -586,12 +586,12 @@ ROMAN 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. -Syntax + ROMAN(Number; Mode) Number is the number that is to be converted into a Roman numeral. Mode (optional) indicates the degree of simplification. The higher the value, the greater is the simplification of the Roman number. -Example + =ROMAN(999) returns CMXCIX =ROMAN(999;0) returns CMXCIX =ROMAN (999;1) returns LMVLIV @@ -611,13 +611,13 @@ Returns the position of a text segment within a character string. 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). -Syntax + SEARCH("FindText"; "Text"; Position) FindText is the text to be searched for. Text is the text where the search will take place. Position (optional) is the position in the text where the search is to start. -Example + =SEARCH(54;998877665544) returns 10. @@ -631,14 +631,14 @@ SUBSTITUTE Substitutes new text for old text in a string. -Syntax + SUBSTITUTE("Text"; "SearchText"; "NewText"; Occurrence) Text is the text in which text segments are to be exchanged. SearchText is the text segment that is to be replaced (a number of times). NewText is the text that is to replace the text segment. Occurrence (optional) indicates which occurrence of the search text is to be replaced. If this parameter is missing the search text is replaced throughout. -Example + =SUBSTITUTE("123123123";"3";"abc") returns 12abc12abc12abc. =SUBSTITUTE("123123123";"3";"abc";2) returns 12312abc123. @@ -653,11 +653,11 @@ T This function returns the target text, or a blank text string if the target is not text. -Syntax + T(Value) If Value is a text string or refers to a text string, T returns that text string; otherwise it returns a blank text string. -Example + =T(12345) returns an empty string. =T("12345") returns the string 12345. @@ -672,12 +672,12 @@ TEXT Converts a number into text according to a given format. -Syntax + TEXT(Number; Format) Number is the numerical value to be converted. Format is the text which defines the format. Use decimal and thousands separators according to the language set in the cell format. -Example + =TEXT(12.34567;"###.##") returns the text 12.35 =TEXT(12.34567;"000.00") returns the text 012.35 @@ -694,11 +694,11 @@ TRIM Removes spaces from a string, leaving only a single space character between words. -Syntax + TRIM("Text") Text refers to text in which spaces are to be removed. -Example + =TRIM(" hello world ") returns hello world without leading and trailing spaces and with single space between words. @@ -712,10 +712,10 @@ UNICHAR Converts a code number into a Unicode character or letter. -Syntax + UNICHAR(number) -Example + =UNICHAR(169) returns the Copyright character ©. See also the UNICODE() function. @@ -730,10 +730,10 @@ UNICODE Returns the numeric code for the first Unicode character in a text string. -Syntax + UNICODE("Text") -Example + =UNICODE("©") returns the Unicode number 169 for the Copyright character. See also the UNICHAR() function. @@ -748,11 +748,11 @@ UPPER Converts the string specified in the text field to uppercase. -Syntax + UPPER("Text") Text refers to the lower case letters you want to convert to upper case. -Example + =UPPER("Good Morning") returns GOOD MORNING. @@ -766,11 +766,11 @@ VALUE Converts a text string into a number. -Syntax + VALUE("Text") Text is the text to be converted to a number. -Example + =VALUE("4321") returns 4321. 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 @@ The following describes and lists some of the available add-in functions. Add-in concept -You will also find a description of the $[officename] Calc add-in interface in the Help. In addition, important functions and their parameters are described in the Help for the Shared Library +You will also find a description of the $[officename] Calc add-in interface in the Help. In addition, important functions and their parameters are described in the Help for the Shared Library $[officename] Calc add-in DLL. Add-ins supplied $[officename] contains examples for the add-in interface of $[officename] Calc. @@ -47,11 +47,11 @@ mw added one entry ISLEAPYEAR Determines whether a year is a leap year. If yes, the function will return the value 1 (TRUE); if not, it will return 0 (FALSE). -Syntax + ISLEAPYEAR(Date) Date specifies whether a given date falls within a leap year. The Date parameter must be a valid date. -Example + =ISLEAPYEAR(A1) returns 1, if A1 contains 1968-02-29, the valid date 29th of February 1968 in your locale setting. You may also use =ISLEAPYEAR(DATE(1968;2;29)) or =ISLEAPYEAR("1968-02-29") giving the date string in the ISO 8601 notation. 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. @@ -63,7 +63,7 @@ YEARS Calculates the difference in years between two dates. -Syntax + YEARS(StartDate; EndDate; Type) StartDate is the first date @@ -79,7 +79,7 @@ MONTHS Calculates the difference in months between two dates. -Syntax + MONTHS(StartDate; EndDate; Type) StartDate is the first date @@ -95,7 +95,7 @@ ROT13 Encrypts a character string by moving the characters 13 positions in the alphabet. After the letter Z, the alphabet begins again (Rotation). By applying the encryption function again to the resulting code, you can decrypt the text. -Syntax + ROT13(Text) Text is the character string to be encrypted. ROT13(ROT13(Text)) decrypts the code. @@ -107,11 +107,11 @@ DAYSINYEAR Calculates the number of days of the year in which the date entered occurs. -Syntax + DAYSINYEAR(Date) Date is any date in the respective year. The Date parameter must be a valid date according to the locale settings of %PRODUCTNAME. -Example + =DAYSINYEAR(A1) returns 366 days if A1 contains 1968-02-29, a valid date for the year 1968.
@@ -121,11 +121,11 @@ DAYSINMONTH Calculates the number of days of the month in which the date entered occurs. -Syntax + DAYSINMONTH(Date) Date 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. -Example + =DAYSINMONTH(A1) returns 29 days if A1 contains 1968-02-17, a valid date for February 1968.
@@ -135,7 +135,7 @@ WEEKS Calculates the difference in weeks between two dates. -Syntax + WEEKS(StartDate; EndDate; Type) StartDate is the first date @@ -151,11 +151,11 @@ WEEKSINYEAR Calculates the number of weeks of the year in which the date entered occurs. 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. -Syntax + WEEKSINYEAR(Date) Date is any date in the respective year. The Date parameter must be a valid date according to the locale settings of %PRODUCTNAME. -Example + WEEKSINYEAR(A1) returns 53 if A1 contains 1970-02-17, a valid date for the year 1970.
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 @@ BESSELI Calculates the modified Bessel function of the first kind In(x). -Syntax + BESSELI(X; N) X is the value on which the function will be calculated. N is a positive integer (N >= 0) representing the order of the Bessel function In(x) -Examples + =BESSELI(3.45, 4), returns 0.651416873060081 =BESSELI(3.45, 4.333), returns 0.651416873060081, same as above because the fractional part of N is ignored. =BESSELI(-1, 3), returns -0.022168424924332 @@ -67,12 +67,12 @@ BESSELJ Calculates the Bessel function of the first kind Jn(x) (cylinder function). -Syntax + BESSELJ(X; N) X is the value on which the function will be calculated. N is a positive integer (N >= 0) representing the order of the Bessel function Jn(x) -Examples + =BESSELJ(3.45, 4), returns 0.196772639864984 =BESSELJ(3.45, 4.333), returns 0.196772639864984, same as above because the fractional part of N is ignored. =BESSELJ(-1, 3), returns -0.019563353982668 @@ -84,12 +84,12 @@ BESSELK Calculates the modified Bessel function of the second kind Kn(x). -Syntax + BESSELK(X; N) X is the strictly positive value (X > 0) on which the function will be calculated. N is a positive integer (N >= 0) representing the order of the Bessel function Kn(x) -Examples + =BESSELK(3.45, 4), returns 0.144803466373734 =BESSELK(3.45, 4.333), returns 0.144803466373734, same as above because the fractional part of N is ignored. =BESSELK(0, 3), returns Err:502 – invalid argument (X=0) @@ -101,12 +101,12 @@ BESSELY Calculates the Bessel function of the second kind Yn(x). -Syntax + BESSELY(X; N) X is the strictly positive value (X > 0) on which the function will be calculated. N is a positive integer (N >= 0) representing the order of the Bessel function Yn(x) -Examples + =BESSELY(3.45, 4), returns -0.679848116844476 =BESSELY(3.45, 4.333), returns -0.679848116844476, same as above because the fractional part of N is ignored. =BESSELY(0, 3), returns Err:502 – invalid argument (X=0) @@ -123,11 +123,11 @@ BIN2DEC The result is the decimal number for the binary number entered. -Syntax + BIN2DEC(Number) Number 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. -Example + =BIN2DEC(1100100) returns 100. @@ -142,12 +142,12 @@ BIN2HEX The result is the hexadecimal number for the binary number entered. -Syntax + BIN2HEX(Number; Places) Number 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. Places means the number of places to be output. -Example + =BIN2HEX(1100100;6) returns 000064. @@ -162,12 +162,12 @@ BIN2OCT The result is the octal number for the binary number entered. -Syntax + BIN2OCT(Number; Places) Number 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. Places means the number of places to be output. -Example + =BIN2OCT(1100100;4) returns 0144. @@ -182,10 +182,10 @@ DELTA The result is TRUE (1) if both numbers, which are delivered as an argument, are equal, otherwise it is FALSE (0). -Syntax + DELTA(Number1; Number2) -Example + =DELTA(1;2) returns 0. @@ -200,12 +200,12 @@ DEC2BIN The result is the binary number for the decimal number entered between -512 and 511. -Syntax + DEC2BIN(Number; Places) Number 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. Places means the number of places to be output. -Example + =DEC2BIN(100;8) returns 01100100. @@ -220,12 +220,12 @@ DEC2HEX The result is the hexadecimal number for the decimal number entered. -Syntax + DEC2HEX(Number; Places) Number 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. Places means the number of places to be output. -Example + =DEC2HEX(100;4) returns 0064. @@ -240,12 +240,12 @@ DEC2OCT The result is the octal number for the decimal number entered. -Syntax + DEC2OCT(Number; Places) Number 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. Places means the number of places to be output. -Example + =DEC2OCT(100;4) returns 0144. @@ -260,12 +260,12 @@ ERF Returns values of the Gaussian error integral. -Syntax + ERF(LowerLimit; UpperLimit) LowerLimit is the lower limit of the integral. UpperLimit 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. -Example + =ERF(0;1) returns 0.842701. @@ -280,11 +280,11 @@ ERF.PRECISE Returns values of the Gaussian error integral between 0 and the given limit. -Syntax + ERF.PRECISE(LowerLimit) LowerLimit is the limit of the integral. The calculation takes places between 0 and this limit. -Example + =ERF.PRECISE(1) returns 0.842701. @@ -298,11 +298,11 @@ ERFC Returns complementary values of the Gaussian error integral between x and infinity. -Syntax + ERFC(LowerLimit) LowerLimit is the lower limit of the integral -Example + =ERFC(1) returns 0.157299. @@ -316,11 +316,11 @@ ERFC.PRECISE Returns complementary values of the Gaussian error integral between x and infinity. -Syntax + ERFC.PRECISE(LowerLimit) LowerLimit is the lower limit of the integral -Example + =ERFC.PRECISE(1) returns 0.157299. @@ -335,10 +335,10 @@ GESTEP The result is 1 if Number is greater than or equal to Step. -Syntax + GESTEP(Number; Step) -Example + =GESTEP(5;1) returns 1. @@ -353,12 +353,12 @@ HEX2BIN The result is the binary number for the hexadecimal number entered. -Syntax + HEX2BIN(Number; Places) Number 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. Places is the number of places to be output. -Example + =HEX2BIN("6a";8) returns 01101010. @@ -373,11 +373,11 @@ HEX2DEC The result is the decimal number for the hexadecimal number entered. -Syntax + HEX2DEC(Number) Number 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. -Example + =HEX2DEC("6a") returns 106. @@ -392,12 +392,12 @@ HEX2OCT The result is the octal number for the hexadecimal number entered. -Syntax + HEX2OCT(Number; Places) Number 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. Places is the number of places to be output. -Example + =HEX2OCT("6a";4) returns 0152. 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 @@ IMABS The result is the absolute value of a complex number. - Syntax + IMABS("ComplexNumber") ComplexNumber is a complex number that is entered in the form "x+yi" or "x+yj". no blanks allowed, see i82522 - Example + =IMABS("5+12j") returns 13. @@ -56,10 +56,10 @@ IMAGINARY The result is the imaginary coefficient of a complex number. - Syntax + IMAGINARY("ComplexNumber") - Example + =IMAGINARY("4+3j") returns 3. @@ -69,12 +69,12 @@ IMPOWER The result is the ComplexNumber raised to the power of Number. - Syntax + IMPOWER("ComplexNumber"; Number) Number is the exponent. - Example + =IMPOWER("2+3i";2) returns -5+12i. @@ -84,10 +84,10 @@ IMARGUMENT The result is the argument (the phi angle) of a complex number. - Syntax + IMARGUMENT("ComplexNumber") - Example + =IMARGUMENT("3+4j") returns 0.927295. @@ -137,11 +137,11 @@ IMDIV The result is the division of two complex numbers. - Syntax + IMDIV("Numerator"; "Denominator") Numerator, Denominator are complex numbers that are entered in the form "x+yi" or "x+yj". - Example + =IMDIV("-238+240i";"10+24i") returns 5+12i. @@ -151,10 +151,10 @@ IMEXP The result is the power of e and the complex number. The constant e has a value of approximately 2.71828182845904. - Syntax + IMEXP("ComplexNumber") - Example + =IMEXP("1+j") returns 1.47+2.29j (rounded). @@ -164,10 +164,10 @@ IMCONJUGATE The result is the conjugated complex complement to a complex number. - Syntax + IMCONJUGATE("ComplexNumber") - Example + =IMCONJUGATE("1+j") returns 1-j. @@ -177,10 +177,10 @@ IMLN The result is the natural logarithm (to the base e) of a complex number. The constant e has a value of approximately 2.71828182845904. - Syntax + IMLN("ComplexNumber") - Example + =IMLN("1+j") returns 0.35+0.79j (rounded). @@ -190,10 +190,10 @@ IMLOG10 The result is the common logarithm (to the base 10) of a complex number. - Syntax + IMLOG10("ComplexNumber") - Example + =IMLOG10("1+j") returns 0.15+0.34j (rounded). @@ -203,10 +203,10 @@ IMLOG2 The result is the binary logarithm of a complex number. - Syntax + IMLOG2("ComplexNumber") - Example + =IMLOG2("1+j") returns 0.50+1.13j (rounded). @@ -216,10 +216,10 @@ IMPRODUCT The result is the product of up to 29 complex numbers. - Syntax + IMPRODUCT("ComplexNumber"; "ComplexNumber1"; ...) - Example + =IMPRODUCT("3+4j";"5-3j") returns 27+11j. @@ -229,10 +229,10 @@ IMREAL The result is the real coefficient of a complex number. - Syntax + IMREAL("ComplexNumber") - Example + =IMREAL("1+3j") returns 1. @@ -282,10 +282,10 @@ IMSUB The result is the subtraction of two complex numbers. - Syntax + IMSUB("ComplexNumber1"; "ComplexNumber2") - Example + =IMSUB("13+4j";"5+3j") returns 8+j. @@ -295,10 +295,10 @@ IMSUM The result is the sum of up to 29 complex numbers. - Syntax + IMSUM("ComplexNumber1"; "ComplexNumber2"; ...) - Example + =IMSUM("13+4j";"5+3j") returns 18+7j. @@ -308,10 +308,10 @@ IMSQRT The result is the square root of a complex number. - Syntax + IMSQRT("ComplexNumber") - Example + =IMSQRT("3+4i") returns 2+1i. @@ -321,7 +321,7 @@ COMPLEX The result is a complex number which is returned from a real coefficient and an imaginary coefficient. - Syntax + COMPLEX(RealNum; INum; Suffix) RealNum is the real coefficient of the complex number. @@ -329,7 +329,7 @@ INum is the imaginary coefficient of the complex number. Suffix is a list of options, "i" or "j". - Example + =COMPLEX(3;4;"j") returns 3+4j. @@ -340,13 +340,13 @@ OCT2BIN The result is the binary number for the octal number entered. - Syntax + OCT2BIN(Number; Places) Number 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. Places is the number of places to be output. - Example + =OCT2BIN(3;3) returns 011. @@ -357,11 +357,11 @@ OCT2DEC The result is the decimal number for the octal number entered. - Syntax + OCT2DEC(Number) Number 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. - Example + =OCT2DEC(144) returns 100. @@ -372,13 +372,13 @@ OCT2HEX The result is the hexadecimal number for the octal number entered. - Syntax + OCT2HEX(Number; Places) Number 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. Places is the number of places to be output. - Example + =OCT2HEX(144;4) returns 0064. @@ -690,7 +690,7 @@ - Syntax + CONVERT(Number; "FromUnit"; "ToUnit") Number is the number to be converted. @@ -698,7 +698,7 @@ FromUnit is the unit from which conversion is taking place. ToUnit is the unit to which conversion is taking place. Both units must be of the same type. - Examples + =CONVERT(10;"HP";"PS") returns, rounded to two decimal places, 10.14. 10 HP equal 10.14 PS. @@ -711,7 +711,7 @@ FACTDOUBLE Returns the double factorial of a number. - Syntax + FACTDOUBLE(Number) Returns Number !!, the double factorial of Number, where Number is an integer greater than or equal to zero. @@ -720,7 +720,7 @@ For odd numbers FACTDOUBLE(n) returns: 1*3*5*7* ... *n FACTDOUBLE(0) returns 1 by definition. - Example + =FACTDOUBLE(5) returns 15. 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 @@ ODDFPRICE Calculates the price per 100 currency units par value of a security, if the first interest date falls irregularly. -Syntax + ODDFPRICE(Settlement; Maturity; Issue; FirstCoupon; Rate; Yield; Redemption; Frequency; Basis) Settlement is the date of purchase of the security. Maturity is the date on which the security matures (expires). @@ -65,7 +65,7 @@ ODDFYIELD Calculates the yield of a security if the first interest date falls irregularly. -Syntax + ODDFYIELD(Settlement; Maturity; Issue; FirstCoupon; Rate; Price; Redemption; Frequency; Basis) Settlement is the date of purchase of the security. Maturity is the date on which the security matures (expires). @@ -88,7 +88,7 @@ ODDLPRICE Calculates the price per 100 currency units par value of a security, if the last interest date falls irregularly. -Syntax + ODDLPRICE(Settlement; Maturity; LastInterest; Rate; Yield; Redemption; Frequency; Basis) Settlement is the date of purchase of the security. Maturity is the date on which the security matures (expires). @@ -99,7 +99,7 @@ Frequency is number of interest payments per year (1, 2 or 4). -Example + 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 The price per 100 currency units per value of a security, which has an irregular last interest date, is calculated as follows: =ODDLPRICE("1999-02-07";"1999-06-15";"1998-10-15"; 0.0375; 0.0405;100;2;0) returns 99.87829. @@ -115,7 +115,7 @@ ODDLYIELD Calculates the yield of a security if the last interest date falls irregularly. -Syntax + ODDLYIELD(Settlement; Maturity; LastInterest; Rate; Price; Redemption; Frequency; Basis) Settlement is the date of purchase of the security. Maturity is the date on which the security matures (expires). @@ -126,7 +126,7 @@ Frequency is number of interest payments per year (1, 2 or 4). -Example + 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 The yield of the security, that has an irregular last interest date, is calculated as follows: =ODDLYIELD("1999-04-20";"1999-06-15"; "1998-10-15"; 0.0375; 99.875; 100;2;0) returns 0.044873 or 4.4873%. @@ -144,7 +144,7 @@ VDB Returns the depreciation of an asset for a specified or partial period using a variable declining balance method. -Syntax + VDB(Cost; Salvage; Life; S; End; Factor; NoSwitch) Cost is the initial value of an asset. Salvage is the value of an asset at the end of the depreciation. @@ -155,7 +155,7 @@ NoSwitchis an optional parameter. NoSwitch = 0 (default) means a switch to linear depreciation. In NoSwitch = 1 no switch is made. -Example + 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. =VDB(35000;7500;36;10;20;2) = 8603.80 currency units. The depreciation during the period between the 10th and the 20th period is 8,603.80 currency units. @@ -173,12 +173,12 @@ Calculates the internal rate of return for a list of payments which take place on different dates. The calculation is based on a 365 days per year basis, ignoring leap years. If the payments take place at regular intervals, use the IRR function. -Syntax + XIRR(Values; Dates; Guess) Values and Dates 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). Guess (optional) is a guess that can be input for the internal rate of return. The default is 10%. -Example + Calculation of the internal rate of return for the following five payments: @@ -278,12 +278,12 @@ Calculates the capital value (net present value) for a list of payments which take place on different dates. The calculation is based on a 365 days per year basis, ignoring leap years.If the payments take place at regular intervals, use the NPV function. -Syntax +XNPV(Rate; Values; Dates)Rate is the internal rate of return for the payments.Values and Dates 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) -Example +Calculation of the net present value for the above-mentioned five payments for a notional internal rate of return of 6%.=XNPV(0.06;B1:B5;A1:A5) returns 323.02. @@ -299,13 +299,13 @@ RRICalculates the interest rate resulting from the profit (return) of an investment. -Syntax +RRI(P; PV; FV)P is the number of periods needed for calculating the interest rate.PV 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.FV determines what is desired as the cash value of the deposit. -Example +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.=RRI(4;7500;10000) = 7.46 %The interest rate must be 7.46 % so that 7,500 currency units will become 10,000 currency units. @@ -323,7 +323,7 @@ RATEReturns the constant interest rate per period of an annuity. -Syntax +RATE(NPer; Pmt; PV; FV; Type; Guess)NPer is the total number of periods, during which payments are made (payment period).Pmt is the constant payment (annuity) paid during each period. @@ -333,7 +333,7 @@ Guess (optional) determines the estimated value of the interest with iterative calculation. -Example +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.=RATE(3;-10;900) = -75.63% The interest rate is therefore 75.63%. @@ -348,7 +348,7 @@ INTRATECalculates 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. -Syntax +INTRATE(Settlement; Maturity; Investment; Redemption; Basis)Settlement is the date of purchase of the security.Maturity is the date on which the security is sold. @@ -356,7 +356,7 @@ Redemption is the selling price. -Example +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?=INTRATE("1990-01-15"; "2002-05-05"; 1000000; 2000000; 3) returns 8.12%. @@ -371,14 +371,14 @@ COUPNCDReturns the date of the first interest date after the settlement date. Format the result as a date. -Syntax +COUPNCD(Settlement; Maturity; Frequency; Basis)Settlement is the date of purchase of the security.Maturity is the date on which the security matures (expires).Frequency is number of interest payments per year (1, 2 or 4). -Example +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?=COUPNCD("2001-01-25"; "2001-11-15"; 2; 3) returns 2001-05-15. @@ -393,14 +393,14 @@ COUPDAYSReturns the number of days in the current interest period in which the settlement date falls. -Syntax +COUPDAYS(Settlement; Maturity; Frequency; Basis)Settlement is the date of purchase of the security.Maturity is the date on which the security matures (expires).Frequency is number of interest payments per year (1, 2 or 4). -Example +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?=COUPDAYS("2001-01-25"; "2001-11-15"; 2; 3) returns 181. @@ -415,14 +415,14 @@ COUPDAYSNCReturns the number of days from the settlement date until the next interest date. -Syntax +COUPDAYSNC(Settlement; Maturity; Frequency; Basis)Settlement is the date of purchase of the security.Maturity is the date on which the security matures (expires).Frequency is number of interest payments per year (1, 2 or 4). -Example +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?=COUPDAYSNC("2001-01-25"; "2001-11-15"; 2; 3) returns 110. @@ -439,14 +439,14 @@ COUPDAYBSReturns the number of days from the first day of interest payment on a security until the settlement date. -Syntax +COUPDAYBS(Settlement; Maturity; Frequency; Basis)Settlement is the date of purchase of the security.Maturity is the date on which the security matures (expires).Frequency is the number of interest payments per year (1, 2 or 4). -Example +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?=COUPDAYBS("2001-01-25"; "2001-11-15"; 2; 3) returns 71. @@ -462,14 +462,14 @@ COUPPCDReturns the date of the interest date prior to the settlement date. Format the result as a date. -Syntax +COUPPCD(Settlement; Maturity; Frequency; Basis)Settlement is the date of purchase of the security.Maturity is the date on which the security matures (expires).Frequency is the number of interest payments per year (1, 2 or 4). -Example +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?=COUPPCD("2001-01-25"; "2001-11-15"; 2; 3) returns 2000-15-11. @@ -485,14 +485,14 @@ COUPNUMReturns the number of coupons (interest payments) between the settlement date and the maturity date. -Syntax +COUPNUM(Settlement; Maturity; Frequency; Basis)Settlement is the date of purchase of the security.Maturity is the date on which the security matures (expires).Frequency is the number of interest payments per year (1, 2 or 4). -Example +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?=COUPNUM("2001-01-25"; "2001-11-15"; 2; 3) returns 2. @@ -508,7 +508,7 @@ IPMTCalculates the periodic amortizement for an investment with regular payments and a constant interest rate. -Syntax +IPMT(Rate; Period; NPer; PV; FV; Type)Rate is the periodic interest rate.Period is the period, for which the compound interest is calculated. Period=NPER if compound interest for the last period is calculated. @@ -517,7 +517,7 @@ FV (optional) is the desired value (future value) at the end of the periods.Type is the due date for the periodic payments. -Example +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.=IPMT(5%;5;7;15000) = -352.97 currency units. The compound interest during the fifth period (year) is 352.97 currency units. @@ -534,7 +534,7 @@ FVReturns the future value of an investment based on periodic, constant payments and a constant interest rate (Future Value). -Syntax +FV(Rate; NPer; Pmt; PV; Type)Rate is the periodic interest rate.NPer is the total number of periods (payment period). @@ -543,7 +543,7 @@ Type (optional) defines whether the payment is due at the beginning or the end of a period. -Example +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.=FV(4%;2;750;2500) = -4234.00 currency units. The value at the end of the investment is 4234.00 currency units. @@ -559,12 +559,12 @@ FVSCHEDULECalculates the accumulated value of the starting capital for a series of periodically varying interest rates. -Syntax +FVSCHEDULE(Principal; Schedule)Principal is the starting capital.Schedule is a series of interest rates, for example, as a range H3:H5 or as a (List) (see example). -Example +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?=FVSCHEDULE(1000;{0.03;0.04;0.05}) returns 1124.76. @@ -582,7 +582,7 @@ NPERReturns the number of periods for an investment based on periodic, constant payments and a constant interest rate. -Syntax +NPER(Rate; Pmt; PV; FV; Type)Rate is the periodic interest rate.Pmt is the constant annuity paid in each period. @@ -591,7 +591,7 @@ Type (optional) is the due date of the payment at the beginning or at the end of the period. -Example +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.=NPER(6%;153.75;2600) = -12,02. The payment period covers 12.02 periods. 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 @@ PPMT 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. -Syntax + PPMT(Rate; Period; NPer; PV; FV; Type) Rate is the periodic interest rate. @@ -57,7 +57,7 @@ -Example + 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. =PPMT(8.75%/12;1;36;5000;8000;1) = -350.99 currency units. @@ -72,7 +72,7 @@ CUMPRINC Returns the cumulative interest paid for an investment period with a constant interest rate. -Syntax + CUMPRINC(Rate; NPer; PV; S; E; Type) Rate is the periodic interest rate. @@ -86,7 +86,7 @@ E is the last period. Type is the due date of the payment at the beginning or end of each period. -Example + 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. =CUMPRINC(5.5%/12;36;15000;10;18;0) = -3669.74 currency units. The payoff amount between the 10th and 18th period is 3669.74 currency units. @@ -98,7 +98,7 @@ CUMPRINC_ADD Calculates the cumulative redemption of a loan in a period. -Syntax + CUMPRINC_ADD(Rate; NPer; PV; StartPeriod; EndPeriod; Type) Rate is the interest rate for each period. @@ -112,7 +112,7 @@ EndPeriod is the last payment period for the calculation. Type is the maturity of a payment at the end of each period (Type = 0) or at the start of the period (Type = 1). -Example + The following mortgage loan is taken out on a house: Rate: 9.00 per cent per annum (9% / 12 = 0.0075), Duration: 30 years (payment periods = 30 * 12 = 360), NPV: 125000 currency units. How much will you repay in the second year of the mortgage (thus from periods 13 to 24)? @@ -130,7 +130,7 @@ CUMIPMT Calculates the cumulative interest payments, that is, the total interest, for an investment based on a constant interest rate. -Syntax + CUMIPMT(Rate; NPer; PV; S; E; Type) Rate is the periodic interest rate. @@ -144,7 +144,7 @@ E is the last period. Type is the due date of the payment at the beginning or end of each period. -Example + 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. =CUMIPMT(5.5%/12;24;5000;4;6;1) = -57.54 currency units. The interest payments for between the 4th and 6th period are 57.54 currency units. @@ -156,7 +156,7 @@ CUMIPMT_ADD Calculates the accumulated interest for a period. -Syntax + CUMIPMT_ADD(Rate; NPer; PV; StartPeriod; EndPeriod; Type) Rate is the interest rate for each period. @@ -170,7 +170,7 @@ EndPeriod is the last payment period for the calculation. Type is the maturity of a payment at the end of each period (Type = 0) or at the start of the period (Type = 1). -Example + The following mortgage loan is taken out on a house: Rate: 9.00 per cent per annum (9% / 12 = 0.0075), Duration: 30 years (NPER = 30 * 12 = 360), Pv: 125000 currency units. How much interest must you pay in the second year of the mortgage (thus from periods 13 to 24)? @@ -188,7 +188,7 @@ 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. -Syntax + PRICE(Settlement; Maturity; Rate; Yield; Redemption; Frequency; Basis) Settlement is the date of purchase of the security. @@ -203,7 +203,7 @@ Frequency is the number of interest payments per year (1, 2 or 4). -Example + 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: =PRICE("1999-02-15"; "2007-11-15"; 0.0575; 0.065; 100; 2; 0) returns 95.04287. @@ -215,7 +215,7 @@ PRICEDISC Calculates the price per 100 currency units of par value of a non-interest- bearing security. -Syntax + PRICEDISC(Settlement; Maturity; Discount; Redemption; Basis) Settlement is the date of purchase of the security. @@ -226,7 +226,7 @@ Redemption is the redemption value per 100 currency units of par value. -Example + 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: =PRICEDISC("1999-02-15"; "1999-03-01"; 0.0525; 100; 2) returns 99.79583. @@ -237,7 +237,7 @@ PRICEMAT Calculates the price per 100 currency units of par value of a security, that pays interest on the maturity date. -Syntax + PRICEMAT(Settlement; Maturity; Issue; Rate; Yield; Basis) Settlement is the date of purchase of the security. @@ -250,7 +250,7 @@ Yield is the annual yield of the security. -Example + 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. The price is calculated as follows: =PRICEMAT("1999-02-15";"1999-04-13";"1998-11-11"; 0.061; 0.061;0) returns 99.98449888. @@ -263,7 +263,7 @@ DURATION Calculates the number of periods required by an investment to attain the desired value. -Syntax + DURATION(Rate; PV; FV) Rate 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. @@ -271,7 +271,7 @@ PV 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. FV is the expected value. The future value determines the desired (future) value of the deposit. -Example + 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.
@@ -284,7 +284,7 @@ SLN Returns the straight-line depreciation of an asset for one period. The amount of the depreciation is constant during the depreciation period. -Syntax + SLN(Cost; Salvage; Life) Cost is the initial cost of an asset. @@ -292,7 +292,7 @@ Salvage is the value of an asset at the end of the depreciation. Life is the depreciation period determining the number of periods in the depreciation of the asset. -Example + 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. =SLN(50000;3,500;84) = 553.57 currency units. The periodic monthly depreciation of the office equipment is 553.57 currency units. @@ -304,7 +304,7 @@ MDURATION Calculates the modified Macauley duration of a fixed interest security in years. -Syntax + MDURATION(Settlement; Maturity; Coupon; Yield; Frequency; Basis) Settlement is the date of purchase of the security. @@ -317,7 +317,7 @@ Frequency is the number of interest payments per year (1, 2 or 4). -Example + 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? =MDURATION("2001-01-01"; "2006-01-01"; 0.08; 0.09; 2; 3) returns 4.02 years.
@@ -331,13 +331,13 @@ 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. If the payments take place at irregular intervals, use the XNPV function. -Syntax + NPV(Rate; Value1; Value2; ...; Value30) Rate is the discount rate for a period. Value1, Value2, ..., Value30 are up to 30 values, which represent deposits or withdrawals. -Example + 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. =NPV(8.75%;10;20;30) = 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. @@ -350,13 +350,13 @@ NOMINAL Calculates the yearly nominal interest rate, given the effective rate and the number of compounding periods per year. -Syntax + NOMINAL(EffectiveRate; NPerY) EffectiveRate is the effective interest rate NPerY is the number of periodic interest payments per year. -Example + What is the nominal interest per year for an effective interest rate of 13.5% if twelve payments are made per year. =NOMINAL(13.5%;12) = 12.73%. The nominal interest rate per year is 12.73%. @@ -368,13 +368,13 @@ NOMINAL_ADD Calculates the annual nominal rate of interest on the basis of the effective rate and the number of interest payments per annum. -Syntax + NOMINAL_ADD(EffectiveRate; NPerY) EffectiveRate is the effective annual rate of interest. NPerY the number of interest payments per year. -Example + What is the nominal rate of interest for a 5.3543% effective rate of interest and quarterly payment. =NOMINAL_ADD(5.3543%;4) returns 0.0525 or 5.25%. @@ -386,13 +386,13 @@ DOLLARFR Converts a quotation that has been given as a decimal number into a mixed decimal fraction. -Syntax + DOLLARFR(DecimalDollar; Fraction) DecimalDollar is a decimal number. Fraction is a whole number that is used as the denominator of the decimal fraction. -Example + =DOLLARFR(1.125;16) converts into sixteenths. The result is 1.02 for 1 plus 2/16. @@ -406,13 +406,13 @@ DOLLARDE Converts a quotation that has been given as a decimal fraction into a decimal number. -Syntax + DOLLARDE(FractionalDollar; Fraction) FractionalDollar is a number given as a decimal fraction. Fraction is a whole number that is used as the denominator of the decimal fraction. -Example + =DOLLARDE(1.02;16) stands for 1 and 2/16. This returns 1.125. @@ -427,7 +427,7 @@ MIRR Calculates the modified internal rate of return of a series of investments. -Syntax + MIRR(Values; Investment; ReinvestRate) Values corresponds to the array or the cell reference for cells whose content corresponds to the payments. @@ -435,7 +435,7 @@ Investment is the rate of interest of the investments (the negative values of the array) ReinvestRate:the rate of interest of the reinvestment (the positive values of the array) -Example + Assuming a cell content of A1 = -5, A2 = 10, A3 = 15, and A4 = 8, and an investment value of 0.5 and a reinvestment value of 0.1, the result is 94.16%.
@@ -446,7 +446,7 @@ YIELD Calculates the yield of a security. -Syntax + YIELD(Settlement; Maturity; Rate; Price; Redemption; Frequency; Basis) Settlement is the date of purchase of the security. @@ -461,7 +461,7 @@ Frequency is the number of interest payments per year (1, 2 or 4). -Example + 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? =YIELD("1999-02-15"; "2007-11-15"; 0.0575 ;95.04287; 100; 2; 0) returns 0.065 or 6.50 per cent.
@@ -472,7 +472,7 @@ YIELDDISC Calculates the annual yield of a non-interest-bearing security. -Syntax + YIELDDISC(Settlement; Maturity; Price; Redemption; Basis) Settlement is the date of purchase of the security. @@ -483,7 +483,7 @@ Redemption is the redemption value per 100 currency units of par value. -Example + 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? =YIELDDISC("1999-02-15"; "1999-03-01"; 99.795; 100; 2) returns 0.052823 or 5.2823 per cent. @@ -494,7 +494,7 @@ YIELDMAT Calculates the annual yield of a security, the interest of which is paid on the date of maturity. -Syntax + YIELDMAT(Settlement; Maturity; Issue; Rate; Price; Basis) Settlement is the date of purchase of the security. @@ -507,7 +507,7 @@ Price is the price (purchase price) of the security per 100 currency units of par value. -Example + 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? =YIELDMAT("1999-03-15"; "1999-11-03"; "1998-11-08"; 0.0625; 100.0123; 0) returns 0.060954 or 6.0954 per cent. @@ -519,7 +519,7 @@ PMT Returns the periodic payment for an annuity with constant interest rates. -Syntax + PMT(Rate; NPer; PV; FV; Type) Rate is the periodic interest rate. @@ -534,7 +534,7 @@ -Example + 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. =PMT(1.99%/12;36;25000) = -715.96 currency units. The periodic monthly payment is therefore 715.96 currency units. @@ -547,7 +547,7 @@ TBILLEQ Calculates the annual return on a treasury bill. 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. -Syntax + TBILLEQ(Settlement; Maturity; Discount) Settlement is the date of purchase of the security. @@ -555,7 +555,7 @@ Maturity is the date on which the security matures (expires). Discount is the percentage discount on acquisition of the security. -Example + Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9.14 per cent. The return on the treasury bill corresponding to a security is worked out as follows: =TBILLEQ("1999-03-31";"1999-06-01"; 0.0914) returns 0.094151 or 9.4151 per cent. @@ -568,7 +568,7 @@ TBILLPRICE Calculates the price of a treasury bill per 100 currency units. -Syntax + TBILLPRICE(Settlement; Maturity; Discount) Settlement is the date of purchase of the security. @@ -576,7 +576,7 @@ Maturity is the date on which the security matures (expires). Discount is the percentage discount upon acquisition of the security. -Example + Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9 per cent. The price of the treasury bill is worked out as follows: =TBILLPRICE("1999-03-31";"1999-06-01"; 0.09) returns 98.45. @@ -589,7 +589,7 @@ TBILLYIELD Calculates the yield of a treasury bill. -Syntax + TBILLYIELD(Settlement; Maturity; Price) Settlement is the date of purchase of the security. @@ -597,7 +597,7 @@ Maturity is the date on which the security matures (expires). Price is the price (purchase price) of the treasury bill per 100 currency units of par value. -Example + Settlement date: March 31 1999, maturity date: June 1 1999, price: 98.45 currency units. The yield of the treasury bill is worked out as follows: =TBILLYIELD("1999-03-31";"1999-06-01"; 98.45) returns 0.091417 or 9.1417 per cent. 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 @@ - + - - + + Bit Operation Functions @@ -49,11 +49,11 @@ BITAND Returns a bitwise logical "and" of the parameters. -Syntax + BITAND(number1; number2) Number1 and number2 are positive integers less than 2 ^ 48 (281 474 976 710 656). -Example + =BITAND(6;10) returns 2 (0110 & 1010 = 0010). @@ -63,7 +63,7 @@ BITOR Returns a bitwise logical "or" of the parameters. -Syntax + BITOR(number1; number2) Number1 and number2 are positive integers less than 2 ^ 48 (281 474 976 710 656). @@ -76,11 +76,11 @@ BITXOR Returns a bitwise logical "exclusive or" of the parameters. -Syntax + BITXOR(number1; number2) Number1 and number2 are positive integers less than 2 ^ 48 (281 474 976 710 656). -Example + =BITXOR(6;10) returns 12 (0110 ^ 1010 = 1100) @@ -90,13 +90,13 @@ BITLSHIFT Shifts a number left by n bits. -Syntax + BITLSHIFT(number; shift) Number is a positive integer less than 2 ^ 48 (281 474 976 710 656). Shift is the number of positions the bits will be moved to the left. If shift is negative, it is synonymous with BITRSHIFT (number; -shift). -Example + =BITLSHIFT(6;1) returns 12 (0110 << 1 = 1100). @@ -106,13 +106,13 @@ BITRSHIFT Shifts a number right by n bits. -Syntax + BITRSHIFT(number; shift) Number is a positive integer less than 2 ^ 48 (281 474 976 710 656). Shift is the number of positions the bits will be moved to the right. If shift is negative, it is synonymous with BITLSHIFT (number; -shift). -Example + =BITRSHIFT(6;1) returns 3 (0110 >> 1 = 0011). 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 @@ INTERCEPT Calculates the point at which a line will intersect the y-values by using known x-values and y-values. -Syntax + INTERCEPT(DataY; DataX) DataY is the dependent set of observations or data. DataX is the independent set of observations or data. Names, arrays or references containing numbers must be used here. Numbers can also be entered directly. -Example + 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: =INTERCEPT(D3:D9;C3:C9) = 2.15. @@ -65,11 +65,11 @@ COUNT Counts how many numbers are in the list of arguments. Text entries are ignored. -Syntax + COUNT(Value1; Value2; ...; Value30) Value1; Value2, ..., Value30 are 1 to 30 values or ranges representing the values to be counted. -Example + The entries 2, 4, 6 and eight in the Value 1-4 fields are to be counted. =COUNT(2;4;6;"eight") = 3. The count of numbers is therefore 3. @@ -85,11 +85,11 @@ COUNTA Counts how many values are in the list of arguments. 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.UFI: fix to #i35888# -Syntax + COUNTA(Value1; Value2; ...; Value30) Value1; Value2, ..., Value30 are 1 to 30 arguments representing the values to be counted. -Example + The entries 2, 4, 6 and eight in the Value 1-4 fields are to be counted. =COUNTA(2;4;6;"eight") = 4. The count of values is therefore 4. @@ -106,11 +106,11 @@ COUNTBLANK Returns the number of empty cells. -Syntax + COUNTBLANK(Range) Returns the number of empty cells in the cell range Range. -Example + =COUNTBLANK(A1:B2) returns 4 if cells A1, A2, B1, and B2 are all empty.see also COUNTIF @@ -126,12 +126,12 @@ Returns the number of cells that meet with certain criteria within a cell range. -Syntax + COUNTIF(Range; Criteria) Range is the range to which the criteria are to be applied. Criteria 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. -Example + A1:A10 is a cell range containing the numbers 2000 to 2009. Cell B1 contains the number 2006. In cell B2, you enter a formula: =COUNTIF(A1:A10;2006) - this returns 1. =COUNTIF(A1:A10;B1) - this returns 1. @@ -158,14 +158,14 @@ B Returns the probability of a sample with binomial distribution. -Syntax + B(Trials; SP; T1; T2) Trials is the number of independent trials. SP is the probability of success on each trial. T1 defines the lower limit for the number of trials. T2 (optional) defines the upper limit for the number of trials. -Example + 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: =B(10;1/6;2) returns a probability of 29%. @@ -182,12 +182,12 @@ RSQ Returns the square of the Pearson correlation coefficient based on the given values. RSQ (also called determination coefficient) is a measure for the accuracy of an adjustment and can be used to produce a regression analysis. -Syntax + RSQ(DataY; DataX) DataY is an array or range of data points. DataX is an array or range of data points. -Example + =RSQ(A1:A20;B1:B20) calculates the determination coefficient for both data sets in columns A and B. @@ -202,7 +202,7 @@ BETAINV Returns the inverse of the cumulative beta probability density function. -Syntax + BETAINV(Number; Alpha; Beta; Start; End) Number is the value between Start and End at which to evaluate the function. Alpha is a parameter to the distribution. @@ -211,7 +211,7 @@ End (optional) is the upper bound for Number. -Example + =BETAINV(0.5;5;10) returns the value 0.33. @@ -226,7 +226,7 @@ BETA.INV Returns the inverse of the cumulative beta probability density function. -Syntax + BETA.INV(Number; Alpha; Beta; Start; End) Number is the value between Start and End at which to evaluate the function. Alpha is a parameter to the distribution. @@ -235,7 +235,7 @@ End (optional) is the upper bound for Number. -Example + =BETA.INV(0.5;5;10) returns the value 0.3257511553. @@ -250,7 +250,7 @@ BETADIST Returns the beta function. -Syntax + BETADIST(Number; Alpha; Beta; Start; End; Cumulative) Number is the value between Start and End at which to evaluate the function. Alpha is a parameter to the distribution. @@ -260,7 +260,7 @@ Cumulative (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. -Example + =BETADIST(0.75;3;4) returns the value 0.96. @@ -275,7 +275,7 @@ BETA.DIST Returns the beta function. -Syntax + BETA.DIST(Number; Alpha; Beta; Cumulative; Start; End) Number (required) is the value between Start and End at which to evaluate the function. Alpha (required) is a parameter to the distribution. @@ -285,7 +285,7 @@ End (optional) is the upper bound for Number. -Examples + =BETA.DIST(2;8;10;1;1;3) returns the value 0.6854706 =BETA.DIST(2;8;10;0;1;3) returns the value 1.4837646 @@ -300,14 +300,14 @@ BINOMDIST Returns the individual term binomial distribution probability. -Syntax + BINOMDIST(X; Trials; SP; C) X is the number of successes in a set of trials. Trials is the number of independent trials. SP is the probability of success on each trial. C = 0 calculates the probability of a single event and C = 1 calculates the cumulative probability. -Example + =BINOMDIST(A1;12;0.5;0) shows (if the values 0 to 12 are entered in A1) the probabilities for 12 flips of a coin that Heads will come up exactly the number of times entered in A1. =BINOMDIST(A1;12;0.5;1) shows the cumulative probabilities for the same series. For example, if A1 = 4, the cumulative probability of the series is 0, 1, 2, 3 or 4 times Heads (non-exclusive OR). @@ -322,14 +322,14 @@ BINOM.DIST Returns the individual term binomial distribution probability. -Syntax + BINOM.DIST(X; Trials; SP; C) X is the number of successes in a set of trials. Trials is the number of independent trials. SP is the probability of success on each trial. C = 0 calculates the probability of a single event and C = 1 calculates the cumulative probability. -Example + =BINOM.DIST(A1;12;0.5;0) shows (if the values 0 to 12 are entered in A1) the probabilities for 12 flips of a coin that Heads will come up exactly the number of times entered in A1. =BINOM.DIST(A1;12;0.5;1) shows the cumulative probabilities for the same series. For example, if A1 = 4, the cumulative probability of the series is 0, 1, 2, 3 or 4 times Heads (non-exclusive OR). @@ -344,13 +344,13 @@ BINOM.INV Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value. -Syntax + BINOM.INV(Trials; SP; Alpha) Trials The total number of trials. SP is the probability of success on each trial. Alpha The border probability that is attained or exceeded. -Example + =BINOM.INV(8;0.6;0.9) returns 7, the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value. @@ -364,7 +364,7 @@ CHISQINV Returns the inverse of CHISQDIST. -Syntax + Probability is the probability value for which the inverse of the chi-square distribution is to be calculated. Degrees Of Freedom is the degrees of freedom for the chi-square function. @@ -379,12 +379,12 @@ CHISQ.INV Returns the inverse of the left-tailed probability of the chi-square distribution. -Syntax + CHISQ.INV(Probability; DegreesFreedom) Probability is the probability value for which the inverse of the chi-square distribution is to be calculated. Degrees Of Freedom is the degrees of freedom for the chi-square function. -Example + =CHISQ.INV(0,5;1) returns 0.4549364231. @@ -398,12 +398,12 @@ CHIINV Returns the inverse of the one-tailed probability of the chi-squared distribution. -Syntax + CHIINV(Number; DegreesFreedom) Number is the value of the error probability. DegreesFreedom is the degrees of freedom of the experiment. -Example + 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. 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. 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. @@ -422,12 +422,12 @@ CHISQ.INV.RT Returns the inverse of the one-tailed probability of the chi-squared distribution. -Syntax + CHISQ.INV.RT(Number; DegreesFreedom) Number is the value of the error probability. DegreesFreedom is the degrees of freedom of the experiment. -Example + 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. 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. 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. @@ -447,12 +447,12 @@ Returns the probability of a deviance from a random distribution of two test series based on the chi-squared test for independence. CHITEST returns the chi-squared distribution of the data. 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. -Syntax + CHITEST(DataB; DataE) DataB is the array of the observations. DataE is the range of the expected values. -Example +
@@ -547,12 +547,12 @@ Returns the probability of a deviance from a random distribution of two test series based on the chi-squared test for independence. CHISQ.TEST returns the chi-squared distribution of the data. 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. -Syntax + CHISQ.TEST(DataB; DataE) DataB is the array of the observations. DataE is the range of the expected values. -Example +
@@ -647,12 +647,12 @@ Returns the probability value from the indicated Chi square that a hypothesis is confirmed. 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. The probability determined by CHIDIST can also be determined by CHITEST. -Syntax + CHIDIST(Number; DegreesFreedom) Number is the chi-square value of the random sample used to determine the error probability. DegreesFreedom are the degrees of freedom of the experiment. -Example + =CHIDIST(13.27; 5) equals 0.02. 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%. @@ -667,13 +667,13 @@ CHISQ.DIST Returns the probability density function or the cumulative distribution function for the chi-square distribution. -Syntax + CHISQ.DIST(Number; DegreesFreedom; Cumulative) Number is the chi-square value of the random sample used to determine the error probability. DegreesFreedom are the degrees of freedom of the experiment. Cumulative 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. -Example + =CHISQ.DIST(3; 2; 0) equals 0.1115650801, the probability density function with 2 degrees of freedom, at x = 3. =CHISQ.DIST(3; 2; 1) equals 0.7768698399, the cumulative chi-square distribution with 2 degrees of freedom, at the value x = 3. @@ -689,12 +689,12 @@ Returns the probability value from the indicated Chi square that a hypothesis is confirmed. 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. The probability determined by CHISQ.DIST.RT can also be determined by CHITEST. -Syntax + CHISQ.DIST.RT(Number; DegreesFreedom) Number is the chi-square value of the random sample used to determine the error probability. DegreesFreedom are the degrees of freedom of the experiment. -Example + =CHISQ.DIST.RT(13.27; 5) equals 0.0209757694. 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%. @@ -710,7 +710,7 @@ CHISQDIST Returns the value of the probability density function or the cumulative distribution function for the chi-square distribution. -Syntax + CHISQDIST(Number; Degrees Of Freedom; Cumulative) Number is the number for which the function is to be calculated. Degrees Of Freedom is the degrees of freedom for the chi-square function. @@ -728,13 +728,13 @@ EXPONDIST Returns the exponential distribution. -Syntax + EXPONDIST(Number; Lambda; C) Number is the value of the function. Lambda is the parameter value.UFI removed a double bookmark C is a logical value that determines the form of the function. C = 0 calculates the density function, and C = 1 calculates the distribution. -Example + =EXPONDIST(3;0.5;1) returns 0.78. @@ -749,13 +749,13 @@ EXPON.DIST Returns the exponential distribution. -Syntax + EXPON.DIST(Number; Lambda; C) Number is the value of the function. Lambda is the parameter value.UFI removed a double bookmark C is a logical value that determines the form of the function. C = 0 calculates the density function, and C = 1 calculates the distribution. -Example + =EXPON.DIST(3;0.5;1) returns 0.7768698399. 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 @@ FINV Returns the inverse of the F probability distribution. The F distribution is used for F tests in order to set the relation between two differing data sets. - Syntax + FINV(Number; DegreesFreedom1; DegreesFreedom2) Number is probability value for which the inverse F distribution is to be calculated. @@ -45,7 +45,7 @@ DegreesFreedom1 is the number of degrees of freedom in the numerator of the F distribution. DegreesFreedom2 is the number of degrees of freedom in the denominator of the F distribution. - Example + =FINV(0.5;5;10) yields 0.93. @@ -58,12 +58,12 @@ F.INV Returns the inverse of the cumulative F distribution. The F distribution is used for F tests in order to set the relation between two differing data sets. - Syntax + F.INV(Number; DegreesFreedom1; DegreesFreedom2) Number is probability value for which the inverse F distribution is to be calculated. DegreesFreedom1 is the number of degrees of freedom in the numerator of the F distribution. DegreesFreedom2 is the number of degrees of freedom in the denominator of the F distribution. - Example + =F.INV(0.5;5;10) yields 0.9319331609.
@@ -75,12 +75,12 @@ F.INV.RT Returns the inverse right tail of the F distribution. - Syntax + F.INV.RT(Number; DegreesFreedom1; DegreesFreedom2) Number is probability value for which the inverse F distribution is to be calculated. DegreesFreedom1 is the number of degrees of freedom in the numerator of the F distribution. DegreesFreedom2 is the number of degrees of freedom in the denominator of the F distribution. - Example + =F.INV.RT(0.5;5;10) yields 0.9319331609.
@@ -89,11 +89,11 @@ FISHER Returns the Fisher transformation for x and creates a function close to a normal distribution. - Syntax + FISHER(Number) Number is the value to be transformed. - Example + =FISHER(0.5) yields 0.55.
@@ -104,11 +104,11 @@ FISHERINV Returns the inverse of the Fisher transformation for x and creates a function close to a normal distribution. - Syntax + FISHERINV(Number) Number is the value that is to undergo reverse-transformation. - Example + =FISHERINV(0.5) yields 0.46. @@ -118,13 +118,13 @@ FTEST Returns the result of an F test. - Syntax + FTEST(Data1; Data2) Data1 is the first record array. Data2 is the second record array. - Example + =FTEST(A1:A30;B1:B12) 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. @@ -135,11 +135,11 @@ F.TEST Returns the result of an F test. - Syntax + F.TEST(Data1; Data2) Data1 is the first record array. Data2 is the second record array. - Example + =F.TEST(A1:A30;B1:B12) 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.
@@ -148,7 +148,7 @@ FDIST Calculates the values of an F distribution. - Syntax + FDIST(Number; DegreesFreedom1; DegreesFreedom2) Number is the value for which the F distribution is to be calculated. @@ -156,7 +156,7 @@ degreesFreedom1 is the degrees of freedom in the numerator in the F distribution. degreesFreedom2 is the degrees of freedom in the denominator in the F distribution. - Example + =FDIST(0.8;8;12) yields 0.61.
@@ -167,13 +167,13 @@ F.DIST Calculates the values of the left tail of the F distribution. - Syntax + F.DIST(Number; DegreesFreedom1; DegreesFreedom2; Cumulative) Number is the value for which the F distribution is to be calculated. degreesFreedom1 is the degrees of freedom in the numerator in the F distribution. degreesFreedom2 is the degrees of freedom in the denominator in the F distribution. Cumulative = 0 or False calculates the density function Cumulative = 1 or True calculates the distribution. - Example + =F.DIST(0.8;8;12;0) yields 0.7095282499. =F.DIST(0.8;8;12;1) yields 0.3856603563. @@ -184,12 +184,12 @@ F.DIST.RT Calculates the values of the right tail of the F distribution. - Syntax + F.DIST.RT(Number; DegreesFreedom1; DegreesFreedom2) Number is the value for which the F distribution is to be calculated. degreesFreedom1 is the degrees of freedom in the numerator in the F distribution. degreesFreedom2 is the degrees of freedom in the denominator in the F distribution. - Example + =F.DIST.RT(0.8;8;12) yields 0.6143396437.
@@ -198,7 +198,7 @@ GAMMA Returns the Gamma function value. Note that GAMMAINV is not the inverse of GAMMA, but of GAMMADIST. - Syntax + Number is the number for which the Gamma function value is to be calculated.
@@ -208,7 +208,7 @@ GAMMAINV Returns the inverse of the Gamma cumulative distribution GAMMADIST. This function allows you to search for variables with different distribution. - Syntax + GAMMAINV(Number; Alpha; Beta) Number is the probability value for which the inverse Gamma distribution is to be calculated. @@ -216,7 +216,7 @@ Alpha is the parameter Alpha of the Gamma distribution. Beta is the parameter Beta of the Gamma distribution. - Example + =GAMMAINV(0.8;1;1) yields 1.61. @@ -227,7 +227,7 @@ GAMMA.INV Returns the inverse of the Gamma cumulative distribution GAMMADIST. This function allows you to search for variables with different distribution. This function is identical to GAMMAINV and was introduced for interoperability with other office suites. - Syntax + GAMMA.INV(Number; Alpha; Beta) Number is the probability value for which the inverse Gamma distribution is to be calculated. @@ -235,7 +235,7 @@ Alpha is the parameter Alpha of the Gamma distribution. Beta is the parameter Beta of the Gamma distribution. - Example + =GAMMA.INV(0.8;1;1) yields 1.61. @@ -246,11 +246,11 @@ GAMMALN Returns the natural logarithm of the Gamma function: G(x). - Syntax + GAMMALN(Number) Number is the value for which the natural logarithm of the Gamma function is to be calculated. - Example + =GAMMALN(2) yields 0. @@ -261,11 +261,11 @@ GAMMALN.PRECISE Returns the natural logarithm of the Gamma function: G(x). - Syntax + GAMMALN.PRECISE(Number) Number is the value for which the natural logarithm of the Gamma function is to be calculated. - Example + =GAMMALN.PRECISE(2) yields 0. @@ -276,7 +276,7 @@ GAMMADIST Returns the values of a Gamma distribution. The inverse function is GAMMAINV. - Syntax + GAMMADIST(Number; Alpha; Beta; C) Number is the value for which the Gamma distribution is to be calculated. @@ -286,7 +286,7 @@ Beta is the parameter Beta of the Gamma distribution. C (optional) = 0 or False calculates the density function C = 1 or True calculates the distribution. - Example + =GAMMADIST(2;1;1;1) yields 0.86. @@ -299,13 +299,13 @@ Returns the values of a Gamma distribution. The inverse function is GAMMAINV or GAMMA.INV. This function is identical to GAMMADIST and was introduced for interoperability with other office suites. -Syntax + GAMMA.DIST(Number; Alpha; Beta; C) Number is the value for which the Gamma distribution is to be calculated. Alpha is the parameter Alpha of the Gamma distribution. Beta is the parameter Beta of the Gamma distribution. C (optional) = 0 or False calculates the density function C = 1 or True calculates the distribution. -Example + =GAMMA.DIST(2;1;1;1) yields 0.86.
@@ -316,11 +316,11 @@ GAUSS Returns the standard normal cumulative distribution. It is GAUSS(x)=NORMSDIST(x)-0.5 - Syntax + GAUSS(Number) Number is the value for which the value of the standard normal distribution is to be calculated. - Example + =GAUSS(0.19) = 0.08 @@ -333,11 +333,11 @@ GEOMEAN Returns the geometric mean of a sample. - Syntax + GEOMEAN(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numeric arguments or ranges that represent a random sample. - Example + =GEOMEAN(23;46;69) = 41.79. The geometric mean value of this random sample is therefore 41.79.
@@ -348,13 +348,13 @@ TRIMMEAN Returns the mean of a data set without the Alpha percent of data at the margins. - Syntax + TRIMMEAN(Data; Alpha) Data is the array of data in the sample. Alpha is the percentage of the marginal data that will not be taken into consideration. - Example + =TRIMMEAN(A1:A50; 0.1) 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. @@ -364,7 +364,7 @@ ZTEST Calculates the probability of observing a z-statistic greater than the one computed based on a sample. - Syntax + ZTEST(Data; mu; Sigma) Data is the given sample, drawn from a normally distributed population. @@ -380,12 +380,12 @@ Z.TEST Calculates the probability of observing a z-statistic greater than the one computed based on a sample. -Syntax + Z.TEST(Data; mu; Sigma) Data is the given sample, drawn from a normally distributed population. mu is the known mean of the population. Sigma (optional) is the known standard deviation of the population. If omitted, the standard deviation of the given sample is used. -Example + =Z.TEST(A2:A20; 9; 2) 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.
@@ -395,11 +395,11 @@ HARMEAN Returns the harmonic mean of a data set. - Syntax + HARMEAN(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are up to 30 values or ranges, that can be used to calculate the harmonic mean. - Example + =HARMEAN(23;46;69) = 37.64. The harmonic mean of this random sample is thus 37.64
@@ -410,7 +410,7 @@ HYPGEOMDIST Returns the hypergeometric distribution. - Syntax + HYPGEOMDIST(X; NSample; Successes; NPopulation) X is the number of results achieved in the random sample. @@ -420,7 +420,7 @@ Successes is the number of possible results in the total population. NPopulation is the size of the total population. - Example + =HYPGEOMDIST(2;2;90;100) 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. @@ -433,14 +433,14 @@ HYPGEOM.DIST Returns the hypergeometric distribution. - Syntax + HYPGEOM.DIST(X; NSample; Successes; NPopulation; Cumulative) X is the number of results achieved in the random sample. NSample is the size of the random sample. Successes is the number of possible results in the total population. NPopulation is the size of the total population. Cumulative : 0 or False calculates the probability density function. Other values or True calculates the cumulative distribution function. - Examples + =HYPGEOM.DIST(2;2;90;100;0) 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. =HYPGEOM.DIST(2;2;90;100;1) yields 1. 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 @@ LARGE Returns the Rank_c-th largest value in a data set. -Syntax + LARGE(Data; RankC) Data is the cell range of data. RankC is the ranking of the value. -Example + =LARGE(A1:C50;2) gives the second largest value in A1:C50. @@ -52,13 +52,13 @@ SMALL Returns the Rank_c-th smallest value in a data set. -Syntax + SMALL(Data; RankC) Data is the cell range of data. RankC is the rank of the value. -Example + =SMALL(A1:C50;2) gives the second smallest value in A1:C50. @@ -68,7 +68,7 @@ CONFIDENCE Returns the (1-alpha) confidence interval for a normal distribution. -Syntax + CONFIDENCE(Alpha; StDev; Size) Alpha is the level of the confidence interval. @@ -76,7 +76,7 @@ StDev is the standard deviation for the total population. Size is the size of the total population. -Example + =CONFIDENCE(0.05;1.5;100) gives 0.29. @@ -87,7 +87,7 @@ CONFIDENCE.T Returns the (1-alpha) confidence interval for a Student's t distribution. -Syntax + CONFIDENCE.T(Alpha; StDev; Size) Alpha is the level of the confidence interval. @@ -95,7 +95,7 @@ StDev is the standard deviation for the total population. Size is the size of the total population. -Example + =CONFIDENCE.T(0.05;1.5;100) gives 0.2976325427. @@ -106,7 +106,7 @@ CONFIDENCE.NORM Returns the (1-alpha) confidence interval for a normal distribution. -Syntax + CONFIDENCE.NORM(Alpha; StDev; Size) Alpha is the level of the confidence interval. @@ -114,7 +114,7 @@ StDev is the standard deviation for the total population. Size is the size of the total population. -Example + =CONFIDENCE.NORM(0.05;1.5;100) gives 0.2939945977. @@ -125,13 +125,13 @@ CORREL Returns the correlation coefficient between two data sets. -Syntax + CORREL(Data1; Data2) Data1 is the first data set. Data2 is the second data set. -Example + =CORREL(A1:A50;B1:B50) calculates the correlation coefficient as a measure of the linear correlation of the two data sets. @@ -141,13 +141,13 @@ COVAR Returns the covariance of the product of paired deviations. -Syntax + COVAR(Data1; Data2) Data1 is the first data set. Data2 is the second data set. -Example + =COVAR(A1:A30;B1:B30) @@ -159,11 +159,11 @@ COVARIANCE.P Returns the covariance of the product of paired deviations, for the entire population. - Syntax + COVARIANCE.P(Data1; Data2) Data1 is the first data set. Data2 is the second data set. - Example + =COVARIANCE.P(A1:A30;B1:B30)
@@ -173,11 +173,11 @@ COVARIANCE.S Returns the covariance of the product of paired deviations, for a sample of the population. - Syntax + COVARIANCE.S(Data1; Data2) Data1 is the first data set. Data2 is the second data set. - Example + =COVARIANCE.S(A1:A30;B1:B30)
@@ -186,7 +186,7 @@ CRITBINOM Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value. -Syntax + CRITBINOM(Trials; SP; Alpha) Trials is the total number of trials. @@ -194,7 +194,7 @@ SP is the probability of success for one trial. Alpha is the threshold probability to be reached or exceeded. -Example + =CRITBINOM(100;0.5;0.1) yields 44.
@@ -204,11 +204,11 @@ KURT Returns the kurtosis of a data set (at least 4 values required). -Syntax + KURT(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numeric arguments or ranges representing a random sample of distribution. -Example + =KURT(A1;A2;A3;A4;A5;A6) @@ -220,7 +220,7 @@ LOGINV Returns the inverse of the lognormal distribution. -Syntax + LOGINV(Number; Mean; StDev) Number is the probability value for which the inverse standard logarithmic distribution is to be calculated. @@ -228,7 +228,7 @@ Mean is the arithmetic mean of the standard logarithmic distribution. StDev is the standard deviation of the standard logarithmic distribution. -Example + =LOGINV(0.05;0;1) returns 0.1930408167. @@ -240,7 +240,7 @@ LOGNORM.INV Returns the inverse of the lognormal distribution. This function is identical to LOGINV and was introduced for interoperability with other office suites. -Syntax + LOGNORM.INV(Number; Mean; StDev) Number (required) is the probability value for which the inverse standard logarithmic distribution is to be calculated. @@ -248,7 +248,7 @@ Mean (required) is the arithmetic mean of the standard logarithmic distribution. StDev (required) is the standard deviation of the standard logarithmic distribution. -Example + =LOGNORM.INV(0.05;0;1) returns 0.1930408167. @@ -259,7 +259,7 @@ LOGNORMDIST Returns the values of a lognormal distribution. -Syntax + LOGNORMDIST(Number; Mean; StDev; Cumulative) Number is the probability value for which the standard logarithmic distribution is to be calculated. @@ -269,7 +269,7 @@ StDev (optional) is the standard deviation of the standard logarithmic distribution. Cumulative (optional) = 0 calculates the density function, Cumulative = 1 calculates the distribution. -Example + =LOGNORMDIST(0.1;0;1) returns 0.01. @@ -280,7 +280,7 @@ LOGNORM.DIST Returns the values of a lognormal distribution. -Syntax + LOGNORM.DIST(Number; Mean; StDev; Cumulative) Number (required) is the probability value for which the standard logarithmic distribution is to be calculated. @@ -290,7 +290,7 @@ StDev (required) is the standard deviation of the standard logarithmic distribution. Cumulative (required) = 0 calculates the density function, Cumulative = 1 calculates the distribution. -Example + =LOGNORM.DIST(0.1;0;1;1) returns 0.0106510993. 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 @@ MAX Returns the maximum value in a list of arguments. 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. -Syntax + MAX(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges. -Example + =MAX(A1;A2;A3;50;100;200) returns the largest value from the list. @@ -53,10 +53,10 @@ 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. The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered. -Syntax + MAXA(Value1; Value2; ...; Value30) Value1; Value2;...; Value30 are values or ranges. Text has the value of 0. -Example + =MAXA(A1;A2;A3;50;100;200;"Text") returns the largest value from the list. @@ -68,10 +68,10 @@ 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. -Syntax + MEDIAN(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are values or ranges, which represent a sample. Each number can also be replaced by a reference. -Example + for an odd number: =MEDIAN(1;5;9;20;21) returns 9 as the median value. for an even number: =MEDIAN(1;5;9;20) returns the average of the two middle values 5 and 9, thus 7. @@ -82,10 +82,10 @@ MIN Returns the minimum value in a list of arguments. 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. -Syntax + MIN(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges. -Example + =MIN(A1:B100) returns the smallest value in the list. @@ -96,10 +96,10 @@ MINA Returns the minimum value in a list of arguments. Here you can also enter text. The value of the text is 0. The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered. -Syntax + MINA(Value1; Value2; ...; Value30) Value1, Value2, ..., Value30 are values or ranges. Text has the value of 0. -Example + =MINA(1;"Text";20) returns 0. @@ -112,10 +112,10 @@ AVEDEV Returns the average of the absolute deviations of data points from their mean. Displays the diffusion in a data set. -Syntax + AVEDEV(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are values or ranges that represent a sample. Each number can also be replaced by a reference. -Example + =AVEDEV(A1:A50) @@ -126,10 +126,10 @@ AVERAGE Returns the average of the arguments. -Syntax + AVERAGE(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges. -Example + =AVERAGE(A1:A50) @@ -140,10 +140,10 @@ AVERAGEA Returns the average of the arguments. The value of a text is 0. -Syntax + AVERAGEA(Value1; Value2; ...; Value30) Value1, Value2, ..., Value30 are values or ranges. Text has the value of 0. -Example + =AVERAGEA(A1:A50) @@ -164,10 +164,10 @@ MODE Returns the most common value in a data set. If there are several values with the same frequency, it returns the smallest value. An error occurs when a value doesn't appear twice. -Syntax + MODE(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges. -Example + =MODE(A1:A50) @@ -180,11 +180,11 @@ MODE.SNGL Returns the most frequently occurring, or repetitive, value in an array or range of data. If there are several values with the same frequency, it returns the smallest value. An error occurs when a value doesn't appear twice. -Syntax + MODE.SNGL(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges. If the data set contains no duplicate data points, MODE.SNGL returns the #VALUE! error value. -Example + =MODE.SNGL(A1:A50)
@@ -194,11 +194,11 @@ MODE.MULT Returns a vertical array of the statistical modes (the most frequently occurring values) within a list of supplied numbers. -Syntax + MODE.MULT(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges. 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. -Example + =MODE.MULT(A1:A50)
@@ -208,12 +208,12 @@ NEGBINOMDIST Returns the negative binomial distribution. -Syntax + NEGBINOMDIST(X; R; SP) X represents the value returned for unsuccessful tests. R represents the value returned for successful tests. SP is the probability of the success of an attempt. -Example + =NEGBINOMDIST(1;1;0.5) returns 0.25.
@@ -224,13 +224,13 @@ NEGBINOM.DIST Returns the negative binomial density or distribution function. -Syntax + NEGBINOM.DIST(X; R; SP; Cumulative) X represents the value returned for unsuccessful tests. R represents the value returned for successful tests. SP is the probability of the success of an attempt. Cumulative = 0 calculates the density function, Cumulative = 1 calculates the distribution. -Example + =NEGBINOM.DIST(1;1;0.5;0) returns 0.25. =NEGBINOM.DIST(1;1;0.5;1) returns 0.75. @@ -241,12 +241,12 @@ NORMINV Returns the inverse of the normal cumulative distribution. -Syntax + NORMINV(Number; Mean; StDev) Number represents the probability value used to determine the inverse normal distribution. Mean represents the mean value in the normal distribution. StDev represents the standard deviation of the normal distribution. -Example + =NORMINV(0.9;63;5) 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. @@ -257,12 +257,12 @@ NORM.INV Returns the inverse of the normal cumulative distribution. -Syntax + NORM.INV(Number; Mean; StDev) Number represents the probability value used to determine the inverse normal distribution. Mean represents the mean value in the normal distribution. StDev represents the standard deviation of the normal distribution. -Example + =NORM.INV(0.9;63;5) 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. @@ -273,13 +273,13 @@ NORMDIST Returns the density function or the normal cumulative distribution. -Syntax + NORMDIST(Number; Mean; StDev; C) Number is the value of the distribution based on which the normal distribution is to be calculated. Mean is the mean value of the distribution. StDev is the standard deviation of the distribution. C is optional. C = 0 calculates the density function, C = 1 calculates the distribution. -Example + =NORMDIST(70;63;5;0) returns 0.03. @@ -292,13 +292,13 @@ NORM.DIST Returns the density function or the normal cumulative distribution. -Syntax + NORM.DIST(Number; Mean; StDev; C) Number is the value of the distribution based on which the normal distribution is to be calculated. Mean is the mean value of the distribution. StDev is the standard deviation of the distribution. C = 0 calculates the density function, C = 1 calculates the distribution. -Example + =NORM.DIST(70;63;5;0) returns 0.029945493. @@ -310,11 +310,11 @@ PEARSON Returns the Pearson product moment correlation coefficient r. -Syntax + PEARSON(Data1; Data2) Data1 represents the array of the first data set. Data2 represents the array of the second data set. -Example + =PEARSON(A1:A30;B1:B30) returns the Pearson correlation coefficient of both data sets. @@ -324,10 +324,10 @@ PHI Returns the values of the distribution function for a standard normal distribution. -Syntax + PHI(Number) Number represents the value based on which the standard normal distribution is calculated. -Example + =PHI(2.25) = 0.03 @@ -341,12 +341,12 @@ POISSON Returns the Poisson distribution. -Syntax + POISSON(Number; Mean; C) Number represents the value based on which the Poisson distribution is calculated. Mean represents the middle value of the Poisson distribution. C (optional) = 0 or False calculates the density function; C = 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. -Example + =POISSON(60;50;1) returns 0.93. @@ -357,12 +357,12 @@ POISSON.DIST Returns the Poisson distribution. - Syntax + POISSON.DIST(Number; Mean; C) Number represents the value based on which the Poisson distribution is calculated. Mean represents the middle value of the Poisson distribution. C (optional) = 0 or False calculates the density function; C = 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. - Example + =POISSON.DIST(60;50;1) returns 0.9278398202.
@@ -371,11 +371,11 @@ PERCENTILE Returns the alpha-percentile of data values in an array. A percentile returns the scale value for a data series which goes from the smallest (Alpha=0) to the largest value (alpha=1) of a data series. For Alpha = 25%, the percentile means the first quartile; Alpha = 50% is the MEDIAN. -Syntax + PERCENTILE(Data; Alpha) Data represents the array of data. Alpha represents the percentage of the scale between 0 and 1. -Example + =PERCENTILE(A1:A50;0.1) represents the value in the data set, which equals 10% of the total data scale in A1:A50.
@@ -387,11 +387,11 @@ Returns the Alpha'th percentile of a supplied range of values for a given value of Alpha, within the range 0 to 1 (exclusive). A percentile returns the scale value for a data series which goes from the smallest (Alpha=0) to the largest value (Alpha=1) of a data series. For Alpha = 25%, the percentile means the first quartile; Alpha = 50% is the MEDIAN. If Alpha is not a multiple of 1/(n+1), (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 Alpha is less than 1/(n+1) or Alpha is greater than n/(n+1), the function is unable to interpolate, and so returns an error. The difference between PERCENTILE.INC and PERCENTILE.EXC is that, in the PERCENTILE.INC function the value of alpha is is within the range 0 to 1 inclusive, and in the PERCENTILE.EXC function, the value of alpha is within the range 0 to 1 exclusive. -Syntax + PERCENTILE.EXC(Data; Alpha) Data represents the array of data. Alpha represents the percentage of the scale between 0 and 1. -Example + =PERCENTILE.EXC(A1:A50;10%) represents the value in the data set, which equals 10% of the total data scale in A1:A50.
@@ -401,11 +401,11 @@ PERCENTILE.INC Returns the alpha-percentile of data values in an array. A percentile returns the scale value for a data series which goes from the smallest (Alpha=0) to the largest value (alpha=1) of a data series. For Alpha = 25%, the percentile means the first quartile; Alpha = 50% is the MEDIAN. The difference between PERCENTILE.INC and PERCENTILE.EXC is that, in the PERCENTILE.INC function the value of alpha is is within the range 0 to 1 inclusive, and in the PERCENTILE.EXC function, the value of alpha is within the range 0 to 1 exclusive. -Syntax + PERCENTILE.INC(Data; Alpha) Data represents the array of data. Alpha represents the percentage of the scale between 0 and 1. -Example + =PERCENTILE.INC(A1:A50;0.1) represents the value in the data set, which equals 10% of the total data scale in A1:A50.
@@ -414,12 +414,12 @@ PERCENTRANK Returns the percentage rank of a value in a sample. -Syntax + PERCENTRANK(Data; Value; Significance) Data represents the array of data in the sample. Value represents the value whose percentile rank must be determined. Significance 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. -Example + =PERCENTRANK(A1:A50;50) 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.
@@ -429,12 +429,12 @@ PERCENTRANK.EXC Returns the relative position, between 0 and 1 (exclusive), of a specified value within a supplied array. The difference between PERCENTRANK.INC and PERCENTRANK.EXC is that PERCENTRANK.INC calculates a value in the range 0 to 1 inclusive, whereas the PERCENTRANK.EXC function calculates a value in the range 0 to 1 exclusive. -Syntax + PERCENTRANK.EXC(Data; Value; Significance) Data represents the array of data in the sample. Value represents the value whose percentile rank must be determined. Significance An optional argument that specifies the number of significant digits that the returned percentage value is rounded to. -Example + =PERCENTRANK.EXC(A1:A50;50) 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.
@@ -443,12 +443,12 @@ PERCENTRANK.INC Returns the relative position, between 0 and 1 (inclusive), of a specified value within a supplied array. The difference between PERCENTRANK.INC and PERCENTRANK.EXC is that PERCENTRANK.INC calculates a value in the range 0 to 1 inclusive, whereas the PERCENTRANK.EXC function calculates a value in the range 0 to 1 exclusive. -Syntax + PERCENTRANK.INC(Data; Value; Significance) Data represents the array of data in the sample. Value represents the value whose percentile rank must be determined. Significance An optional argument that specifies the number of significant digits that the returned percentage value is rounded to. -Example + =PERCENTRANK.INC(A1:A50;50) 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.
@@ -457,11 +457,11 @@ QUARTILE Returns the quartile of a data set. -Syntax + QUARTILE(Data; Type) Data represents the array of data in the sample. Type represents the type of quartile. (0 = MIN, 1 = 25%, 2 = 50% (MEDIAN), 3 = 75% and 4 = MAX.) -Example + =QUARTILE(A1:A50;2) returns the value of which 50% of the scale corresponds to the lowest to highest values in the range A1:A50.
@@ -472,11 +472,11 @@ QUARTILE.EXC Returns a requested quartile of a supplied range of values, based on a percentile range of 0 to 1 exclusive. The difference between QUARTILE.INC and QUARTILE.EXC is that the QUARTILE.INC function bases its calculation on a percentile range of 0 to 1 inclusive, whereas the QUARTILE.EXC function bases its calculation on a percentile range of 0 to 1 exclusive. -Syntax + QUARTILE.EXC(Data; Type) Data represents the range of data values for which you want to calculate the specified quartile. Type An integer between 1 and 3, representing the required quartile. (if type = 1 or 3, the supplied array must contain more than 2 values) -Example + =QUARTILE.EXC(A1:A50;2) returns the value of which 50% of the scale corresponds to the lowest to highest values in the range A1:A50. @@ -487,11 +487,11 @@ QUARTILE.INC Returns the quartile of a data set. The difference between QUARTILE.INC and QUARTILE.EXC is that the QUARTILE.INC function bases its calculation on a percentile range of 0 to 1 inclusive, whereas the QUARTILE.EXC function bases its calculation on a percentile range of 0 to 1 exclusive. -Syntax + QUARTILE.INC(Data; Type) Data represents the array of data in the sample. Type represents the type of quartile. (0 = MIN, 1 = 25%, 2 = 50% (MEDIAN), 3 = 75% and 4 = MAX.) -Example + =QUARTILE.INC(A1:A50;2) returns the value of which 50% of the scale corresponds to the lowest to highest values in the range A1:A50. 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 @@ RANK Returns the rank of a number in a sample. - Syntax + RANK(Value; Data; Type) Value is the value, whose rank is to be determined. @@ -47,7 +47,7 @@ Type (optional) is the sequence order. Type = 0 means descending from the last item of the array to the first (this is the default), Type = 1 means ascending from the first item of the range to the last. - Example + =RANK(A10;A1:A50) returns the ranking of the value in A10 in value range A1:A50. If Value does not exist within the range an error message is displayed. @@ -60,14 +60,14 @@ RANK.AVG Returns the statistical rank of a given value, within a supplied array of values. If there are duplicate values in the list, the average rank is returned. The difference between RANK.AVG and RANK.EQ occurs when there are duplicates in the list of values. The RANK.EQ function returns the lower rank, whereas the RANK.AVG function returns the average rank. -Syntax + RANK.AVG(Value; Data; Type) Value is the value, whose rank is to be determined. Data is the array or range of data in the sample. Type (optional) is the sequence order. Type = 0 means descending from the last item of the array to the first (this is the default), Type = 1 means ascending from the first item of the range to the last. -Example + =RANK.AVG(A10;A1:A50) returns the ranking of the value in A10 in value range A1:A50. If Value does not exist within the range an error message is displayed.
@@ -79,14 +79,14 @@ RANK.EQ Returns the statistical rank of a given value, within a supplied array of values. If there are duplicate values in the list, these are given the same rank. The difference between RANK.AVG and RANK.EQ occurs when there are duplicates in the list of values. The RANK.EQ function returns the lower rank, whereas the RANK.AVG function returns the average rank. -Syntax + RANK.EQ(Value; Data; Type) Value is the value, whose rank is to be determined. Data is the array or range of data in the sample. Type (optional) is the sequence order. Type = 0 means descending from the last item of the array to the first (this is the default), Type = 1 means ascending from the first item of the range to the last. -Example + =RANK.EQ(A10;A1:A50) returns the ranking of the value in A10 in value range A1:A50. If Value does not exist within the range an error message is displayed.
@@ -95,11 +95,11 @@ SKEW Returns the skewness of a distribution. - Syntax + SKEW(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges. - Example + =SKEW(A1:A50) calculates the value of skew for the data referenced.
@@ -115,7 +115,7 @@ mw made "regression lines" a two level entry FORECAST Extrapolates future values based on existing x and y values. - Syntax + FORECAST(Value; DataY; DataX) Value is the x value, for which the y value on the linear regression is to be returned. @@ -123,7 +123,7 @@ DataY is the array or range of known y's. DataX is the array or range of known x's. - Example + =FORECAST(50;A1:A50;B1;B50) 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. @@ -135,7 +135,7 @@ FORECAST.LINEAR Extrapolates future values based on existing x and y values. - Syntax + FORECAST.LINEAR(Value; DataY; DataX) Value is the x value, for which the y value on the linear regression is to be returned. @@ -143,7 +143,7 @@ DataY is the array or range of known y's. DataX is the array or range of known x's. - Example + =FORECAST.LINEAR(50;A1:A50;B1;B50) 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. @@ -154,11 +154,11 @@ STDEV Estimates the standard deviation based on a sample. - Syntax + STDEV(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges representing a sample based on an entire population. - Example + =STDEV(A1:A50) returns the estimated standard deviation based on the data referenced. @@ -168,11 +168,11 @@ STDEVA Calculates the standard deviation of an estimation based on a sample. - Syntax + STDEVA(Value1; Value2; ...; Value30) Value1, Value2, ..., Value30 are values or ranges representing a sample derived from an entire population. Text has the value 0. - Example + =STDEVA(A1:A50) returns the estimated standard deviation based on the data referenced. @@ -183,11 +183,11 @@ STDEVP Calculates the standard deviation based on the entire population. - Syntax + STDEVP(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges representing an entire population. - Example + =STDEVP(A1:A50) returns a standard deviation of the data referenced. @@ -199,10 +199,10 @@ STDEV.P Calculates the standard deviation based on the entire population. - Syntax + STDEV.P(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges representing an entire population. - Example + =STDEV.P(A1:A50) returns a standard deviation of the data referenced.
@@ -213,10 +213,10 @@ STDEV.S Calculates the standard deviation based on sample of the population. - Syntax + STDEV.S(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges representing a sample of the population. - Example + =STDEV.S(A1:A50) returns a standard deviation of the data referenced.
@@ -225,11 +225,11 @@ STDEVPA Calculates the standard deviation based on the entire population. - Syntax + STDEVPA(Value1; Value2; ...; Value30) Value1, Value2, ..., Value30 are values or ranges representing an entire population. Text has the value 0. - Example + =STDEVPA(A1:A50) returns the standard deviation of the data referenced.
@@ -240,7 +240,7 @@ STANDARDIZE Converts a random variable to a normalized value. - Syntax + STANDARDIZE(Number; Mean; StDev) Number is the value to be standardized. @@ -248,7 +248,7 @@ Mean is the arithmetic mean of the distribution. StDev is the standard deviation of the distribution. - Example + =STANDARDIZE(11;10;1) 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. @@ -259,11 +259,11 @@ NORMSINV Returns the inverse of the standard normal cumulative distribution. - Syntax + NORMSINV(Number) Number is the probability to which the inverse standard normal distribution is calculated. - Example + =NORMSINV(0.908789) returns 1.3333. @@ -274,11 +274,11 @@ NORM.S.INV Returns the inverse of the standard normal cumulative distribution. - Syntax + NORM.S.INV(Number) Number is the probability to which the inverse standard normal distribution is calculated. - Example + =NORM.S.INV(0.908789) returns 1.333334673. @@ -290,11 +290,11 @@ NORMSDIST Returns the standard normal cumulative distribution function. The distribution has a mean of zero and a standard deviation of one. It is GAUSS(x)=NORMSDIST(x)-0.5 - Syntax + NORMSDIST(Number) Number is the value to which the standard normal cumulative distribution is calculated. - Example + =NORMSDIST(1) returns 0.84. The area below the standard normal distribution curve to the left of X value 1 is 84% of the total area. @@ -305,13 +305,13 @@ NORM.S.DIST Returns the standard normal cumulative distribution function. The distribution has a mean of zero and a standard deviation of one. - Syntax + NORM.S.DIST(Number; Cumulative) Number is the value to which the standard normal cumulative distribution is calculated. Cumulative 0 or FALSE calculates the probability density function. Any other value or TRUE calculates the cumulative distribution function. - Examples + =NORM.S.DIST(1;0) returns 0.2419707245. @@ -323,13 +323,13 @@ SLOPE Returns the slope of the linear regression line. The slope is adapted to the data points set in the y and x values. - Syntax + SLOPE(DataY; DataX) DataY is the array or matrix of Y data. DataX is the array or matrix of X data. - Example + =SLOPE(A1:A50;B1:B50) @@ -341,13 +341,13 @@ STEYX Returns the standard error of the predicted y value for each x in the regression. - Syntax + STEYX(DataY; DataX) DataY is the array or matrix of Y data. DataX is the array or matrix of X data. - Example + =STEYX(A1:A50;B1:B50) @@ -359,11 +359,11 @@ DEVSQ Returns the sum of squares of deviations based on a sample mean. - Syntax + DEVSQ(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges representing a sample. - Example + =DEVSQ(A1:A50) @@ -375,13 +375,13 @@ TINV Returns the inverse of the t-distribution. - Syntax + TINV(Number; DegreesFreedom) Number is the probability associated with the two-tailed t-distribution. DegreesFreedom is the number of degrees of freedom for the t-distribution. - Example + =TINV(0.1;6) returns 1.94 @@ -393,11 +393,11 @@ T.INV Returns the one tailed inverse of the t-distribution. - Syntax + T.INV(Number; DegreesFreedom) Number is the probability associated with the one-tailed t-distribution. DegreesFreedom is the number of degrees of freedom for the t-distribution. - Example + =T.INV(0.1;6) returns -1.4397557473.
@@ -408,11 +408,11 @@ T.INV.2T Calculates the inverse of 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. - Syntax + T.INV.2T(Number; DegreesFreedom) Number is the probability associated with the two-tailed t-distribution. DegreesFreedom is the number of degrees of freedom for the t-distribution. - Example + =T.INV.2T(0.25; 10) returns 1.221255395.
@@ -421,7 +421,7 @@ TTEST Returns the probability associated with a Student's t-Test. - Syntax + TTEST(Data1; Data2; Mode; Type) Data1 is the dependent array or range of data for the first record. @@ -431,7 +431,7 @@ Mode = 1 calculates the one-tailed test, Mode = 2 the two- tailed test. Type 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). - Example + =TTEST(A1:A50;B1:B50;2;2) @@ -443,13 +443,13 @@ T.TEST Returns the probability associated with a Student's t-Test. - Syntax + T.TEST(Data1; Data2; Mode; Type) Data1 is the dependent array or range of data for the first record. Data2 is the dependent array or range of data for the second record. Mode = 1 calculates the one-tailed test, Mode = 2 the two- tailed test. Type 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). - Example + =T.TEST(A1:A50;B1:B50;2;2)
@@ -459,7 +459,7 @@ TDIST Returns the t-distribution. - Syntax + TDIST(Number; DegreesFreedom; Mode) Number is the value for which the t-distribution is calculated. @@ -467,7 +467,7 @@ DegreesFreedom is the number of degrees of freedom for the t-distribution. Mode = 1 returns the one-tailed test, Mode = 2 returns the two-tailed test. - Example + =TDIST(12;5;1) @@ -480,12 +480,12 @@ T.DIST Returns the t-distribution. - Syntax + T.DIST(Number; DegreesFreedom; Cumulative) Number is the value for which the t-distribution is calculated. DegreesFreedom is the number of degrees of freedom for the t-distribution. Cumulative = 0 or FALSE returns the probability density function, 1 or TRUE returns the cumulative distribution function. - Example + =T.DIST(1; 10; TRUE) returns 0.8295534338
@@ -496,11 +496,11 @@ T.DIST.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. - Syntax + T.DIST.2T(Number; DegreesFreedom) Number is the value for which the t-distribution is calculated. DegreesFreedom is the number of degrees of freedom for the t-distribution. - Example + =T.DIST.2T(1; 10) returns 0.3408931323.
@@ -511,11 +511,11 @@ T.DIST.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. - Syntax + T.DIST.RT(Number; DegreesFreedom) Number is the value for which the t-distribution is calculated. DegreesFreedom is the number of degrees of freedom for the t-distribution. - Example + =T.DIST.RT(1; 10) returns 0.1704465662.
@@ -525,11 +525,11 @@ VAR Estimates the variance based on a sample. - Syntax + VAR(Number1 ; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges representing a sample based on an entire population. - Example + =VAR(A1:A50) @@ -542,10 +542,10 @@ VAR.S Estimates the variance based on a sample. - Syntax + VAR.S(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges representing a sample based on an entire population. - Example + =VAR.S(A1:A50)
@@ -554,11 +554,11 @@ VARA Estimates a variance based on a sample. The value of text is 0. - Syntax + VARA(Value1; Value2; ...; Value30) Value1, Value2, ..., Value30 are values or ranges representing a sample derived from an entire population. Text has the value 0. - Example + =VARA(A1:A50) @@ -569,11 +569,11 @@ VARP Calculates a variance based on the entire population. - Syntax + VARP(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges representing an entire population. - Example + =VARP(A1:A50) @@ -585,10 +585,10 @@ VAR.P Calculates a variance based on the entire population. - Syntax + VAR.P(Number1; Number2; ...; Number30) Number1, Number2, ..., Number30 are numerical values or ranges representing an entire population. - Example + =VAR.P(A1:A50)
@@ -597,11 +597,11 @@ VARPA Calculates the variance based on the entire population. The value of text is 0. - Syntax + VARPA(Value1; Value2; ...; Value30) Value1, Value2, ..., Value30 are values or ranges representing an entire population. - Example + =VARPA(A1:A50) @@ -613,13 +613,13 @@ PERMUT Returns the number of permutations for a given number of objects. - Syntax + PERMUT(Count1; Count2) Count1 is the total number of objects. Count2 is the number of objects in each permutation. - Example + =PERMUT(6;3) returns 120. There are 120 different possibilities, to pick a sequence of 3 playing cards out of 6 playing cards.
@@ -629,13 +629,13 @@ PERMUTATIONA Returns the number of permutations for a given number of objects (repetition allowed). - Syntax + PERMUTATIONA(Count1; Count2) Count1 is the total number of objects. Count2 is the number of objects in each permutation. - Example + How often can 2 objects be selected from a total of 11 objects? =PERMUTATIONA(11;2) returns 121. @@ -648,7 +648,7 @@ PROB Returns the probability that values in a range are between two limits. If there is no End value, this function calculates the probability based on the principle that the Data values are equal to the value of Start. - Syntax + PROB(Data; Probability; Start; End) Data is the array or range of data in the sample. @@ -658,7 +658,7 @@ Start is the start value of the interval whose probabilities are to be summed. End (optional) is the end value of the interval whose probabilities are to be summed. If this parameter is missing, the probability for the Start value is calculated. - Example + =PROB(A1:A50;B1:B50;50;60) 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. @@ -671,7 +671,7 @@ The Weibull distribution is a continuous probability distribution, with parameters Alpha > 0 (shape) and Beta > 0 (scale). If C is 0, WEIBULL calculates the probability density function. If C is 1, WEIBULL calculates the cumulative distribution function. - Syntax + WEIBULL(Number; Alpha; Beta; C) Number is the value at which to calculate the Weibull distribution. @@ -681,7 +681,7 @@ Beta is the scale parameter of the Weibull distribution. C indicates the type of function. - Example + =WEIBULL(2;1;1;1) returns 0.86. See also the Wiki page. @@ -696,13 +696,13 @@ The Weibull distribution is a continuous probability distribution, with parameters Alpha > 0 (shape) and Beta > 0 (scale). If C is 0, WEIBULL.DIST calculates the probability density function. If C is 1, WEIBULL.DIST calculates the cumulative distribution function. - Syntax + WEIBULL.DIST(Number; Alpha; Beta; C) Number is the value at which to calculate the Weibull distribution. Alpha is the shape parameter of the Weibull distribution. Beta is the scale parameter of the Weibull distribution. C indicates the type of function. - Example + =WEIBULL.DIST(2;1;1;1) returns 0.8646647168. See also the Wiki page. 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 @@ Name -Example + @@ -144,7 +144,7 @@ Name -Example + @@ -225,7 +225,7 @@ Name -Example + @@ -254,7 +254,7 @@ Name -Example + 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 @@ + + + + + + Common Syntax and example + /text/scalc/01/common_func.xhp + + + +
+ Syntax +
+
+ Example +
+ + 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 @@
-Examples + Consider the following table
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 @@
- Examples + The table below contains a timeline and its associated values:
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 @@ 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. -Syntax + AGGREGATE(Function; Option; Ref1 [; Ref2 [; …]]) or AGGREGATE(Function; Option; Array [; k]) @@ -282,7 +282,7 @@ For using column labels “Automatically find columns and rows labels” function needs to be enabled. k – 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. -Examples +
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 @@ AVERAGEIF function 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. -Syntax + AVERAGEIF(Range; Criterion [; Average_Range ]) Range – 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. Criterion – 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). 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 @@ AVERAGEIFS function 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. -Syntax + AVERAGEIFS() Func_range – 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. 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 @@ COUNTIFS function Returns the count of cells that meet criteria in multiple ranges. -Syntax + COUNTIFS(Range1; Criterion1 [; Range2; Criterion2 [; ...]]) Range1 – 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. 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 @@ DATE This function calculates a date specified by year, month, day and displays it in the cell's formatting. 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. -Syntax + DATE(Year; Month; Day) Year is an integer between 1583 and 9957 or between 0 and 99. @@ -44,7 +44,7 @@ Day is an integer indicating the day of the month. If the values for month and day are out of bounds, they are carried over to the next digit. If you enter =DATE(00;12;31) the result will be 2000-12-31. If, on the other hand, you enter =DATE(00;13;31) the result will be 2001-01-31. -Example + =DATE(00;1;31) yields 1/31/00 if the cell format setting is MM/DD/YY. 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 @@ DATEDIF This function returns the number of whole days, months or years between Start date and End date. -Syntax + DATEDIF(Start date; End date; Interval) Start date is the date from when the calculation is carried out. @@ -92,7 +92,7 @@
-Example + Birthday calculation. A man was born on 1974-04-17. Today is 2012-06-13. =DATEDIF("1974-04-17";"2012-06-13";"y") yields 38. 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 @@ Returns the internal date number for text in quotes. 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. If the text string also includes a time value, DATEVALUE only returns the integer part of the conversion. - Syntax + DATEVALUE("Text") Text is a valid date expression and must be entered with quotation marks. - Example + =DATEVALUE("1954-07-20") yields 19925. 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 @@ DAY Returns the day of given date value. The day is returned as an integer between 1 and 31. You can also enter a negative date/time value. -Syntax + DAY(Number) Number is the internal date number. -Examples + =DAY(1) returns 31 (since $[officename] starts counting at zero from December 30, 1899) =DAY(NOW()) returns the current day. =DAY(C4) returns 5 if you enter 1901-08-05 in cell C4 (the date value might get formatted differently after you press Enter). 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 @@ DAYS Calculates the difference between two date values. The result returns the number of days between the two days. -Syntax + DAYS(Date2; Date1) Date1 is the start date, Date2 is the end date. If Date2 is an earlier date than Date1 the result is a negative number. -Examples + =DAYS("2010-01-01"; NOW()) returns the number of days from today until January 1, 2010. =DAYS("1990-10-10";"1980-10-10") returns 3652 days. 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 @@ DAYS360 Returns the difference between two dates based on the 360 day year used in interest calculations. -Syntax + DAYS360("Date1"; "Date2"; Type) If Date2 is earlier than Date1, the function will return a negative number. The optional argument Type 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. -Examples + =DAYS360("2000-01-01";NOW()) returns the number of interest days from January 1, 2000 until today. 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 @@ EASTERSUNDAY Returns the date of Easter Sunday for the entered year. -Syntax + EASTERSUNDAY(Year) Year is an integer between 1583 and 9956 or 0 and 99. You can also calculate other holidays by simple addition with this date. @@ -37,7 +37,7 @@ Good Friday = EASTERSUNDAY(Year) - 2 Pentecost Sunday = EASTERSUNDAY(Year) + 49 Pentecost Monday = EASTERSUNDAY(Year) + 50 -Examples + =EASTERSUNDAY(2000) returns 2000-04-23. =EASTERSUNDAY(2000)+49 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. 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 @@ EDATE The result is a date which is a number of months away from the start date. Only months are considered; days are not used for calculation. -Syntax + EDATE(StartDate; Months) StartDate is a date. @@ -42,7 +42,7 @@ Months is the number of months before (negative) or after (positive) the start date. -Example + What date is one month prior to 2001-03-31? =EDATE("2001-03-31";-1) returns the serial number 36950. Formatted as a date, this is 2001-02-28. 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 @@ EOMONTH Returns the date of the last day of a month which falls months away from the start date. -Syntax + EOMONTH(StartDate; Months) StartDate is a date (the starting point of the calculation). Months is the number of months before (negative) or after (positive) the start date. -Example + What is the last day of the month that falls 6 months after September 14 2001? =EOMONTH(DATE(2001;9;14);6) returns the serial number 37346. Formatted as a date, this is 2002-03-31. 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 @@ Returns a number representing a specific Error type, or the error value #N/A, if there is no error. -Syntax + ERROR.TYPE(Error_value) Error_value – required argument. The error value or a reference to a cell, whose value needs to be processed. @@ -109,7 +109,7 @@ -Examples + Simple usage =ERROR.TYPE(#N/A) Returns 7, because 7 is the index number of the error value #N/A. 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 @@ FORECAST.ETS.ADD calculates with the model -Syntax + FORECAST.ETS.ADD(targets, values, timeline, [period_length], [data_completion], [aggregation]) 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 @@ FORECAST.ETS.MULT calculates with the model -Syntax + FORECAST.ETS.MULT(targets, values, timeline, [period_length], [data_completion], [aggregation]) 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 @@ FORECAST.ETS.PI.ADD calculates with the model -Syntax + FORECAST.ETS.PI.ADD(target, values, timeline, [confidence_level], [period_length], [data_completion], [aggregation]) 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 @@ FORECAST.ETS.PI.MULT calculates with the model -Syntax + FORECAST.ETS.PI.MULT(target, values, timeline, [confidence_level], [period_length], [data_completion], [aggregation]) 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 @@ The same result is returned with FORECAST.ETS.STAT functions when argument stat_type equals 9 (and period_length equals 1). -Syntax + FORECAST.ETS.SEASONALITY (values, timeline, [data_completion], [aggregation]) 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 @@ FORECAST.ETS.STAT.ADD calculates with the model -Syntax + FORECAST.ETS.STAT.ADD (values, timeline, stat_type, [period_length], [data_completion], [aggregation]) 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 @@ FORECAST.ETS.STAT.MULT calculates with the model -Syntax + FORECAST.ETS.STAT.MULT (values, timeline, stat_type, [period_length], [data_completion], [aggregation]) 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 @@ HOUR Returns the hour for a given time value. The hour is returned as an integer between 0 and 23. -Syntax + HOUR(Number) Number, as a time value, is a decimal, for which the hour is to be returned. -Examples + =HOUR(NOW()) returns the current hour 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 @@ ISOWEEKNUM calculates the week number of the year for the internal date value. 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. -Syntax + ISOWEEKNUM(Number) Number is the internal date number. -Examples + =ISOWEEKNUM(DATE(1995;1;1)) returns 52. Week 1 starts on Monday, 1995-01-02. =ISOWEEKNUM(DATE(1999;1;1)) returns 53. Week 1 starts on Monday, 1999-01-04. 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 @@ Returns the maximum of the values of cells in a range that meets multiple criteria in multiple ranges. -Syntax + MAXIFS() Func_Range – 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. 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 @@ Returns the minimum of the values of cells in a range that meets multiple criteria in multiple ranges. -Syntax + MINIFS() Func_Range – 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. 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 @@ MINUTE Calculates the minute for an internal time value. The minute is returned as a number between 0 and 59. -Syntax + MINUTE(Number) Number, as a time value, is a decimal number where the number of the minute is to be returned. -Examples + =MINUTE(8.999) returns 58 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 @@ MONTH Returns the month for the given date value. The month is returned as an integer between 1 and 12. -Syntax + MONTH(Number) Number is the internal date number. -Examples + =MONTH(NOW()) returns the current month. =MONTH(C4) returns 7 if you enter 2000-07-07 to cell C4 (that date value might get formatted differently after you press Enter). 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 @@ NETWORKDAYS.INTL 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. -Syntax + NETWORKDAYS.INTL(StartDate; EndDate; Weekend; Holidays) StartDate is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation. EndDate 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. -Example + 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. =NETWORKDAYS.INTL(C3;D3;;F3:J3) returns 21 workdays with default for weekend days. =NETWORKDAYS.INTL(C3;D3;11;F3:J3) returns 24 workdays with Sunday only weekends. 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 @@ NETWORKDAYS Returns the number of workdays between a start date and an end date. Holidays can be deducted. -Syntax + NETWORKDAYS(StartDate; EndDate; Holidays; Workdays) StartDate is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation. EndDate 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. @@ -44,7 +44,7 @@ Workdays 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. -Examples + 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". =NETWORKDAYS(C3;D3;F3:J3) returns 17 workdays. How many workdays fall between September 12nd and 25th in 2016 if only Mondays, Tuesdays and Wednesdays are considered as workdays? 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 @@ NOW Returns the computer system date and time. The value is updated when you recalculate the document or each time a cell value is modified. -Syntax + NOW() NOW is a function without arguments. -Example + =NOW()-A1 returns the difference between the date in A1 and now. Format the result as a number. 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 @@ Convert text to number, in a locale-independent way. Constraints: LEN(decimal_separator) = 1, decimal_separator shall not appear in group_separator - Syntax + NUMBERVALUE("Text";decimal_separator;group_separator) Text is a valid number expression and must be entered with quotation marks. decimal_separator (optional) defines the character used as the decimal separator. group_separator (optional) defines the character(s) used as the group separator. - Example + =NUMBERVALUE("123.456";".";",") yields 123.456 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 @@ SECOND Returns the second for the given time value. The second is given as an integer between 0 and 59. -Syntax + SECOND(Number) Number, as a time value, is a decimal, for which the second is to be returned. -Examples + =SECOND(NOW()) returns the current second 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 @@ Returns the sum of the values of cells in a range that meets multiple criteria in multiple ranges. -Syntax + SUMIFS() Func_Range – 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. 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 @@ TIME TIME returns the current time value from values for hours, minutes and seconds. This function can be used to convert a time based on these three elements to a decimal time value. -Syntax + TIME(Hour; Minute; Second) Use an integer to set the Hour. Use an integer to set the Minute. Use an integer to set the Second. -Examples + =TIME(0;0;0) returns 00:00:00 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 @@ TIMEVALUE returns the internal time number from a text enclosed by quotes and which may show a possible time entry format. The internal number indicated as a decimal is the result of the date system used under $[officename] to calculate date entries. If the text string also includes a year, month, or day, TIMEVALUE only returns the fractional part of the conversion. -Syntax + TIMEVALUE("Text") Text is a valid time expression and must be entered in quotation marks. -Examples + =TIMEVALUE("4PM") returns 0.67. When formatting in time format HH:MM:SS, you then get 16:00:00. =TIMEVALUE("24:00") returns 0. If you use the HH:MM:SS time format, the value is 00:00:00. 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 @@ TODAY Returns the current computer system date. The value is updated when you reopen the document or modify the values of the document. -Syntax + TODAY() TODAY is a function without arguments. -Example + TODAY() returns the current computer system date. 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 @@ WEBSERVICE Get some web content from a URI. - Syntax + WEBSERVICE(URI) URI: URI text of the web service. - Example + =WEBSERVICE("wiki.documentfoundation.org/api.php?hidebots=1&days=7&limit=50&action=feedrecentchanges&feedformat=rss") Returns the web page content of "https://wiki.documentfoundation.org/api.php?hidebots=1&days=7&limit=50&action=feedrecentchanges&feedformat=rss". @@ -35,11 +35,11 @@ FILTERXML Apply a XPath expression to a XML document. - Syntax + FILTERXML(XML Document; XPath expression) XML Document (required): String containing a valid XML stream. XPath expression (required): String containing a valid XPath expression. - Example + =FILTERXML(WEBSERVICE("wiki.documentfoundation.org/api.php?hidebots=1&days=7&limit=50&action=feedrecentchanges&feedformat=rss");"//lastBuildDate") Returns information on the last build date of the wiki. @@ -51,10 +51,10 @@ ENCODEURL function Returns a URL-encoded string. 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. - Syntax + ENCODEURL(Text) Text: String to encode to a sequence of URL-standard symbols. - Example + If cell A1 contains the Cyrillic text "автомобиль", =ENCODEURL(A1) 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). If cell B1 contains the text "車", =ENCODEURL(B1) returns %E8%BB%8A ("車" means car in Japanese). 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 @@ WEEKDAY Returns the day of the week for the given date value. 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. -Syntax + WEEKDAY(Number; Type) Number, as a date value, is a decimal for which the weekday is to be returned. Type is optional and determines the type of calculation. @@ -136,7 +136,7 @@ Tools - Options- %PRODUCTNAME Calc - Calculate. -Examples + =WEEKDAY("2000-06-14") 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). =WEEKDAY("1996-07-24";2) returns 3 (the Type parameter is 2, therefore Monday is day number 1. July 24, 1996 was a Wednesday and therefore day number 3). =WEEKDAY("1996-07-24";1) returns 4 (the Type parameter is 1, therefore Sunday is day number 1. July 24, 1996 was a Wednesday and therefore day number 4). 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 @@ -Syntax + WEEKNUM(Number [; Mode]) Number is the internal date number. @@ -171,7 +171,7 @@ -Examples + =WEEKNUM(DATE(1995;1;1);1) returns 1 =WEEKNUM(DATE(1995;1;1);2) returns 52. If the week starts on Monday, Sunday belongs to the last week of the previous year. =WEEKNUM(DATE(1995;1;1);21) returns 52. Week 1 starts on Monday, 1995-01-02. 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 @@ WEEKNUM_OOO calculates the week number of the year for the internal date value. 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 WEEKNUM or ISOWEEKNUM function instead. -Syntax + WEEKNUM_OOO(Number; Mode) Number is the internal date number. @@ -41,7 +41,7 @@ any other value = Monday (ISO 8601) -Examples + =WEEKNUM_OOO(DATE(1995;1;1);1) returns 1 =WEEKNUM_OOO(DATE(1995;1;1);2) returns 52. Week 1 starts on Monday, 1995-01-02. 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 @@ The result indicates the number of the calendar week for a date. The WEEKNUM_EXCEL2003 function is designed to calculate week numbers exactly as Microsoft Excel 2003 did. Use the WEEKNUM function for ODF OpenFormula and Excel 2010 compatibility, or ISOWEEKNUM function when you just need ISO 8601 week numbers. In releases prior to $[officename] 5.1 WEEKNUM_EXCEL2003 was named WEEKNUM_ADD. -Syntax + WEEKNUM_EXCEL2003(Date; ReturnType) Date is the date within the calendar week. ReturnType is 1 for week beginning on a Sunday, 2 for week beginning on a Monday. -Example + In which week number does 2001-12-24 fall? =WEEKNUM_EXCEL2003(DATE(2001;12;24);1) returns 52. 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 @@ 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. -Syntax + WORKDAY.INTL(StartDate; Days; Weekend; Holidays) StartDate 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. Days is the number of workdays. Positive value for a result after the start date, negative value for a result before the start date. -Example + What date comes 20 workdays after December 13, 2016? Enter the start date in C3 and the number of workdays in D3. The weekend parameter (number) may be left blank or defined as 1 for default weekend (non-working days) – Saturday and Sunday. 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. 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 @@ 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 workdays away from the start date. -Syntax + WORKDAY(StartDate; Days; Holidays) StartDate is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation. @@ -44,7 +44,7 @@ Holidays is a list of optional holidays. These are non-working days. Enter a cell range in which the holidays are listed individually. -Example + 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". =WORKDAY(C3;D3;F3:J3) returns 2001-12-28. Format the serial date number as a date, for example in the format YYYY-MM-DD.UFI: fixed #i30213#
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 @@ YEAR Returns the year as a number according to the internal calculation rules. -Syntax + YEAR(Number) Number shows the internal date value for which the year is to be returned. -Examples + =YEAR(1) returns 1899 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 @@ YEARFRAC The result is the number of the years (including fractional part) between StartDate and EndDate. -Syntax + YEARFRAC(StartDate; EndDate; Basis) StartDate and EndDate are two date values. @@ -94,7 +94,7 @@
-Example + What fraction of the year 2008 lies between 2008-01-01 and 2008-07-01? =YEARFRAC("2008-01-01"; "2008-07-01";0) returns 0.50. 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 @@
-Example + The following data will be used as example @@ -233,7 +233,7 @@
-Example + 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.
@@ -396,7 +396,7 @@
-Example + The following table has two data sets.
@@ -559,7 +559,7 @@
-Example + The following table has samples of a physical phenomenon taken in 1 second interval.
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 @@ Sample size: Number of lines sampled from the source table.Periodic: Picks lines in a pace defined by Period.Period: the number of lines to skip periodically when sampling. -Example +The following data will be used as example of source data table for sampling:
-- cgit