Verwenden Sie die Script-Funktion ADD_DAYS, um Tage zu einem bestimmten Datum hinzuzufügen. Mit dieser Funktion können Sie optional das Datum abhängig von Kalenderereignissen berechnen, die in einem Kalenderobjekt definiert sind.
Syntax
ADD_DAYS ([Date Format:]Date, Days[, Calendar, Calendar Event])
Parameter
-
ADD_DAYS
Fügt eine Anzahl von Tagen zu einem bestimmten Datum hinzu -
Date Format
Gibt das Datum im Format YYMMDD oder YYYYMMDD an
Hinweis: Das Datumsformat gilt sowohl für das von Ihnen angegebene Datum als auch für das Datum, das die Script-Funktion zurückgibt.
Format: Script-Literal oder Script-Variable
(Optional) Um ein anderes Format zu verwenden, geben Sie das gewünschte Datumsformat gefolgt von einem Trennzeichen (: oder ;) und das Datum ein. -
Days
Anzahl der Tage, die zum Datum hinzugefügt werden sollen
Format: Script-Literal, Zahl ohne Anführungszeichen oder Script-Variable
Tipp: Geben Sie 0 Tage an, um ein Datum gegen ein Kalenderobjekt zu validieren. Wenn das Datum gemäß dem Kalender gültig ist, gibt die Script-Funktion das angegebene Datum zurück. Wenn das Datum nicht gültig ist, gibt die Script-Funktion das vorherige gültige Datum aufgrund von Kalenderbedingungen zurück. -
Calendar
(Optional) Name eines Kalenderobjekts
Wenn Sie ein Kalenderobjekt festlegen, berücksichtigt die Berechnung nur Tage, die in Kalenderereignisses im Kalenderobjekt definiert sind.
Format: AE-Name, Script-Literal oder Script-Variable -
Calendar Event
(Optional) Name eines Kalenderereignisses, wenn Sie ein Kalenderobjekt festlegen
Format: AE-Name, Script-Literal oder Script-Variable
Rückgabewerte
Diese Script-Funktion hat die folgenden Rückgabewerte:
- 0
Dem Kalenderereignis sind keine Tage zugeordnet, oder das berechnete Datum liegt außerhalb des Kalenderbereichs - 20327
Kalenderobjekt existiert nicht - 20328
Kalenderereignis existiert nicht im Kalender-Objekt
Hinweis: Die Kalenderberechnung berücksichtigt automatisch den Bereich des angegebenen Kalenders. Der Kalenderbereich hängt von den Mandanten-Einstellungen NOW_MINUS und NOW_PLUS ab. Weitere Informationen finden Sie unter UC_CLIENT_SETTINGS - Diverse Mandanten-Einstellungen.
Beispiele
Das folgende Beispiel fügt zwei Tage zum angegebenen Datum hinzu. Das Datum ist im Standardformat YYMMDD. Das Script gibt das Ergebnis (000401) im Aktivierungsreport aus.
:SET &DATE# = ADD_DAYS("000330", 2)
:PRINT &DATE#
Das folgende Beispiel weist das aktuelle Datum einer Script-Variablen zu und verwendet das Standarddatumsformat YYMMDD. Das Script gibt das Ergebnis (000401) im Aktivierungsreport aus.
:SET &DATE1# = "000330"
:SET &DATE2# = ADD_DAYS(&DATE1#, 2)
:PRINT &DATE2#
Das folgende Beispiel ruft das aktuelle Datum in einem Format ab, das nicht das Standarddatumsformat für ADD_DAYS ist. Die ADD_DAYS-Funktion ruft den nächsten gültigen Werktag ab, indem sie die Definitionen in einem Kalenderobjekt mit dem Namen COMPANY verwendet. Das spezielle Datumsformat wird in den Parametern der Funktion ADD_DAYS angegeben.
:SET &CURDATE# = SYS_DATE("DD.MM.YY")
:SET &NWRKDAY# = ADD_DAYS("DD.MM.YY:&CURDATE#", 1, COMPANY, WORKDAY)
Siehe auch: