DATEADD (レポート ビルダ 1.0)
指定した数の時間間隔の単位を、元の日時または時刻のフィールド型に追加した結果を返します。結果は、元の開始日時または時刻のフィールドと同じデータ型です。
構文
DATEADD(interval, units, datetime)
interval |
日付または時刻の加算に使用する単位 (年、四半期、月、日、時、分、秒、週) を指定します。 |
units |
間隔を表す数値を指定します。 |
datetime |
間隔を加算する対象の開始日または開始時刻を指定します。 |
説明
式で開始時刻に時間間隔の単位を多数追加する場合、間隔の単位には HOUR、MINUTE、または SECOND のみを使用できます。
datetime 値を time 値として表示するには、[書式] ダイアログ ボックスの [数値] タブで、カスタム日付/時刻書式設定文字列のいずれか (u、f、または s) を使用するようにフィールドの書式設定を行う必要があります。
interval に指定する値の大文字と小文字は区別されません。
interval には以下の値を指定できます。
Interval |
結果 |
|---|---|
YEAR |
指定された datetime または time に年数を加算した日時または時刻を返します。 |
QUARTER |
指定された datetime または time に四半期数を加算した日時または時刻を返します。 |
MONTH |
指定された datetime または time に月数を加算した日時または時刻を返します。 |
WEEK |
指定された datetime または time に週数を加算した日時または時刻を返します。 |
DAY |
指定された datetime または time に日数を加算した日時または時刻を返します。 |
HOUR |
指定された datetime または time に時間数を加算した日時または時刻を返します。 |
MINUTE |
指定された datetime または time に分数を加算した日時または時刻を返します。 |
SECOND |
指定された datetime または time に秒数を加算した日時または時刻を返します。 |
例
数式 |
結果 |
|---|---|
DATEADD(MONTH, 3, #8/18/2009#) |
11/18/2009 |
DATEADD(HOUR, 3, DtId) |
DtId フィールドのインスタンスごとに時刻値を返します。たとえば、元の時刻が 07:00:01 AM の場合、結果は 10:00:01 AM になります。 |
DATEADD(DAY, 365, Sell End Date) |
元の販売終了日に 365 日を加算して各インスタンスの販売終了日を返します。たとえば、元の販売終了日が 12/18/2009 の場合、結果は 12/18/2010 になります。 |