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

FIRST_OF_PERIOD

Script-Funktion: Ermittelt den ersten Tag der Periode für ein angegebenes Datum.

Syntax

FIRST_OF_PERIOD (Date, Period Format, [Output Format, [[Calendar], [Calendar Keyword]])

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	Angabe eines gültigen Periodenformates.
Ausgabeformat	Formatvorgabe für das ermittelte Datum. Format: Script-Literal oder Script-Variable Standardwert: YYMMDD
Kalender	Name des Kalenders, der für den Periodenbeginn berücksichtigt werden soll. Format: AE-Name, Script-Literal oder Script-Variable
Kalenderbegriff	Name des Kalenderbegriffs, der für den Periodenbeginn berücksichtigt werden soll. Format: AE-Name, Script-Literal oder Script-Variable

Rückgabewerte
Datum des Periodenbeginns im angegebenen Format. "20327" - Das Kalender-Objekt existiert nicht. "20328" - Der Kalenderbegriff existiert nicht im Kalender-Objekt. "20456" - Im Kalenderbegriff ist das Startdatum der Periode nicht enthalten.

Anmerkungen

Die Script-Funktion ermittelt den ersten Tag der Periode, zu der ein angegebenes Datum gehört. Der Script-Funktion wird ein Datum übergeben.

Die Angabe des Datumsformats Die Angabe eines Datumsformats ist 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.

Mit Periodenformat wird die Art der Periode (Jahr, Quartal, Monat oder Woche) festgelegt.
Hinweis: Für diese Script-Funktion gibt es das spezielle Periodenformat "WS". Damit wird als letzter Tag einer Woche immer der Samstag genommen. "WW" hingegen geht stets vom Sonntag als letzten Tag der Woche aus.

Ausgabeformat ist optional. Wird Ausgabeformat nicht verwendet, liefert die Script-Funktion ein Datum mit dem Standardformat "JJMMTT" zurück. Bitte beachten Sie: Kommata sind auch zu setzen, wenn Ausgabeformat nicht verwendet wird, aber Kalender und Kalenderbegriff angegeben werden.

Werden Kalender und Kalenderbegriff verwendet, gibt die Script-Funktion den letzten zutreffenden Kalendertag der Periode zurück. Gibt es keinen gültigen Kalendertag für diese Periode, ist das Ergebnis ein Null-Datum im jeweiligen Datumsformat (z.B.: 0000-00-00).

Mit der Script-Anweisung :ON_ERROR legen Sie die Reaktion auf diesen Fehler fest. Wie bisher können Sie ihn mit den Script-Funktionen zur Fehlerbehandlung analysieren. Das Script wird weiter prozessiert. Es besteht aber auch die Möglichkeit, die Prozessierung des Scripts abzubrechen.

Beispiele

Das erste Beispiel ermittelt, den ersten Tag der Woche für den 29.3.2000. Als Ergebnis wird der 27.03.00 (Montag) im Aktivierungsprotokoll ausgegeben.

:SET &DATE# = FIRST_OF_PERIOD ("000329","WW","DD.MM.YY")
:PRINT &DATE#

Mit dem speziellen Periodenformat "WS" steht der 26.03.00 (Sonntag) als Ergebnis im Aktivierungsprotokoll.

:SET &DATE# = FIRST_OF_PERIOD ("DD.MM.YY:29.03.00","WS","DD.MM.YY")
:PRINT &DATE#

Im dritten Beispiel wird der erste zutreffende Kalendertag eines Quartals ermittelt. Auf die Vorgabe eines Ausgabeformates wird dabei verzichtet.

:SET &DATE# = FIRST_OF_PERIOD ("000329", "Q", , READINESS, WEEKDAY)
:PRINT &DATE#

Siehe auch:

Script-Sprachmittel	Beschreibung
LAST_OF_PERIOD	Ermittelt den letzten Tag der Periode für ein angegebenes Datum.
:ON_ERROR	Legt die Reaktion auf bestimmte Fehler bzw. Meldungen von Script-Sprachmitteln fest.

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