LEAST

SyntaxSyntax

LEAST( value_1, value_2, value_3 [ , ... ] )

DescriptionDescription

Returns the smallest value.

See also GREATEST.

Depending on the specified data type, it returns:

• The smallest number.
• The first string in alphabetical order.
• The earliest date.
• FALSE when selecting between TRUE and FALSE for Boolean type.

Argument types:

• value_1 — Boolean | Date | Datetime | Fractional number | Integer | String
• value_2 — Boolean | Date | Datetime | Fractional number | Integer | String
• value_3 — Boolean | Date | Datetime | Fractional number | Integer | String

Return type: Same type as (value_1, value_2, value_3)

ExamplesExamples

LEAST(3.4, 2.6) = 2.6

LEAST("3.4", "2.6") = "2.6"

LEAST(#2019-01-02#, #2019-01-17#) = #2019-01-02#

LEAST(#2019-01-02 04:03:02#, #2019-01-17 03:02:01#) = #2019-01-02 04:03:02#

LEAST(TRUE, FALSE) = FALSE

LEAST(34, 5, 7, 3, 99, 1, 2, 2, 56) = 1

LEAST(5.6, 1.2, 7.8, 3.4) = 1.2

LEAST(#2019-01-02#, #2019-01-17#, #2019-01-10#) = #2019-01-02#

Data source supportData source support

ClickHouse 21.8, Files, Google Sheets, Microsoft SQL Server 2017 (14.0), MySQL 5.7, Oracle Database 12c (12.1), PostgreSQL 9.3, Yandex Documents, YDB.