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

SUB_DAYS

Script-Funktion: Subtrahiert Tage von angegebenem Datum.

Syntax

SUB_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 entsprechenden Kalenders. 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 subtrahieren Sie Tage von einem angegebenen Datum. Optional können Sie diese Rechenoperationen auch in Abhängigkeit von einem Kalender und einem Kalenderbegriff ausführen. Es werden dann nur solche Tage berücksichtigt, die laut Definition im Kalender gültig sind.

Wird ein bestimmtes Datumsformat angegeben, entspricht das zurückgegebene Datum diesem Format. Wird kein Datumsformat verwendet, muss das Datum in den Formaten "JJMMTT" oder "JJJJMMTT" angegeben 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 subtrahiert zwei Tage von einem angegebenen Datum. Das Ergebnis ("000330") wird im Aktivierungsprotokoll ausgegeben.

:SET &DATE# = SUB_DAYS("000401", 2)
:PRINT &DATE#

Das zweite Beispiel erfragt durch eine Script-Anweisung die Anzahl von Tagen vom Benutzer, die aufzuheben ist. Mit der Funktion wird diese Anzahl vom aktuellen Tagesdatum abgezogen und in einer Script-Variablen hinterlegt. Da kein Datumsformat angegeben wird, verwendet jedes Datum das Defaultformat "JJMMTT".

:SET &CURDATE# = SYS_DATE()
:READ &NUMBER#,"00","Store how many days?","08",N
:SET &RETDATE# = SUB_DAYS(&CURRENTDATE#, &NUMBER#)

Im dritten Beispiel wird das aktuelle Datum ermittelt. Davon werden anschließend zwei Tage abgezogen. Da das aktuelle Tagesdatum nicht im Standardformat abgefragt wurde, muss auch bei der Script-Variablen das spezielle Datumsformat angegeben werden.

:SET &CURDATE# = SYS_DATE("DD.MM.YY")
:SET &PWRKDAY# = SUB_DAYS("DD.MM.YY:&CURDATE#", 2)

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