Ansicht
Dokumentation
ABENCDS_TIMEZONE_FUNCTIONS_V2 - CDS TIMEZONE FUNCTIONS V2
Fill RESBD Structure from EBP Component Structure ROGBILLS - Synchronize billing plansDiese Dokumentation steht unter dem Copyright der SAP AG.
- CDS-View-Entität, 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-Entität 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, Ausdrücke, oder Reuse-Ausdrücke mit $projection 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.
Hinweis
Für Benutzerzeitzonen ist auch die
Sitzungsvariable
user_timezone verfügbar. Sie gibt dasselbe Ergebnis als die eingebaute Funktion ABAP_USER_TIMEZONE 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 DDIC-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 ABAP-Benutzer und den mit clnt angegebenen Mandant zurück. Der Aktualparameter user muss vom eingebauten Typ CHAR 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_FUNC_VE greift auf die View zu, vergleicht die CDS-Werte mit den entsprechenden ABAP-Werten und gibt das Ergebnis aus.
CL_GUI_FRONTEND_SERVICES - Frontend Services Addresses (Business Address Services)
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 8223 Date: 20240523 Time: 175051 sap01-206 ( 91 ms )
