Outdated Version
You are viewing an older version of this section. View current production version.
LEAST
Returns the lowest value observed in its arguments. “Lowest” is determined by the collation rules of the data passed in.
Info
This function is not to be confused with MIN, which is an aggregate function returning the lowest value in all rows in an aggregation.
Syntax
LEAST ( expression, expression [, expression ...] )
Arguments
- expression: any number of expressions. This may be a column name, the result of another function, or a math operation.
Return Type
The lowest value, in the type of the input.
For example, if all arguments are integers, they are compared as integers. If one argument is a decimal type, they are compared as decimal types. If arguments are a mix of strings and numbers, they are compared as numbers. If an argument is a nonbinary string, the arguments are compared as nonbinary strings.
Examples
select least(1, 2, 3);
+----------------+
| least(1, 2, 3) |
+----------------+
| 1 |
+----------------+
select least ('a', 'b', '_', '9', 'c');
+---------------------------------+
| least ('a', 'b', '_', '9', 'c') |
+---------------------------------+
| 9 |
+---------------------------------+
