Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.Opens in a new window

For information on migrating to InterSystems IRISOpens in a new window, see the InterSystems IRIS Migration Guide and Migrating to InterSystems IRIS, both available on the WRC Distributions pageOpens in a new window (login required).


A function that returns the greatest value from a list of values.




Argument Description
expression An expression that resolves to a number or a string. The values of these expressions are compared to each other. An expression can be a field name, a literal, an arithmetic expression, a host variable, or an object reference. You can list up to 140 comma-separated expressions.


GREATEST returns the greatest value from a comma-separated list of expression values. Expressions are evaluated in left-to-right order. If only one expression is provided, GREATEST returns that value. If any expression is NULL, GREATEST returns NULL.

If all of the expression values resolve to canonical numbers, they are compared in numeric order. If a quoted string contains a number in canonical format, it is compared in numeric order. However, if a quoted string contains a number not in canonical format (for example, '00', '0.4', or '+4'), it is compared as a string. String comparisons are performed character-by-character in collation order. Any string value is greater than any numeric value.

The empty string is greater than any numeric value, but less than any other string value.

If the returned value is a number, GREATEST returns it in canonical format (leading and trailing zeros removed, etc.). If the returned value is a string, GREATEST returns it unchanged, including any leading or trailing blanks.

The inverse function of GREATEST is LEAST.

Data Type of Returned Value

If the data types of the expression values are different, the data type returned is the type most compatible with all of the possible return values, the data type with the highest data type precedence. For example, if one expression is an integer and another expression is a fractional number, GREATEST returns a value with data type NUMERIC. This is because NUMERIC is the data type with the highest precedence that is compatible with both.


In the following example, each GREATEST compares three canonical numbers:

SELECT GREATEST(22,2.2,-21) AS HighNum,
       GREATEST('2.2','22','-21') AS HighNumStr
Copy code to clipboard

In the following example, each GREATEST compare three numeric strings. However, each GREATEST contains one string that is non-canonical; these non-canonical values are compared as character strings. A character string is always greater than a number:

SELECT GREATEST('22','+2.2','-21'),
Copy code to clipboard

In the following example, each GREATEST compare three strings and returns the value with the highest collation sequence:

Copy code to clipboard

The following example compares two dates, treated as canonical numbers: the date of birth as a $HOROLOG integer, and the integer 58073 converted to a date. It returns the date of birth for each person born in the 21st century. Anyone born before January 1, 2000 is displayed with the default birth date of December 31, 1999:

SELECT Name,GREATEST(DOB,TO_DATE(58073)) AS NewMillenium
FROM Sample.Person
Copy code to clipboard

See Also

FeedbackOpens in a new window