UNIT_CONVERSION_SIMPLE — Convert a Quantity Between Units of the Same Dimension
Converts a numeric value from one unit of measure to another using central unit customizing in T006 and applies configured rounding rules. Both units normally need to belong to the same dimension. It is a generic unit conversion; material-specific alternative-unit factors require material-aware functions such as MATERIAL_UNIT_CONVERSION or MD_CONVERT_MATERIAL_UNIT.
Verified-reference draft for UNIT_CONVERSION_SIMPLE, focused on real input/output semantics, edge cases, S/4HANA implications, and safe use. The page deliberately avoids inventing release-specific exception names; the active SE37 signature remains the authority for exact technical typing.
Published 20 Sept 2026· 663 words
What it does
Converts a numeric value from one unit of measure to another using central unit customizing in T006 and applies configured rounding rules. Both units normally need to belong to the same dimension. It is a generic unit conversion; material-specific alternative-unit factors require material-aware functions such as MATERIAL_UNIT_CONVERSION or MD_CONVERT_MATERIAL_UNIT. The function should be treated as one technical building block inside a larger business process. It does not replace application-specific validation, authorization, posting-period control, or master-data checks unless its own documentation explicitly says those are part of the service.
Important parameters
ERPClimb documents the parameters that materially affect the result rather than reproducing the entire SE37 signature. Always inspect the active interface before coding because optional flags and exact DDIC types can differ across releases.
- INPUT, UNIT_IN, UNIT_OUT, ROUND_SIGN and OUTPUT are the core parameters; factor and decimal outputs can also be returned.
- Keep source and target values typed with the DDIC elements expected by the interface so conversion, decimal, language, and length rules are preserved.
- If the function returns both a result and supporting factor/rate/calendar metadata, keep them together when troubleshooting so the result can be reproduced.
Exceptions
Treat technical exceptions and 'no matching customizing/data' outcomes separately. A clean SY-SUBRC does not excuse the caller from validating that the result is present and meaningful for the business context.
- Missing unit customizing, dimension mismatch, overflow/rounding issues, or using generic T006 conversion when material-specific factors are required are key failures.
- Where named exceptions are not stated here, use SE37 function documentation as the authoritative list instead of copying exception names from an unrelated release.
- Log enough input context to reproduce the failure without writing sensitive business data unnecessarily.
How to call it safely
Normalize the input with the field's assigned conversion semantics, call the function with explicit date/language/unit/currency context, check exceptions immediately, and validate the result before continuing. For bulk processing, avoid repeated calls when the same calendar, rate, or metadata can be resolved once and cached safely within the current LUW.
ECC vs S/4HANA
SAP documents equivalent unit-conversion semantics in current ABAP platform and CDS. For new analytics, released CDS unit_conversion can be preferable to procedural FM calls. Availability in classic S/4HANA does not by itself make the function a released ABAP Cloud API. For new clean-core work, prefer released CDS conversion functions, classes, or business APIs where SAP provides an equivalent.
Common pitfalls
- Do not assume the function's existence means it is a released clean-core API; verify release status in the target system.
- Use DDIC-typed variables rather than hard-coded character lengths so S/4HANA length extensions and language-dependent formats do not get truncated.
- Handle all declared exceptions and validate the semantic result before using it in a posting, interface, or calculation.
- Test boundary cases such as blank values, end-of-month dates, leap years, missing customizing, and maximum field lengths relevant to the function.
- Do not confuse formatting/conversion with business determination: the caller still owns which calendar, rate type, unit, language, or target format is correct for the scenario.
Whose problem this is
ABAP development owns correct typing, exception handling, and call context. Functional ownership depends on the data being interpreted: Finance owns exchange-rate and currency rules, MM/PP owns material and unit semantics, HCM owns statutory date logic, and Basis or cross-application configuration owners maintain central calendars and units.
Related SAP objects
Reviewed pages this object connects to in the ERPClimb knowledge graph.
Source: ERPClimb — https://erpclimb.com/sap-function-modules/unit-conversion-simpleERPClimb is an independent platform and is not affiliated with SAP SE. Reference pages are written and reviewed by SAP consultants for learning and troubleshooting.