ADD_DAYS

Verwenden Sie die Script-Funktion ADD_DAYS, um Tage zu einem bestimmten Datum zu addieren. Mit dieser Funktion können Sie optional das Datum abhängig von Kalenderereignissen berechnen, die in einem Kalenderobjekt definiert sind.

Syntax

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

Parameter

• ADD_DAYS
  Addiert eine Anzahl von Tagen zu einem bestimmten Datum

• Datumsformat
  (Optional) Geben Sie ein Format gefolgt von einem Doppelpunkt als Trennzeichen an (;)
  Weitere Informationen: Datums-, Zeit- und Periodenformate in Scripts

• Datum
  Gibt das Datum an
  Format: Script-Literal oder Script-Variable
  Hinweis:

  • Das Datumsformat gilt sowohl für das von Ihnen angegebene Datum als auch für das Datum, das die Script-Funktion zurückgibt.
  • Wenn Sie kein Datumsformat angeben, verwenden Sie YYMMDD oder YYYYMMDD

• Tage
  Anzahl der Tage, die dem Datum hinzugefügt 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
  Weitere Informationen:Kalender (CALE)

• 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 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 ADD_DAYS-Funktion angegeben.

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

Siehe auch: