MINIMUM( ) 関数
一連の数値中の最小値、または一連の日付時刻値中の最も古い値を返します。
構文
MINIMUM(値1, 値2 <,...n>)
パラメーター
| 名前 | 種類 | 説明 |
|---|---|---|
| 値1、値2<, ...n> |
数値 日付時刻 |
カンマによって区切られた、比較し合う値。 すべての値は同じデータ型である必要があります。 また、日付時刻値は同じサブタイプである必要があります。この関数の 1 回の実行において、日付値、日付時刻値、時刻値を混在させることはできません。 |
出力
数値または日付時刻。
例
基本的な例
リテラル数値の入力値
4 が返されます。
MINIMUM(4, 7)
3 が返されます。
MINIMUM(4, 7, 3, 8)
3.00 が返されます。
MINIMUM(4, 7.25, 3, 8)
リテラル日付時刻の入力値
`20161229` が返されます。
MINIMUM(`20161231`, `20161229`, `20161230`)
`20161229 23:59:59` が返されます。
MINIMUM(`20161231 235959`, `20161229 235959`)
`23:59:57` が返されます。
MINIMUM(`.235957`, `.235959`, `.235958`)
フィールドへの入力値
各レコードについて、次の 3 つのフィールドのうち、最も古い日付が返されます。
MINIMUM(PO_Date, Invoice_Date, Payment_Date)
高度な例
複数のフィールドの値のうち、最も低い値を識別する
"Cost"（費用）、"Sale_Price（販売価格）、"Discount_Price"（割引価格）フィールドの値のうち、最も低い値を識別するには、次の式を使用した演算フィールドを作成します。
DEFINE FIELD Low_Value COMPUTED MINIMUM(Cost, Sale_Price, Discount_Price)
四半期の開始日より前の日付を検出する
複数のフィールドにまたがる日付が四半期の開始日より前であるかどうかを判断するには、下記のような式を使用した演算フィールドを作成します。
DEFINE FIELD Pre_Qtr COMPUTED MINIMUM(PO_Date, Invoice_Date, Payment_Date, `20160101`)
- 2016 年 1 月 1 日以後の日付が含まれるレコードに対し、`20160101` が返されます。
- 2016 年 1 月 1 日より前の日付が含まれるレコードに対しては、上記 3 つのフィールドのうち、最も古い日付が返されます。
備考
数値の比較における小数点以下の桁数の動作
比較し合う数値の小数点以下の桁数が異なる場合、比較結果は最も大きい小数点以下の桁数に合わせて調整されます。
次の例では 3.600 が返されます。
MINIMUM(3.6,10.88, 20.482)
DECIMALS( ) 関数を使用して、値パラメーターの小数点以下の桁数を調整することができます。
次の例では 3.60 が返されます。
MINIMUM(3.6,10.88, DECIMALS(20.482, 2))
省略形 MIN( )
ACLScript では、省略形の MIN は関数を一意に識別しないにもかかわらず、MINIMUM( ) 関数の省略形として使用することができます。これは、関数名を省略するときの規定の要件です。
MIN() は MINUTE( ) の省略形である可能性も考えられますが、Analytics では、省略形 MIN() を MINIMUM( ) 関数のために取ってあります。
ACL のスクリプト作成ガイド 14.1