Funktionsreferenz

_DateAdd

Berechnet ein neues Datum, basierend auf einem gegebenen Datum und einem zu addierenden Intervall.

#include <Date.au3>
_DateAdd($sType, $iValToAdd, $sDate)

Parameter

$sType eines der folgenden:
D - Addiere Anzahl von Tagen zu dem angegebenen Datum
M - Addiere Anzahl von Monaten zu dem angegebenen Datum
Y - Addiere Anzahl von Jahren zu dem angegebenen Datum
w - Addiere Anzahl von Wochen zu dem angegebenen Datum
h - Addiere Anzahl von Stunden zu dem angegebenen Datum
n - Addiere Anzahl von Minuten zu dem angegebenen Datum
s - Addiere Anzahl von Sekunden zu dem angegebenen Datum
$iValToAdd die zu addierende Zahl
$sDate Eingabedatum im Format YYYY/MM/DD[ hh:mm:ss]

Rückgabewert

Erfolg: Neu berechnetes Datum.
Fehler: 0 und setzt @ERROR
@error: 0 - Kein Fehler
1 - $sType ungültig
2 - $iValToAdd ungültig
3 - $sDate ungültig

Bemerkungen

Diese Funktion gibt kein ungültiges Datum zurück. 2004-01-31 + 3 Monate ergibt 2004-04-30. Das Datum muss in der Form YYYY-MM-DD hh:mm:ss angegeben werden. Statt "-" kann auch "/" oder "." als Trennzeichen verwendet werden. Die Angabe von "hh:mm:ss" ist optional.

Verwandte Funktionen

_DateDiff, _DateTimeSplit, _DateToDayOfWeek, _DateToDayOfWeekISO, _DateToDayValue, _DayValueToDate

Beispiel


#include <Date.au3>

; Addiert zum heutigen Datum 5 Tage dazu
Local $sNewDate = _DateAdd('d', 5, _NowCalcDate())
MsgBox(4096, "", "Heute + 5 Tage: " & $sNewDate)

; Subtrahiert vom heutigen Datum 2 Wochen
$sNewDate = _DateAdd('w', -2, _NowCalcDate())
MsgBox(4096, "", "Heute minus 2 Wochen: " & $sNewDate)

; Addiert zur jetzigen Zeit 15 Minuten
$sNewDate = _DateAdd('n', 15, _NowCalc())
MsgBox(4096, "", "Aktuelle Zeit + 15 Minuten: " & $sNewDate)

; Addiert zum 01.01.1970 1087497645 Sekunden und gibt das neue Datum zurück
$sNewDate = _DateAdd('s', 1087497645, "1970/01/01 00:00:00")
MsgBox(4096, "", "Datum: " & $sNewDate)