MINIMUM( ) function

Returns the minimum value in a set of numeric values, or the oldest value in a set of datetime values.

Syntax

MINIMUM(value_1, value_2 <,...n>)

Parameters

Name Type Description
value_1, value_2<, ...n>

numeric

datetime

The values to compare, separated by commas.

All values must be of the same data type.

Additionally, datetime values must be of the same subtype. You cannot mix date, datetime, or time values in a single execution of the function.

Output

Numeric or Datetime.

Examples

Basic examples

Literal numeric input

Returns 4:

MINIMUM(4, 7)

Returns 3:

MINIMUM(4, 7, 3, 8)

Returns 3.00:

MINIMUM(4, 7.25, 3, 8)

Literal datetime input

Returns `20161229`:

MINIMUM(`20161231`, `20161229`, `20161230`)

Returns `20161229 23:59:59`:

MINIMUM(`20161231 235959`, `20161229 235959`)

Returns `23:59:57`:

MINIMUM(`.235957`, `.235959`, `.235958`)

Field input

Returns the oldest date among the three fields for each record:

MINIMUM(PO_Date, Invoice_Date, Payment_Date)

Advanced examples

Identifying the lowest value among multiple fields

Create a computed field to identify the lowest value among the Cost, Sale_Price, and Discount_Price fields:

DEFINE FIELD Low_Value COMPUTED MINIMUM(Cost, Sale_Price, Discount_Price)

Discovering dates before the beginning of a quarter

To discover if any dates across multiple fields are before the beginning of a quarter, create a computed field with an expression like the one below:

DEFINE FIELD Pre_Qtr COMPUTED MINIMUM(PO_Date, Invoice_Date, Payment_Date, `20160101`)
  • Records with all dates on or after 01 Jan 2016 return `20160101`.
  • Records with one or more dates before 01 Jan 2016 return the oldest date among the three fields.

Remarks

How decimal places work in sets of numeric values

If the numeric values being compared do not have the same number of decimal places, the result is adjusted to the largest number of decimal places.

Returns 3.600:

MINIMUM(3.6,10.88, 20.482)

You can use the DECIMALS( ) function to adjust the number of decimals for value parameters.

Returns 3.60:

MINIMUM(3.6,10.88, DECIMALS(20.482, 2))

The MIN( ) abbreviation

In ACLScript, you can use the abbreviation MIN( ) for the MINIMUM( ) function even though it does not uniquely identify the function, which is the normal requirement when abbreviating function names.

MIN( ) could also be an abbreviation for MINUTE( ), however Analytics reserves the abbreviation MIN( ) for the MINIMUM( ) function.

ACL Scripting Guide 14.1