Datumsfunktionen - SAP-Dokumentation

Funktion

Erklärung

ALERT_BDATE()

ALERT_BDATE( ALERT ) liefert das Startdatum des frühesten zulässigen Alert/Status des Alert-/Statustyps, der durch ALERT für die derzeitige Selektion vorgegeben ist. Das Argument dieser Funktion ist ein Alert-/Status -Element.

ALERT_EDATE()

ALERT_EDATE( ALERT ) liefert das Endedatum des spätesten gültigen Alert/Status des Alert-/Statustyps, der durch ALERT für die derzeitige Selektion vorgegeben ist. Das Argument dieser Funktion ist ein Alert-/Status -Element.

BUCKET_BDATE()

BUCKET_BDATE( X1 ; ... ; Xn ) liefert das frühestmögliche Startdatum der Perioden, die durch die Zelle(n) , Zeile(n) , und/oder Spalte(n) (nicht Bereiche) X1 bis Xn der Planungs- oder der Hilfstabelle vorgegeben sind. Dieses Datum wird ganzzahlig mit Bezug auf das Datum 01.01.0001 ausgedrückt. Bei den Attributen der Argumentelemente müssen Sie Periodendaten als Datenquelle angeben.

BUCKET_DATE_IN()

BUCKET_DATE_IN( X ; Y1 ; ... ; Yn ) liefert den Wert 1, wenn das Datum X innerhalb der Perioden liegt, die durch die Zelle(en) , Zeile(n) , und/oder Spalte(n) (nicht Bereiche) Y1 bis Yn vorgegeben sind. Andernfalls wird der Wert 0 zurückgeliefert. Das Datum X (z.B. die Funktion TODAY oder DATE()) wird ganzzahlig mit Bezug auf das Datum 01.01.0001 ausgedrückt. Das Argument kann entweder eine Zahl sein, die Sie in einem Dialogfenster Operator/Funktion eingeben, oder eines der Makroelemente Zelle , Zeile oder Spalte aus der Planungs- oder der Hilfstabelle. Bei den Attributen der Argumentelemente Y1 bis Yn müssen Sie Periodendaten als Datenquelle angeben.

BUCKET_DAYS()

BUCKET_DAYS( X1 ; ... ; Xn ) liefert die Anzahl Kalendertage der Perioden, die durch die Zelle(n) , Zeile(n) , und/oder Spalte(n) (nicht Bereiche) X1 bis Xn vorgegeben sind. Bei den Attributen der Argumentelemente müssen Sie Periodendaten als Datenquelle angeben.

BUCKET_EDATE()

BUCKET_EDATE( X1 ; ... ; Xn ) liefert as späteste Endedatum der Perioden, die durch die Zelle(n) , Zeile(n) , und/oder Spalte(n) (nicht Bereiche) X1 bis Xn vorgegeben sind. Dieses Datum wird ganzzahlig mit Bezug auf das Datum 01.01.0001 ausgedrückt. Bei den Attributen der Argumentelemente müssen Sie Periodendaten als Datenquelle angeben.

BUCKET_FISCAL_PERIOD()

Siehe FISCAL_PERIOD()

BUCKET_WDAYS()

BUCKET_WDAYS( <Kalender> ; X1 ; ... ; Xn ) liefert die Anzahl Arbeitstage in den Perioden, die durch die Zelle(n) , Zeile(n) , und/oder Spalte(n) (nicht Bereiche) X1 bis Xn vorgegeben sind. Bei den Attributen der Argumentelemente müssen Sie Periodendaten als Datenquelle angeben. Die Angabe eines Kalenders als erstes Argument ist optional. Wenn Sie keinen Kalender angeben, dann liest das System den Kalender, der durch den Zeitstrahl im Speicherzeitraster vorgegeben ist. Wenn kein Zeitstrahl definiert ist, dann arbeitet das System mit Kalendertagen.

CALENDAR_WDAYS()

CALENDAR_WDAYS( ‘Kalender’ ; Von-Datum ; <Bis-Datum> ) liefert die im angegebenen Kalender enthaltene Anzahl Arbeitstage zwischen dem Von-Datum und Bis-Datum. Der Kalender ist die Zeitstrahl-ID.

DATE()

DATE( YYYYMMDD ) liefert den ganzzahligen Wert, der der Anzahl Tage zwischen dem 01.01.0001 und dem angegebenen Datum entspricht. Das Datum DD.MM.YYYY geben Sie im Format YYYYMMDD in einem Dialogfenster Operator/Funktion ein. Beispiel: DATE( 19990101 ) = 729756. Nutzen Sie diese Funktion zur Aufnahme eines festen, bekannten Datums in ein Makro.

DATE_TO_CHAR ()

Syntax

DATE_TO_CHAR ( Anzahl Tage )

Anzahl Tage : Anzahl Tage seit 01.01.0001.

Beschreibung

DATE_TO_CHAR () liefert das Datum als eine Zeichenkette zurück.Die Funktion berechnet das Datum, indem sie am 01.01.0001 beginnt und die Anzahl Tage addiert. Das System benutzt das Datumsformat, das in den Benutzerstammdaten gesichert ist.

DAY()

DAY( X ) liefert den Tag innerhalb eines Datums, der im ganzzahligen Format mit Bezug auf das Datum 01.01.0001 ausgedrückt wird. Beispiel: DAY( DATE( 19990220 )) = 20. Das Argument kann entweder eine Zahl sein, die Sie in einem Dialogfenster Operator/Funktion eingeben, oder eines der Makroelemente Zelle , Zeile oder Spalte aus der Planungs- oder der Hilfstabelle.

FISCAL_BDATE()

FISCAL_BDATE( X; ’Geschäftsjahresvariante’ ) liefert den Beginn der Buchungsperiode, die das Datum X enthält (ausgedrückt im ganzzahligen Format mit Bezug auf das Datum 01.01.0001). Sie können das Datum eingeben als DATE ( 19990101 ) oder andere Datumsfunktionen verwenden, z.B. BUCKET_EDATE(). Das zweite Argument gibt die Geschäftsjahresvariante an.

FISCAL_EDATE()

FISCAL_EDATE( X; ’Geschäftsjahresvariante’ ) liefert das Ende der Buchungsperiode, die das Datum X enthält (ausgedrückt im ganzzahligen Format mit Bezug auf das Datum 01.01.0001). Sie können das Datum eingeben als DATE ( 19990101 ) oder andere Datumsfunktionen verwenden, z.B. BUCKET_EDATE(). Das zweite Argument gibt die Geschäftsjahresvariante an.

FISCAL_PERIOD()

FISCAL_PERIOD(X) liefert die Nummer der durch Spalte X vorgegebenen Buchungsperiode.

FISCAL_YEAR

FISCAL_YEAR (X) liefert das Geschäftsjahr der durch Spalte X vorgegebenen Periode.

MONTH()

MONTH( X ) liefert den Monat innerhalb eines Datums X, der im ganzzahligen Format mit Bezug auf das Datum 01.01.0001 ausgedrückt wird. Beispiel: MONTH( DATE( 19990220 )) = 2. Das Argument kann entweder eine Zahl sein, die Sie in einem Dialogfenster Operator/Funktion eingeben, oder eines der Makroelemente Zelle , Zeile oder Spalte aus der Planungs- oder der Hilfstabelle.

MONTH_BDATE()

MONTH_BDATE( X ) liefert das Startdatum des Monats, der im Argument vorgegeben ist, in ganzzahligem Format mit Bezug auf das Datum 01.01.0001.

MONTH_EDATE()

MONTH_EDATE( X ) liefert das Endedatum des Monats, der im Argument vorgegeben ist, in ganzzahligem Format mit Bezug auf das Datum 01.01.0001.

PRODUCT_PHIN_END oder PRODUCT_PHIN_END()

PRODUCT_PHIN_END( <'GRID=2'> ;<'Produkt'> ) liefert das Endedatum der Einführungsphase des angegebenen Produkts, und zwar so, wie es für das Phase-in-Profil im Produktstammsatz gepflegt wurde. Die Argumente für Grid 2 und Produkt sind optional. Wenn Sie kein Produkt angeben, liefert das System das Endedatum der Phase-in-Zeitspanne (Einführungszeitspanne) des derzeit beplanten Produkts. Aus Performance-Gründen empfiehlt SAP jedoch, zur Abbildung des aktuellen Produkts die Funktion ACT_PRODUCT zu verwenden.

PRODUCT_PHIN_START oder PRODUCT_PHIN_START()

PRODUCT_PHIN_START( <'GRID=2'> ;<'Produkt'> ) liefert das Anfangsdatum der Einführungsphase des angegebenen Produkts, und zwar so, wie es für das Phase-in-Profil im Produktstammsatz gepflegt wurde. Die Argumente für Grid 2 und Produkt sind optional. Wenn Sie kein Produkt angeben, liefert das System das Anfangsdatum der Phase-in-Zeitspanne (Einführungszeitspanne) des derzeit beplanten Produkts. Aus Performance-Gründen empfiehlt SAP jedoch, zur Abbildung des aktuellen Produkts die Funktion ACT_PRODUCT zu verwenden.

PRODUCT_PHOUT_END oder PRODUCT_PHOUT_END()

PRODUCT_PHOUT_END( <'GRID=2'> ;<'Produkt'> ) liefert das Endedatum der Auslaufphase des angegebenen Produkts, und zwar so, wie es für das Phase-out-Profil im Produktstammsatz gepflegt wurde. Die Argumente für Grid 2 und Produkt sind optional. Wenn Sie kein Produkt angeben, liefert das System das Endedatum der Phase-out-Zeitspanne (Auslaufzeitspanne) des derzeit beplanten Produkts. Aus Performance-Gründen empfiehlt SAP jedoch, zur Abbildung des aktuellen Produkts die Funktion ACT_PRODUCT zu verwenden.

PRODUCT_PHOUT_START oder PRODUCT_PHOUT_START()

PRODUCT_PHOUT_START( <'GRID=2'> ;<'Produkt'> ) liefert das Anfangsdatum der Auslaufphase des angegebenen Produkts, und zwar so, wie es für das Phase-out-Profil im Produktstammsatz gepflegt wurde. Die Argumente für Grid 2 und Produkt sind optional. Wenn Sie kein Produkt angeben, liefert das System das Anfangsdatum der Phase-out-Zeitspanne (Auslaufzeitspanne) des derzeit beplanten Produkts. Aus Performance-Gründen empfiehlt SAP jedoch, zur Abbildung des aktuellen Produkts die Funktion ACT_PRODUCT zu verwenden.

QUARTER()

Syntax

QUARTER ( Anzahl Tage )

Anzahl Tage : Anzahl Tage seit 01.01.0001.

Beschreibung

QUARTER() liefert das Quartal zurück (als eine Zahl zwischen 1 und 4), in dem das Datum, ausgedrückt als die Anzahl Tage seit 01.01.0001, liegt. Sie können ein Datum mit normalem Format in das Anzahl-Tage-Format konvertieren, indem Sie folgende Funktionen benutzen: DATE oder TODAY.

QUARTER_BDATE()

Syntax

QUARTER_BDATE ( Anzahl Tage )

Anzahl Tage : Anzahl Tage seit 01.01.0001.

Beschreibung

QUARTER_BDATE() liefert das erste Datum des Quartals zurück, in dem das Datum, ausgedrückt als Anzahl Tage seit 01.01.0001, liegt. Sie können ein Datum mit normalem Format in das Anzahl-Tage-Format konvertieren, indem Sie folgende Funktionen benutzen: DATE oder TODAY.

QUARTER_EDATE()

Syntax

QUARTER_EDATE ( Anzahl Tage )

Anzahl Tage : Anzahl Tage seit 01.01.0001.

Beschreibung

QUARTER_EDATE() liefert das letzte Datum des Quartals zurück, in dem das Datum, ausgedrückt als Anzahl Tage seit 01.01.0001, liegt. Sie können ein Datum mit normalem Format in das Anzahl-Tage-Format konvertieren, indem Sie folgende Funktionen benutzen: DATE oder TODAY.

SEASON_BDATE

Syntax

SEASON_BDATE ( Spalte )

Spalte : Zeilen-, Spalten- oder Zellenelement (Datenquelle = Spaltenattribute)

Beschreibung

Die Funktion SEASON_BDATE ermittelt das Startdatum einer Saison, wenn alle für das Planungsobjekt selektierten Merkmalswertekombinationen dasselbe Startdatum haben.

SEASON_EDATE

Syntax

SEASON_EDATE ( Spalte )

Spalte : Zeilen-, Spalten- oder Zellenelement (Datenquelle = Spaltenattribute)

Beschreibung

Die Funktion SEASON_EDATE ermittelt das Endedatum einer Saison, wenn alle für das Planungsobjekt selektierten Merkmalswertekombinationen dasselbe Endedatum haben.

TIMESHIFT_BACKWARDS()

Syntax

TIMESHIFT_BACKWARDS( <’E’;> Bereich 1 ; Bereich 2 )

‘E’: optionaler Parameter zur Steuerung des Verhaltens am Ende der Periode

Bereich 1: Name des Bereichs, der die zu verschiebenden Daten enthält

Bereich 2: Name des Bereichs, der die Offsets enthält

Die beiden Bereiche sollten dieselbe Länge haben und nur aus einer Zeile bestehen.

Beschreibung

TIMESHIFT_BACKWARDS() verschiebt die Werte der Zeitreihe in Bereich 1 zeitlich um die Anzahl Perioden zurück, die in Bereich 2 angegeben ist. Wenn Sie den optionalen Parameter ‘E’ setzen, gehen Werte, die über die erste Periode in Bereich 1 hinaus zurück verschoben werden, verloren, andernfalls werden sie zur ersten Periode hinzu addiert.

Beispiel:

Die Zeitreihen sehen wie folgt aus:

Bereich 1 10 20 30 40 50

Bereich 2 1 2 1 3

Das Ergebnis sieht wie folgt aus, wenn Parameter E gesetzt wurde:

Ergebnis 40 30 0 50 0

Wenn E nicht gesetzt ist, lautet das Ergebnis wie folgt:

Ergebnis 70 30 0 50 0

TIMESHIFT_FORWARDS()

Syntax

TIMESHIFT_FORWARDS( <’E’;> Bereich 1 ; Bereich 2 )

‘E’: optionaler Parameter zur Steuerung des Verhaltens am Ende der Periode

Bereich 1: Name des Bereichs, der die zu verschiebenden Daten enthält

Bereich 2: Name des Bereichs, der die Offsets enthält

Die beiden Bereiche sollten dieselbe Länge haben und nur aus einer Zeile bestehen.

Beschreibung

TIMESHIFT_FORWARDS() verschiebt die Werte der Zeitreihe in Bereich 1 zeitlich um die Anzahl Perioden nach vorn, die in Bereich 2 angegeben ist. Wenn Sie den optionalen Parameter ‘E’ setzen, gehen Werte, die über die letzte Periode in Bereich 1 hinaus verschoben werden, verloren, andernfalls werden sie zur letzten Periode hinzu addiert.

TODAY

TODAY liefert das Tagesdatum im ganzzahligen Format mit Bezug auf das Datum 01.01.0001. Diese Funktion können Sie z.B. als Argument einer anderen Funktion nutzen:

DAY ( TODAY )

WEEK ( TODAY )

MONTH ( TODAY )

PRODUCT_LIFE ( TODAY )

WEEKDAY ( TODAY )

WEEK_BDATE( TODAY )

WEEK_EDATE( TODAY )

YEAR ( TODAY )

YEAR_BDATE( TODAY )

YEAR_EDATE( TODAY )

BUCKET_DATE_IN ( TODAY ; ... )

WEEK()

WEEK( X ) liefert die Woche innerhalb eines Datums X, die im ganzzahligen Format mit Bezug auf das Datum 01.01.0001 ausgedrückt wird. Beispiel: WEEK( DATE( 20001220 )) = 51. Das Argument kann entweder eine Zahl sein, die Sie in einem Dialogfenster Operator/Funktion eingeben, oder eines der Makroelemente Zelle , Zeile oder Spalte aus der Planungs- oder der Hilfstabelle.

WEEK_BDATE()

WEEK_BDATE( X ) liefert das Anfangsdatum der Woche, in die der angegebene Tag X fällt. Beispiel: Wenn heute Mittwoch, der 20. Dezember im Jahr 2000 ist, dann liefert WEEK_BDATE( TODAY ) den Wert 20001218.

WEEK_EDATE()

WEEK_EDATE( X ) liefert das Endedatum der Woche, in die der angegebene Tag X fällt. Beispiel: Wenn heute Mittwoch, der 20. Dezember im Jahr 2000 ist, dann liefert WEEK_EDATE( TODAY ) den Wert 20001224.

YEAR_BDATE()

YEAR_BDATE( X ) liefert das Anfangsdatum des Jahres, in das der angegebene Tag X fällt. Beispiel: Wenn heute Mittwoch, der 20. Dezember im Jahr 2000 ist, dann liefert YEAR_BDATE( TODAY ) den Wert 20000101.

YEAR_EDATE()

YEAR_EDATE( X ) liefert das Endedatum des Jahres, in das der angegebene Tag X fällt. Beispiel: Wenn heute Mittwoch, der 20. Dezember im Jahr 2000 ist, dann liefert YEAR_EDATE( TODAY ) den Wert 20001231.

WEEKDAY()

WEEKDAY( X ) liefert als Zahl zwischen 1 und 7 den Wochentag eines Datums, der in ganzzahligem Format mit Bezug aufdas Datum 01.01.0001 ausgedrückt wird; hierbei ist 1 = Montag und 7 = Sonntag. Beispielsweise liefert WEEKDAY( DATE( 19990120 ) ) für den 20. Januar 1999 den Wert 3. Das Argument kann entweder eine Zahl sein, die Sie in einem Dialogfenster Operator/Funktion eingeben, oder eines der Makroelemente Zelle , Zeile oder Spalte aus der Planungs- oder der Hilfstabelle.

YEAR()

YEAR( X ) liefert das Jahr eines Datums, das in ganzzahligem Format mit Bezug auf das Datum 0001/01/01 ausgedrückt wird. Beispiel: Für den 20. Januar 1999 liefert YEAR( DATE( 19990120 ) ) den Wert 1999. Das Argument kann entweder eine Zahl sein, die Sie in einem Dialogfenster Operator/Funktion eingeben, oder eines der Makroelemente Zelle , Zeile oder Spalte aus der Planungs- oder der Hilfstabelle.