Diese Funktion ist veraltet und könnte im Laufe der nächsten Updates entfernt werden. Es sollte die neue Berechnungsfunktion dateCalc (Datum berechnen).

Die Funktion $dateAdd dient dazu, auf ein Datumswert Datums- oder Zeiteinheiten aufzuaddieren.

Syntax

$dateAdd(part,units[,dateValue])

Parameter

Name	Beschreibung
part	Gibt an, welche Einheit des Datumswertes aufaddiert werden soll. Gültige Werte: h Stunde d Tag m oder n Minute s Sekunde l Millisekunde
units	Gibt die Anzahl an zu addierenden Einheiten an
dateValue (optional)	Ein gültiges Datums- oder Zeitwert, welcher als Quelle der Berechnung dient. Wenn dieser Parameter nicht angegeben ist, wird vom Zeitpunkt der Ausführung ausgegangen ( $now( ) )

Rückgabewert

Gibt das Ergebnis der Berechnung als neuen Wert, kompatibel zum Eingabewert (dateValue Parameter), zurück. Ist dateValue beispielsweise ein Datumsbereich (DateRange), so wird auch wieder ein Datumsbereichsobjekt zurückgeliefert.

Beispiele

Ausgeführt am 03.12.2019 um 08:50 Uhr.

Syntax	Ergebnis	Bemerkung
$dateAdd(h,11,$today())	03.12.2019 11:00	Erzeugt ein aktuelles Datum ohne Uhrzeit und zählt 11 Stunden dazu
$dateAdd(m,30,$dateAdd(h,11,$today()))	03.12.2019 11:30	Erzeugt ein aktuelles Datum ohne Uhrzeit und zählt 11 Stunden dazu, zum Ergebnis werden noch 30 Minuten dazu gezählt
$dateAdd(h,17)	04.12.2019 01:50	Überlauf: Addiert 17 Stunden zum Zeitpunkt der Ausführung hinzu. Dadurch ergibt sich der Folgetag um 01:50 Uhr