Setting the CellType of a cell to a FormulaCell will allow you to enter algebraic expressions using formulas and cell references. Cell references are entries such as A11 for column A row 11 or BA3 for column BA row 3. A formula is a defined calculation from the Formula Library which, is included with Essential Grid. This Formula Library is extensible and allows you to add additional formulas.
You can use FormulaCells for every cell in a grid or for just a few cells. Even if you assign a CellType FormulaCell to every cell in a grid, the default behavior is to treat such cells as text box cells unless you start the cell entry with an equal sign. If the cell value starts with an equal sign then, the cell is considered as a formula cell and its contents are treated as such.
To make all cells present in a grid as potential formula cells, you will have to set the CellType of the standard BaseStyle to a FormulaCell using the following code.
Essential Grid’s Formula Library contains the mathematical functions that are available in the .NET FrameWork’s System.Math class. In addition, there are Sum and Avg members. For a complete list of these library functions, please see the Class Reference for GridFormulaEngine. You can also add additional functions to this library using your own code.
In the above image, cell A2 has a formula that uses four different library functions: Sqrt, Pow, Cos, and Sin.
The current formula support will allow you to enter well-formed parenthetical algebraic expressions using operators and operands. The nine supported operators are shown in the precedence table given below, with operators on the same level being calculated as encountered when the expression is scanned from left to right.
The supported operands include those listed in the table given below. An operand by itself is also a well-formed algebraic expression that can serve as an entire formula in a cell.
Within a formula cell, a case is ignored. So, a1 is the same as A1, and Cos(3) is the same as COS(3).
Here are the steps that are required to add a function to the Function Library.
Here MyLibraryFormulaName must be a name that has not been already used in the Function Library and must include only letters and digits. If you want to replace an existing formula with a formula of the same name, first remove the existing formula before adding the new formula. Use the GridFormulaEngine.RemoveFunction method to remove a formula.
Then, write an implementation for your method. Here we use code to implement a function that will sum only positive numbers that are passed in as either a range like A1:A5 and/or a list such as A1, A4, A10. The code uses the FormulaEngine helper method to extract these values from the cells. The GetCellsFromArgs method will return an array of cells from a range such as A1:A5, and GetValueFromArgs method will take cells such as A3 and return a value such as 123.3.
The last step is to actually add your formula to the library. You should do this after the grid has been created, say in a Form.Load event handler.
The Syncfusion Grid control supports 370 formulas under various categories including math, statistical, logical, engineering, information, date, time, text, web, financial, lookup, and database functions.
Name |
Description |
Syntax |
ABS |
Returns the number without its sign. |
ABS(number) |
ACOS |
Returns the arccosine, or inverse cosine, of a number. The returned angle is given in radians in the range 0 (zero) to pi. |
ACOS(number)number must be in the range of -1 to 1. |
ACOSH |
Returns the inverse hyperbolic cosine of a number.The inverse hyperbolic cosine is the value whose hyperbolic cosine is number. |
ACOSH(number)number must be a real number. |
ACOT |
Returns the principal value of the arc cotangent, or inverse cotangent, of a number. |
ACOT(number)number must be a real number. |
ACOTH |
Returns the inverse hyperbolic cotangent of a number. |
ACOTH(number)number must be greater than 1. |
ARABIC |
Converts a Roman numeral to an Arabic numeral. |
ARABIC( text ) |
ASIN |
Returns the arcsine, or inverse sine, of a number.The returned angle is given in radians in the range -pi/2 to pi/2. |
ASIN(number)number must be in the range of -1 to 1. |
ASINH |
Returns the inverse hyperbolic sine of a number. |
ASINH(number)number must be a real number. |
ATAN |
Returns the arctangent, or inverse tangent, of a number.The returned angle is given in radians in the range -pi/2 to pi/2. |
ATAN(number) |
ATAN2 |
Returns the arctangent, or inverse tangent, of the specified x- and y-coordinates. |
ATAN2(x_num, y_num) |
ATANH |
Returns the inverse hyperbolic tangent of a number. |
ATANH(number)number must be in the range of -1 and 1. |
BASE |
Converts a number into a text representation with the given radix. |
BASE(Number, Radix, [Min_length])Number must be an integer greater than or equal to 0 and less than 2^53.Radix must be an integer greater than or equal to 2 and less than or equal to 36.Min_Length must be an integer greater than or equal to 0. (Optional) |
CEILING |
Returns number rounded up to the nearest multiple of significance. |
CEILING(number, significance) |
CEILING.MATH |
Rounds a number up to the nearest integer or to the nearest multiple of significance. |
CEILING(number, [significance], [mode])number must be less than 9.99E+307 and greater than -2.229E-308.Significance: The multiple to which the number is to be rounded. (Optional)Mode: For negative numbers, controls whether number is rounded toward or away from zero. (Optional) |
COMBIN |
Returns the number of combinations for a given number of items. |
COMBIN(number, number_chosen) |
COMBINA |
Returns the number of combinations (with repetitions) for a given number of items. |
COMBINA(number, number_chosen) |
COS |
Returns the cosine of the given angle. |
COS(number) |
COSH |
Returns the hyperbolic cosine of a number. |
COSH(number) |
COT |
Returns the cotangent of an angle specified in radians. |
COT(number) |
COTH |
Returns the hyperbolic cotangent of a hyperbolic angle. |
COTH(number) |
CSC |
Returns the cosecant of an angle specified in radians. |
CSC(number) |
CSCH |
Returns the hyperbolic cosecant of an angle specified in radians. |
CSCH(number) |
DECIMAL |
Converts a text representation of a number in a given base into a decimal number. |
DECIMAL(text, radix)Radix must be an integer. |
DEGREES |
Converts radians into degrees. |
DEGREES(angle) |
EVEN |
Returns number rounded up to the nearest even integer. |
EVEN(number) |
EXP |
Returns e raised to the power of number. The constant e equals 2.71828182845904, the base of the natural logarithm. |
EXP(number) |
FACT |
Returns the factorial of a number. |
FACT(number) |
FACTDOUBLE |
Returns the double factorial of a number. |
FACTDOUBLE(number) |
FLOOR |
Rounds number down, toward zero, to the nearest multiple of significance. |
FLOOR(number, significance) |
GCD |
Returns the greatest common divisor of two or more integers. |
GCD(number1, [number2], ...) |
INT |
Rounds a number down to the nearest integer. |
INT(number) |
LCM |
Returns the least common multiple of integers. |
LCM(number1, [number2], ...) |
LN |
Returns the natural logarithm of a number. |
LN(number) |
LOG |
Returns the logarithm of a number to the base you specify. |
LOG(number, [base])Number must be a positive real number.Base: Optional, if base is omitted it is assumed to be 10. |
LOG10 |
Returns the base 10 logarithm of a number. |
LOG10(number) |
MDETERM |
Returns the matrix determinant of an array. |
MDETERM(array)Array is a numeric array with an equal number of rows and columns. |
MINVERSE |
Returns the inverse matrix for the matrix stored in an array. |
MINVERSE(array)Array is a numeric array with an equal number of rows and columns. |
MMULT |
Returns the matrix product of two arrays. |
MMULT(array1, array2) |
MOD |
Returns the remainder after number is divided by divisor. The result has the same sign as divisor. |
MOD(number, divisor) |
MROUND |
Returns a number rounded to the desired multiple. |
MROUND(number, multiple) |
MULTINOMIAL |
Returns the ratio of the factorial of a sum of values to the product of factorials. |
MULTINOMIAL(number1, [number2], ...) |
MUNIT |
Returns the unit matrix for the specified dimension. |
MUNIT(dimension)Dimension must be an integer greater than 0. |
ODD |
Returns number rounded up to the nearest odd integer. |
ODD(number) |
PI |
Returns the number 3.14159265358979 |
PI() |
POW |
Returns the result of a number raised to a power. |
POW(number, power) |
POWER |
Returns the result of a number raised to a power. |
POWER(number, power) |
PRODUCT |
Multiplies all of the numbers given as arguments and returns the product. |
PRODUCT(number1, [number2], ...) |
QUOTIENT |
Returns the integer portion of a division. |
QUOTIENT(numerator, denominator) |
RADIANS |
Converts degrees to radians. |
RADIANS(angle) |
ROMAN |
Converts an Arabic numeral to a Roman numeral as text. |
ROMAN(number, [form])Number is an Arabic numeral you want converted.Form: Optional. A number specifying the type of Roman numeral you want |
ROUND |
Rounds a number to a specified number of digits. |
ROUND(number, num_digits) |
ROUNDDOWN |
Rounds a number down, toward zero. |
ROUNDDOWN(number, num_digits) |
ROUNDUP |
Rounds a number up, away from zero. |
ROUNDUP(number, num_digits) |
SEC |
Returns the secant of an angle. |
SEC(number) |
SECH |
Returns the hyperbolic secant of an angle. |
SECH(number) |
SIGN |
Determines the sign of a number. Returns 1 if the number is positive, zero (0) if the number is 0, and -1 if the number is negative. |
SIGN(number)Number must be a real number. |
SIN |
Returns the sine of the given angle. |
SIN(number) |
SINH |
Returns the hyperbolic sine of a number. |
SINH(number)Number must be a real number. |
SQRT |
Returns a positive square root. |
SQRT(number) |
SQRTPI |
Returns the square root of (number * pi). |
SQRTPI(number) |
SUBTOTAL |
Returns a subtotal in a list or database. |
SUBTOTAL(function_num,ref1,[ref2],...)function_num specifies which function to use in calculating subtotals.
Function_num |
Function |
1 |
101 |
AVERAGE |
2 |
102 |
COUNT |
3 |
103 |
COUNTA |
4 |
104 |
MAX |
5 |
105 |
MIN |
6 |
106 |
PRODUCT |
7 |
107 |
STDEV |
8 |
108 |
STDEVP |
9 |
109 |
SUM |
10 |
110 |
VAR |
11 |
111 |
VARP |
The function_num 1-11 includes hidden cell values, and the 101-111 ignores the hidden values.
Ref1: NamedRange or References
Ref2: Optional , named range or cell references.
|
SUM |
Adds all the numbers that have been specified as arguments. |
SUM(number1,[number2],...) |
SUMIFS |
Adds the cells in a range that meet multiple criteria. |
SUMIFS(sum_range,criteria_range1, criteria1, [criteria_range2, criteria2], ...)Sum_range: One or more cells to sum, including numbers or names, ranges, or cell references that contain numbers. Blank and text values are ignored.Criteria_range1: The first range in which to evaluate the associated criteria.Criteria1: The criteria in the form of a number, expression etc.Criteria_range2 , Criteria2: Optional. |
SUMPRODUCT |
Multiplies corresponding components in the given arrays, and returns the sum of those products. |
SUMPRODUCT(array1, [array2], [array3], ...)Array1: The first array argument whose components you want to multiply and then add.Array2, array3,... Optional. |
SUMSQ |
Returns the sum of the squares of the arguments. |
SUMSQ(number1, [number2], ...) |
SUMX2MY2 |
Returns the sum of the difference of squares of corresponding values in two arrays. |
SUMX2MY2(array_x, array_y) |
SUMX2PY2 |
Returns the sum of the sum of squares of corresponding values in two arrays. |
SUMX2PY2(array_x, array_y) |
SUMXMY2 |
Returns the sum of squares of differences of corresponding values in two arrays. |
SUMXMY2(array_x, array_y) |
TAN |
Returns the tangent of the given angle. |
TAN(number) |
TANH |
Returns the hyperbolic tangent of a number. |
TANH(number) |
TRUNC |
Truncates a number to an integer by removing the fractional part of the number. |
TRUNC(number, [num_digits]) |
TRUNCATE |
Truncates a number to an integer by removing the fractional part of the number. |
TRUNCATE(number, [num_digits]) |
Name |
Description |
Syntax |
AVEDEV |
Returns the average of the absolute deviations of data points from their mean. |
AVEDEV(number1, [number2], ...) |
AVERAGE |
Returns the average (arithmetic mean) of the arguments. |
AVERAGE(number1, [number2], ...) |
AVERAGEA |
Calculates the average (arithmetic mean) of the values in the list of arguments. |
AVERAGEA(value1, [value2], ...) |
AVE |
Equivalent to Average. Added for compatibility with older versions. |
AVE(number1, [number2], ...) |
BINOM.DIST |
Returns the individual term binomial distribution probability. |
BINOM.DIST(number_s,trials,probability_s,cumulative)Number_s: The number of successes in trials.Trials: The number of independent trials.Probability_s: The probability of success on each trial.Cumulative: A logical value (TRUE/FALSE) |
BINOM.INV |
Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value. |
BINOM.INV(trials,probability_s,alpha)Trials: The number of Bernoulli trials.Probability_s: The probability of a success on each trial.Alpha: The criterion value. |
BINOMDIST |
Equivalent to BINOM.DIST, added for compatibility with older versions. |
BINOMDIST(number_s,trials,probability_s,cumulative) |
CHIDIST |
Equivalent to CHISQ.DIST, added for compatibility with older versions. |
CHIDIST(x,deg_freedom) |
CHIINV |
Equivalent to CHISQ.INV, added for compatibility with older versions. |
CHIINV(probability,deg_freedom) |
CHISQ.DIST.RT |
Returns the right-tail probability of the chi-squared distribution. |
CHISQ.DIST.RT(x,deg_freedom)X : The value at which you want to evaluate the distribution.Deg_freedom : The number of degrees of freedom. |
CHISQ.INV |
Returns the inverse of the left-tail probability of the chi-squared distribution. |
CHISQ.INV(probability,deg_freedom)Probability: A probability associated with the chi-squared distribution.Deg_freedom: The number of degrees of freedom. |
CHISQ.INV.RT |
Returns the inverse of the right-tail probability of the chi-squared distribution. |
CHISQ.INV.RT(probability,deg_freedom)Probability: A probability associated with the chi-squared distribution.Deg_freedom: The number of degrees of freedom. |
CHISQ.TEST |
Returns the value from the chi-squared (χ2) |
CHISQ.TEST(actual_range,expected_range)Actual_range: The range of data that contains observations to test against expected values.Expected_range: The range of data that contains the ratio of the product of row totals and column totals to the grand total. |
CHITEST |
Equivalent to CHISQ.TEST, added for compatibility with older versions. |
CHITEST(actual_range,expected_range) |
CONFIDENCE |
Returns the confidence interval for a population mean, using a normal distribution. |
CONFIDENCE(alpha,standard_dev,size)Alpha: The significance level used to compute the confidence level. Standard_dev: The population standard deviation for the data range, it is assumed to be known.Size: The sample size. |
CONFIDENCE.NORM |
Returns the confidence interval for a population mean, using a normal distribution. |
CONFIDENCE.NORM(alpha,standard_dev,size)Alpha: The significance level used to compute the confidence level. Standard_dev: The population standard deviation for the data range, it is assumed to be known.Size: The sample size. |
CONFIDENCE.T |
Returns the confidence interval for a population mean, using a student's t distribution. |
CONFIDENCE.T(alpha,standard_dev,size) |
CORREL |
Returns the correlation coefficient of the Array1 and Array2 cell ranges. |
CORREL(array1, array2)Array1: A cell range of values.Array2: A second cell range of values. |
COUNT |
Counts the number of cells that contain numbers. |
COUNT(value1, [value2], ...)Value1, value2: Cell Reference or Range |
COUNTA |
Counts the number of cells that are not empty in a range. |
COUNTA(value1, [value2], ...)value1: The first argument representing the values that you want to count.value2: Additional arguments representing the values that you want to count. (Optional) |
COUNTBLANK |
Counts the empty cells in a specified range of cells. |
COUNTBLANK(range) |
COUNTIF |
Counts the number of cells within a range that meet a single criterion that you specify. |
COUNTIF(range, criteria)range: One or more cells to count.criteria: A number, expression, cell reference, or text string. |
COVAR |
Returns covariance, the average of the products of deviations for each data point pair in two data sets. |
COVAR(array1,array2)Array1: The first cell range of integers.Array2: The second cell range of integers. |
COVARIANCE.P |
Returns population covariance, the average of the products of deviations for each data point pair in two data sets. |
COVARIANCE.P(array1,array2)Array1: The first cell range of integers.Array2: The second cell range of integers. |
COVARIANCE.S |
Returns the sample covariance, the average of the products of deviations for each data point pair in two data sets. |
COVARIANCE.S(array1,array2)Array1: The first cell range of integers.Array2: The second cell range of integers. |
CRITBINOM |
Equivalent to BINOM.INV, added for compatibility with older versions. |
CRITBINOM(trials,probability_s,alpha) |
DEVSQ |
Returns the sum of squares of deviations of data points from their sample mean. |
DEVSQ(number1, [number2], ...) |
EXPON.DIST |
Returns the exponential distribution. |
EXPON.DIST(x,lambda,cumulative)X: The value of the function.Lambda: The parameter value.Cumulative: A logical value. If cumulative is TRUE, EXPON.DIST returns the cumulative distribution function; if FALSE, it returns the probability density function. |
EXPONDIST |
Equivalent to EXPON.DIST, added for Compatibility with older versions. |
EXPONDIST(x,lambda,cumulative) |
F.DIST |
Returns the F probability distribution. |
F.DIST(x,deg_freedom1,deg_freedom2,cumulative)X: The value at which to evaluate the function.Deg_freedom1: The numerator degrees of freedom.Deg_freedom2: The denominator degrees of freedom.Cumulative: A logical value. If cumulative is TRUE, F.DIST returns the cumulative distribution function; if FALSE, it returns the probability density function. |
F.DIST.RT |
Returns the (right-tailed) F probability distribution for two data sets. |
F.DIST.RT(x,deg_freedom1,deg_freedom2)X :The value at which to evaluate the function.Deg_freedom1: The numerator degrees of freedom.Deg_freedom2: The denominator degrees of freedom. |
F.INV.RT |
Returns the inverse of the (right-tailed) F probability distribution. |
F.INV.RT(probability,deg_freedom1,deg_freedom2)Probability: A probability associated with the F cumulative distribution.Deg_freedom1: The numerator degrees of freedom.Deg_freedom2: The denominator degrees of freedom. |
FDIST |
Equivalent to F.DIST, added for compatibility with older versions. |
FDIST(x,deg_freedom1,deg_freedom2) |
FINV |
Equivalent to F.INV, added for compatibility with older versions. |
FINV(probability,deg_freedom1,deg_freedom2) |
FISHER |
Returns the Fisher transformation at x. |
FISHER(x)X: A numeric value for which you want the transformation. |
FISHERINV |
Returns the inverse of the Fisher transformation. |
FISHERINV(y)Y: The value for which you want to perform the inverse of the transformation. |
FORECAST |
Calculates, or predicts, a future value using existing values. |
FORECAST(x, known_y's, known_x's)X: The data point for which you want to predict a value.Known_y's: The dependent array or range of data.Known_x's: The independent array or range of data. |
GAMMA.DIST |
Returns the gamma distribution. |
GAMMA.DIST(x,alpha,beta,cumulative)X: The value at which you want to evaluate the distribution.Alpha: A parameter to the distribution.Beta: A parameter to the distribution. Cumulative: If cumulative is TRUE, GAMMA.DIST returns the cumulative distribution function; if FALSE, it returns the probability density function. |
GAMMA.INV |
Returns the inverse of the gamma cumulative distribution. |
GAMMA.INV(probability,alpha,beta)Probability: The probability associated with the gamma distribution.Alpha: A parameter to the distribution.Beta: A parameter to the distribution. If beta = 1, GAMMA.INV returns the standard gamma distribution. |
GAMMADIST |
Equivalent to GAMMA.DIST, added for compatibility with older versions. |
GAMMADIST(x,alpha,beta,cumulative) |
GAMMAINV |
Equivalent to GAMMA.INV, added for compatibility with older versions. |
GAMMAINV(probability,alpha,beta) |
GAMMALN |
Returns the natural logarithm of the gamma function, Γ(x). |
GAMMALN(x)X: The value for which you want to calculate GAMMALN. |
GAMMALN.PRECISE |
Returns the natural logarithm of the gamma function, Γ(x). |
GAMMALN.PRECISE(x)X: The value for which you want to calculate GAMMALN.PRECISE. |
GEOMEAN |
Returns the geometric mean of an array or range of positive data. |
GEOMEAN(number1, [number2], ...) |
HARMEAN |
Returns the harmonic mean of a data set. |
HARMEAN(number1, [number2], ...) |
HYPGEOM.DIST |
Returns the hypergeometric distribution. |
HYPGEOM.DIST(sample_s,number_sample,population_s,number_pop, ,cumulative)Sample_s: The number of successes in the sample.Number_sample: The size of the sample.Population_s: The number of successes in the population.Number_pop: The population size.Cumulative: If cumulative is TRUE, then HYPGEOM.DIST returns the cumulative distribution function; if FALSE, it returns the probability mass function. |
HYPGEOMDIST |
Equivalent to HYPGEOM.DIST, added for compatibility with older versions. |
HYPGEOMDIST(sample_s,number_sample,population_s,number_pop) |
INTERCEPT |
Calculates the point at which a line will intersect the y-axis by using existing x-values and y-values. |
INTERCEPT(known_y's, known_x's)Known_y's: The dependent set of observations or data.Known_x's: The independent set of observations or data. |
KURT |
Returns the kurtosis of a data set. |
KURT(number1, [number2], ...) |
LARGE |
Returns the k-th largest value in a data set. |
LARGE(array, k)Array: The array or range of data .K: The position in the array or cell range of data to return |
LOGINV |
Equivalent to LOGNORM.INV, added for compatibility with older versions. |
LOGINV(probability, mean, standard_dev) |
LOGNORM.DIST |
Returns the log-normal distribution of x. |
LOGNORM.DIST(x,mean,standard_dev,cumulative)X: The value at which to evaluate the function.Mean: The mean of ln(x).Standard_dev: The standard deviation of ln(x).Cumulative: If cumulative is TRUE, LOGNORM.DIST returns the cumulative distribution function; if FALSE, it returns the probability density function. |
LOGNORM.INV |
Returns the inverse of the log-normal cumulative distribution function of x. |
LOGNORM.INV(probability, mean, standard_dev)Probability: A probability associated with the log-normal distribution.Mean: The mean of ln(x).Standard_dev: The standard deviation of ln(x). |
LOGNORMDIST |
Equivalent to LOGNORM.DIST, added for Compatibility with older versions. |
LOGNORMDIST(x,mean,standard_dev) |
MAX |
Returns the largest value in a set of values. |
MAX(number1, [number2], ...) |
MAXA |
Returns the largest value in the list of arguments. |
MAXA(value1,[value2],...) |
MEDIAN |
Returns the median of the given numbers. |
MEDIAN(number1, [number2], ...) |
MIN |
Returns the smallest value in a set of values. |
MIN(number1, [number2], ...) |
MINA |
Returns the smallest value in the list of arguments. |
MINA(value1, [value2], ...) |
MODE |
Returns the most frequently occurring, or repetitive, value in an array or range of data. |
MODE(number1,[number2],...) |
NEGBINOM.DIST |
Returns the negative binomial distribution. |
NEGBINOM.DIST(number_f,number_s,probability_s,cumulative)Number_f: The number of failures.Number_s: The threshold number of successes.Probability_s: The probability of a success.Cumulative: If cumulative is TRUE, NEGBINOM.DIST returns the cumulative distribution function; if FALSE, it returns the probability density function. |
NEGBINOMDIST |
Equivalent to NEGBINOM.DIST, added for compatibility with old versions. |
NEGBINOMDIST(number_f,number_s,probability_s) |
NORM.DIST |
Returns the normal distribution for the specified mean and standard deviation. |
NORM.DIST(x,mean,standard_dev,cumulative)X: The value for which you want the distribution.Mean: The arithmetic mean of the distribution.Standard_dev: The standard deviation of the distribution.Cumulative: If cumulative is TRUE, NORM.DIST returns the cumulative distribution function; if FALSE, it returns the probability mass function. |
NORM.INV |
Returns the inverse of the normal cumulative distribution for the specified mean and standard deviation. |
NORM.INV(probability,mean,standard_dev)Probability: A probability corresponding to the normal distribution.Mean: The arithmetic mean of the distribution.Standard_dev: The standard deviation of the distribution. |
NORM.S.DIST |
Returns the standard normal distribution. |
NORM.S.DIST(z,cumulative)Z: The value for which you want the distribution.Cumulative: If cumulative is TRUE, NORMS.DIST returns the cumulative distribution function; if FALSE, it returns the probability mass function. |
NORM.S.INV |
Returns the inverse of the standard normal cumulative distribution. |
NORM.S.INV(probability)Probability: A probability corresponding to the normal distribution. |
NORMDIST |
Equivalent to NORM.DIST, added for compatibility with old versions. |
NORMDIST(x,mean,standard_dev,cumulative) |
NORMINV |
Equivalent to NORM.INV, added for compatibility with old versions. |
NORMINV(probability,mean,standard_dev) |
NORMSDIST |
Equivalent to NORM.S.DIST, added for compatibility with old versions. |
NORMSDIST(z,cumulative) |
NORMSINV |
Equivalent to NORM.S.INV, added for compatibility with old versions. |
NORMSINV(z,cumulative) |
PEARSON |
Returns the Pearson product moment correlation coefficient. |
PEARSON(array1, array2)Array1: A set of independent values.Array2: A set of dependent values. |
PERCENTILE |
Returns the k-th percentile of values in a range. |
PERCENTILE(array,k)Array: The array or range of data that defines relative standing.K: The percentile value in the range of 0 to 1, inclusively. |
PERCENTILE.EXC |
Returns the k-th percentile of values in a range, where k is in the range of 0 to 1, exclusively. |
PERCENTILE.EXC(array,k)Array: The array or range of data that defines relative standing.K: The percentile value in the range of 0 to 1, exclusively. |
PERCENTILE.INC |
Returns the k-th percentile of values in a range, where k is in the range of 0 to 1, inclusively. |
PERCENTILE.INC(array,k)Array: The array or range of data that defines relative standing.K: The percentile value in the range 0 to 1, exclusively. |
PERCENTRANK |
Returns the rank of a value in a data set as a percentage of the data set. |
PERCENTRANK(array,x,[significance])Array: The array or range of data with numeric values that defines relative standing.X: The value for which you want to know the rank.Significance: A value that identifies the number of significant digits for the returned percentage value. |
PERCENTRANK.EXC |
Returns the rank of a value in a data set as a percentage (0 to 1, exclusively) of the data set. |
PERCENTRANK.EXC(array,x,[significance])Array: The array or range of data with numeric values that defines relative standing.X: The value for which you want to know the rank.Significance: A value that identifies the number of significant digits for the returned percentage value. |
PERCENTRANK.INC |
Returns the rank of a value in a data set as a percentage (0 to1, inclusively) of the data set. |
PERCENTRANK.INC(array,x,[significance])Array: The array or range of data with numeric values that defines relative standing.X: The value for which you want to know the rank.Significance: A value that identifies the number of significant digits for the returned percentage value. |
PERMUT |
Returns the number of permutations for a given number of objects that can be selected from number objects. |
PERMUT(number, number_chosen)Number: An integer that describes the number of objects.Number_chosen: An integer that describes the number of objects in each permutation. |
PERMUTATIONA |
Returns the number of permutations for a given number of objects (with repetitions) that can be selected from the total objects. |
PERMUTATIONA(number, number-chosen)Number: An integer that describes the number of objects.Number_chosen: An integer that describes the number of objects in each permutation. |
POISSON |
This function has been replaced with the POISSON.DIST function. This function is available for compatibility with older versions. |
POISSON(x,mean,cumulative) |
POISSON.DIST |
Returns the Poisson distribution. |
POISSON.DIST(x,mean,cumulative)X: The number of events.Mean: The expected numeric value.Cumulative: If cumulative is TRUE, POISSON.DIST returns the cumulative Poisson distribution. If FALSE, it returns the Poisson probability mass function. |
PROB |
Returns the probability that values in a range are between two limits. |
PROB(x_range, prob_range, [lower_limit], [upper_limit])X_range: The range of numeric values of x with which there are associated probabilities.Prob_range: A set of probabilities associated with values in x_range.Lower_limit: The lower limit on the value for which you want a probability.Upper_limit: The optional upper limit on the value for which you want a probability. |
QUARTILE |
This function has been replaced with QUARTILE.EXC and QUARTILE.INC.However, this function is available for compatibility with older versions. |
QUARTILE(array,quart) |
QUARTILE.EXC |
Returns the quartile of the data set, based on percentile values from 0 to1, exclusively. |
QUARTILE.EXC(array, quart)Array: The array or cell range of numeric values for which you want the quartile value.Quart: Indicates which value to return. |
QUARTILE.INC |
Returns the quartile of a data set, based on percentile values from 0 to 1, inclusively. |
QUARTILE.INC(array,quart)Array: The array or cell range of numeric values for which you want the quartile value.Quart: Indicates which value to return. |
RANK.AVG |
Returns the rank of a number in a list of numbers. |
RANK.AVG(number,ref,[order])Number: The number whose rank you want to find.Ref: An array of, or a reference to, a list of numbers. Non numeric values in Ref are ignored.Order: A number specifying how to rank number. |
RANK.EQ |
Returns the rank of a number in a list of numbers. |
RANK.EQ(number,ref,[order])Number: The number whose rank you want to find.Ref: An array of, or a reference to, a list of numbers. Non numeric values in Ref are ignored.Order: A number specifying how to rank number. |
RANK |
This function has been replaced with the RANK.AVG and RANK.EQ functions.This is available for compatibility with older versions. |
RANK(number,ref,[order]) |
RSQ |
Returns the square of the Pearson product moment correlation coefficient through data points in known_y's and known_x's. |
RSQ(known_y's,known_x's)Known_y's: An array or range of data points.Known_x's: An array or range of data points. |
SKEW |
Returns the skewness of a distribution. |
SKEW(number1, [number2], ...) |
SKEW.P |
Returns the skewness of a distribution based on a population. |
SKEW.P(number 1, [number 2],…) |
SLOPE |
Returns the slope of the linear regression line through data points in known_y's and known_x's. |
SLOPE(known_y's, known_x's)Known_y's: An array or cell range of numeric dependent data points.Known_x's: The set of independent data points. |
SMALL |
Returns the k-th smallest value in a data set. |
SMALL(array, k)Array: An array or range of numerical data for which you want to determine the k-th smallest value.K: The position (from the smallest) in the array or range of data to return. |
STANDARDIZE |
Returns a normalized value from a distribution characterized by mean and standard_dev. |
STANDARDIZE(x, mean, standard_dev)X: The value you want to normalize.Mean: The arithmetic mean of the distribution.Standard_dev: The standard deviation of the distribution. |
STDEV |
This function has been replaced with the STDEV.S function.This function is available for compatibility with older versions. |
STDEV(number1,[number2],...) |
STDEV.P |
Calculates standard deviation based on the entire population given as arguments. |
STDEV.P(number1,[number2],...) |
STDEV.S |
Estimates standard deviation based on a sample (ignores logical values and text in the sample). |
STDEV.S(number1,[number2],...) |
STDEVA |
Estimates standard deviation based on a sample. |
STDEVA(value1, [value2], ...) |
STDEVP |
This function has been replaced with the STDEV.P function. It is available for compatibility with older versions. |
STDEVP(number1,[number2],...) |
STDEVPA |
Calculates standard deviation based on the entire population given as arguments, including text and logical values. |
STDEVPA(value1, [value2], ...) |
STEYX |
Returns the standard error of the predicted y-value for each x in the regression. |
STEYX(known_y's, known_x's)Known_y's: An array or range of dependent data points.Known_x's: An array or range of independent data points. |
T.INV |
Returns the left-tail inverse of the Student's t-distribution. |
T.INV(probability,deg_freedom)Probability: The probability associated with the Student's t-distribution.Deg_freedom: The number of degrees of freedom with which to characterize the distribution. |
TRIMMEAN |
Returns the mean of the interior of a data set. |
TRIMMEAN(array, percent)Array: The array or range of values to trim and average.Percent: The fractional number of data points to exclude from the calculation. |
VAR |
This function has been replaced with the VAR.S function.This is available for compatibility with older versions. |
VAR(number1,[number2],...) |
VARA |
Estimates variance based on a sample. |
VARA(value1, [value2], ...) |
VARP |
This function has been replaced with the VAR.P function.This is available for compatibility with older versions. |
VARP(number1,[number2],...) |
VARPA |
Calculates the variance based on the entire population. |
VARPA(value1, [value2], ...) |
WEIBULL |
This function has been replaced with the WEIBULL.DIST function.This is available for compatibility with older versions. |
WEIBULL(x,alpha,beta,cumulative) |
WEIBULL.DIST |
Returns the Weibull distribution. |
WEIBULL.DIST(x,alpha,beta,cumulative)X: The value at which to evaluate the function.Alpha: A parameter for the distribution.Beta: A parameter for the distribution.Cumulative: Determines the form of the function. |
Z.TEST |
Returns the one-tailed P-value of a z-test. |
Z.TEST(array,x,[sigma])Array: The array or range of data against which to test x.x: The value to test.Sigma: The population (known) standard deviation. |
ZTEST |
This function has been replaced with the Z.TEST function.This is available for compatibility with older versions. |
ZTEST(array,x,[sigma]) |
Name |
Description |
Syntax |
BESSELI |
Returns the modified Bessel function. |
BESSELI(X, N)X: The value at which to evaluate the function.N: The order of the Bessel function. If n is not an integer, it is truncated. |
BESSELJ |
Returns the Bessel function. |
BESSELJ(X, N)X: The value at which to evaluate the function.N: The order of the Bessel function. If n is not an integer, it is truncated. |
BESSELK |
Returns the modified Bessel function, which is equivalent to the Bessel functions evaluated for purely imaginary arguments. |
BESSELK(X, N)X: The value at which to evaluate the function.N: The order of the function. If n is not an integer, it is truncated. |
BESSELY |
Returns the Bessel function, which is also called the Weber function or the Neumann function. |
BESSELY(X, N)X: The value at which to evaluate the function.N: The order of the function. If n is not an integer, it is truncated. |
BIN2DEC |
Converts a binary number to decimal. |
BIN2DEC(number)Number: The binary number you want to convert. |
BIN2HEX |
Converts a binary number to hexadecimal. |
BIN2HEX(number, [places])Number: The binary number you want to convert.Places: The number of characters to use. |
BIN2OCT |
Converts a binary number to octal. |
BIN2OCT(number, [places])Number: The binary number you want to convert.Places: The number of characters to use. |
BITAND |
Returns a bitwise 'AND' of two numbers. |
BITAND( number1, number2)Number1,Number2: Must be in decimal form and greater than or equal to 0. |
BITLSHIFT |
Returns a number shifted left by the specified number of bits. |
BITLSHIFT(number, shift_amount)Number: Number must be an integer greater than or equal to 0.Shift_amount: Shift_amount must be an integer. |
BITOR |
Returns a bitwise 'OR' of two numbers. |
BITOR(number1, number2)Number1, Number2: Must be in decimal form and greater than or equal to 0. |
BITRSHIFT |
Returns a number shifted right by the specified number of bits. |
BITRSHIFT(number, shift_amount)Number: Number must be an integer greater than or equal to 0.Shift_amount: Shift_amount must be an integer. |
BITXOR |
Returns a bitwise 'XOR' of two numbers. |
BITXOR(number1, number2)Number1,Number2: Must be in decimal form and greater than or equal to 0. |
COMPLEX |
Converts real and imaginary coefficients into a complex number of the form x + yi or x + yj. |
COMPLEX(real_num, i_num, [suffix])Real_num: The real coefficient of the complex number.I_num: The imaginary coefficient of the complex number.Suffix: The suffix for the imaginary component of the complex number. If omitted, suffix is assumed to be "i". |
CONVERT |
Converts a number from one measurement system to another. |
CONVERT(number,from_unit,to_unit)Number: the value in from_units to convert.From_unit: the units for number.To_unit: the units for the result. |
DEC2BIN |
Converts a decimal number to binary. |
DEC2BIN(number, [places])Number: The decimal integer you want to convert.Places: The number of characters to use. |
DEC2HEX |
Converts a decimal number to hexadecimal. |
DEC2HEX(number, [places])Number: The decimal integer you want to convert.Places: The number of characters to use. |
DEC2OCT |
Converts a decimal number to octal. |
DEC2OCT(number, [places])Number: The decimal integer you want to convert.Places: The number of characters to use. |
ERF |
Returns the error function integrated between lower_limit and upper_limit. |
ERF(lower_limit,[upper_limit])Lower_limit: The lower bound for integrating ERF.Upper_limit: The upper bound for integrating ERF. (Optional) |
ERF.PRECISE |
Returns the error function. |
ERF.PRECISE(x)X: The lower bound for integrating ERF.PRECISE. |
ERFC.PRECISE |
Returns the complementary ERF function integrated between x and infinity. |
ERFC.PRECISE(x)X: The lower bound for integrating ERFC.PRECISE. |
GESTEP |
Returns 1 if number ≥ step; returns 0 (zero) otherwise. |
GESTEP(number, [step])Number: The value to test against step.Step: The threshold value. If you omit a value for step, GESTEP uses zero. (Optional) |
HEX2BIN |
Converts a hexadecimal number to binary. |
HEX2BIN(number, [places])Number: The hexadecimal number you want to convert.Places: The number of characters to use. |
HEX2DEC |
Converts a hexadecimal number to decimal. |
HEX2DEC(number)Number: The hexadecimal number you want to convert. |
HEX2OCT |
Converts a hexadecimal number to octal. |
HEX2OCT(number, [places])Number: The hexadecimal number you want to convert.Places: The number of characters to use. |
IMABS |
Returns the absolute value of a complex number in x + yi or x + yj text format. |
IMABS(inumber)Inumber: A complex number for which you want the absolute value. |
IMAGINARY |
Returns the imaginary coefficient of a complex number in x + yi or x + yj text format. |
IMAGINARY(inumber)Inumber: A complex number for which you want the imaginary coefficient. |
IMARGUMENT |
Returns the argument Theta. |
IMARGUMENT(inumber)Inumber: A complex number for which you want the argument Theta. |
IMCONJUGATE |
Returns the complex conjugate of a complex number in x + yi or x + yj text format. |
IMCONJUGATE(inumber)Inumber: A complex number for which you want the conjugate. |
IMCOS |
Returns the cosine of a complex number in x + yi or x + yj text format. |
IMCOS(inumber)Inumber: A complex number for which you want the cosine. |
IMCOSH |
Returns the hyperbolic cosine of a complex number in x+yi or x+yj text format. |
IMCOSH(inumber)Inumber: A complex number for which you want the hyperbolic cosine. |
IMCOT |
Returns the cotangent of a complex number in x+yi or x+yj text format. |
IMCOT(inumber)Inumber: A complex number for which you want the cotangent. |
IMCSC |
Returns the cosecant of a complex number in x+yi or x+yj text format. |
IMCSC(inumber)Inumber: A complex number for which you want the cosecant. |
IMCSCH |
Returns the hyperbolic cosecant of a complex number in x+yi or x+yj text format. |
IMCSCH(inumber)Inumber: A complex number for which you want the hyperbolic cosecant. |
IMDIV |
Returns the quotient of two complex numbers in x + yi or x + yj text format. |
IMDIV(inumber1, inumber2)Inumber1: The complex numerator or dividend.Inumber2: The complex denominator or divisor. |
IMEXP |
Returns the exponential of a complex number in x + yi or x + yj text format. |
IMEXP(inumber)Inumber: A complex number for which you want the exponential. |
IMLN |
Returns the natural logarithm of a complex number in x + yi or x + yj text format. |
IMLN(inumber)Inumber: A complex number for which you want the natural logarithm. |
IMLOG10 |
Returns the common logarithm (base 10) of a complex number in x + yi or x + yj text format. |
IMLOG10(inumber)Inumber: A complex number for which you want the common logarithm. |
IMLOG2 |
Returns the base-2 logarithm of a complex number in x + yi or x + yj text format. |
IMLOG2(inumber)Inumber: A complex number for which you want the base-2 logarithm. |
IMPOWER |
Returns a complex number in x + yi or x + yj text format raised to a power. |
IMPOWER(inumber, number)Inumber: A complex number you want to raise to a power.Number: The power to which you want to raise the complex number. |
IMPRODUCT |
Returns the product of 1 to 255 complex numbers in x + yi or x + yj text format. |
IMPRODUCT(inumber1, [inumber2], ...) |
IMREAL |
Returns the real coefficient of a complex number in x + yi or x + yj text format. |
IMREAL(inumber)Inumber: A complex number for which you want the real coefficient. |
IMSEC |
Returns the secant of a complex number in x+yi or x+yj text format. |
IMSEC(inumber)Inumber: A complex number for which you want the secant. |
IMSECH |
Returns the hyperbolic secant of a complex number in x+yi or x+yj text format. |
IMSECH(inumber)Inumber: A complex number for which you want the hyperbolic secant. |
IMSIN |
Returns the sine of a complex number in x + yi or x + yj text format. |
IMSIN(inumber)Inumber: A complex number for which you want the sine. |
IMSINH |
Returns the hyperbolic sine of a complex number in x+yi or x+yj text format. |
IMSINH(inumber)Inumber: A complex number for which you want the hyperbolic sine. |
IMSQRT |
Returns the square root of a complex number in x + yi or x + yj text format. |
IMSQRT(inumber)Inumber: A complex number for which you want the square root. |
IMSUB |
Returns the difference of two complex numbers in x + yi or x + yj text format. |
IMSUB(inumber1, inumber2)Inumber1: The complex number from which to subtract inumber2.Inumber2: The complex number to subtract from inumber1. |
IMSUM |
Returns the sum of two or more complex numbers in x + yi or x + yj text format. |
IMSUM(inumber1, [inumber2], ...) |
IMTAN |
Returns the tangent of a complex number in x+yi or x+yj text format. |
IMTAN(inumber)Inumber: A complex number for which you want the tangent. |
OCT2BIN |
Converts an octal number to binary. |
OCT2BIN(number, [places])Number: The octal number you want to convert.Places: The number of characters to use. |
OCT2DEC |
Converts an octal number to decimal. |
OCT2DEC(number)Number: The octal number you want to convert. |
OCT2HEX |
Converts an octal number to hexadecimal. |
OCT2HEX(number, [places])Number: The octal number you want to convert.Places: The number of characters to use. |
Name |
Description |
Syntax |
CUMIPMT |
Returns the cumulative interest paid on a loan between start_period and end_period. |
CUMIPMT(rate, nper, pv, start_period, end_period, type)Rate: The interest rate.Nper: The total number of payment periods.Pv: The present value.Start_period: The first period in the calculation. End_period: The last period in the calculation.Type: The timing of the payment.
Type |
Timing |
0 (zero) |
Payment at the end of the period. |
1 |
Payment at the beginning of the period. |
|
CUMPRINC |
Returns the cumulative principal paid on a loan between start_period and end_period. |
CUMPRINC(rate, nper, pv, start_period, end_period, type)Rate: The interest rate.Nper: The total number of payment periods.Pv: The present value.Start_period: The first period in the calculation. End_period: The last period in the calculation.Type: The timing of the payment.
Type |
Timing |
0 (zero) |
Payment at the end of the period. |
1 |
Payment at the beginning of the period. |
|
DB |
Returns the depreciation of an asset for a specified period using the fixed-declining balance method. |
DB(cost, salvage, life, period, [month])Cost: The initial cost of the asset.Salvage: The value at the end of the depreciation Life: The number of periods over which the asset is being depreciated.Period: The period for which you want to calculate the depreciation. Period must use the same units as life.Month: The number of months in the first year. If month is omitted, it is assumed to be 12. (Optional) |
DDB |
Returns the depreciation of an asset for a specified period using the double-declining balance method or some other method you specify. |
DDB(cost, salvage, life, period, [factor])Cost: The initial cost of the asset.Salvage: The value at the end of the depreciation This value can be 0.Life: The number of periods over which the asset is being depreciated.Period: The period for which you want to calculate the depreciation. Period must use the same units as life.Factor: The rate at which the balance declines. (Optional) |
DISC |
Returns the discount rate for a security. |
DISC(settlement, maturity, pr, redemption, [basis])Settlement: The security's settlement date. Maturity: The security's maturity date. The maturity date is the date when the security expires.Pr: The security's price per $100 face value.Redemption: The security's redemption value per $100 face value.Basis: The type of day count basis to use. (Optional) |
DOLLARDE |
Converts a dollar price expressed as an integer part and a fraction part, such as 1.02, into a dollar price expressed as a decimal number. |
DOLLARDE(fractional_dollar, fraction)Fractional_dollar: A number expressed as an integer part and a fraction part, separated by a decimal symbol.Fraction: The integer to use in the denominator of the fraction. |
DOLLARFR |
Use DOLLARFR to convert decimal numbers to fractional dollar numbers, such as securities prices. |
DOLLARFR(decimal_dollar, fraction)Decimal_dollar: A decimal number.Fraction: The integer to use in the denominator of a fraction. |
DURATION |
Returns the Macaulay duration for an assumed par value of $100. |
DURATION(settlement, maturity, coupon, yield, frequency, [basis])Settlement: The security settlement date is the date after the issue date when the security is traded to the buyer.Maturity: The maturity date is the date when the security expires.Coupon: The security's annual coupon rate.Yield: The security's annual yield.Frequency: The number of coupon payments per year. For annual payments, frequency = 1; for semiannual, frequency = 2; for quarterly, frequency = 4.Basis: The type of day count basis to use. (Optional)
Basis |
Day count basis |
0 or omitted |
US (NASD) 30/360 |
1 |
Actual/actual |
2 |
Actual/360 |
3 |
Actual/365 |
4 |
European 30/360 |
|
FV |
Returns the future value of an investment based on periodic, constant payments and a constant interest rate. |
FV(rate,nper,pmt,[pv],[type])Rate: The interest rate per period.Nper: The total number of payment periods in an annuity.Pmt: The payment made each period.Pv: The present value, or the lump-sum amount that a series of future payments is worth right now. If pv is omitted, it is assumed to be 0. (Optional)Type: The number 0 or 1, which indicates when payments are due. If type is omitted, it is assumed to be 0. (Optional) |
FVSHEDULE |
Returns the future value of an initial principal after applying a series of compound interest rates. |
FVSCHEDULE(principal, schedule)Principal: The present value.Schedule: An array of interest rates to apply. |
INTRATE |
Returns the interest rate for a fully invested security. |
INTRATE(settlement, maturity, investment, redemption, [basis])Settlement: The security settlement date is the date after the issue date when the security is traded to the buyer.Maturity: The maturity date is the date when the security expires.Investment: The amount invested in the security.Redemption: The amount to be received at maturity.Basis: The type of day count basis to use.
Basis |
Day count basis |
0 or omitted |
US (NASD) 30/360 |
1 |
Actual/actual |
2 |
Actual/360 |
3 |
Actual/365 |
4 |
European 30/360 |
|
IPMT |
Returns the interest payment for a given period for an investment based on periodic, constant payments and a constant interest rate. |
IPMT(rate, per, nper, pv, [fv], [type])Rate: The interest rate per period.Per: The period for which you want to find the interest and must be in the range 1 to nper.Nper: The total number of payment periods in an annuity.Pv: The present value, or the lump-sum amount that a series of future payments is worth right now.Fv: The future value or a cash balance you want to attain after the last payment is made. If fv is omitted, it is assumed to be 0 (the future value of a loan, for example, is 0).Type: The number 0 or 1.
Type |
Payment Due |
0 |
At the end of the period. |
1 |
At the beginning of the period. |
|
IRR |
Returns the internal rate of return for a series of cash flows represented by the numbers in values. |
IRR(values, [guess])Values: An array or a reference to cellsGuess: A number that you guess is close to the result of IRR. (Optional) |
ISPMT |
Calculates the interest paid during a specific period of an investment. This function is provided for compatibility with Lotus 1-2-3. |
ISPMT(rate, per, nper, pv)Rate: The interest rate for the investment.Per: The period for which you want to find the interest, and must be between 1 and nper.Nper: The total number of payment periods for the investment.Pv: The present value of the investment. For a loan, pv is the loan amount. |
MIRR |
Returns the modified internal rate of return for a series of periodic cash flows. |
MIRR(values, finance_rate, reinvest_rate)Values: An array or a reference to cells that contain numbers.Finance_rate: The interest rate you pay on the money used in the cash flows.Reinvest_rate: The interest rate you receive on the cash flows as you reinvest them. |
NPER |
Returns the number of periods for an investment based on periodic, constant payments and a constant interest rate. |
NPER(rate,pmt,pv,[fv],[type])Rate : The interest rate per period.Pmt : The payment made each period; Pv : The present value, or the lump-sum amount that a series of future payments is worth right now.Fv : The future value, or a cash balance you want to attain after the last payment is made. (Optional)Type : The number 0 or 1 and indicates when payments are due. (Optional) |
NPV |
Calculates the net present value of an investment by using a discount rate and a series of future payments and income. |
NPV(rate,value1,[value2],...)Rate: The rate of discount over the length of one period. |
PMT |
Calculates the payment for a loan based on constant payments and a constant interest rate. |
PMT(rate, nper, pv, [fv], [type])Rate: The interest rate for the loan.Nper: The total number of payments for the loan.Pv: The present value, or the total amount that a series of future payments is worth now.Fv: The future value, or a cash balance you want to attain after the last payment is made. Type: The number 0 (zero) or 1, it indicates when payments are due. (Optional) |
PPMT |
Returns the payment on the principal for a given period for an investment based on periodic, constant payments and a constant interest rate. |
PPMT(rate, per, nper, pv, [fv], [type])Rate: The interest rate per period.Per: Specifies the period and must be in the range 1 to nper.Nper: The total number of payment periods in an annuity.Pv: The present value — the total amount that a series of future payments is worth now.Fv: The future value, or a cash balance you want to attain after the last payment is made. If fv is omitted, it is assumed to be 0 (zero), that is, the future value of a loan is 0.Type: The number 0 or 1, it indicates when payments are due. (Optional) |
PV |
Returns the present value of an investment. The present value is the total amount that a series of future payments is worth now. |
PV(rate, nper, pmt, [fv], [type])Rate: The interest rate per period. Nper: The total number of payment periods in an annuity. Pmt: The payment made each period and cannot change over the life of the annuity. Fv: The future value, or a cash balance you want to attain after the last payment is made.Type: The number 0 or 1, it indicates when payments are due. (Optional) |
RATE |
Returns the interest rate per period of an annuity. |
RATE(nper, pmt, pv, [fv], [type], [guess])Nper: The total number of payment periods in an annuity.Pmt: The payment made each period and cannot change over the life of the annuity. Pv: The present value — the total amount that a series of future payments is worth now.Fv: The future value, or a cash balance you want to attain after the last payment is made. Type: The number 0 or 1 and indicates when payments are due. (Optional)
Type |
Payment Due |
0 or omitted |
At the end of the period. |
1 |
At the beginning of the period. |
Guess: Your guess for what the rate will be. (Optional)
|
RRI |
Returns an equivalent interest rate for the growth of an investment. |
RRI(nper, pv, fv)Nper: Nper is the number of periods for the investment.Pv: Pv is the present value of the investment.Fv: Fv is the future value of the investment. |
SLN |
Returns the straight-line depreciation of an asset for one period. |
SLN(cost, salvage, life)Cost: The initial cost of the asset.Salvage: The value at the end of the depreciation.Life: The number of periods over which the asset is depreciated. |
SYD |
Returns the sum-of-years' digits depreciation of an asset for a specified period. |
SYD(cost, salvage, life, per)Cost: The initial cost of the asset.Salvage: The value at the end of the depreciation.Life: The number of periods over which the asset has depreciated.Per: The period, it must use the same units as life. |
VDB |
Returns the depreciation of an asset for any specified period, including partial periods. |
VDB(cost, salvage, life, start_period, end_period, [factor], [no_switch])Cost: The initial cost of the asset.Salvage: The value at the end of the depreciation This value can be 0.Life: The number of periods over which the asset is depreciated.Start_period: The starting period for which you want to calculate the depreciation.End_period: The ending period for which you want to calculate the depreciation. Factor: The rate at which the balance declines. (Optional) No_switch: A logical value specifying whether to switch to straight-line depreciation when depreciation is greater than the declining balance calculation. (Optional) |
XIRR |
Returns the internal rate of return for a schedule of cash flows that is not necessarily periodic. |
XIRR(values, dates, [guess])Values: A series of cash flows that corresponds to a schedule of payments in dates. Dates: A schedule of payment dates that corresponds to the cash flow paymentsGuess: A number that you guess is close to the result of XIRR. (Optional) |
Name |
Description |
Syntax |
CODE |
Returns a numeric code for the first character in a text string. |
CODE(text)Text: The text for which you want the code of the first character. |
CONCATENATE |
The CONCATENATE function joins up to 255 text strings into one text string. |
CONCATENATE(text1, [text2], ...)Text1: The first text item to be concatenated.Text2: Additional text items, up to a maximum of 255 items. |
DOLLAR |
The function described in this Help topic converts a number to text format and applies a currency symbol. |
DOLLAR(number, [decimals])Number: A number, a reference to a cell containing a number, or a formula that evaluates to a number.Decimals: The number of digits to the right of the decimal point. (Optional) |
FINDB |
FINDB counts each double-byte character as 2 when editing of a language that supports DBCS is enabled and has been set as the default language. |
FINDB(find_text, within_text, [start_num])Find_text: The text you want to find.Within_text: The text containing the text you want to find.Start_num: Specifies the character at which to start the search. (Optional) |
FIXED |
Rounds a number to the specified number of decimals, formats the number in decimal format using a period and commas, and returns the result as text. |
FIXED(number, [decimals], [no_commas])Number: The number you want to round and convert to text.Decimals: The number of digits to the right of the decimal point.No_commas: A logical value that, if TRUE, prevents FIXED from including commas in the returned text. (Optional) |
JIS |
Converts half-width (single-byte) letters within a character string to full-width (double-byte) characters. |
JIS(Text)Text: The text or a reference to a cell that contains the text you want to change. |
LEFT |
LEFT returns the first character or characters in a text string, based on the number of characters you specify. |
LEFT(text, [num_chars]) |
LEFTB |
LEFTB returns the first character or characters in a text string, based on the number of bytes you specify. |
LEFTB(text, [num_bytes])Text: The text string that contains the characters you want to extract.Num_chars: Specifies the number of characters you want LEFT to extract. (Optional)Num_bytes: Specifies the number of characters you want LEFTB to extract, based on bytes. (Optional) |
LEN |
LEN returns the number of characters in a text string. |
LEN(text)Text: The text whose length you want to find. Spaces count as characters. |
LENB |
LENB returns the number of bytes used to represent the characters in a text string. |
LENB(text)Text: The text whose length you want to find. Spaces count as characters. |
LOWER |
Converts all uppercase letters in a text string to lowercase. |
LOWER(text)Text: The text you want to convert to lowercase. |
MID |
MID returns a specific number of characters from a text string, starting at the position you specify, based on the number of characters you specify. |
MID(text, start_num, num_chars)Text: The text string containing the characters you want to extract.Start_num: The position of the first character you want to extract in text. The first character in text has start_num 1, and so on.Num_chars: Specifies the number of characters you want MID to return from text.Num_bytes: Specifies the number of characters you want MIDB to return from text, in bytes. |
MIDB |
MIDB returns a specific number of characters from a text string, starting at the position you specify, based on the number of bytes you specify. |
MIDB(text, start_num, num_chars)Text: The text string containing the characters you want to extract.Start_num: The position of the first character you want to extract in text. The first character in text has start_num 1, and so on.Num_chars: Specifies the number of characters you want MID to return from text.Num_bytes: Specifies the number of characters you want MIDB to return from text, in bytes. |
NUMBERVALUE |
Converts text to a number, in a locale-independent way. |
NUMBERVALUE(Text,[Decimal_separator], [Group_separator ])Text: The text to convert to a number.Decimal_separator: The character used to separate the integer and fractional part of the result.Group_separator : The character used to separate groupings of numbers, such as thousands from hundreds and millions from thousands. |
PROPER |
Capitalizes the first letter in a text string and any other letters in that string that follow non-letter characters. |
PROPER(text)Text: Text enclosed in quotation marks, a formula that returns text, or a reference to a cell containing the text you want to partially capitalize. |
REPLACE |
Replaces part of a text string, based on the number of characters you specify, with a different text string. |
REPLACE(old_text, start_num, num_chars, new_text)Old_text: Text in which you want to replace some characters.Start_num: The position of the character in old_text that you want to replace with new_text.Num_chars: The number of characters in old_text for REPLACE to replace with new_text.Num_bytes: The number of bytes in old_text for REPLACEB to replace with new_text.New_text: The text that will replace characters in old_text. |
REPT |
Repeats text a given number of times. |
REPT(text, number_times)Text: The text you want to repeat.Number_times: A positive number specifying the number of times to repeat text. |
RIGHT |
RIGHT returns the last character or characters in a text string, based on the specified number of characters. |
RIGHT(text,[num_chars])Text: The text string containing the characters you want to extract.Num_chars: Specifies the number of characters you want RIGHT to extract. (Optional) |
RIGHTB |
RIGHTB returns the last character or characters in a text string, based on the number of bytes specified. |
RIGHTB(text,[num_bytes])Text: The text string containing the characters you want to extract.Num_bytes: Specifies the number of characters you want RIGHTB to extract, based on bytes. (Optional) |
SEARCHB |
Locates one text string within a second text string, and returns the number of the starting position of the first text string from the first character of the second text string. |
SEARCHB(find_text,within_text,[start_num])find_text: The text that you want to find.within_text: The text in which you want to search for the value of the find_text argument.start_num: The character number in the within_text argument at which you want to start searching. |
SUBSTITUTE |
Substitutes new_text for old_text in a text string. |
SUBSTITUTE(text, old_text, new_text, [instance_num])Text: The text or the reference to a cell containing text for which you want to substitute characters.Old_text: The text you want to replace.New_text: The text you want to replace old_text with.Instance_num: Specifies which occurrence of old_text you want to replace with new_text. (Optional) |
T |
Returns the text referred to by value. |
T(value)Value: The value you want to test. |
TEXT |
The TEXT function converts a numeric value to text and lets you specify the display formatting by using special format strings. |
TEXT(value, format_text)value: A numeric value, a formula that evaluates to a numeric value, or a reference to a cell containing a numeric value.format_text: A numeric format as a text string enclosed in quotation marks. |
TRIM |
Removes all spaces from text except for single spaces between words. |
TRIM(text)Text: The text from which you want spaces removed. |
UNICHAR |
Returns the Unicode character that is referenced by the given numeric value. |
UNICHAR(number)Number is the Unicode number that represents the character. |
UNICODE |
Returns the number (code point) corresponding to the first character of the text. |
UNICODE(text)Text: Text is the character for which you want the Unicode value. |
UPPER |
Converts text to uppercase. |
UPPER(text)Text: The text you want converted to uppercase. |
VALUE |
Converts a text string that represents a number to a number. |
VALUE(text)Text: The text enclosed in quotation marks or a reference to a cell containing the text you want to convert. |