mirror of https://github.com/nocodb/nocodb
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
8.0 KiB
8.0 KiB
| title | description | position | category | menuTitle |
|---|---|---|---|---|
| Formulas | Formulas | 43 | Usage | Formulas |
Adding formula column
1. Click on '+' (Add column)
2. Populate column Name
3. Select column Type as 'Formula'
4. Insert required formula
- Can use column names in equation
- Can use explicit numberical values/ strings as needed
- Table below lists supported formula & associated syntax
- Nested formula (formula equation referring to another formula column) are not supported
5. Click on 'Save'
Available Formula Features
Functions
| Name | Syntax | Sample | Output | Minimum arguments |
|---|---|---|---|---|
| AVG | AVG(value1, [value2,...]) |
AVG(Column1, Column1) |
Average of input parameters | 1 |
| ADD | ADD(value1, [value2,...]) |
ADD(Column1, Column1) |
Sum of input parameters | 1 |
| CONCAT | CONCAT(value1, [value2,...]) |
CONCAT(FirstName, ' ', LastName) |
Concatenated string of input parameters | 2 |
| TRIM | TRIM(value) |
TRIM(Title) |
Removes trailing and leading whitespaces from input parameter | 1 |
| UPPER | UPPER(value) |
UPPER(Title) |
Upper case converted string of input parameter | 1 |
| LOWER | LOWER(value) |
LOWER(Title) |
Lower case converted string of input parameter | 1 |
| LEN | LEN(value) |
LEN(Title) |
Input parameter charachter length | 1 |
| MIN | MIN(value1, [value2,...]) |
MIN(Column1, Column2, Column3) |
Minimum value amongst input parameters | 1 |
| MAX | MAX(value1, [value2,...]) |
MAX(Column1, Column2, Column3) |
Maximum value amongst input parameters | 1 |
| CEILING | CEILING(value) |
CEILING(Column) |
Rounded next largest integer value of input parameter | 1 |
| FLOOR | FLOOR(value) |
FLOOR(Column) |
Rounded largest integer less than or equal to input parameter | 1 |
| ROUND | ROUND(value) |
ROUND(Column) |
Nearest integer to the input parameter | 1 |
| MOD | MOD(value1, value2) |
MOD(Column, 2) |
Remainder after integer division of input parameters | 2 |
| REPEAT | REPEAT(value1, count) |
REPEAT(Column, 2) |
Specified copies of the input parameter string concatenated together | 2 |
| LOG | LOG(value1, [base]) |
LOG(Column) |
Logarithm of input parameter to the base specified | 1 |
| EXP | EXP(value) |
EXP(Column) |
Exponential value of input parameter (e^x) |
1 |
| POWER | POWER(base, exponent) |
POWER(Column, 3) |
base to the exponent power, as in base^exponent |
2 |
| SQRT | SQRT(value) |
SQRT(Column) |
Square root of the input parameter | 1 |
| ABS | ABS(value) |
ABS(Column) |
Absolute value of the input parameter | 1 |
| NOW | NOW() |
NOW() |
Current date time | 0 |
| REPLACE | REPLACE(value, old_str,new_str) |
REPLACE(Column, old_string, new_String) |
String, after replacing all occurrences of old_string with new_String |
3 |
| SEARCH | SEARCH(value, search_val) |
SEARCH(Column, 'str') |
Index of sub-string specified if found, 0 otherwise | 2 |
| INT | INT(value) |
INT(Column) |
Integer value of input parameter | 1 |
| RIGHT | RIGHT(value, count) |
RIGHT(Column, 3) |
n characters from the end of input parameter |
2 |
| LEFT | LEFT(value1, [value2,...]) |
LEFT(Column, 3) |
n characters from the beginning of input parameter |
2 |
| SUBSTR | SUBTR(value, position, [count]) |
SUBSTR(Column, 3, 2) |
Substring of length 'count' of input string, from the postition specified | 3 |
| MID | SUBTR(value, position, [count]) |
MID(Column, 3, 2) |
Alias for SUBSTR |
3 |
| IF | IF(expression, success_case, [else_case]) |
IF(Column > 1, Value1, Value2) |
success_case if expression evaluates to TRUE, else_case otherwise | 2 |
| SWITCH | SWITCH(expression, [pattern,value,..., default_value]) |
SWITCH(Column1, 1, 'One', 2, 'Two', '--') |
Switch case value based on expression output | 3 |
| AND | AND(expression1, [expression2,...]) |
AND(Column > 2, Column < 10) |
TRUE if all expressions evaluate to TRUE | 1 |
| OR | OR(expression1, [expression2,...]) |
OR(Column > 2, Column < 10) |
TRUE if at least one expression evaluates to TRUE | 1 |
Numeric Operators
| Operator | Sample | Description |
|---|---|---|
+ |
column1 + column2 + 2 |
Addition of numeric values |
- |
column1 - column2 |
Subtraction of numeric values |
* |
column1 * column2 |
Multiplication of numeric values |
- |
column1 / column2 |
Division of numeric values |
Logical operators
| Operator | Sample | Description |
|---|---|---|
< |
column1 < column2 |
Less than |
> |
column1 > column2 |
Greater than |
<= |
column1 <= column2 |
Less than or equal to |
>= |
column1 >= column2 |
Greater than or equal to |
== |
column1 == column2 |
Equal to |
!= |
column1 != column2 |
Not equal to |