DATESYTD

適用対象:計算列計算テーブルメジャービジュアル計算

Note

この関数は、意味のない結果を返す可能性があるため、ビジュアル計算で使用することはお勧めしません。

現在のコンテキストで、現在までの年の日付の列を含むテーブルを返します。

構文

DATESYTD(<dates> [,<year_end_date>])  

パラメーター

用語 定義
日付 日付を含む列。
year_end_date (省略可能) 年度末の日付を定義する日付を含むリテラル文字列。 既定値は 12 月 31 日です。

戻り値

日付値の単一列を含むテーブル。

解説

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

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

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

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

    注意

    ブール式に対する制約については、CALCULATE 関数に関するトピックで説明されています。

  • year_end_date パラメーターは日付の文字列リテラルで、ロケールはブックが作成されたクライアントのロケールと同じです。 日付の年の部分は無視されます。 ロケールによっては、"m-dd" や "dd-m" のような形式になる場合があります。

  • この関数は、計算列または行レベルのセキュリティ (RLS) ルールで使用される場合、DirectQuery モードでの使用はサポートされません。

次の数式例では、インターネット販売の "累計" を計算するメジャーを作成します。

= CALCULATE(SUM(InternetSales_USD[SalesAmount_USD]), DATESYTD(DateTime[DateKey]))  

次のサンプル数式では、Date 形式に米国ロケールを使用して、インターネット販売の "会計年度累計" を計算するメジャーを作成します。

= CALCULATE(
    SUM(InternetSales_USD[SalesAmount_USD]), 
    DATESYTD(DateTime[DateKey],
        "6-30"
        )
)

タイム インテリジェンス関数
日付と時刻関数
DATESMTD 関数
DATESQTD 関数