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

SUB_PERIOD

Script-Funktion: Subtrahiert eine Periode von einem angegebenen Datum.

Syntax

SUB_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 zieht Jahre, Monate, Quartale oder Wochen von einem angegebenen Datum ab.

Der Script-Funktion wird ein Datum übergeben. Die Angabe eines Datumsformatsist 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.

Vom angegebenen Datum wird die Periode abgezogen. Periode kann eine beliebige Zahl sein. Ist das Ergebnis ein Datum, welches vor dem Jahr 0000 liegen würde, führt das zu einem Fehler.

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

Beachten Sie dies, wenn Sie Jahre, Quartale und Monate subtrahieren.

Beispiel

Das erste Beispiel subtrahiert zwei Wochen vom 5.7.2000. Das Ergebnis (21.06.2000) wird im Report ausgegeben.

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

Das zweite Beispiel subtrahiert ein Quartal vom 31.7.2000. Das Ergebnis (30-04-2000) wird im Report ausgegeben.

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

Im dritten Beispiel wird ein Jahr vom 28.02.2001 subtrahiert. Als Ergebnis wird 28.02.2000 im Report ausgegeben.

:SET &DATE#=SUB_PERIOD ("20010228","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