Verwenden Sie die Script-Funktion SUB_DAYS, um eine Anzahl von Tagen von einem bestimmten Datum abzuziehen. Mit dieser Funktion können Sie optional das Datum abhängig von Kalenderereignissen berechnen, die in einem Kalenderobjekt definiert sind.
Syntax
SUB_DAYS ([Date Format:]Date, Days[, Calendar, Calendar Event])
Parameter
-
SUB_DAYS
Subtrahiert eine Anzahl von Tagen von einem bestimmten Datum -
Date
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 vom Datum zu subtrahierenden Tage
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 subtrahiert zwei Tage vom angegebenen Datum. Das Datum ist im Standardformat YYMMDD. Das Script gibt das Ergebnis (000330) im Aktivierungsreport aus.
:SET &DATE# = SUB_DAYS("000401", 2)
:PRINT &DATE#
Im folgenden Beispiel kann ein Benutzer definieren, wie lange er etwas speichern möchte. Das Script weist das aktuelle Datum einer Script-Variablen zu und fragt den Benutzer mit einem :READ-Statement nach der Anzahl der Tage ab. Die Funktion SUB_DAYS zieht die vom Benutzer angegebene Zahl vom aktuellen Datum ab.
:SET &CURRENTDATE# = SYS_DATE()
:READ &NUMBER#,"00","Enter how many days you want to store","08",N
:SET &RETDATE# = SUB_DAYS(&CURRENTDATE#, &NUMBER#)
Das folgende Beispiel ruft das aktuelle Datum ab und zieht zwei Tage ab. Das aktuelle Datum ist nicht im Standarddatumsformat. Das spezielle Datumsformat wird in den Parametern der Funktion SUB_DAYS angegeben.
:SET &CURDATE# = SYS_DATE("DD.MM.YY")
:SET &PWRKDAY# = SUB_DAYS("DD.MM.YY:&CURDATE#", 2)
Siehe auch: