DateAndTime.DateAdd メソッド

定義

名前空間:

Microsoft.VisualBasic

アセンブリ:

Microsoft.VisualBasic.Core.dll

指定した時間間隔が追加された日付と時刻の値を含む Date 値を返します。

オーバーロード

名前	説明
DateAdd(DateInterval, Double, DateTime)	指定した時間間隔が追加された日付と時刻の値を含む値を返します。
DateAdd(String, Double, Object)	指定した時間間隔が追加された日付と時刻の値を含む値を返します。

DateAdd(DateInterval, Double, DateTime)

ソース:

DateAndTime.vb

指定した時間間隔が追加された日付と時刻の値を含む値を返します。

public:
 static DateTime DateAdd(Microsoft::VisualBasic::DateInterval Interval, double Number, DateTime DateValue);

public static DateTime DateAdd(Microsoft.VisualBasic.DateInterval Interval, double Number, DateTime DateValue);

static member DateAdd : Microsoft.VisualBasic.DateInterval * double * DateTime -> DateTime

Public Function DateAdd (Interval As DateInterval, Number As Double, DateValue As DateTime) As DateTime

パラメーター

Interval

DateInterval

必須。 DateInterval列挙値、または追加する時間間隔を表す文字列式。

Number

Double

必須。 追加する間隔の数を表す浮動小数点式。 正の値 (将来の日付/時刻値を取得する場合) または負の値 (過去の日付/時刻値を取得する場合) を指定できます。 Intervalが時間、分、または秒を指定する場合は、小数部を含めることができます。 Intervalの他の値の場合、Numberの小数部は無視されます。

DateValue

DateTime

必須。 間隔を追加する日付と時刻を表す式。 DateValue は、呼び出し元のプログラムでは変更されません。

戻り値

DateTime

指定した時間間隔が追加された日付と時刻の値を含む値。

例外

InvalidCastException

DateValue は、 Dateに強制できません。

ArgumentException

Interval が無効です。

ArgumentOutOfRangeException

計算日は、1 年 1 月 1 日の 00:00:00 より前、または 9999 年 12 月 31 日の 23:59:59 より後です。

例

この例では、日付を取得し、 DateAdd 関数を使用して、指定した数か月後の対応する日付を表示します。

Dim dateEntered As String =
InputBox("Enter a date", DefaultResponse:=Date.Now.ToShortDateString)
Dim monthsEntered As String =
InputBox("Enter number of months to add", DefaultResponse:="12")

Dim dateValue As Date = Date.Parse(dateEntered)
Dim monthsValue As Integer = Integer.Parse(monthsEntered)

' Add the months to the date.
Dim newDate As Date = DateAdd(DateInterval.Month, monthsValue, dateValue)

' This statement has a string interval argument, and
' is equivalent to the above statement.
'Dim newDate As Date = DateAdd("m", monthsValue, dateValue)

MessageBox.Show("New date: " & newDate.ToShortDateString)

注釈

DateAdd関数を使用して、指定した時間間隔を日付から加算または減算できます。 たとえば、今日から 30 日、または 45 分前の日付を計算できます。

DateValueに日数を追加するには、DateInterval.Day、DateInterval.DayOfYear、またはDateInterval.Weekdayを使用できます。 DayOfYearとWeekdayは意味のある時間間隔ではないため、これらは同等として扱われます。

DateAdd関数は無効な日付を返しません。 必要に応じて、結果の日付の日部分が、結果の年の結果の月の最後の日に下方に調整されます。 次の例では、1 月 31 日に 1 か月を追加します。

Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)

この例では、DateAddは#2/31/1995#ではなく、#2/28/1995#を返します。 DateValueが#1/31/1996#の場合、1996 年は閏年であるため、#2/29/1996#が返されます。

注

DateAddは、System.Globalization名前空間のCultureInfo クラスのCurrentCulture プロパティの現在のカレンダー設定を使用します。 既定の CurrentCulture 値は、 コントロール パネル の設定によって決まります。

すべての Date 値は DateTime 構造体でサポートされているため、そのメソッドでは時間間隔を追加するオプションが追加されます。 たとえば、次のように、最も近いミリ秒に丸められた小数部の日数を Date 変数に追加できます。

Dim NextTime As Date = Now        ' Current date and time.
NextTime = NextTime.AddDays(3.4)  ' Increment by 3 2/5 days.

Interval引数には、次のいずれかの設定を指定できます。

列挙値	糸	追加する時間間隔の単位
DateInterval.Day	d	日;整数値に切り捨て
DateInterval.DayOfYear	y	日;整数値に切り捨て
DateInterval.Hour	h	時間;最も近いミリ秒に丸められます
DateInterval.Minute	n	分;最も近いミリ秒に丸められます
DateInterval.Month	m	月;整数値に切り捨て
DateInterval.Quarter	q	四半期;整数値に切り捨て
DateInterval.Second	s	2 番目;最も近いミリ秒に丸められます
DateInterval.Weekday	w	日;整数値に切り捨て
DateInterval.WeekOfYear	ww	週;整数値に切り捨て
DateInterval.Year	yyyy	年;整数値に切り捨て

こちらもご覧ください

• DateDiff
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• データ型の概要 (Visual Basic)

DateAdd(String, Double, Object)

ソース:

DateAndTime.vb

指定した時間間隔が追加された日付と時刻の値を含む値を返します。

public:
 static DateTime DateAdd(System::String ^ Interval, double Number, System::Object ^ DateValue);

public static DateTime DateAdd(string Interval, double Number, object? DateValue);

static member DateAdd : string * double * obj -> DateTime

Public Function DateAdd (Interval As String, Number As Double, DateValue As Object) As DateTime

パラメーター

Interval

String

必須。 DateInterval列挙値、または追加する時間間隔を表す文字列式。

Number

Double

必須。 追加する間隔の数を表す浮動小数点式。 Number は、正の値 (将来の日付/時刻値を取得する場合) または負の値 (過去の日付/時刻値を取得する場合) です。 Intervalが時間、分、または秒を指定する場合は、小数部を含めることができます。 Intervalの他の値の場合、Numberの小数部は無視されます。

DateValue

Object

必須。 間隔を追加する日付と時刻を表す式。 DateValue は、呼び出し元のプログラムでは変更されません。

戻り値

DateTime

指定した時間間隔が追加された日付と時刻の値を含む値。

例外

InvalidCastException

DateValue は、 Dateに強制できません。

ArgumentException

Interval が無効です。

ArgumentOutOfRangeException

計算日は、1 年 1 月 1 日の 00:00:00 より前、または 9999 年 12 月 31 日の 23:59:59 より後です。

例

この例では、日付を取得し、 DateAdd 関数を使用して、指定した数か月後の対応する日付を表示します。

Dim dateEntered As String =
InputBox("Enter a date", DefaultResponse:=Date.Now.ToShortDateString)
Dim monthsEntered As String =
InputBox("Enter number of months to add", DefaultResponse:="12")

Dim dateValue As Date = Date.Parse(dateEntered)
Dim monthsValue As Integer = Integer.Parse(monthsEntered)

' Add the months to the date.
Dim newDate As Date = DateAdd(DateInterval.Month, monthsValue, dateValue)

' This statement has a string interval argument, and
' is equivalent to the above statement.
'Dim newDate As Date = DateAdd("m", monthsValue, dateValue)

MessageBox.Show("New date: " & newDate.ToShortDateString)

注釈

DateAdd関数を使用して、指定した時間間隔を日付から加算または減算できます。 たとえば、今日から 30 日、または 45 分前の日付を計算できます。

DateValueに日数を追加するには、DateInterval.Day、DateInterval.DayOfYear、またはDateInterval.Weekdayを使用できます。 DayOfYearとWeekdayは意味のある時間間隔ではないため、これらは同等として扱われます。

DateAdd関数は無効な日付を返しません。 必要に応じて、結果の日付の日部分が、結果の年の結果の月の最後の日に下方に調整されます。 次の例では、1 月 31 日に 1 か月を追加します。

Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)

この例では、DateAddは#2/31/1995#ではなく、#2/28/1995#を返します。 DateValueが#1/31/1996#の場合、1996 年は閏年であるため、#2/29/1996#が返されます。

注

DateAddは、System.Globalization名前空間のCultureInfo クラスのCurrentCulture プロパティの現在のカレンダー設定を使用します。 既定の CurrentCulture 値は、 コントロール パネル の設定によって決まります。

すべての Date 値は DateTime 構造体でサポートされているため、そのメソッドでは時間間隔を追加するオプションが追加されます。 たとえば、次のように、最も近いミリ秒に丸められた小数部の日数を Date 変数に追加できます。

Dim NextTime As Date = Now        ' Current date and time.
NextTime = NextTime.AddDays(3.4)  ' Increment by 3 2/5 days.

Interval引数には、次のいずれかの設定を指定できます。

列挙値	糸	追加する時間間隔の単位
DateInterval.Day	d	日;整数値に切り捨て
DateInterval.DayOfYear	y	日;整数値に切り捨て
DateInterval.Hour	h	時間;最も近いミリ秒に丸められます
DateInterval.Minute	n	分;最も近いミリ秒に丸められます
DateInterval.Month	m	月;整数値に切り捨て
DateInterval.Quarter	q	四半期;整数値に切り捨て
DateInterval.Second	s	2 番目;最も近いミリ秒に丸められます
DateInterval.Weekday	w	日;整数値に切り捨て
DateInterval.WeekOfYear	ww	週;整数値に切り捨て
DateInterval.Year	yyyy	年;整数値に切り捨て

こちらもご覧ください

• DateDiff
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• データ型の概要 (Visual Basic)