DateAndTime.DateAdd メソッド

ソース:

DateAndTime.vb

ソース:

DateAndTime.vb

ソース:

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

パラメーター

戻り値

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

例外

例

次の使用例は、日付を受け取り、 関数を 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.DayOfYearまたは DateInterval.Weekdayを使用DateInterval.Dayできます。 と は意味のある時間間隔ではないのでDayOfYearWeekday、これらは同等として扱われます。

関数は 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#、 #2/29/1996# 1996 が閏年であるため、 が返されます。

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

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

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

こちらもご覧ください

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

ソース:

DateAndTime.vb

ソース:

DateAndTime.vb

ソース:

DateAndTime.vb

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

public static DateTime DateAdd (string Interval, double Number, 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

パラメーター

戻り値

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

例外

例

次の使用例は、日付を受け取り、 関数を 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.DayOfYearまたは DateInterval.Weekdayを使用DateInterval.Dayできます。 と は意味のある時間間隔ではないのでDayOfYearWeekday、これらは同等として扱われます。

関数は 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#、 #2/29/1996# 1996 が閏年であるため、 が返されます。

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

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

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

こちらもご覧ください

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