@RANGEFIRSTVAL

最初の関数パラメータで指定された基準を満たす、指定されたmbrListの範囲内の最初の値を戻します。

構文

@RANGEFIRSTVAL(SKIPNONE | SKIPMISSING | SKIPZERO | SKIPBOTH, mbrList)

パラメータ

SKIPNONE: すべてのセル値はデータとみなされます。
SKIPMISSING: #MISSING値はデータとみなされません。
SKIPZERO: ゼロ(0)値はデータとみなされません。
SKIPBOTH: ゼロ(0)および#MISSING値はデータとみなされません。
mbrList: 有効なメンバー名、メンバー名のカンマ区切りリスト、ディメンション間メンバー、または同じディメンションのメンバーのリストを戻すメンバー・セット関数。 range演算子または関数を使用する場合、mbrListの順序はデータベース・アウトラインの順序によって決まります。

ノート

この関数は、最初の引数で指定された基準に一致する値がmbrListに含まれていない場合に#MISSINGを返します。

例

例 1

次の例では、Sample.Basicデータベースを使用します。

@RANGEFIRSTVAL(SKIPMISSING, @CHILDREN("Qtr1"));

または

@RANGEFIRSTVAL(SKIPMISSING, "Jan":"Mar");

または

@RANGEFIRSTVAL(SKIPMISSING, ("Jan","Feb","Mar"))

前述の文は、メンバーJan、FebおよびMarの値を順番に検索するときに見つかった最初の#MISSING以外の値を戻します。

例 2

@RANGEFIRSTVAL(SKIPZERO, @CHILDREN("Jan"));

メンバーJanには子がないため、#MISSINGを戻します。

例 3

@RANGEFIRSTVAL(SKIPBOTH, @CHILDREN("Qtr1"));

アウトライン順序を使用して、Qtr1から#MISSING以外の最初の値およびゼロ以外のActual値を返します。すべての月にデータがあるため、Janの値が返されます。

例 4

@RANGEFIRSTVAL (SKIPBOTH, (Actual->Feb, Actual->Mar, Actual->Jan ))

mbrListで指定された順序を使用して、指定された月のリストから最初の非#MISSINGおよび非ゼロのActual値を返します。すべての月にデータがあるため、Febの値が返されます。