FIRST_OF_PERIOD

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

Syntax

FIRST_OF_PERIOD ([Date Format:]Date, Period Format[, Output Format[, Calendar, Calendar Event]])

Syntax	Beschreibung/Format
Date
Period Format	Siehe Datums-, Zeit- und Periodenformate in Scripts.
Output Format	Formatvorgabe für das ermittelte Datum Format: Script-Literal oder Script-Variable Standardwert: YYMMDD
Calendar	Name des Kalenderobjektes, das für den Periodenbeginn berücksichtigt werden soll Format: AE-Name, Script-Literal oder Script-Variable
Calenda Event	Name des Kalenderereignisses, das 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 - Das Kalenderereignis existiert nicht im Kalender-Objekt 20456 - Im Kalenderereignis ist das Startdatum der Periode nicht enthalten

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

Der Script-Funktion wird ein Datum zugeordnet. Die Angabe eines Datumsformats ist dabei optional. Wird kein 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.

Für diese Funktion gibt es ein spezielles Periodenformat „WS“. Damit wird als erster Tag einer Woche immer der Sonntag 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 Kalenderereignis angegeben werden.

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

Tipp: Verwenden Sie das Script-Statement :ON_ERROR, um Maßnahmen zu definieren, die im Fehlerfall ergriffen werden sollen. Weitere Informationen finden Sie unter Script-Sprachmittel zur Fehlerbehandlung.

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 Aktivierungsreport 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 Aktivierungsreport.

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

Im dritten Beispiel wird der letzte zutreffende Kalendertag eines Quartals ermittelt. Die Richtlinien eines Ausgabeformats werden nicht berücksichtigt.

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

Siehe auch: