La fonction LEAST compare un ensemble de valeurs et renvoie la plus petite.
Syntaxe
least(<var1>, <var2>[,...])
Paramètres
var : Obligatoire. Valeur d'entrée de type BIGINT, DOUBLE, DECIMAL, DATETIME, DATE ou STRING.
Valeur de retour
Renvoie la plus petite valeur parmi les paramètres d'entrée.
Si tous les paramètres d'entrée sont du même type, la valeur de retour est de ce même type.
-
Si les paramètres d'entrée sont de types différents, une conversion implicite s'applique selon les règles suivantes :
Les valeurs de types DOUBLE, BIGINT et STRING sont converties en DOUBLE.
Les valeurs de types DECIMAL, DOUBLE, BIGINT et STRING sont converties en DECIMAL.
-
Les valeurs de types STRING et DATETIME sont converties en DATETIME.
RemarqueSi une valeur STRING respecte le format
yyyy-mm-dd hh:mi:sset que l'édition des types de données de votre projet MaxCompute est définie sur 1.0, la valeur est implicitement convertie en DATETIME. Pour configurer l'édition des types de données, consultez la rubrique Édition du type de données 1.0.
NULL est considéré comme la valeur minimale. Si tous les paramètres d'entrée sont NULL, la fonction renvoie NULL.
Exemples
-- Returns 2.
SELECT least(5, 2, 7);
-- Returns 1.1111.
SELECT least(3,2.5,'1.1111');
-- Returns 12345678901234567890.123456789012345679.
SELECT least(12345678901234567890.12345678901234567890,12345678901234567890.523456789012345679BD);
-- Returns 2025-07-01 12:00:00.
set odps.sql.type.system.odps2=false;
SELECT LEAST(datetime'2025-07-01 12:00:00', '2025-07-02 12:00:00') AS result;
-- Returns 2025-02-02.
set odps.sql.type.system.odps2=true;
SELECT LEAST(date'2025-10-01', date'2025-10-03', date'2026-01-01',date'2025-02-02') AS result;
Fonctions associées
LEAST est une fonction mathématique. Pour plus d'informations sur les fonctions de calcul et de conversion de données, consultez la rubrique Fonctions mathématiques.