ABAP Addition 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 ... XSD = YES|NO|(val) ... 10 ... STYLE = ...|(val) ... 11 ... CURRENCY = cur ... 12 ... NUMBER = RAW|USER|ENVIRONMENT|(val) ... 13 ... ALPHA = IN|OUT|RAW|(val) ... 14 ... DATE = RAW|ISO|USER|ENVIRONMENT|(val) ... 15 ... TIME = RAW|ISO|USER|ENVIRONMENT|(val) ... 16 ... TIMESTAMP = SPACE|ISO|USER|ENVIRONMENT|(val) ... 17 ... TIMEZONE = tz ... 18 ... COUNTRY = cty ...
What does it do? These formatting options override thepredefined formats of embedded expressions in string templates. The formatting options are specified as optional keyword parameters to which an actual parameter is assigned.
The possible formatting options depend on the data type of the embedded expression. The formatting options NUMBER, DATE, TIME, TIMESTAMP, and COUNTRY are mutually exclusive.
If a formal parameter or a field symbol with a generic data type is specified as an embedded expression, only those formatting options can be specified that are permitted for all possible specific data types.
ABAP Addition
What does it do? This formatting option defines the length of the string displayed by the embedded expression as the value of len, where len is a numerical expression position.
The option WIDTH can be specified for all data types of the embedded expression. If the value of len is less than the minimum required length, it is ignored. This means that the predefined length cannot be reduced, only increased. By default, a string is extended on the right and padded with blanks. This default setting can be overridden using the formatting options ALIGN and PAD.
Example ABAP Coding See Character String Templates, Length
ABAP Addition
What does it do? This formatting option defines the alignment of the string represented by the embedded expression. It only takes effect if WIDTH is used to define a length that is greater than the minimum required length.
The alignment can either be specified statically with one of the predefined parameters or dynamically as the content of a data object val, specified in parentheses. The possible values of val are defined as constants in the class CL_ABAP_FORMAT. ParameterValue of valEffect LEFTCL_ABAP_FORMAT=>A_LEFTLeft-aligned RIGHTCL_ABAP_FORMAT=>A_RIGHTRight-aligned CENTERCL_ABAP_FORMAT=>A_CENTERCentered
The default setting is LEFT. Depending on the alignment, excess characters in the result are padded with blanks (default) on the right, left, or alternately left and right. This default setting can be overridden using the formatting option PAD.
Example ABAP Coding See Character String Templates, Alignments, and Padding
ABAP Addition
What does it do? This formatting option defines the character used to pad any excess places in the result. It only takes effect if WIDTH is used to define a length that is greater than the minimum required length.
A data object of data type c or string can be defined for c, the first character of which is used as padding. If the PAD option is not specified or if c is specified as an empty string, blanks are used as padding.
Example ABAP Coding See Character String Templates, Alignments, and Padding
ABAP Addition
What does it do? This formatting option defines the case of the string represented by the embedded expression. It can be specified for all data types of the embedded expression.
The case (upper/lower) can either be specified statically with one of the predefined parameters or dynamically as the content of a data object val, specified in parentheses. The possible values of val are defined as constants in the class CL_ABAP_FORMAT. ParameterValue of valEffect RAWCL_ABAP_FORMAT=>C_RAWUnchanged UPPERCL_ABAP_FORMAT=>C_UPPERUppercase LOWERCL_ABAP_FORMAT=>C_LOWERLowercase
The default setting is RAW.
Latest notes:The formatting option CASE affects the letters in a string. It has no effect on padding characters specified using PAD . In numeric data types, the 'e' or 'E' of an exponent is affected; in byte-like data types, the letters in a hexadecimal representation are affected.
Example ABAP Coding See String Templates, Upper/Lower Case
What does it do? This formatting option defines the format of the +/- sign when the string represented by the embedded expression contains a numeric value. It can be specified only if the embedded expression has a numeric data type.
The format of the +/- sign can either be specified statically with one of the predefined parameters or dynamically as the content of a data object val, specified in parentheses. The possible values of val are defined as constants in the class CL_ABAP_FORMAT. ParameterValue of valEffect LEFTCL_ABAP_FORMAT=>S_LEFT'-' left without space, no '+' LEFTPLUSCL_ABAP_FORMAT=>S_LEFTPLUS'-' and ' +' left without space LEFTSPACECL_ABAP_FORMAT=>S_LEFTSPACE'-' left without space, blank left for '+' RIGHTCL_ABAP_FORMAT=>S_RIGHT'-' right without space, no '+' RIGHTPLUSCL_ABAP_FORMAT=>S_RIGHTPLUS'-' and ' +' right without space RIGHTSPACECL_ABAP_FORMAT=>S_RIGHTSPACE'-' left without space, blank right for '+'
The default setting is LEFT.
Example ABAP Coding See String Templates, Sign
ABAP Addition
What does it do? This formatting option defines the exponent as the value of exp when formatting floating point numbers, where exp is a numerical expression position . The option EXPONENT can be specified only if the embedded expression has a numeric data type. It cannot be specified in combination with the option TIMEZONE.
The option EXPONENT only affects the data type f or if the option STYLE is specified with the value scientific. The string is then formatted in exactly the same way as with the formatting option EXPONENT of the statement WRITE TO, with the following exception:
If exp is specified as the value of the constant CL_ABAP_FORMAT=>EXP_PRESERVE, the exponent is used that matches the internal representation of the floating point value.
ABAP Addition
What does it do? This formatting option defines the number of decimal places as the value of dec, where dec is a numerical expression position . The option DECIMALS can be specified only if the embedded expression has a numeric data type. It cannot be specified in combination with the option TIMEZONE.
The string is then formatted in exactly the same way as with the formatting option DECIMALS of the statement WRITE TO.
Latest notes:The DECIMALS formatting option does not override thepredefined format specifying that thousands separators are not inserted.
ABAP Addition
What does it do? This formatting option defines the format of the numeric value zero. The option ZERO can be specified only if the embedded expression has a numeric data type. It cannot be specified in combination with the option TIMEZONE.
The format of the value zero can either be specified statically with one of the predefined parameters or dynamically as the content of a data object val, specified in parentheses. The possible values of val are defined as constants in the class CL_ABAP_FORMAT. ParameterValue of valEffect YESCL_ABAP_FORMAT=>Z_YESThe value zero is represented as a numeric value in accordance with the current formatting. NOCL_ABAP_FORMAT=>Z_NOThe value zero is represented as an empty string.
The default setting is YES.
ABAP Addition
What does it do? This formatting option formats the value of the embedded expression in the axXML format that is associated with its data type. The option XSD can be specified for all elementary data types. It cannot be specified together with other formatting options; with the exception of WIDTH, ALIGN , PAD, CASE, and ZERO.
The option XSD affects all data types listed underMapping of Elementary ABAP Types, as specified there.
The asXML format can either be enabled statically using one of the predefined parameters or dynamically as the content of a data object val, specified in parentheses. The possible values of val are defined as constants in the class CL_ABAP_FORMAT. ParameterValue of valEffect YESCL_ABAP_FORMAT=>X_YESThe data type of the embedded expression determines how it is formatted in accordance with the asXML format specified under Mapping of Elementary ABAP Types. If the data type references one of the domains specified under Mapping of Further XML Schema Data Types (with the exception of XSDQNAME), then the format listed there is used. XML fragments cannot be mapped using the domain XSDANY. NOCL_ABAP_FORMAT=>X_NOUnchanged
If the data type of the embedded expression has the type x orxstring, then a formatting option CASE specified at the same time is ignored (unless it refers to the domain XSDUUID_RAW ).
Latest notes:The formatting of an embedded expression generally produces the same result as applying the predefined identity transformation ID. Unlike a CALL TRANSFORMATION call, exceptions that can be raised by mappings, but not wrapped, should be handled directly
What does it do? This formatting option defines the style ofdecimal floating point numbers. The option STYLE can be specified only if the embedded expression has a numeric data type. It cannot be specified in combination with the options CURRENCY, SIGN, or TIMEZONE.
The style of a decimal floating point number can either be specified statically with a predefined parameter or dynamically as the content of a data object val, specified in parentheses. The possible values of val are defined as constants in the class CL_ABAP_FORMAT. The following table shows the predefined parameters and the constants of the class CL_ABAP_FORMAT: ParameterValue of val SIMPLECL_ABAP_FORMAT=>O_SIMPLE SIGN_AS_POSTFIXCL_ABAP_FORMAT=>O_SIGN_AS_POSTFIX SCALE_PRESERVINGCL_ABAP_FORMAT=>O_SCALE_PRESERVING SCIENTIFICCL_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 ENGINEERINGCL_ABAP_FORMAT=>O_ENGINEERING
The default setting is SIMPLE. The string is then formatted in exactly the same way as with the formatting option STYLE of the statement WRITE TO. This means that the numeric value is converted to the data type decfloat34 and is handled as described here. Unlike WRITE TO, the following applies: SIMPLE uses the predefined format of embedded expressions. The general rules for embedded expressions apply to thousands separators and decimal separators for embedded expressions.
As in WRITE TO, the following rules apply when combining these options with other formatting options: The option EXPONENT can only be specified in combination with the output style SCIENTIFIC. The option DECIMALS cannot be specified for output styles that include scaling.
Example ABAP Coding See Decimal Floating Point Number, Formatting with STYLE
ABAP Addition
What does it do? This formatting option defines the number of decimal places when formatting numeric values, dependent on a currency when specified incur using a currency code . The option CURRENCY can be specified only if the embedded expression has one of the numeric data types i, p, or f. It cannot be specified for the numeric data types decfloat16 and decfloat34 and not in combination with the options STYLE or TIMEZONE. The option SIGN can be used to control the formatting of the sign.
The string is formatted in exactly the same way as with the formatting option CURRENCY of the statement WRITE TO with the exception of data type p. In the case of data type p, the formatting depends on how the value is specified: When the value is specified as a data object or a functional method, CURRENCY works as in WRITE TO, meaning that the actual decimal places are ignored and the decimal separator is inserted according to the currency associated with the specified currency ID . When specifying a value of an arithmetic expression or a general numeric function, CURRENCY works as in DECIMALS.
cur in the numeric data types i, p, and f expects a currency ID from the column WAERS of the database table TCURC. Two decimal places are used for every currency ID specified, unless it is contained in the CURRKEY column of the database table TCURX. In this case, the number of decimal places is determined from the CURRDEC column of the corresponding row in table TCURX.
Latest notes:The CURRENCY formatting option does not override thepredefined format specifying that thousands separators are not inserted.
ABAP Addition
What does it do? This formatting option defines the format of the decimal representation (decimal and thousand separators). The option NUMBER can only be specified if the embedded expression has a numeric data type. As well as the exclusions mentioned above, it cannot be used in combination with the option TIMEZONE .
The format of the decimal representation can either be specified statically with one of the predefined parameters or dynamically as the content of a data object val, specified in parentheses. The possible values of
