DateAdd 関数
指定された時間間隔を加算した日付を返します。
DateAdd(interval, number, date)
引数
- interval
必ず指定します。追加する時間間隔の単位を表す文字列式を指定します。設定する値については、次の「設定値」を参照してください。 - number
必ず指定します。追加する時間間隔の数を表す数式を指定します。将来の日時を取得するには正の数を指定します。過去の日時を取得するには負の数を指定します。 - date
必ず指定します。時間間隔を追加する日付を表すバリアント型 (Variant) の値またはリテラル文字列を指定します。
設定値
引数 interval の設定値は次のとおりです。
設定値 | 内容 |
---|---|
yyyy | 年 |
q | 四半期 |
m | 月 |
y | 年間通算日 |
d | 日 |
w | 週日 |
ww | 週 |
h | 時 |
n | 分 |
s | 秒 |
解説
DateAdd 関数を使うと、ある日付に対して指定した時間間隔を、加えたり引いたりすることができます。たとえば、現在から 30 日後の日付や、現在から 45 分後の時刻などを計算できます。引数 date に日数を加えるには、年間通算日 ("y")、日 ("d")、週日 ("w") のいずれかを指定します。
DateAdd 関数は、無効な日付を返しません。次の例は、1 月 31 日に 1 か月を足します。
NewDate = DateAdd("m", 1, "31-Jan-95")
この場合、31-Feb-95 ではなく、28-Feb-95 が返されます。名前付き引数 date が 31-Jan-96 であれば、1996 年はうるう年なので 29-Feb-96 が返されます。
計算の結果、日付が西暦 100 年以前になる場合は、エラーが発生します。
名前付き引数 number に指定した値が長整数型 (Long) でない場合は、最も近い整数値に丸められてから評価されます。