DateAndTime.DateAdd Methode

Quelle:

DateAndTime.vb

Quelle:

DateAndTime.vb

Quelle:

DateAndTime.vb

Quelle:

DateAndTime.vb

Quelle:

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

Parameter

Gibt zurück

Ein Wert, der einen Datums- und Uhrzeitwert enthält, dem ein angegebenes Zeitintervall hinzugefügt wurde.

Ausnahmen

Beispiele

In diesem Beispiel wird ein Datum verwendet, und mithilfe der DateAdd Funktion wird ein entsprechendes Datum angezeigt, das eine bestimmte Anzahl von Monaten in der Zukunft annimmt.

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)

Hinweise

Sie können die DateAdd Funktion verwenden, um ein angegebenes Zeitintervall von einem Datum hinzuzufügen oder zu subtrahieren. Sie können z. B. ein Datum von 30 Tagen ab heute oder eine Uhrzeit von 45 Minuten vorher berechnen.

Zum Hinzufügen von Tagen zu DateValue, können Sie verwenden DateInterval.Day, , DateInterval.DayOfYearoder DateInterval.Weekday. Diese werden als gleichwertig behandelt, da DayOfYear sie Weekday keine sinnvollen Zeitintervalle sind.

Die DateAdd Funktion gibt nie ein ungültiges Datum zurück. Bei Bedarf wird der Tagesteil des resultierenden Datums bis zum letzten Tag des resultierenden Monats im resultierenden Jahr nach unten angepasst. Das folgende Beispiel addiert zum 31. Januar einen Monat hinzu:

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

Gibt in diesem Beispiel DateAdd#2/28/1995#, nicht #2/31/1995#. Wenn DateValue ja #1/31/1996#, gibt sie zurück #2/29/1996# , weil 1996 ein Schaltjahr ist.

Da jeder Date Wert von einer DateTime Struktur unterstützt wird, bieten ihnen die Methoden zusätzliche Optionen zum Hinzufügen von Zeitintervallen. Sie können z. B. eine Bruchzahl von Tagen hinzufügen, die auf die nächste Millisekunden gerundet werden, zu einer Date Variablen wie folgt:

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

Das Interval Argument kann über eine der folgenden Einstellungen verfügen.

Weitere Informationen

• DateDiff
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• Zusammenfassung des Datentyps (Visual Basic)

Quelle:

DateAndTime.vb

Quelle:

DateAndTime.vb

Quelle:

DateAndTime.vb

Quelle:

DateAndTime.vb

Quelle:

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

Parameter

Gibt zurück

Ein Wert, der einen Datums- und Uhrzeitwert enthält, dem ein angegebenes Zeitintervall hinzugefügt wurde.

Ausnahmen

Beispiele

In diesem Beispiel wird ein Datum verwendet, und mithilfe der DateAdd Funktion wird ein entsprechendes Datum angezeigt, das eine bestimmte Anzahl von Monaten in der Zukunft annimmt.

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)

Hinweise

Sie können die DateAdd Funktion verwenden, um ein angegebenes Zeitintervall von einem Datum hinzuzufügen oder zu subtrahieren. Sie können z. B. ein Datum von 30 Tagen ab heute oder eine Uhrzeit von 45 Minuten vorher berechnen.

Zum Hinzufügen von Tagen zu DateValue, können Sie verwenden DateInterval.Day, , DateInterval.DayOfYearoder DateInterval.Weekday. Diese werden als gleichwertig behandelt, da DayOfYear sie Weekday keine sinnvollen Zeitintervalle sind.

Die DateAdd Funktion gibt nie ein ungültiges Datum zurück. Bei Bedarf wird der Tagesteil des resultierenden Datums bis zum letzten Tag des resultierenden Monats im resultierenden Jahr nach unten angepasst. Das folgende Beispiel addiert zum 31. Januar einen Monat hinzu:

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

Gibt in diesem Beispiel DateAdd#2/28/1995#, nicht #2/31/1995#. Wenn DateValue ja #1/31/1996#, gibt sie zurück #2/29/1996# , weil 1996 ein Schaltjahr ist.

Da jeder Date Wert von einer DateTime Struktur unterstützt wird, bieten ihnen die Methoden zusätzliche Optionen zum Hinzufügen von Zeitintervallen. Sie können z. B. eine Bruchzahl von Tagen hinzufügen, die auf die nächste Millisekunden gerundet werden, zu einer Date Variablen wie folgt:

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

Das Interval Argument kann über eine der folgenden Einstellungen verfügen.

Weitere Informationen

• DateDiff
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• Zusammenfassung des Datentyps (Visual Basic)