手記
この関数は、意味のない結果を返す可能性があるため、視覚的な計算
日付列入力の場合、指定した日付列の現在のコンテキストの最初の日付を返します。
カレンダー入力の場合は、カレンダーに基づいて現在のコンテキストの最初の日付を返します。
構文
FIRSTDATE(<dates> or <calendar>)
パラメーター
| 用語 | 定義 |
|---|---|
dates or calendar |
日付またはカレンダー参照を含む列 |
戻り値
日付列入力の場合、1 つの列と日付値を持つ 1 つの行を含むテーブル。
カレンダー入力の場合、すべての主要なタグ付け列とすべての時間関連列を含むテーブル。
備考
dates引数には、次のいずれかを指定できます。- 日付/時刻列への参照。
- 日付/時刻値の単一列を返すテーブル式。
- 日付/時刻値の単一列テーブルを定義するブール式。
ブール式に対する制約については、関数
トピックで説明します。 現在のコンテキストが 1 つの日付の場合、FIRSTDATE 関数と LASTDATE 関数によって返される日付は等しくなります。
日付列の入力の場合、戻り値は 1 つの列と 1 つの値を含むテーブルです。 したがって、この関数は、その引数にテーブルを必要とする任意の関数の引数として使用できます。 また、返される値は、日付値が必要な場合はいつでも使用できます。
この関数は、計算列または行レベル セキュリティ (RLS) 規則で使用する場合、DirectQuery モードでは使用できません。
例
次のサンプル式では、現在のコンテキストのインターネット販売チャネルで販売が行われた最初の日付を取得するメジャーを作成します。
= FIRSTDATE('InternetSales_USD'[SaleDateKey])
カレンダー ベースのタイム インテリジェンスの例
次のサンプル式では、現在のコンテキストのインターネット販売チャネルで販売が行われた最初の日付を取得するメジャーを作成します。
= FIRSTDATE(FiscalCalendar)