DateAndTime.DateAdd Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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)
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
- Source:
- 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 wird ein entsprechendes Datum mit einer angegebenen 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. Beispielsweise können Sie ein Datum 30 Tage nach dem heutigen Tag oder eine Zeit von 45 Minuten vor jetzt berechnen.
Zum Hinzufügen von Tagen zu DateValue
können Sie , DateInterval.DayOfYear
oder DateInterval.Weekday
verwendenDateInterval.Day
. Diese werden als gleichwertig behandelt, da DayOfYear
und Weekday
keine sinnvollen Zeitintervalle sind.
Die DateAdd
Funktion gibt nie ein ungültiges Datum zurück. Falls erforderlich, wird der Tagesteil des resultierenden Datums nach unten auf den letzten Tag des resultierenden Monats im resultierenden Jahr angepasst. Im folgenden Beispiel wird am 31. Januar ein Monat hinzugefügt:
Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)
In diesem Beispiel wird nicht zurückgegeben#2/28/1995#
#2/31/1995#
. DateAdd
Wenn DateValue
ist #1/31/1996#
, wird zurückgegeben #2/29/1996#
, weil 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 die zugehörigen Methoden zusätzliche Optionen zum Hinzufügen von Zeitintervallen. Beispielsweise können Sie einer Variablen wie folgt eine Bruchteilzahl von Tagen hinzufügen, gerundet auf die nächste Millisekunde Date
:
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 | Hinzuzufügende Zeiteinheit |
---|---|---|
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
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Datentyp: Zusammenfassung (Visual Basic)
Gilt für:
DateAdd(String, Double, Object)
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
- Source:
- 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 wird ein entsprechendes Datum mit einer angegebenen 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. Beispielsweise können Sie ein Datum 30 Tage nach dem heutigen Tag oder eine Zeit von 45 Minuten vor jetzt berechnen.
Zum Hinzufügen von Tagen zu DateValue
können Sie , DateInterval.DayOfYear
oder DateInterval.Weekday
verwendenDateInterval.Day
. Diese werden als gleichwertig behandelt, da DayOfYear
und Weekday
keine sinnvollen Zeitintervalle sind.
Die DateAdd
Funktion gibt nie ein ungültiges Datum zurück. Falls erforderlich, wird der Tagesteil des resultierenden Datums nach unten auf den letzten Tag des resultierenden Monats im resultierenden Jahr angepasst. Im folgenden Beispiel wird am 31. Januar ein Monat hinzugefügt:
Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)
In diesem Beispiel wird nicht zurückgegeben#2/28/1995#
#2/31/1995#
. DateAdd
Wenn DateValue
ist #1/31/1996#
, wird zurückgegeben #2/29/1996#
, weil 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 die zugehörigen Methoden zusätzliche Optionen zum Hinzufügen von Zeitintervallen. Beispielsweise können Sie einer Variablen wie folgt eine Bruchteilzahl von Tagen hinzufügen, gerundet auf die nächste Millisekunde Date
:
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 | Hinzuzufügende Zeiteinheit |
---|---|---|
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
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Datentyp: Zusammenfassung (Visual Basic)
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für