SUB_DAYS

Verwenden Sie die Script-Funktion SUB_DAYS, um eine Anzahl von Tagen von einem bestimmten Datum zu subtrahieren. Mit dieser Funktion können Sie optional das Datum abhängig von Kalenderereignissen berechnen, die in einem Kalenderobjekt definiert sind.

Syntax

SUB_DAYS ([Datumsformat:]Datum, Tage[, Kalender, Kalenderereignis])

Parameter

• SUB_DAYS
  Subtrahiert eine Anzahl von Tagen von einem bestimmten Datum

• Datum
  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.

• Tage
  Anzahl der Tage, die von dem Datum subtrahiert werden sollen
  Format: Script-Literal, Zahl ohne Anführungszeichen oder Script-Variable
  Tipp: Geben Sie 0 Tage an, um ein Datum für 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 basierend auf Kalenderbedingungen zurück.

• Kalender
  (Optional) Name eines Kalenderobjekts
  Wenn Sie ein Kalenderobjekt angeben, berücksichtigt die Berechnung nur Tage, die in Kalenderereignissen im Kalenderobjekt definiert sind.
  Format:AE-Name, Script-Literal oder Script-Variable

• Kalenderereignis
  (Optional) Name eines Kalenderereignisses, wenn Sie ein Kalenderobjekt angeben
  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
  Das Kalenderobjekt existiert nicht
• 20328
  Das Kalenderereignis existiert nicht im Kalender-Objekt

Hinweis: Die Kalenderberechnung berücksichtigt automatisch den Bereich des angegebenen Kalenders. Der Kalenderbereich hängt von den Mandanteneinstellungen NOW_MINUS und NOW_PLUS ab. Weitere Informationen finden Sie unter UC_CLIENT_SETTINGS - Verschiedene Mandanteneinstellungen.

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 einer :READ-Anweisung nach der Anzahl der Tage ab. Die Funktion SUB_DAYS subtrahiert die vom Benutzer angegebene Zahl vom aktuellen Datum.

:SET &CURRENTDATE# = SYS_DATE()  
:READ &NUMBER#,"00","Geben Sie ein, wie viele Tage Sie speichern möchten","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 SUB_DAYS-Funktion angegeben.

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

Siehe auch: