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.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 が閏年であるため、 が返されます。

注意

DateAdd では、 名前空間の クラスの CurrentCulture プロパティの現在の CultureInfo カレンダー設定を System.Globalization 使用します。 既定値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 、次のいずれかの設定を指定できます。

列挙値	String	追加する時間間隔の単位
DateInterval.Day	d	日;整数値に切り捨てられます
DateInterval.DayOfYear	○	日;整数値に切り捨てられます
DateInterval.Hour	h	時間;最も近いミリ秒に丸められます
DateInterval.Minute	n	分;最も近いミリ秒に丸められます
DateInterval.Month	m	月;整数値に切り捨てられます
DateInterval.Quarter	q	四半期;整数値に切り捨てられます
DateInterval.Second	s	2 番目;最も近いミリ秒に丸められます
DateInterval.Weekday	。	日;整数値に切り捨てられます
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.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 が閏年であるため、 が返されます。

注意

DateAdd では、 名前空間の クラスの CurrentCulture プロパティの現在の CultureInfo カレンダー設定を System.Globalization 使用します。 既定値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 、次のいずれかの設定を指定できます。

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

こちらもご覧ください

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