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
$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)