Automation Engine Script-Leitfaden > Funktionelle Gliederung > Datum und Zeit > ADD_PERIOD

ADD_PERIOD

Script-Funktion: Addiert eine Periode zu einem angegebenen Datum.

Syntax

ADD_PERIOD(Date, Period Format:Period, [Output Format])

Syntax	Beschreibung/Format
Datum	Angabe eines Datums im Format "YYMMDD" oder "YYYYMMDD". Format: Script-Literal oder Script-Variable Es ist auch möglich, ein anderes Datumsformat auszuwählen. Geben Sie dazu zuerst das gewünschte Datumsformat, ein Trennzeichen (: oder ;) und danach das Datum an. Die Angabe des Datumsformats ist optional.
Periodenformat:Periode	Format: Script-Literal oder Script-Variable Periode: Angabe einer Periode, die zum angegebenen Datum addiert werden soll. Periodenformat: Formatvorgabe für die Periode. Als Trennzeichen zwischen dem Periodenformat und der Periode ist ein Doppelpunkt (:) oder ein Semikolon (;) erlaubt.
Ausgabeformat	Formatvorgabe für das ermittelte Datum. Format: AE-Name, Script-Literal oder Script-Variable Standardwert: "JJMMTT"

Syntax

Beschreibung/Format

Datum

Angabe eines Datums im Format "YYMMDD" oder "YYYYMMDD".

Format: Script-Literal oder Script-Variable

Es ist auch möglich, ein anderes Datumsformat auszuwählen. Geben Sie dazu zuerst das gewünschte Datumsformat, ein Trennzeichen (: oder ;) und danach das Datum an. Die Angabe des Datumsformats ist optional.

Periodenformat:Periode

Format: Script-Literal oder Script-Variable

Periode: Angabe einer Periode, die zum angegebenen Datum addiert werden soll.
Periodenformat: Formatvorgabe für die Periode.

Als Trennzeichen zwischen dem Periodenformat und der Periode ist ein Doppelpunkt (:) oder ein Semikolon (;) erlaubt.

Ausgabeformat

Formatvorgabe für das ermittelte Datum.
Format: AE-Name, Script-Literal oder Script-Variable
Standardwert: "JJMMTT"

Rückgabewert
Datum im angegebenen Format.

Anmerkungen

Die Script-Funktion zählt zu einem angegebenen Datum Jahre, Monate, Quartale oder Wochen hinzu.

Der Script-Funktion wird ein Datum übergeben. Eine explizite Angabe des Datumsformats ist dabei optional. Wird kein bestimmtes Datumsformat verwendet, muss das Datum in den Formaten "JJMMTT" oder "JJJJMMTT" angegeben werden. Als Trennzeichen zwischen Datumsformat und Datum sind Doppelpunkt oder Semikolon erlaubt.

Zum angegebenen Datum wird die Periode addiert. Periode kann eine beliebige Zahl sein. Ist das Ergebnis ein Datum, welches nach dem 31.12.9999 liegen würde, führt das zu einem Fehler.

Ausgabeformat ist optional. Wird Ausgabeformat nicht verwendet, liefert die Script-Funktion ein Datum mit dem Defaultformat "JJMMTT" zurück.

Beispiele

Das erste Beispiel addiert zwei Wochen zum 6.3.2000. Das Ergebnis (20.03.2000) wird im Report ausgegeben.

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

Das zweite Beispiel addiert ein Quartal zum 31.1.2000. Das Ergebnis (30-04-2000) wird im Report ausgegeben.

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

Im dritten Beispiel wird ein Jahr zum 29.2.2000 addiert. Als Ergebnis wird 28.02.2001 im Report ausgegeben, denn das Jahr 2001 ist kein Schaltjahr.

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

Siehe auch:

Script-Sprachmittel - Datum und Zeit

Datums-, Zeit- und Periodenformate

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support