DATEADDDATEADD

現在のコンテキストの日付から、指定された間隔数だけ時間を前後にシフトした日付の列を含むテーブルを返します。Returns a table that contains a column of dates, shifted either forward or backward in time by the specified number of intervals from the dates in the current context.

構文Syntax

DATEADD(<dates>,<number_of_intervals>,<interval>)  

パラメーターParameters

項目Term 定義Definition
日付dates 日付を含む列。A column that contains dates.
number_of_intervalsnumber_of_intervals 日付に対して加算または減算する間隔の数を指定する整数。An integer that specifies the number of intervals to add to or subtract from the dates.
intervalinterval 日付をシフトする間隔。The interval by which to shift the dates. interval の値は、yearquartermonthday のいずれかにすることができますThe value for interval can be one of the following: year, quarter, month, day

戻り値Return value

日付値の単一列を含むテーブル。A table containing a single column of date values.

解説Remarks

dates 引数には、次のいずれかを指定できます。The dates argument can be any of the following:

  • 日付/時刻列への参照。A reference to a date/time column,

  • 日付/時刻の値の単一の列を返すテーブル式。A table expression that returns a single column of date/time values,

  • 日付/時刻の値の単一列テーブルを定義するブール式。A Boolean expression that defines a single-column table of date/time values.

注意

ブール式に対する制約については、CALCULATE 関数 (DAX) に関するトピックで説明されています。Constraints on Boolean expressions are described in the topic, CALCULATE function (DAX).

number_of_intervals に指定された数値が正の場合は dates の日数分、時間が進みます。数値が負の場合は dates の日数分、時間が戻ります。If the number specified for number_of_intervals is positive, the dates in dates are moved forward in time; if the number is negative, the dates in dates are shifted back in time.

interval パラメーターは列挙型であり、文字列のセットではありません。そのため、値を引用符で囲むことはできません。The interval parameter is an enumeration, not a set of strings; therefore values should not be enclosed in quotation marks. また、yearquartermonthday という値を使用する場合は、スペルを略さずに入力する必要があります。Also, the values: year, quarter, month, day should be spelled in full when using them.

結果テーブルには、dates 列に存在する日付のみが含まれます。The result table includes only dates that exist in the dates column.

現在のコンテキストの日付が連続した間隔を形成していない場合、関数からはエラーが返されます。If the dates in the current context do not form a contiguous interval, the function returns an error.

この DAX 関数の DirectQuery モードでの使用はサポートされていません。This DAX function is not supported for use in DirectQuery mode. DirectQuery モデルの制限の詳細については、https://go.microsoft.com/fwlink/?LinkId=219172 を参照してください。For more information about limitations in DirectQuery models, see https://go.microsoft.com/fwlink/?LinkId=219172.

例 - 複数日をシフトするExample - Shifting a set of dates

DescriptionDescription

次の数式例では、現在のコンテキストの日付の 1 年前の日付を計算します。The following formula calculates dates that are one year before the dates in the current context.

=DATEADD(DateTime[DateKey],-1,year)  

関連項目See also

タイムインテリジェンス関数 (DAX)Time-intelligence functions (DAX)
日付と時刻関数 (DAX)Date and time functions (DAX)