ABAPCOMPUTE_STRING_FORMAT_OPTIONS - COMPUTE STRING FORMAT OPTIONS
ABAP Short Reference Vendor Master (General Section)Diese Dokumentation steht unter dem Copyright der SAP AG.
Eingebettete Ausdrücke - format_options
Syntax
... [WIDTH = len]
[ALIGN = LEFT|RIGHT|CENTER|(val)]
[PAD = c]
[CASE = RAW|UPPER|LOWER|(val)]
[SIGN = LEFT|LEFTPLUS|LEFTSPACE|RIGHT|RIGHTPLUS|RIGHTSPACE|(val)]
[EXPONENT = exp]
[DECIMALS = dec]
[ZERO = YES|NO|(val)]
[STYLE = SIMPLE|SIGN_AS_POSTFIX|SCALE_PRESERVING
|SCIENTIFIC|SCIENTIFIC_WITH_LEADING_ZERO
|SCALE_PRESERVING_SCIENTIFIC|ENGINEERING
|MONETARY|EXTENDED_MONETARY
|(val)]
[CURRENCY = cur]
[NUMBER = RAW|USER|ENVIRONMENT|(val)]
[DATE = RAW|ISO|USER|ENVIRONMENT|(val)]
[TIME = RAW|ISO|USER|ENVIRONMENT|(val)]
[TIMESTAMP = SPACE|ISO|USER|ENVIRONMENT|(val)]
[TIMEZONE = tz]
[COUNTRY = cty] ... .
Zusätze:
1. ... WIDTH = len ...
2. ... ALIGN = LEFT|RIGHT|CENTER|(val) ...
3. ... PAD = c ...
4. ... CASE = RAW|UPPER|LOWER|(val) ...
5. ... SIGN = LEFT|LEFTPLUS|LEFTSPACE|RIGHT|RIGHTPLUS|RIGHTSPACE|(val) ...
6. ... EXPONENT = exp ...
7. ... DECIMALS = dec ...
8. ... ZERO = YES|NO|(val) ...
9. ... STYLE = ...|(val) ...
10. ... CURRENCY = cur ...
11. ... NUMBER = RAW|USER|ENVIRONMENT|(val) ...
12. ... DATE = RAW|ISO|USER|ENVIRONMENT|(val) ...
13. ... TIME = RAW|ISO|USER|ENVIRONMENT|(val) ...
14. ... TIMESTAMP = SPACE|ISO|USER|ENVIRONMENT|(val) ...
15. ... TIMEZONE = tz ...
16. ... COUNTRY = cty ...
Wirkung
Diese Formatierungsoptionen übersteuern dievordefinierten Formate voneingebetteten Ausdrücken inZeichenketten-Templates.Die Formatierungsoptionen werden in der Form von optionalen Schlüsselwortparametern angegeben, denen ein Aktualparameter zugewiesen wird.
Welche Formatierungsoptionen angegeben werden können, hängt vom Datentyp des eingebettetenAusdrucks ab. Die Formatierungsoptionen NUMBER, DATE, TIME, TIMESTAMP und COUNTRY schließen sich gegenseitig aus.
Zusatz 1
... WIDTH = len ...
Wirkung
Diese Formatierungsoption legt die Länge der vom eingebetteten Ausdruck dargestellten Zeichenkette auf den Wert von len fest, wobei len einenumerische Ausdrucksposition ist.
Die Option WIDTH kann für alle Datentypen des eingebetteten Ausdrucks angegeben werden.Wenn der Wert von len kleiner als die minimal benötigte Länge ist, wird die Angabeignoriert. Die vordefinierte Länge kann also nur vergrößert aber nicht verkleinertwerden. Standardmäßig wird die Zeichenkette bei einer Vergrößerung nachrechts verlängert und dort mit Leerzeichen aufgefüllt. Diese Standardeinstellung kann mit den Formatierungsoptionen ALIGN und PAD übersteuert werden.
Beispiel
Siehe Zeichenketten-Templates, Längenangabe
Zusatz 2
... ALIGN = LEFT|RIGHT|CENTER|(val) ...
Wirkung
Diese Formatierungsoption legt die Ausrichtung der vom eingebetteten Ausdruck dargestellten Zeichenkettefest. Sie hat nur eine Wirkung, wenn gleichzeitig mit WIDTH eine Länge festgelegt wird, die größer als die minimal benötigte Länge ist.
Die Ausrichtung kann entweder statisch mit einem der vorgegebenen Parameter oder dynamisch als Inhalt eines in Klammern angegebenen Datenobjekts val angegeben werden. Die möglichen Werte von val sind in der KlasseCL_ABAP_FORMAT als Konstanten definiert.
| Parameter | Wert von val | Wirkung |
| LEFT | CL_ABAP_FORMAT=>A_LEFT | linksbündig |
| RIGHT | CL_ABAP_FORMAT=>A_RIGHT | rechtsbündig |
| CENTER | CL_ABAP_FORMAT=>A_CENTER | mittig |
Die Standardeinstellung ist LEFT. Je nach Ausrichtung werden überzählige Stellenim Ergebnis rechts, links oder abwechselnd rechts und links standardmäßig mit Leerzeichenaufgefüllt. Diese Standardeinstellung kann mit der Formatierungsoption PAD übersteuert werden.
Beispiel
Siehe Zeichenketten-Templates, Ausrichtung und Auffüllen
Zusatz 3
... PAD = c ...
Wirkung
Diese Formatierungsoption legt das Zeichen fest, mit der überzählige Stellen im Ergebnisaufgefüllt werden. Sie hat nur eine Wirkung, wenn gleichzeitig mit WIDTH eine Länge festgelegt wird, die größer als die minimal benötigte Länge ist.
Für c kann ein Datenobjekt vom Datentyp c oder string angegeben werden, dessen erstes Zeichen zum Auffüllen verwendet wird. Wenn dieOption PAD nicht angegeben ist oder für c ein leerer String angegeben wird, wird mit Leerzeichen aufgefüllt.
Beispiel
Siehe Zeichenketten-Templates, Ausrichtung und Auffüllen
Zusatz 4
... CASE = RAW|UPPER|LOWER|(val) ...
Wirkung
Diese Formatierungsoption legt die Groß-/Kleinschreibung der vom eingebetteten Ausdruck dargestellten Zeichenkette fest. Sie kann für alle Datentypen des eingebetteten Ausdrucks angegeben werden.
Die Groß-/Kleinschreibung kann entweder statisch mit einem der vorgegebenen Parameter oder dynamischals Inhalt eines in Klammern angegebenen Datenobjekts val angegeben werden. Die möglichen Werte von val sind in der KlasseCL_ABAP_FORMAT als Konstanten definiert.
| Parameter | Wert von val | Wirkung |
| RAW | CL_ABAP_FORMAT=>C_RAW | unverändert |
| UPPER | CL_ABAP_FORMAT=>C_UPPER | Großschreibung |
| LOWER | CL_ABAP_FORMAT=>C_LOWER | Kleinschreibung |
Die Standardeinstellung ist RAW.
Hinweis
Die Formatierungsoption CASE wirkt auf die Buchstaben der Zeichenkette. Sie wirkt nicht auf einmit PAD angegebenes Auffüllungszeichen. Bei numerischen Datentypen wird das "e" bzw. "E" eines Exponenten beeinflusst, bei byteartigen Datentypen sind es die Buchstaben der Hexadezimaldarstellung.
Beispiel
Siehe Zeichenketten-Templates, Groß-/Kleinschreibung
Zusatz 5
... SIGN = LEFT|LEFTPLUS|LEFTSPACE|RIGHT|RIGHTPLUS|RIGHTSPACE|(val) ...
Wirkung
Diese Formatierungsoption legt das Format des Vorzeichens fest, wenn die vom eingebetteten Ausdruck dargestellte Zeichenkette einen numerischen Wert darstellt. Sie kann nur angegeben werden, wenn der eingebettete Ausdruck einennumerischen Datentyp hat.
Das Format des Vorzeichens kann entweder statisch mit einem der vorgegebenen Parameter oder dynamischals Inhalt eines in Klammern angegebenen Datenobjekts val angegeben werden. Die möglichen Werte von val sind in der KlasseCL_ABAP_FORMAT als Konstanten definiert.
| Parameter | Wert von val | Wirkung |
| LEFT | CL_ABAP_FORMAT=>S_LEFT | "-" links ohne Zwischenraum, kein "+" |
| LEFTPLUS | CL_ABAP_FORMAT=>S_LEFTPLUS | "-" und "+" links ohne Zwischenraum |
| LEFTSPACE | CL_ABAP_FORMAT=>S_LEFTSPACE | "-" links ohne Zwischenraum, Leerzeichen links für "+" |
| RIGHT | CL_ABAP_FORMAT=>S_RIGHT | "-" rechts ohne Zwischenraum, kein "+" |
| RIGHTPLUS | CL_ABAP_FORMAT=>S_RIGHTPLUS | "-" und "+" rechts ohne Zwischenraum |
| RIGHTSPACE | CL_ABAP_FORMAT=>S_RIGHTSPACE | "-" links ohne Zwischenraum, Leerzeichen rechts für "+" |
Die Standardeinstellung ist LEFT.
Beispiel
Siehe Zeichenketten-Templates, Vorzeichen
Zusatz 6
... EXPONENT = exp ...
Wirkung
Diese Formatierungsoption legt den Exponenten bei der Aufbereitung vonGleitpunktzahlen auf den Wert von exp fest, wobei exp einenumerischeAusdrucksposition ist. Die Option EXPONENT kann nur angegeben werden, wenn der eingebettete Ausdruck einennumerischen Datentyp hat. Sie darf nicht zusammen mit der Option TIMEZONE angegeben werden.
Die Option EXPONENT wirkt nur auf den Datentyp f oder wenn die Option STYLE mitdem Wert scientific angegeben ist. Die Aufbereitung der Zeichenkette erfolgt dann genau wie beider Formatierungsoption EXPONENTder Anweisung WRITE TO mit folgender Ausnahme:
Wenn für exp der Wert der Konstanten CL_ABAP_FORMAT=>EXP_PRESERVE angegeben wird, wird der Exponent verwendet, welcher der internen Darstellung der Gleitpunktzahl entspricht.
Zusatz 7
... DECIMALS = dec ...
Wirkung
Diese Formatierungsoption legt die Anzahl der Nachkommastellen bei der Aufbereitung von numerischen Werten auf den Wert von dec fest, wobei dec einenumerischeAusdrucksposition ist. Die Option DECIMALS kann nur angegeben werden, wenn der eingebettete Ausdruck einennumerischen Datentyp hat. Sie darf nicht zusammen mit der Option TIMEZONE angegeben werden.
Die Aufbereitung der Zeichenkette erfolgt bezüglich der Nachkommastellen dann genau wie bei derFormatierungsoption DECIMALSder Anweisung WRITE TO.
Hinweis
Die Formatierungsoption DECIMALS übersteuert nicht dievordefinierte Einstellung, dass keine Tausendertrennzeichen eingefügt werden.
Zusatz 8
... ZERO = YES|NO|(val) ...
Wirkung
Diese Formatierungsoption legt das Format des numerischen Werts Null fest. Die Option ZERO kann nur angegeben werden, wenn der eingebettete Ausdruck einennumerischen Datentyp hat. Sie darf nicht zusammen mit der Option TIMEZONE angegeben werden.
Das Format des Werts Null kann entweder statisch mit einem der vorgegebenen Parameter oder dynamischals Inhalt eines in Klammern angegebenen Datenobjekts val angegeben werden. Die möglichen Werte von val sind in der KlasseCL_ABAP_FORMAT als Konstanten definiert.
| Parameter | Wert von val | Wirkung |
| YES | CL_ABAP_FORMAT=>Z_YES | Der Wert Null wird gemäß der aktuellen Formatierung als Zahlenwert dargestellt. |
| NO | CL_ABAP_FORMAT=>Z_NO | Der Wert Null wird als leere Zeichenkette dargestellt. |
Die Standardeinstellung ist YES.
Zusatz 9
... STYLE = ...|(val) ...
Wirkung
Diese Formatierungsoption legt das Format von dezimalen Gleitpunktzahlen fest. Die Option STYLE kann nur angegeben werden, wenn der eingebettete Ausdruck einennumerischenDatentyp hat. Sie darf nicht zusammen mit den Optionen SIGN und TIMEZONE angegeben werden.
Das Format einer dezimalen Gleitpunktzahl kann entweder statisch mit einem vorgegebenen Parameter oderdynamisch als Inhalt eines in Klammern angegebenen Datenobjekts val angegeben werden. Die möglichen Werte von val sind in der KlasseCL_ABAP_FORMAT als Konstanten definiert. Die folgende Tabelle zeigt die vorgegebenen Parameter und die Konstanten aus der Klasse CL_ABAP_FORMAT:
| Parameter | Wert von val |
| SIMPLE | CL_ABAP_FORMAT=>O_SIMPLE |
| SIGN_AS_POSTFIX | CL_ABAP_FORMAT=>O_SIGN_AS_POSTFIX |
| SCALE_PRESERVING | CL_ABAP_FORMAT=>O_SCALE_PRESERVING |
| SCIENTIFIC | CL_ABAP_FORMAT=>O_SCIENTIFIC |
| SCIENTIFIC_WITH_LEADING_ZERO | CL_ABAP_FORMAT=>O_SCIENTIFIC_WITH_LEADING_ZERO |
| SCALE_PRESERVING_SCIENTIFIC | CL_ABAP_FORMAT=>O_SCALE_PRESERVING_SCIENTIFIC |
| ENGINEERING | CL_ABAP_FORMAT=>O_ENGINEERING |
| MONETARY | CL_ABAP_FORMAT=>O_MONETARY |
| EXTENDED_MONETARY | CL_ABAP_FORMAT=>O_EXTENDED_MONETARY |
Die Standardeinstellung ist SIMPLE.
Die Aufbereitung der Zeichenkette erfolgt mit folgenden Ausnahmen wie bei der Formatierungsoption STYLE der Anweisung WRITETO. D.h., der numerische Wert wird in den Datentyp decfloat34 konvertiert und wie dort beschrieben behandelt. Anders als bei WRITE TO gilt:
- Bei der Angabe von SIMPLE wird das vordefinierte Format eingebetteter Ausdrücke verwendet.
- Betreffs Tausender- und Dezimaltrennzeichen gelten ebenfalls dieallgemeinen Regeln für eingebettete Ausdrücke.
Wie beim WRITE TO gelten folgende Regeln für das Zusammenspiel mit anderen Formatierungsoptionen:
- Die Option EXPONENT darf nur bei dem Ausgabeformat SCIENTIFIC angegeben werden.
- Die Option CURRENCY muss bei den Ausgabeformaten MONETARY und EXTENDED_MONETARY angegeben werden.
- Die Option DECIMALS darf nicht bei Ausgabeformaten angegeben werden, welche die Skalierung erhalten.
Beispiel
Siehe Dezimale Gleitpunktzahlen, Aufbereitung mit STYLE
Zusatz 10
... CURRENCY = cur ...
Wirkung
Diese Formatierungsoption legt die Anzahl der Nachkommastellen bei der Aufbereitung von numerischen Werten in Abhängigkeit von einer in cur über einWährungskürzelangegebenen Währung fest. Die Option CURRENCY kann nur angegeben werden, wenn der eingebettete Ausdruck einennumerischenDatentyp hat. Sie darf nicht zusammen mit der Option TIMEZONE angegeben werden. Wenn dieOption STYLE verwendet wird, dürfen dort nur die Parameter MONETARY und EXTENDED_MONETARY angegeben werden. Wenn die Option STYLE nicht angegeben ist, wird beidezimalenGleitpunktzahlen implizit der Wert MONETARY verwendet. Mit der Option SIGN kann dann zusätzlich die Formatierung des Vorzeichens gesteuert werden.
Die Aufbereitung der Zeichenkette bezüglich ihrer Nachkommastellen erfolgt mit Ausnahme desDatentyps p genau wie bei der Formatierungsoption CURRENCYder Anweisung WRITE TO. Beim Datentyp p kommt es darauf an, wie der Wert angegeben ist:
- Bei der Angabe als Datenobjekt oder als funktionale Methode wirkt CURRENCY wie bei WRITE TO,d.h. die tatsächlichen Nachkommastellen werden ignoriert und das Dezimaltrennzeichen wird gemäß der Währung des angegebenen Währungskürzels eingefügt.
- Bei der Angabe eines arithmetischen Ausdruck oder einerallgemeinen numerische Funktion wirkt CURRENCY wie DECIMALS.
Bei allen numerischen Datentypen außer dezimalen Gleitpunktzahlen wird in cur ein Währungskürzel aus der Spalte WAERS der DatenbanktabelleTCURC erwartet, während für dezimale Gleitpunktzahlen ein Wert aus der Spalte CURRENCYCODE der Datenbanktabelle/ISCER/C_CUR angegeben werden muss. Bei dezimalenGleitpunktzahlen führt eine ungültige Währung zur Ausnahme CX_SY_UNKNOWN_CURRENCY.Bei den anderen numerischen Typen werden für jedes angegebene Währungskürzel zwei Nachkommastellen verwendet, es sei denn es ist in der Spalte CURRKEY der DatenbanktabelleTCURX enthalten. Dann wird die Anzahl der Nachkommastellen aus der Spalte CURRDEC der entsprechenden Zeile in TabelleTCURX ermittelt.
Hinweis
Die Formatierungsoption CURRENCY übersteuert nicht dievordefinierte Einstellung, dass keine Tausendertrennzeichen eingefügt werden.
Beispiel
Siehe Dezimale Gleitpunktzahlen, Aufbereitung mit STYLE
Zusatz 11
... NUMBER = RAW|USER|ENVIRONMENT|(val) ...
Wirkung
Diese Formatierungsoption legt das Format der Dezimaldarstellung (Dezimaltrennzeichen und Tausendertrennzeichen) fest. Die Option NUMBER kann nur angegeben werden, wenn der eingebettete Ausdruck einennumerischenDatentyp hat. Sie darf neben oben aufgeführten Ausschlüssen auch nicht mit der Option TIMEZONE zusammen angegeben werden.
Das Format der Dezimaldarstellung kann entweder statisch mit einem der vorgegebenen Parameter oder dynamischals Inhalt eines in Klammern angegebenen Datenobjekts val angegeben werden. Die möglichen Werte von val sind in der KlasseCL_ABAP_FORMAT als Konstanten definiert.
| Parameter | Wert von val | Wirkung |
| RAW | CL_ABAP_FORMAT=>N_RAW | Das Dezimaltrennzeichen ist der Punkt (.) und es werden keine Tausendertrennzeichen eingefügt. |
| USER | CL_ABAP_FORMAT=>N_USER | Dezimaltrennzeichen und Tausendertrennzeichen werden demBenutzerstammsatz entnommen. |
| ENVIRONMENT | CL_ABAP_FORMAT=>N_ENVIRONMENT | Dezimaltrennzeichen und Tausendertrennzeichen richten sich nach der aktuellenFormatierungseinstellung derSprachumgebung,die durch SET COUNTRY gesetzt werden kann. |
Die Standardeinstellung ist RAW.
Hinweis
Wenn die Formatierungseinstellung derSprachumgebungnicht über SET COUNTRY auf einländerspezifischesFormat gesetzt wurde, ist die Verwendung von environment gleichbedeutend zur Verwendung von user.
Beispiel
Siehe Zeichenketten-Templates, Formatierungseinstellungen
Zusatz 12
... DATE = RAW|ISO|USER|ENVIRONMENT|(val) ...
Wirkung
Diese Formatierungsoption legt das Format eines Datums fest. Die Option DATE kann nur angegeben werden, wenn der eingebettete Ausdruck den Datentyp d hat.
Das Format des Datums kann entweder statisch mit einem der vorgegebenen Parameter oder dynamisch alsInhalt eines in Klammern angegebenen Datenobjekts val angegeben werden. Die möglichen Werte von val sind in der KlasseCL_ABAP_FORMAT als Konstanten definiert.
| Parameter | Wert von val | Wirkung |
| RAW | CL_ABAP_FORMAT=>D_RAW | Der Inhalt des Datumsfelds wird unformatiert übernommen. |
| ISO | CL_ABAP_FORMAT=>D_ISO | Die Aufbereitung des Datums erfolgt gemäß ISO 8601 mit Strichen (-) als Trennzeichen: "yyyy-mm-dd". |
| USER | CL_ABAP_FORMAT=>D_USER | Die Aufbereitung des Datums geschieht entsprechend der imBenutzerstammsatz definierten Maske. |
| ENVIRONMENT | CL_ABAP_FORMAT=>D_ENVIRONMENT | Die Aufbereitung des Datums richtet sich nach der aktuellenFormatierungseinstellung derSprachumgebung,die durch SET COUNTRY gesetzt werden kann. |
Die Standardeinstellung ist RAW.
Hinweis
Wenn die Formatierungseinstellung derSprachumgebungnicht über SET COUNTRY auf einländerspezifischesFormat gesetzt wurde, ist die Verwendung von environment gleichbedeutend zur Verwendung von user.
Beispiel
Siehe Zeichenketten-Templates, Formatierungseinstellungen
Zusatz 13
... TIME = RAW|ISO|USER|ENVIRONMENT|(val) ...
Wirkung
Diese Formatierungsoption legt das Format einer Zeitangabe fest. Die Option TIME kann nur angegeben werden, wenn der eingebettete Ausdruck den Datentyp t hat.
Das Format der Zeitangabe kann entweder statisch mit einem der vorgegebenen Parameter oder dynamischals Inhalt eines in Klammern angegebenen Datenobjekts val angegeben werden. Die möglichen Werte von val sind in der KlasseCL_ABAP_FORMAT als Konstanten definiert.
| Parameter | Wert von val | Wirkung |
| RAW | CL_ABAP_FORMAT=>T_RAW | Der Inhalt des Zeitfelds wird unformatiert übernommen. |
| ISO | CL_ABAP_FORMAT=>T_ISO | Die Aufbereitung der Zeitangabe erfolgt gemäß ISO 8601 im 24-Stunden-Format mit Doppelpunkten (:) als Trennzeichen: "hh:mm:ss". |
| USER | CL_ABAP_FORMAT=>T_USER | Die Aufbereitung der Zeit geschieht entsprechend des imBenutzerstammsatz definierten Formats. |
| ENVIRONMENT | CL_ABAP_FORMAT=>T_ENVIRONMENT | Die Aufbereitung der Zeit richtet sich nach der aktuellenFormatierungseinstellung derSprachumgebung,die durch SET COUNTRY gesetzt werden kann. |
Die Standardeinstellung ist RAW.
Hinweis
Im Benutzerstammsatz oder über die Anweisung SET COUNTRY können ein 24-Stunden-Format und vier 12-Stunden-Formate eingestellt werden.Um eine Formatierung im 12-Stunden-Format zu erwirken, muss USER oder ENVIRONMENT angegeben oder alternativ mit der Formatierungsoption COUNTRY gearbeitet werden.
Hinweis
Wenn die Formatierungseinstellung derSprachumgebungnicht über SET COUNTRY auf einländerspezifischesFormat gesetzt wurde, ist die Verwendung von environment gleichbedeutend zur Verwendung von user.
Beispiel
Siehe Zeichenketten-Templates, Formatierungseinstellungen
Zusatz 14
... TIMESTAMP = SPACE|ISO|USER|ENVIRONMENT|(val) ...
Wirkung
Diese Formatierungsoption legt das Format eines Zeitstempels fest. Die Option TIMESTAMP kann nur angegeben werden, wenn der eingebetteteAusdruck den Datentyp p der Länge 8 ohne Nachkommastellen (TIMESTAMP aus dem ABAP Dictionary)oder den Datentyp p der Länge 11 mit sieben Nachkommastellen (TIMESTAMPL aus dem ABAP Dictionary) hat. Der Wert des eingebetteten Ausdrucks wird als Zeitstempel aufgefasst.
Das Format des Zeitstempels kann entweder statisch mit einem der vorgegebenen Parameter oder dynamischals Inhalt eines in Klammern angegebenen Datenobjekts val angegeben werden. Die möglichen Werte von val sind in der KlasseCL_ABAP_FORMAT als Konstanten definiert.
| Parameter | Wert von val | Wirkung |
| SPACE | CL_ABAP_FORMAT=>TS_SPACE | Der Inhalt des Zeitstempels wird standardmäßig in ein Datum und eine Zeitangabe inUTC-Referenzzeitkonvertiert und diese werden getrennt durch ein Leerzeichen jeweils nach ISO 8601 dargestellt: "yyyy-mm-dd hh:mm:ss.zzzzzzz". Mit der Option TIMEZONE kann eine andere Zeitzone angegeben werden. |
| ISO | CL_ABAP_FORMAT=>TS_ISO | Wie SPACE, wobei abergemäß ISO 8601 das Zeichen "T" zwischen Datum und Zeit steht und als Dezimaltrennzeichen immer das Komma(,) verwendet wird: "yyyy-mm-ddThh:mm:ss,zzzzzzz". |
| USER | CL_ABAP_FORMAT=>TS_USER | Wie SPACE, wobei aber das Datums- und das Zeitformat demBenutzerstammsatz entnommen werden. |
| ENVIRONMENT | CL_ABAP_FORMAT=>TS_ENVIRONMENT | Wie SPACE. Datums- und das Zeitformat richten sich hier aber nach der aktuellenFormatierungseinstellung derSprachumgebung,die durch SET COUNTRY gesetzt werden kann. |
| - | CL_ABAP_FORMAT=>TS_RAW | Der Inhalt des Zeitstempels wird unkonvertiert als gepackte Zahl ausgegeben. |
Die Standardeinstellung ist SPACE.
Hinweis
Wenn die Formatierungseinstellung derSprachumgebungnicht über SET COUNTRY auf einländerspezifischesFormat gesetzt wurde, ist die Verwendung von environment gleichbedeutend zur Verwendung von user.
Beispiel
Siehe Zeichenketten-Templates, Formatierungseinstellungen
Zusatz 15
... TIMEZONE = tz ...
Wirkung
Diese Formatierungsoption legt die Zeitzone fest, in die einZeitstempelkonvertiert wird. Die Option TIMEZONE kann nur angegeben werden, wenn der eingebettete Ausdruckden Datentyp p der Länge 8 ohne Nachkommastellen (TIMESTAMP aus dem ABAP Dictionary) oderden Datentyp p der Länge 11 mit sieben Nachkommastellen (TIMESTAMPL aus dem ABAP Dictionary)hat. Der Wert des eingebetteten Ausdrucks wird als Zeitstempel aufgefasst. Wenn die Option TIMEZONEohne die Option TIMESTAMP angegeben wird, wird der Zeitstempel implizit so aufbereitet, wie wenn die Option TIMESTAMP mit dem Parameter SPACE angegeben wäre. Wenn für TIMESTAMP in val der Wert von CL_ABAP_FORMAT=>TS_RAW angegeben wird, darf TIMEZONE nicht angegeben werden.
Für tz muss ein Datenobjekt vom Typ TIMEZONE aus dem ABAP Dictionary angegeben werden, das eine Zeitzone aus der Spalte TZONE der DatenbanktabelleTTZZ in Großbuchstaben enthält. Ist tz initial, wird dieUTC-Referenzzeit verwendet.
Beispiel
Siehe Zeichenketten-Templates, Zeitzonen
Zusatz 16
... COUNTRY = cty ...
Wirkung
Die Formatierungsoption COUNTRY legt eine temporäreFormatierungseinstellungfür den aktuellen eingebetteten Ausdruck fest. Sie kann alternativ zu allen Formatierungsoptionen angegeben werden, für die der Parameter ENVIRONMENT angegeben kann, also statt NUMBER, DATE, TIME und TIMESTAMP. Der eingebettete Ausdruck wird je nach Datentyp als Zahl, Datum, Zeit oder Zeitstempel formatiert.
Für cty muss ein Datenobjekt vom TypLAND1 aus dem ABAP Dictionary angegeben werden, das entweder einen Wert aus der Spalte LAND der DatenbanktabelleT005X enthält oder initial ist, ansonsten kommt es zu einer Ausnahme der Klasse CX_SY_STRG_FORMAT
Wenn cty einen Wert aus der Tabelle T005X enthält, wird das dort festgelegteländerspezifische Format verwendet. Wenn cty initial ist, wird die imBenutzerstammsatz angegebene Formatierung verwendet.
Hinweise
- Im Gegensatz zur Verwendung der Anweisung SETCOUNTRY und dem Parameter ENVIRONMENT ist die Verwendung der Formatierungsoption COUNTRYnebenwirkungsfrei. Die Länderangabe wirkt nur auf den aktuellen eingebetteten Ausdruck und nicht auf alle nachfolgenden Anweisungen des aktuellen internen Modus.
- Die Formatierungsoption COUNTRY übersteuert in Zahlen dievordefinierte Einstellung bezüglich Tausendertrennzeichen.
Beispiele
Siehe
- Zeichenketten-Templates, Zahlenformate
- Zeichenketten-Templates, Datumsformate
- Zeichenketten-Templates, Zeitformate
rdisp/max_wprun_time - Maximum work process run time PERFORM Short Reference
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 46797 Date: 20120526 Time: 193102 triton ( 850 ms )






