PrecisionCalc
xl
Precision
Get Your Numbers Right

 

xlpADD

Adds two numbers, with up to 32,767 significant digits of precision.

Syntax

xlpADD(number1,number2,format_negative,format_thousands,format_currency,exponential_notation,
             maximum_significant_digits,format_decimal_place)

number1 Required. The first number to be added.
number2 Required. The second number to be added.
format_negative Optional. Determines whether negatives are formatted with a leading hyphen ("-"), or parentheses ("()"). Set to 1 to format negatives with a leading hyphen. Set to 2 for parentheses. 1 by default.

You can also format negatives with a red font.

format_thousands Optional. Determines whether thousands separators are included. Set to TRUE to include thousands separators. FALSE by default.
format_currency Optional. Determines whether currency symbol is included. Set to TRUE to include currency symbol. The currency symbol will be added either to the beginning or to the end of the result, whichever is appropriate for the locale. FALSE by default.
exponential_notation Optional. Determines whether result is formatted in exponential notation. Set to TRUE to format in exponential notation. FALSE by default.
maximum_significant_digits Optional. Determines the maximum number of significant digits to be returned. Default is 100, or the user's custom maximum set in the About box, or the maximum number allowed by the edition of xlPrecision, whichever is less.
format_decimal_place Optional. Determines whether to add or remove decimal places as required to return the exact specified number of decimal places.

When format_decimal_place causes decimal places to be removed, the remaining decimals are rounded, exactly as Excel's number formatting does.

Set format_decimal_place to the number of decimal places desired. For example, set to 3 to specify that the result should have exactly 3 decimal places, so that:

  • "123.4" is formatted as "123.400"
  • "12.3456" is formatted as "12.346"
  • "9.9999" is formatted as "10.000"


Use the Insert Function Dialog to easily enter these arguments:
(available on most editions of xlPrecision, but not recommended with the Free Edition as it causes the Free Edition dialog to appear multiple times)

   

  


Examples

Formula Description Result
=xlpADD(1,2) 1 + 2 3
=xlpADD("123456789123.456789",
             "123456.789123456789")

To prevent Excel from truncating the numbers to 15 digits, enter them in quotes as shown.

123456789123.456789 + 123456.789123456789, without letting Excel truncate to 15 significant digits 123456912580.245912456789
(25 significant digits)
=xlpADD(1,-2) 1 + -2 -1
=xlpADD(1,-2,2) 1 + -2, formatted with parentheses if negative (1)
=xlpADD(1000,2,,TRUE) 1,000 + 2, formatted with localized thousands separators 1,002  (in the USA)
1.002  (in Germany)
1 002  (in France)
=xlpADD(1000,2,,,TRUE) 1,000 + 2, formatted with the local currency symbol $1002  (in the USA)
1002 €  (in Germany)
1002 kr  (in Estonia)
1002Lek  (in Albania)
=xlpADD(1000,2,,,,TRUE) 1,000 + 2, formatted in exponential notation 1.002E+3
=xlpADD("1.002E+3","3.004E+3",,,,TRUE) '1.002E+3' + '3.004E+3', formatted in exponential notation 4.006E+3
=xlpADD(A1,A2,,,,,500)
=xlpADD(A1,A2,,,,,500000)
=xlpADD(A1,A2,,,,,A3)

To prevent Excel from truncating the numbers in cells A1 & A2 to 15 digits, preformat those cells as "Text" number format, or enter a leading apostrophe.

A1 + A2, with up to 500 (or 500,000, or the number in A3) significant digits of precision.

Allows A1, A2, and the return value to each be up to 500 (or 500,000, or the number in A3) significant digits.

=xlpADD(12.3,23,,,,,,3) 12.3 + 23, formatted to 3 decimal places. 35.300
(padded with zeros to meet the specified number of decimal places)
=xlpADD(12.3,0.045,,,,,,2) 12.3 + 0.045, formatted to 2 decimal places. 12.35
(rounded to fit the specified number of decimal places)
=xlpADD(-2000,2,2,TRUE,TRUE,,500,2) -2,000 + 2, formatted with:
  • parentheses if negative
  • localized thousands separators
  • local currency symbol
  • up to 500 significant digits of precision
  • 2 decimal places
($1,998.00)  (in the USA)
(1.
998,00 €)  (in Germany)
(1
998,00 €)  (in France)
(1 998.00
kr)  (in Estonia)
(1.
998,00Lek)  (in Albania)


Remarks

 

See Also

xlpSUM
 

 

xlPrecision Home Page
PrecisionCalc Home Page