EDATE 関数

  • [アーティクル]

開始日付から起算した指定の月数に対応する日付を返します。 EDATE を使用すると、指定した月数だけ前または後の、発行日と同じ日付の支払日や納期日を求めることができます。

構文

EDATE(<start_date>, <months>)

パラメーター

項目

定義

start_date

開始日付を表す datetime 形式または text 形式の日付。

months

start_date より前または後の月数を表す整数。

戻り値

日付 (datetime)。

説明

日付を連続したシリアル値として保存する Microsoft Excel とは異なり、DAX では日付を datetime 形式で処理します。 別の形式で保存されている日付は、暗黙的に変換されます。

start_date が有効な日付ではない場合、EDATE はエラーを返します。 最初の引数として指定した列参照または日付が有効な日付であることを確認してください。

months が整数ではない場合は切り捨てられます。

日付引数が日付のテキスト表現である場合、EDATE 関数は、クライアント コンピューターのロケールおよび日付と時刻の設定を使用してテキスト値を解釈し、変換を行います。 現在の日付と時刻の設定で、日付が月/日/年の形式で表されている場合、文字列 "1/8/2009" は 2009 年 1 月 8 日に相当する日付時刻値として解釈されます。 一方、現在の日付と時刻の設定で、日付が日/月/年の形式で表されている場合、同じ文字列が 2009 年 8 月 1 日に相当する日付時刻値として解釈されます。

要求された日付が、対応する月の最終日を過ぎている場合、その月の最終日が返されます。 たとえば、関数 EDATE("2009-01-29", 1)、EDATE("2009-01-30", 1)、および EDATE("2009-01-31", 1) は、2009 年 2 月 28 日を返します。これは、開始日付の 1 か月後に相当します。

この DAX 関数は、配置済みのモデルで使用し、DirectQuery モードでクエリを実行した場合には、異なる結果を返すことがあります。 DirectQuery モードのセマンティックの相違点の詳細については、https://go.microsoft.com/fwlink/?LinkId=219171 を参照してください。

使用例

次の例では、列 [TransactionDate] に格納されている発注日から起算して 3 か月後の日付が返されます。

=EDATE([TransactionDate],3)

関連項目

参照

EOMONTH 関数

その他の技術情報

日付と時刻の関数 (DAX)