Note
この関数は、意味のない結果を返す可能性が高いため、ビジュアル計算で使用することは推奨されません。
日付列の入力の場合は、指定した日付列の現在のコンテキストで月の最初の日付を返します。
カレンダー入力の場合、現在のコンテキストで、最初の日付の月のテーブルを返します。 すべてのプライマリ タグ付き列とすべての時間関連列を含むテーブル。
構文
STARTOFMONTH(<dates> or <calendar>)
パラメーター
| 用語 | 定義 |
|---|---|
dates or calendar |
日付またはカレンダー参照を含む列 |
戻り値
日付列入力の場合、1 つの列と日付値を持つ 1 つの行を含むテーブル。
カレンダー入力の場合、すべての主要なタグ付け列とすべての時間関連列を含むテーブル。
解説
dates引数には、次のいずれかを指定できます。- 日付/時刻列への参照。
- 日付/時刻値の単一列を返すテーブル式。
- 日付/時刻値の単一列テーブルを定義するブール式。
ブール式に対する制約については、「CALCULATE」を参照してください。
この関数は、計算列または行レベル セキュリティ (RLS) 規則で使用する場合、DirectQuery モードでは使用できません。
例
次のサンプル数式では、現在のコンテキストの月の始まりを返すメジャーを作成します。
= STARTOFMONTH(DateTime[DateKey])
カレンダー ベースのタイム インテリジェンスの例
次の数式の例では、会計カレンダーの月の始まりに対応する、タグ付きのプライマリ列を返すテーブルを作成します。
= STARTOFMONTH(FiscalCalendar)