Ansicht
Dokumentation
ABENCDS_F1_TIMEZONE_FUNCTIONS - CDS F1 TIMEZONE FUNCTIONS
CPI1466 during Backup ABAP Short ReferenceDiese Dokumentation steht unter dem Copyright der SAP AG.
- Zeitzonenfunktionen
... ABAP_SYSTEM_TIMEZONE(clnt,on_error)
$| ABAP_USER_TIMEZONE(user,clnt,on_error) ...
Varianten:
1. ... ABAP_SYSTEM_TIMEZONE(clnt,on_error)
2. ... ABAP_USER_TIMEZONE(user,clnt,on_error)
Wirkung
Diese Funktionen geben in einer CDS-View die mandantenabhängige
Systemzeitzone und die benutzerabhängige
Benutzerzeitzone
des aktuellen AS ABAP zurück. Die Funktionen haben positionale Parameter, denen beim Aufruf Aktualparameter
zugeordnet werden müssen. Es gibt derzeit keine optionalen Parameter. Als Aktualparameter können passende Felder einer
Datenquelle,
Literale,
Parameter,
Pfadausdrücke, eingebaute
Funktionen oder Ausdrücke angegeben werden. An den Parameter
on_error können ausschließlich Literale übergeben werden. Wenn ein Aktualparameter den
Null-Wert enthält, gibt jede Funktion einen Null-Wert zurück.
Variante 1
... ABAP_SYSTEM_TIMEZONE(clnt,on_error)
Wirkung
Die Funktion ABAP_SYSTEM_TIMEZONE gibt die Systemzeitzone des AS ABAP für den mit clnt angegebenen Mandant zurück. Der Aktualparameter clnt muss vom eingebauten Dictionary-Typ CLNT sein und eine gültige Mandantenkennung enthalten. Das Ergebnis ist vom Typ CHAR der Länge 6. Wenn die Systemzeitzone nicht festgestellt werden kann, kommt es zu einem Fehler.
Der Aktualparameter on_error steuert die Fehlerbehandlung. Er muss vom eingebauten Datentyp CHAR der Länge 10 sein und muss einen der folgenden Werte haben:
- "FAIL", ein Fehler führt zu einer Ausnahme
- "NULL", ein Fehler führt zur Rückgabe des Null-Werts
- "INITIAL" ein Fehler führt zur Rückgabe des Initialwerts
Die Groß-/Kleinschreibung wird berücksichtigt. Ein falsch angegebener Wert führt zu einer Ausnahme.
Hinweis
Die zurückgegebene Systemzeitzone ist der mandantenabhängige Inhalt der Spalte TZONESYS der Datenbanktabelle TTZCU.
Variante 2
... ABAP_USER_TIMEZONE(user,clnt,on_error)
Wirkung
Die Funktion ABAP_USER_TIMEZONE gibt die Benutzerzeitzone des AS ABAP für den mit user angegebenen Benutzer und den mit clnt angegebenen Mandant zurück. Der Aktualparameter user muss vom eingebauten Typ CHAR der Länge 12 sein. Für den Aktualparameter clnt gilt das Gleiche wie für die Funktion ABAP_SYSTEM_TIMEZONE. Das Ergebnis ist vom Typ CHAR der Länge 6. Wenn die Benutzerzeitzone nicht festgestellt werden kann, kommt es zu einem Fehler.
Der Aktualparameter on_error steuert die Fehlerbehandlung und es gilt das Gleiche wie bei der Funktion ABAP_SYSTEM_TIMEZONE.
Hinweis
Die zurückgegebene Benutzerzeitzone entspricht für den aktuellen Mandant dem Inhalt des Systemfelds sy-zonlo in ABAP.
Beispiel
Die folgende SELECT-Anweisung gibt die mit den Funktionen ABAP_SYSTEM_TIMEZONE und ABAP_USER_TIMEZONE für den aktuellen Mandant und den aktuellen Benutzer ausgelesenen Werte für Systemzeitzone und Benutzerzeitzone zurück. Die Aktualparameter der Funktionen werden mit den passenden Sitzungsvariablen versorgt. Das Programm DEMO_CDS_TIMEZONE_FUNCTIONS greift auf die View zu, vergleicht die CDS-Werte mit den entsprechenden ABAP-Werten und gibt das Ergebnis aus.
Addresses (Business Address Services) Vendor Master (General Section)
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 7364 Date: 20240523 Time: 174507 sap01-206 ( 88 ms )
