The following table lists the available operators. For each operator, an example is given of the syntax of using a literal value as well as a cell reference. The type of value returned is given for each type of operator.
| Type of Operator | Example Syntax | Result | ||
|---|---|---|---|---|
| Operator | Description | Literal & Literal | Cell Ref & Literal | Type Returned |
| Binary Operators | ||||
| + | Add | 5 + 3 | A1 + 3 | double |
| – | Subtract | 5 – 3 | A1 – 3 | double |
| * | Multiply | 5 * 3 | A1 * 3 | double |
| / | Divide | 5 / 3 | A1 / 3 | double |
| ^ | Exponent | 5 ^ 3 | A1 ^ 3 | double |
| & | Concatenate | "F" & "p" | A1 & "p" | string |
| = | Equal | A1 <> 3 | boolean | |
| < > | Not Equal | A1 = 3 | boolean | |
| < | Less Than | A1 <3 | boolean | |
| > | Greater Than | A1 > 3 | boolean | |
| <= | Less Than Or Equal | A1 <= 3 | boolean | |
| >= | Greater Than Or Equal | A1 >= 3 | boolean | |
| Unary Operators | ||||
| - | Negate | -(5/3) | -(A1/3) | double |
| + | Plus | +(5/3) | +(A1/3) | double |
| % | Percent | (5/3)% | (A1/3)% | double |
Operators specify the type of calculation that you want to perform on the elements of a formula. Most of the operators return double-precision floating point values for mathematical operations and boolean (or logical) values for comparison operators.
In SpreadJS, all arithmetic operators (including the unary +) check their arguments and return a #VALUE error if any of the arguments are strings that cannot be converted to a number. This is mathematically correct behavior and cannot be overridden. For example, the three formulas +B5 and 0+B5 and --B5 should all produce the same result and, in SpreadJS, they do.
For more information about operators, see Order of Precedence and Operators with Dates and Times.