Automation Engine Script-Leitfaden > Funktionelle Gliederung > Datum und Zeit > ADD_DAYS

ADD_DAYS

Script-Funktion: Addiert Tage zu angegebenem Datum.

Syntax

ADD_DAYS(Date, Days, [[Calendar], [Calendar Keyword]])

Syntax	Beschreibung/Format
Datum	Angabe eines Datums im Format "YYMMDD" oder "YYYYMMDD". Format: Script-Literal oder Script-Variable Es ist auch möglich, ein anderes Datumsformat auszuwählen. Geben Sie dazu zuerst das gewünschte Datumsformat, ein Trennzeichen (: oder ;) und danach das Datum an. Die Angabe des Datumsformats ist optional.
Tage	Anzahl von Tagen, mit denen gerechnet werden soll. Format: Script-Literal, Zahl ohne Hochkommata oder Script-Variable
Kalender	Name des Kalender-Objektes, der bei Berechnung zu berücksichtigen ist. Format: AE-Name, Script-Literal oder Script-Variable
Kalenderbegriff	Name des Kalenderbegriffes, der bei Berechnung zu berücksichtigen ist. Format: AE-Name, Script-Literal oder Script-Variable

Rückgabewert
Datum im angegebenen Format. "0" - Dem Kalenderbegriff wurden keine Tage zugewiesen oder das berechnete Datum liegt außerhalb des Kalenders. "20327" - Das Kalender-Objekt existiert nicht. "20328" - Der Kalenderbegriff existiert nicht im Kalender-Objekt.

Anmerkungen

Mit der Script-Funktion addieren Sie Tage zu einem angegebenen Datum. Optional können Sie diese Rechenoperation auch in Abhängigkeit von einem Kalender und einem Kalenderbegriff ausführen. Es werden dann nur solche Tage berücksichtigt, die im Kalenderbegriff definiert worden sind.

Wird ein bestimmtes Datumsformat angegeben, entspricht das zurückgegebene Datum diesem Format. Wird kein Datumsformat angeben, müssen die Formate "JJMMTT" oder "JJJJMMTT" für das Datum verwendet werden. Es wird im selben Format zurückgegeben. Als Trennzeichen zwischen Datumsformat und Datum sind Doppelpunkt oder Semikolon erlaubt.

Insbesondere sei auf die Möglichkeit hingewiesen, die Anzahl der Tage gleich Null zu setzen. Wenn das angegebene Datum in den Kalenderbegriff fällt, wird das Datum selbst zurückgegeben, ansonsten das vorhergehende gültige Datum laut Kalenderbegriff.

Bei der Datumsberechnung wird der Bereich des angegebenen Kalenders berücksichtigt. Dieser hängt von der Einstellung ab, die der Administrator in der Variablen UC_CLIENT_SETTINGS mit den Keys NOW_MINUS und NOW_PLUS konfiguriert hat. Fällt das errechnete Datum außerhalb des Kalenders, liefert die Script-Funktion den Wert "0" zurück.

Beispiele

Das erste Beispiel addiert zwei Tage zu einem angegebenen Datum. Das Ergebnis ("000401") wird im Aktivierungsprotokoll ausgegeben.

:SET &DATE# = ADD_DAYS("000330", 2)
:PRINT &DATE#

In diesem Beispiel wird das Datum mit einer Script-Variablen übergeben. Da kein Datumsformat angegeben wird, verwendet jedes Datum das Defaultformat "JJMMTT". Das Ergebnis ("000401") wird auch hier im Aktivierungsprotokoll ausgegeben.

:SET &DATE1# = "000330"
:SET &DATE2# = ADD_DAYS(&DATE#, 2)
:PRINT &DATE2#

Im dritten Beispiel wird der nächste gültige Arbeitstag ermittelt. Dazu werden die Definitionen des Firmenkalenders herangezogen. Da das aktuelle Tagesdatum nicht im Defaultformat abgefragt wurde, muss auch bei der Script-Variablen das spezielle Datumsformat angegeben werden.

:SET &CURDATE# = SYS_DATE("DD.MM.YY")
:SET &NWRKDAY# = ADD_DAYS("DD.MM.YY:&CURDATE#", 1, COMPANY, WORKDAY)

Siehe auch:

Script-Sprachmittel - Datum und Zeit

Datums-, Zeit- und Periodenformate

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support