Freigeben über


DateAndTime.DateAdd Methode

Definition

Die Funktion gibt einen Date-Wert zurück, der einen Datumswert und einen Zeitwert enthält, zu dem ein festgelegtes Zeitintervall addiert wird.

Überlädt

DateAdd(DateInterval, Double, DateTime)

Die Funktion gibt einen Wert zurück, der einen Datumswert und einen Zeitwert enthält, zu dem ein festgelegtes Zeitintervall addiert wird.

DateAdd(String, Double, Object)

Die Funktion gibt einen Wert zurück, der einen Datumswert und einen Zeitwert enthält, zu dem ein festgelegtes Zeitintervall addiert wird.

DateAdd(DateInterval, Double, DateTime)

Quelle:
DateAndTime.vb
Quelle:
DateAndTime.vb
Quelle:
DateAndTime.vb

Die Funktion gibt einen Wert zurück, der einen Datumswert und einen Zeitwert enthält, zu dem ein festgelegtes Zeitintervall addiert wird.

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

Interval
DateInterval

Erforderlich. Ein DateInterval-Enumerationswert oder ein Zeichenfolgenausdruck, der das zu addierende Zeitintervall darstellt.

Number
Double

Erforderlich. Gleitkommaausdruck, der die Zahl der hinzuzufügenden Intervalle darstellt. Er kann entweder positiv (zum Abrufen von Datums-/Zeitwerten in der Zukunft) oder negativ (zum Abrufen von Datums-/Zeitwerten in der Vergangenheit) sein. Er kann Nachkommastellen enthalten, wenn Interval Stunden, Minuten oder Sekunden angibt. Bei anderen Werten von Interval werden alle Dezimalstellen von Number ignoriert.

DateValue
DateTime

Erforderlich. Ein Ausdruck, der Datum und Uhrzeit angibt, zu denen das Intervall hinzuaddiert werden muss. DateValue selbst wird im aufrufenden Programm nicht geändert.

Gibt zurück

Ein Wert, der einen Datumswert und einen Zeitwert enthält, zu dem ein festgelegtes Zeitintervall addiert wird.

Ausnahmen

DateValue kann nicht in Date umgewandelt werden.

Interval ist nicht gültig.

Das berechnete Datum liegt vor 00:00:00 Uhr am 1. Januar des Jahres 1 oder nach 23:59:59 Uhr am 31. Dezember 9999.

Beispiele

In diesem Beispiel wird ein Datum verwendet und mithilfe der DateAdd Funktion ein entsprechendes Datum für eine angegebene Anzahl von Monaten in der Zukunft angezeigt.

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 beispielsweise ein Datum von 30 Tagen ab heute oder eine Zeit von 45 Minuten vor jetzt berechnen.

Zum Hinzufügen von Tagen zu DateValuekönnen Sie , DateInterval.DayOfYearoder DateInterval.WeekdayverwendenDateInterval.Day. Diese werden als gleichwertig behandelt, da DayOfYear es Weekday sich um keine sinnvollen Zeitintervalle handelt.

Die DateAdd Funktion gibt nie ein ungültiges Datum zurück. Bei Bedarf wird der Tagesteil des resultierenden Datums nach unten auf den letzten Tag des sich ergebenden Monats im sich ergebenden Jahr angepasst. Im folgenden Beispiel wird dem 31. Januar ein Monat hinzugefügt:

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

In diesem Beispiel wird zurückgegeben#2/28/1995#, DateAdd nicht #2/31/1995#. Wenn DateValue ist #1/31/1996#, gibt es zurück #2/29/1996# , da 1996 ein Schaltjahr ist.

Hinweis

DateAdd verwendet die aktuelle Kalendereinstellung aus der CurrentCulture -Eigenschaft der CultureInfo -Klasse im System.Globalization Namespace. Die Standardwerte CurrentCulture werden durch Systemsteuerung Einstellungen bestimmt.

Da jeder Date Wert von einer DateTime Struktur unterstützt wird, bieten ihnen deren Methoden zusätzliche Optionen beim Hinzufügen von Zeitintervallen. Beispielsweise können Sie einer Variablen wie folgt eine Bruchzahl von Tagen hinzufügen, die auf die nächste Millisekunde Date gerundet ist:

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.

Enumerationswert String Einheit des hinzuzufügenden Zeitintervalls
DateInterval.Day T Tag; Auf integralen Wert abgeschnitten
DateInterval.DayOfYear j Tag; Auf integralen Wert abgeschnitten
DateInterval.Hour h Stunde; Gerundet auf die nächste Millisekunde
DateInterval.Minute n Minute; Gerundet auf die nächste Millisekunde
DateInterval.Month m Monat; Auf integralen Wert abgeschnitten
DateInterval.Quarter q Quartal; Auf integralen Wert abgeschnitten
DateInterval.Second s Zweite; Gerundet auf die nächste Millisekunde
DateInterval.Weekday w Tag; Auf integralen Wert abgeschnitten
DateInterval.WeekOfYear ww Woche; Auf integralen Wert abgeschnitten
DateInterval.Year yyyy Jahr; Auf integralen Wert abgeschnitten

Weitere Informationen

Gilt für:

DateAdd(String, Double, Object)

Quelle:
DateAndTime.vb
Quelle:
DateAndTime.vb
Quelle:
DateAndTime.vb

Die Funktion gibt einen Wert zurück, der einen Datumswert und einen Zeitwert enthält, zu dem ein festgelegtes Zeitintervall addiert wird.

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

Interval
String

Erforderlich. Ein DateInterval-Enumerationswert oder ein Zeichenfolgenausdruck, der das zu addierende Zeitintervall darstellt.

Number
Double

Erforderlich. Gleitkommaausdruck, der die Zahl der hinzuzufügenden Intervalle darstellt. Number kann entweder positiv (zum Abrufen von Datums-/Zeitwerten in der Zukunft) oder negativ (zum Abrufen von Datums-/Zeitwerten in der Vergangenheit) sein. Er kann Nachkommastellen enthalten, wenn Interval Stunden, Minuten oder Sekunden angibt. Bei anderen Werten von Interval werden alle Dezimalstellen von Number ignoriert.

DateValue
Object

Erforderlich. Ein Ausdruck, der Datum und Uhrzeit angibt, zu denen das Intervall hinzuaddiert werden muss. DateValue selbst wird im aufrufenden Programm nicht geändert.

Gibt zurück

Ein Wert, der einen Datumswert und einen Zeitwert enthält, zu dem ein festgelegtes Zeitintervall addiert wird.

Ausnahmen

DateValue kann nicht in Date umgewandelt werden.

Interval ist nicht gültig.

Das berechnete Datum liegt vor 00:00:00 Uhr am 1. Januar des Jahres 1 oder nach 23:59:59 Uhr am 31. Dezember 9999.

Beispiele

In diesem Beispiel wird ein Datum verwendet und mithilfe der DateAdd Funktion ein entsprechendes Datum für eine angegebene Anzahl von Monaten in der Zukunft angezeigt.

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 beispielsweise ein Datum von 30 Tagen ab heute oder eine Zeit von 45 Minuten vor jetzt berechnen.

Zum Hinzufügen von Tagen zu DateValuekönnen Sie , DateInterval.DayOfYearoder DateInterval.WeekdayverwendenDateInterval.Day. Diese werden als gleichwertig behandelt, da DayOfYear es Weekday sich um keine sinnvollen Zeitintervalle handelt.

Die DateAdd Funktion gibt nie ein ungültiges Datum zurück. Bei Bedarf wird der Tagesteil des resultierenden Datums nach unten auf den letzten Tag des sich ergebenden Monats im sich ergebenden Jahr angepasst. Im folgenden Beispiel wird dem 31. Januar ein Monat hinzugefügt:

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

In diesem Beispiel wird zurückgegeben#2/28/1995#, DateAdd nicht #2/31/1995#. Wenn DateValue ist #1/31/1996#, gibt es zurück #2/29/1996# , da 1996 ein Schaltjahr ist.

Hinweis

DateAdd verwendet die aktuelle Kalendereinstellung aus der CurrentCulture -Eigenschaft der CultureInfo -Klasse im System.Globalization Namespace. Die Standardwerte CurrentCulture werden durch Systemsteuerung Einstellungen bestimmt.

Da jeder Date Wert von einer DateTime Struktur unterstützt wird, bieten ihnen deren Methoden zusätzliche Optionen beim Hinzufügen von Zeitintervallen. Beispielsweise können Sie einer Variablen wie folgt eine Bruchzahl von Tagen hinzufügen, die auf die nächste Millisekunde Date gerundet ist:

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.

Enumerationswert String Einheit des hinzuzufügenden Zeitintervalls
DateInterval.Day T Tag; Auf integralen Wert abgeschnitten
DateInterval.DayOfYear j Tag; Auf integralen Wert abgeschnitten
DateInterval.Hour h Stunde; Gerundet auf die nächste Millisekunde
DateInterval.Minute n Minute; Gerundet auf die nächste Millisekunde
DateInterval.Month m Monat; Auf integralen Wert abgeschnitten
DateInterval.Quarter q Quartal; Auf integralen Wert abgeschnitten
DateInterval.Second s Zweite; Gerundet auf die nächste Millisekunde
DateInterval.Weekday w Tag; Auf integralen Wert abgeschnitten
DateInterval.WeekOfYear ww Woche; Auf integralen Wert abgeschnitten
DateInterval.Year yyyy Jahr; Auf integralen Wert abgeschnitten

Weitere Informationen

Gilt für: