New currency conversion function in ABAP SQL

Currency conversions are now possible in ABAP SQL as well as ABAP CDS. From 7.55 release, the new currency conversion function for converting between unit currencies in an ABAP SQL statement is supported as

…CURRENCY_CONVERSION( p1 = a1, p2 = a2, … )…

Which is simillar to currency conversion function for ABAP CDS

…CURRENCY_CONVERSION( p1 => a1, p2 => a2, … )…

with keyword parameters p1, p2, … (some of which are optional), to which actual parameters a1, a2, … must be assigned when a function is called. The table below shows the parameters p1, p2, … and their meaning.

The function CURRENCY_CONVERSION performs a currency conversion for the value passed to the formal parameter amount. The result has the data type CURR with the same technical attributes as the actual parameter passed to amount. The value passed is rounded to two decimal places before it is converted. The conversion is performed on the database, which means that part of the calculation takes place using different rounding rules from ABAP. No matter how the conversion is made, the same results cannot be expected as when using standard function modules for currency conversion, since these modules are generally less precise and round the intermediate results accordingly. After the conversion, the result is divided by 10 to the power of the number of decimal places of the target currency.

Example

The following is an excerpt of the program DEMO_ASQL_CURRENCY_CONVERSION. The SELECT statement calls a currency conversion in its SELECT list for the column AMOUNT of the DDIC database table DEMO_PRICES. The target currency is passed as a host variable. In the event of an error, for example when a currency is not available, an exception is raised. As a prerequisite for the example, the currencies and conversion rules must be available in the corresponding DDIC database tables.

DATA currency TYPE c LENGTH 5 VALUE 'USD'.

SELECT FROM demo_prices
       FIELDS id,
              amount,
              currency,
                currency_conversion(
                amount = amount,
                source_currency = currency,
                target_currency = @currency,
                exchange_rate_date = @sy-datlo,
                round = 'X',
                on_error = @sql_currency_conversion=>c_on_error-fail )
                    AS Converted_Amount,
                @currency AS converted_currency
        ORDER BY id
          INTO TABLE @DATA(converted_prices_asql).

The output is

As a comparison, the same conversion is also performed using the function module CONVERT_TO_LOCAL_CURRENCY.

Example

The following CDS view entity performs a currency conversion in the SELECT list for the column AMOUNT of the DDIC database table DEMO_PRICES. The target currency must be passed as a parameter. Using the same input, the output is similar as the above example.

@AccessControl.authorizationCheck: #NOT_REQUIRED 
define view entity DEMO_CDS_CURR_CONV
  with parameters 
    to_currency :abap.cuky( 5 ), 
    exc_date    :abap.dats 
  as select from 
    demo_prices 
    { 
      key id, 
       amount,
       currency,     
      @Semantics.amount.currencyCode: 'currency' 
      currency_conversion( amount => amount, 
                          source_currency => currency, 
                          round =>  'X', 
                          target_currency => $parameters.to_currency, 
                          exchange_rate_date => $parameters.exc_date, 
                          error_handling => 'SET_TO_NULL' ) as ConvertedAmount, 
      $parameters.to_currency                               as ConvertedCurrency 
    }

To know more details on handling the currency conversions, its roles and limitations, please check the ABAP Keyword Documentation.