LEAST

Описание

Сравнивает несколько выражений и возвращает наименьшее из их значений. Если хотя бы один аргумент равен NULL, возвращает NULL.

Синтаксис

LEAST(<expr> [, ...])

Параметры

Обязательный параметр

• <expr>: Поддерживает типы TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, STRING, DATETIME и DECIMAL.

Необязательные параметры

• Поддерживается несколько аргументов.

Возвращаемое значение

• Возвращает наименьшее из значений заданных выражений.
• Если хотя бы один аргумент равен NULL, возвращает NULL.

Примечания по использованию

1. Рекомендуется передавать аргументы одного типа. Если типы аргументов различаются, функция попытается привести их к одному типу. Правила преобразования см. в разделе Преобразование типов
2. Если хотя бы один аргумент равен NULL, результат будет NULL.

Примеры

1. Пример 1

   SELECT LEAST(-1, 0, 5, 8);

   +--------------------+
   | LEAST(-1, 0, 5, 8) |
   +--------------------+
   |                 -1 |
   +--------------------+
2. Аргумент NULL

   SELECT LEAST(-1, 0, 5, NULL);

   +-----------------------+
   | LEAST(-1, 0, 5, NULL) |
   +-----------------------+
   |                  NULL |
   +-----------------------+
3. Преобразование типов

   SELECT LEAST(6, 9.29, 7);

   +-------------------+
   | LEAST(6, 9.29, 7) |
   +-------------------+
   |              6.00 |
   +-------------------+

   Первый аргумент "6" преобразуется в тип Decimal.

4. Тип даты

   SELECT LEAST('2022-02-26 20:02:11', '2020-01-23 20:02:11', '2020-06-22 20:02:11');

   +----------------------------------------------------------------------------+
   | LEAST('2022-02-26 20:02:11', '2020-01-23 20:02:11', '2020-06-22 20:02:11') |
   +----------------------------------------------------------------------------+
   | 2020-01-23 20:02:11                                                        |
   +----------------------------------------------------------------------------+