OPENINGBALANCEYEAR 関数

現在のコンテキストにおける年の最初の日付で expression を評価します。

構文

OPENINGBALANCEYEAR(<expression>,<dates>[,<filter>][,<year_end_date>])

パラメーター

パラメーター

定義

expression

スカラー値を返す式。

dates

日付を格納する列。

filter

(省略可能) 現在のコンテキストに適用されるフィルターを指定する式。

year_end_date

(省略可能) 年の最終日を定義する日付を表すリテラル文字列。 既定値は 12 月 31 日です。

戻り値

現在のコンテキストにおける年の最初の日付で評価された expression を表すスカラー値。

説明

注意

コンテキストが数式の結果に与える影響の詳細については、「DAX の数式のコンテキスト」を参照してください。

dates 引数には、次のいずれかを指定できます。

  • 日付/時刻列への参照。

  • 日付/時刻値の単一列を返すテーブル式。

  • 日付/時刻値の単一列テーブルを定義するブール式。

注意

ブール式の制約の詳細については、「CALCULATE 関数」を参照してください。

注意

filter 式の制約の詳細については、「CALCULATE 関数」を参照してください。

year_end_date パラメーターは、ブックが作成されたクライアントと同じロケールの、日付の文字列リテラルです。 日付の年の部分は無視されます。

この DAX 関数は DirectQuery モードでは使用できません。 DirectQuery モデルの制限の詳細については、https://go.microsoft.com/fwlink/?LinkId=219172 を参照してください。

使用例

次の例は、製品在庫の "年初の在庫金額" を計算するメジャーを作成する数式です。

この数式の動作を確認するには、ピボットテーブルを作成し、ピボットテーブルの [行ラベル] 領域に CalendarYear フィールドを追加します。 次に、コード例で定義されている数式を使用して、ピボットテーブルの [値] 領域に Year Start Inventory Value という名前のメジャーを追加します。

コード

=OPENINGBALANCEYEAR(SUMX(ProductInventory,ProductInventory[UnitCost]*ProductInventory[UnitsBalance]),DateTime[DateKey])

関連項目

参照

OPENINGBALANCEQUARTER 関数

OPENINGBALANCEMONTH 関数

CLOSINGBALANCEYEAR 関数

その他の技術情報

タイム インテリジェンス関数 (DAX)

サンプル データの入手