ADD_PERIOD

Verwenden Sie die Script-Funktion ADD_PERIOD, um einem Datum eine Periode hinzuzufügen. Mit dieser Funktion können Sie Jahre, Monate, Quartale oder Wochen als Perioden angeben. Sie können dem Datum beliebig viele Perioden hinzufügen.

Syntax

ADD_PERIOD ([Datumsformat:]Datum, Periodenformat:Periode[, Ausgabeformat] )

Parameter

• ADD_PERIOD
  Fügt einem Datum Perioden hinzu

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

• Datum
  Datum, das der Periode hinzugefügt werden soll
  Hinweis: Wenn Sie kein anderes Format angeben, wird das Format YYMMDD oder YYYYMMDD verwendet.
  Format: Script-Literal oder Script-Variable

• Periodenformat:Periode
  Gibt das Periodenformat (Jahre, Quartale, Monate oder Wochen) sowie die Anzahl der Perioden an, die dem Datum hinzugefügt werden sollen
  Hinweis: Verwenden Sie : oder ; als Trennzeichen zwischen dem Periodenformat und der Anzahl der Perioden.
  Mehr Informationen:Datums-, Zeit- und Periodenformate in Scripts

• Ausgabeformat
  (Optional) Format des resultierenden Datums
  Format:AE-Name, Script-Literal oder Script-Variable
  Standardformat:YYMMDD

Rückgabewert

Die Script-Funktion gibt das resultierende Datum entweder im Standardformat YYMMDD oder in dem von Ihnen angegebenen Datumsformat zurück. Beachten Sie das Ausgabeformat, wenn Sie Jahre, Quartale und Monate subtrahieren.

Wichtig! Das Script führt zu einem Fehler, wenn das berechnete Datum nach dem Datum 31.12.9999 liegt.

Beispiele

Das folgende Beispiel fügt zwei Wochen zu einem Datum hinzu und gibt das Ergebnis (20.03.2018) im Aktivierungsreport aus.

: SET   &DATE# = ADD_PERIOD ( "DD.MM.YY:06.03.18" , "WW;2" , "DD.MM.YYYY" )
: PRINT   &DATE#

Das folgende Beispiel fügt ein Quartal zu einem Datum hinzu und gibt das Ergebnis (30-04-2018) im Aktivierungsreport aus.

: SET   &DATE# = ADD_PERIOD ( "180131" , "Q:1" , "DD-MM-YYYY" )
: PRINT   &DATE#

Das folgende Beispiel fügt ein Jahr zu einem Datum hinzu und gibt das Ergebnis im Aktivierungsreport aus. Das Script wählt den letzten Tag des Monats Februar im Zieljahr aus, sodass das Ergebnis der 28.2.2001 ist, da 2001 kein Schaltjahr ist.

: SET   &DATE# = ADD_PERIOD ( "20000229" , "YY:0001" ,DD.MM.YYYY)
: PRINT   &DATE#

Siehe auch: