diff --git a/helpcontent2/source/text/scalc/01/04060106.xhp b/helpcontent2/source/text/scalc/01/04060106.xhp index 4bae25051e..c8a2a3bcb4 100644 --- a/helpcontent2/source/text/scalc/01/04060106.xhp +++ b/helpcontent2/source/text/scalc/01/04060106.xhp @@ -5,9 +5,9 @@ * * $RCSfile: 04060106.xhp,v $ * - * $Revision: 1.5 $ + * $Revision: 1.6 $ * - * last change: $Author: rt $ $Date: 2005-09-07 17:27:59 $ + * last change: $Author: kz $ $Date: 2005-10-05 11:57:21 $ * * The Contents of this file are made available subject to * the terms of GNU Lesser General Public License Version 2.1. @@ -42,7 +42,7 @@ Sun Microsystems, Inc. -UFI: fixed #i25926#, added missing head2 lines, +UFI: fixed #i25926#, added missing head2 lines, also fixed #i24074#, also fixed #i18230# discovered all internal links were empty, so deleted them with FPEs approval.; dedr: reviewed @@ -88,13 +88,13 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d ACOS -Returns the arc cosine of a number. +Returns the inverse trigonometric cosine of a number. Syntax: ACOS(Number) - -Number is the value, whose arc cosine value is to be calculated. + +Number is the value, whose inverse trigonometric cosine value is to be calculated. Example: -The arc cosine of -1 returns the value 3.14. +The inverse trigonometric cosine of -1 returns the value 3.14.
ACOSH function @@ -140,13 +140,13 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d ASIN -Returns the arcsine of a number. +Returns the inverse trigonometric sine of a number. Syntax: ASIN (Number) - -Number is the value whose arcsine is to be calculated. + +Number is the value whose inverse trigonometric sine is to be calculated. Example: -The arcsine of -1 returns the value -1.57. +The inverse trigonometric sine of -1 returns the value -1.57.
ASINH function @@ -166,20 +166,20 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d ATAN -Returns the arctangent of a number. +Returns the inverse trigonometric tangent of a number. Syntax: ATAN(Number) - -Number is the value whose arctangent value is to be calculated. + +Number is the value whose inverse trigonometric tangent value is to be calculated. Example: -The arctangent of -1 returns the value -0.79. +The inverse trigonometric tangent of -1 returns the value -0.79.
ATAN2 function ATAN2 -Returns the arctangent of the specified x and y coordinates. +Returns the inverse trigonometric tangent of the specified x and y coordinates. Syntax: ATAN2(Number x; number y) @@ -187,7 +187,7 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d Number y is the value for the y coordinate. Example: -Entering the value 45 for the x coordinate and the value 90 for the y coordinate will return an arctangent of 1.11. +Entering the value 45 for the x coordinate and the value 90 for the y coordinate will return an inverse trigonometric tangent of 1.11.
ATANH function @@ -273,15 +273,13 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d EXP -Returns e raised to the power of a number. +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: The result for e raised to the power -4 is 0.02. -The result for e raised to the power 0.5 is 1.65. -The result for e raised to the power 1 is 2.72.
FACT function @@ -316,11 +314,11 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d EVEN -Returns a number rounded up to the nearest even integer. +Rounds a positive number up to the nearest even integer and a negative number down to the nearest even integer. Syntax: EVEN(number) - -Number is the number that is to be rounded up to the nearest even integer. + +Number is the number that is to be rounded. Example: If you enter the number 0.01, 2 will be returned as the result. If you enter the number -2.1, -4 will be returned as the result. @@ -446,32 +444,29 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d TRUNC -Truncates a number to an integer (number) by removing the fractional part of the number according to the precision specified in num_digits. -The decimal places correspond to the number of decimal places that are specified in Tools - Options - %PRODUCTNAME Calc - Calculate. +Truncates a number by removing decimal places of the number according to the precision specified in count. +The visible decimal places are specified in Tools - Options - %PRODUCTNAME Calc - Calculate. Syntax: TRUNC(number; count) Number is the number whose decimal places are to be cut off. - -Count is the number whose decimal places are not cut off. + +Count is the number of places after the decimal delimiter that are not to be truncated. Example: If you enter the number 34.5678 and the count 1, 34.5 will be returned as the result. -If you enter the number -15.769 and the count 3, -15.77 will be returned as the result.
LN function LN -Returns the natural logarithm based on the constant e (2.71828182845904) of a number. +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: -The natural logarithm to the base e of the value 3 will return 1.1 as the result. -The natural logarithm to the base e of the value 13 will return 2.56 as the result. -The natural logarithm to the base e of the value 1000 will return 6.91 as the result. +The natural logarithm to the base e of the value 3 will return the rounded value of 1.1 as the result.
LOG function @@ -502,28 +497,26 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d Number is the value whose logarithm to the base 10 is to be calculated. Example: The logarithm to the base 10 of the value 3 will return 0.48 as the result. -The logarithm to the base 10 of the value 10 will return 1 as the result. -The logarithm to the base 10 of the value 0.02 will return -1.7 as the result.
CEILING function CEILING -Rounds a number to the nearest integer or multiple of significance. +Rounds a number up to the nearest multiple of Significance. Syntax: -CEILING(number; increment; mode) +CEILING(Number; Significance; Mode) Number is the number that is to be rounded up. - -Increment is the number to whose multiple the value is to be rounded up. - -Mode is an optional value. If it is indicated and is not equal to zero and if the number and increment are negative, rounding up is carried out based on that value. Please note that this input gets lost in an import to MS Excel since Excel does not recognize any third parameter in functions. -If both parameters Number and Significance are negative and the Mode value is equal to zero or is not given, the results in $[officename] and Excel will differ after the import has been completed. + +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. This parameter is ignored when exporting to MS Excel as Excel does not know any third parameter. +If both parameters Number and Significance are negative and the Mode value is equal to zero or is not given, the results in $[officename] and Excel will differ after the import has been completed. If you export the spreadsheet to Excel, use Mode=1 to see the same results in Excel as in Calc. Example: -If you enter the number 3.4 and the increment 1, 4 will be returned as the result. -If you enter the number -6 and the increment -5, -5 will be returned as the result. -If you enter the number -0.6 and the increment -0.4, -0.4 will be returned as the result. +=CEILING( -11; -2) returns -10 +=CEILING( -11; -2; 0) returns -10 +=CEILING( -11; -2; 1) returns -12
PI function @@ -652,7 +645,7 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d ROUND -Returns a number rounded to a certain number of decimal places according to valid mathematical criteria. +Returns a number rounded to a certain number of decimal places. Syntax: ROUND(number; count) @@ -661,7 +654,7 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d count (optional) is the number of the places to which the value is to be rounded. If the count parameter is negative, numbers before the decimal are rounded. Example: If you enter the number 17.546 in the number field, with 1 specified as the number of rounding places, 17.5 will be returned as the result. -If you enter the number -32.483 in the number field, with 3 specified as the number of rounding places, -32.48 will be returned as the result. +=ROUND(-32.4834; 3) returns -32.483. Change the cell format to see all decimals.
ROUNDDOWN function @@ -673,8 +666,8 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d ROUNDDOWN(number; count) number is the number to be rounded down. - -count (optional) is the number of digits to be rounded down to. If the count parameter is negative, rounding is to the digits preceding the decimal point. + +count (optional) is the number of the places to which the value is to be rounded. If the count parameter is negative, numbers before the decimal are rounded. Example: Entering the value 567.567 and the value 2 in the count field will return 567.56.
@@ -688,8 +681,8 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d ROUNDUP(number; count) number is the number to be rounded up. - -count (optional) is the number of digits to which rounding up is to be done. + +count (optional) is the number of the places to which the value is to be rounded. If the count parameter is negative, numbers before the decimal are rounded. Example: Entering the value 123.343 and the value 2 in the count field will return the value 123.35. @@ -720,8 +713,6 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d Number is the number whose hyperbolic sine is to be calculated. Example: If you enter the value -5, -74.2 will be returned as the hyperbolic sine. -If you enter the value 0, 0 will be returned as the hyperbolic sine. -If you enter the value 90, 6.10E038 will be returned as the hyperbolic sine.
SUM function @@ -756,12 +747,12 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d SUMIF(range; criteria; sum_range) 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. + +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. Sum_range is the range from which values are summed. If this parameter has not been indicated, the values found in the Range are summed. Example: -An example can be found under SUM(). +To sum up only negative numbers: SUMIF(A1:A10;"<0")
TAN function @@ -790,7 +781,6 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d Number is the number whose hyperbolic tangent is to be calculated. Example: If you enter the value -5, the system returns the hyperbolic tangent -1. -If you enter the value 45, the system returns the hyperbolic tangent 1. If you enter the value 90, the system returns the hyperbolic tangent 1.
@@ -917,7 +907,7 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d CONVERT -This function allows you to convert a currency value of a European currency into Euros.UFI: deleted the path to calc.xhp because it is invalid for SO8 (of course no feature mail...) +This function allows you to convert a European currency value into Euros. Syntax: @@ -931,7 +921,7 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d =CONVERT(100;"ATS";"EUR") converts 100 Austrian Schilling into Euro. =CONVERT(100;"EUR";"DEM") converts 100 Euro into German Mark. -The table shows you the names of the currencies and the rates of exchange with the Euro set by the European Commission. The basis of calculation is 1 Euro.UFI: deleted outdated link +The table shows you the names of the currencies and the rates of exchange with the Euro set by the European Commission. The basis of calculation is 1 Euro. @@ -1109,11 +1099,11 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d ODD -Returns a number rounded up to the nearest odd integer. +Rounds a positive number up to the nearest odd integer and a negative number down to the nearest odd integer. Syntax: ODD(number) - -Number is the number that is to be rounded up. + +Number is the number that is to be rounded. Example: If you enter the number 1.01, 3 will be returned as the result. If you enter the number -3.01, -5 will be returned as the result. @@ -1124,20 +1114,20 @@ discovered all internal links were empty, so deleted them with FPEs approval.; d FLOOR -Rounds a number down to the nearest multiple of significance. +Rounds 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 it is indicated and is not equal to zero, if the number and increment are negative, rounding up is carried out based on that value. It is also possible that this value is ignored after completing an import to MS Excel as Excel does not know any third parameter. -If both parameters Number and Significance are negative, and if the Mode value is equal to zero or is not specified, then the results in $[officename] Calc and Excel will differ after exporting. + +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 the number. This parameter is ignored when exporting to MS Excel as Excel does not know any third parameter. +If both parameters Number and Significance are negative, and if the Mode value is equal to zero or is not specified, then the results in $[officename] Calc and Excel will differ after exporting. If you export the spreadsheet to Excel, use Mode=1 to see the same results in Excel as in Calc. Example: -If you enter the number 3.4 and the Significance 1, 3 will be returned as the result. -If you enter the number -6 and the Significance -5, -10 will be returned as the result. -If you enter the number -0.6 and the Significance -0.4, -0.8 will be returned as the result. +=FLOOR( -11; -2) returns -12 +=FLOOR( -11; -2; 0) returns -12 +=FLOOR( -11; -2; 1) returns -10
SIGN function