DateAdd

Erhöht oder verringert einen Datum-Zeit-Wert um eine bestimmte Zeitmenge.

Ergebnis := DateAdd(DatumZeit, Zeit, ZeitEinheit)

Parameter

DatumZeit

Typ: Zeichenkette

Ein Zeitstempel im YYYYMMDDHH24MISS-Format.

Zeit

Typ: Integer oder Float

Die zu addierende Zeitmenge, als Integer oder Floating-Point-Zahl. Mit einer negativen Zahl kann subtrahiert werden.

ZeitEinheit

Typ: Zeichenkette

Die Bedeutung des Zeit-Parameters. ZeitEinheit kann eine der folgenden Zeichenketten sein (oder jeweils nur der erste Buchstabe davon): Seconds, Minutes, Hours oder Days.

Rückgabewert

Typ: Zeichenkette

Diese Funktion gibt eine Zeichenkette von Ziffern im YYYYMMDDHH24MISS-Format zurück. Diese Zeichenkette sollte nicht als Zahl behandelt werden, d.h. es sollten keine Berechnungen oder numerischen Vergleiche mit ihr durchgeführt werden.

Bemerkungen

Die interne Variable A_Now enthält die aktuelle Ortszeit im YYYYMMDDHH24MISS-Format.

Mit DateDiff kann die Zeitdifferenz zwischen zwei Zeitstempeln berechnet werden.

Enthält DatumZeit einen ungültigen Zeitstempel oder ein Jahr älter als 1601, wird ein ValueError ausgelöst.

DateDiff, FileGetTime, FormatTime

Beispiele

Addiert 31 Tage auf das heutige Datum und meldet das Ergebnis in lesbarer Form.

Zukunft := DateAdd(A_Now, 31, "d")
MsgBox FormatTime(Zukunft)