LEAST

Syntax

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

Description

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_1Boolean | Date | Datetime | Fractional number | Integer | String
  • value_2Boolean | Date | Datetime | Fractional number | Integer | String
  • value_3Boolean | Date | Datetime | Fractional number | Integer | String

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

Note

Arguments (value_1, value_2, value_3) must be of the same type.

Examples

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 support

ClickHouse 19.13, Microsoft SQL Server 2017 (14.0), MySQL 5.6, PostgreSQL 9.3.

Previous
Next